use strictures 1;
use Moo::_Utils;
+use B 'perlstring';
-our $VERSION = '0.009001'; # 0.9.1
+our $VERSION = '0.009013'; # 0.9.13
$VERSION = eval $VERSION;
our %MAKERS;
return if $MAKERS{$target}; # already exported into this package
*{_getglob("${target}::extends")} = sub {
_load_module($_) for @_;
- *{_getglob("${target}::ISA")} = \@_;
+ # Can't do *{...} = \@_ or 5.10.0's mro.pm stops seeing @ISA
+ @{*{_getglob("${target}::ISA")}{ARRAY}} = @_;
};
*{_getglob("${target}::with")} = sub {
require Moo::Role;
die "Only one role supported at a time by with" if @_ > 1;
- Moo::Role->apply_role_to_package($_[0], $target);
+ Moo::Role->apply_role_to_package($target, $_[0]);
};
$MAKERS{$target} = {};
*{_getglob("${target}::has")} = sub {
}
sub _constructor_maker_for {
- my ($class, $target) = @_;
+ my ($class, $target, $select_super) = @_;
return unless $MAKERS{$target};
$MAKERS{$target}{constructor} ||= do {
require Method::Generate::Constructor;
+ require Sub::Defer;
+ my ($moo_constructor, $con);
+
+ if ($select_super && $MAKERS{$select_super}) {
+ $moo_constructor = 1;
+ $con = $MAKERS{$select_super}{constructor};
+ } else {
+ my $t_new = $target->can('new');
+ if ($t_new) {
+ if ($t_new == Moo::Object->can('new')) {
+ $moo_constructor = 1;
+ } elsif (my $defer_target = (Sub::Defer::defer_info($t_new)||[])->[0]) {
+ my ($pkg) = ($defer_target =~ /^(.*)::[^:]+$/);
+ if ($MAKERS{$pkg}) {
+ $moo_constructor = 1;
+ $con = $MAKERS{$pkg}{constructor};
+ }
+ }
+ } else {
+ $moo_constructor = 1; # no other constructor, make a Moo one
+ }
+ };
Method::Generate::Constructor
->new(
package => $target,
accessor_generator => do {
require Method::Generate::Accessor;
Method::Generate::Accessor->new;
- }
+ },
+ construction_string => (
+ $moo_constructor
+ ? ($con ? $con->construction_string : undef)
+ : ('$class->'.$target.'::SUPER::new(@_)')
+ ),
+ subconstructor_generator => (
+ $class.'->_constructor_maker_for($class,'.perlstring($target).')'
+ ),
)
->install_delayed
- ->register_attribute_specs(do {
- my @spec;
- # using the -last- entry in @ISA means that classes created by
- # Role::Tiny as N roles + superclass will still get the attributes
- # from the superclass
- if (my $super = do { no strict 'refs'; ${"${target}::ISA"}[-1] }) {
- if (my $con = $MAKERS{$super}{constructor}) {
- @spec = %{$con->all_attribute_specs};
- }
- }
- @spec;
- });
+ ->register_attribute_specs(%{$con?$con->all_attribute_specs:{}})
}
}
1;
-
=pod
+=encoding utf-8
+
=head1 NAME
Moo - Minimalist Object Orientation (with Moose compatiblity)
Unlike C<Mouse> this module does not aim at full L<Moose> compatibility. See
L</INCOMPATIBILITIES> for more details.
+=head1 WHY MOO EXISTS
+
+If you want a full object system with a rich Metaprotocol, L<Moose> is
+already wonderful.
+
+I've tried several times to use L<Mouse> but it's 3x the size of Moo and
+takes longer to load than most of my Moo based CGI scripts take to run.
+
+If you don't want L<Moose>, you don't want "less metaprotocol" like L<Mouse>,
+you want "as little as possible" - which means "no metaprotocol", which is
+what Moo provides.
+
+By Moo 1.0 I intend to have Moo's equivalent of L<Any::Moose> built in -
+if Moose gets loaded, any Moo class or role will act as a Moose equivalent
+if treated as such.
+
+Hence - Moo exists as its name - Minimal Object Orientation - with a pledge
+to make it smooth to upgrade to L<Moose> when you need more than minimal
+features.
+
=head1 IMPORTED METHODS
=head2 new
=head2 BUILDARGS
-This feature from Moose is not yet supported.
+ around BUILDARGS => sub {
+ my $orig = shift;
+ my ( $class, @args ) = @_;
+
+ unshift @args, "attr1" if @args % 2 == 1;
+
+ return $class->$orig(@args);
+ };
-=head2 BUILDALL
+ Foo::Bar->new( 3 );
-Don't override (or probably even call) this method. Instead, you can define
-a C<BUILD> method on your class and the constructor will automatically call the
-C<BUILD> method from parent down to child after the object has been
-instantiated. Typically this is used for object validation or possibly logging.
+The default implementation of this method accepts a hash or hash reference of
+named parameters. If it receives a single argument that isn't a hash reference
+it throws an error.
+
+You can override this method in your class to handle other types of options
+passed to the constructor.
+
+This method should always return a hash reference of named options.
+
+=head2 BUILD
+
+Define a C<BUILD> method on your class and the constructor will automatically
+call the C<BUILD> method from parent down to child after the object has
+been instantiated. Typically this is used for object validation or possibly
+logging.
+
+=head2 DEMOLISH
+
+If you have a C<DEMOLISH> method anywhere in your inheritance hierarchy,
+a C<DESTROY> method is created on first object construction which will call
+C<< $instance->DEMOLISH($in_global_destruction) >> for each C<DEMOLISH>
+method from child upwards to parents.
+
+Note that the C<DESTROY> method is created on first construction of an object
+of your class in order to not add overhead to classes without C<DEMOLISH>
+methods; this may prove slightly surprising if you try and define your own.
=head2 does
=item * is
B<required>, must be C<ro> or C<rw>. Unsurprisingly, C<ro> generates an
-accessor that will not respond to arguments; to be clear: a setter only. C<rw>
+accessor that will not respond to arguments; to be clear: a getter only. C<rw>
will create a perlish getter/setter.
=item * isa
=item * coerce
-This Moose feature is not yet supported
-
-=begin hide
-
Takes a coderef which is meant to coerce the attribute. The basic idea is to
do something like the following:
$_[0] + 1 unless $_[0] % 2
},
+Coerce does not require C<isa> to be defined.
+
L<Sub::Quote aware|/SUB QUOTE AWARE>
-=end hide
+=item * handles
+
+Takes a string
+
+ handles => 'RobotRole'
+
+Where C<RobotRole> is a role (L<Moo::Role>) that defines an interface which
+becomes the list of methods to handle.
+
+Takes a list of methods
+
+ handles => [ qw( one two ) ]
+
+Takes a hashref
+
+ handles => {
+ un => 'one',
+ }
=item * trigger
B<Boolean>. Set this if the attribute must be passed on instantiation.
+=item * reader
+
+The value of this attribute will be the name of the method to get the value of
+the attribute. If you like Java style methods, you might set this to
+C<get_foo>
+
+=item * writer
+
+The value of this attribute will be the name of the method to set the value of
+the attribute. If you like Java style methods, you might set this to
+C<set_foo>
+
=item * weak_ref
B<Boolean>. Set this if you want the reference that the attribute contains to
C<auto_deref> is not supported since the author considers it a bad idea.
C<documentation> is not supported since it's a very poor replacement for POD.
+
+Handling of warnings: when you C<use Moo> we enable FATAL warnings. The nearest
+similar invocation for L<Moose> would be:
+
+ use Moose;
+ use warnings FATAL => "all";
+
+Additionally, L<Moo> supports a set of attribute option shortcuts intended to
+reduce common boilerplate. The set of shortcuts is the same as in the L<Moose>
+module L<MooseX::AttributeShortcuts>. So if you:
+
+ package MyClass;
+ use Moo;
+
+The nearest L<Moose> invocation would be:
+
+ package MyClass;
+
+ use Moose;
+ use warnings FATAL => "all";
+ use MooseX::AttributeShortcuts;
+
+=head1 AUTHOR
+
+mst - Matt S. Trout (cpan:MSTROUT) <mst@shadowcat.co.uk>
+
+=head1 CONTRIBUTORS
+
+dg - David Leadbeater (cpan:DGL) <dgl@dgl.cx>
+
+frew - Arthur Axel "fREW" Schmidt (cpan:FREW) <frioux@gmail.com>
+
+hobbs - Andrew Rodland (cpan:ARODLAND) <arodland@cpan.org>
+
+jnap - John Napiorkowski (cpan:JJNAPIORK) <jjn1056@yahoo.com>
+
+ribasushi - Peter Rabbitson (cpan:RIBASUSHI) <ribasushi@cpan.org>
+
+chip - Chip Salzenberg (cpan:CHIPS) <chip@pobox.com>
+
+ajgb - Alex J. G. BurzyĆski (cpan:AJGB) <ajgb@cpan.org>
+
+doy - Jesse Luehrs (cpan:DOY) <doy at tozt dot net>
+
+=head1 COPYRIGHT
+
+Copyright (c) 2010-2011 the Moo L</AUTHOR> and L</CONTRIBUTORS>
+as listed above.
+
+=head1 LICENSE
+
+This library is free software and may be distributed under the same terms
+as perl itself.
+
+=cut