use strictures 1;
use Moo::_Utils;
-our $VERSION = '0.009001'; # 0.9.1
+our $VERSION = '0.009005'; # 0.9.5
$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(@_)')
+ )
)
->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
+=head1 NAME
+
+Moo - Minimalist Object Orientation (with Moose compatiblity)
+
+=head1 WARNING WARNING WARNING
+
+This is a 0.9 release because we're fairly sure it works. For us. Until it's
+tested in the wild, we make no guarantees it also works for you.
+
+If this module does something unexpected, please submit a failing test.
+
+But if it eats your cat, sleeps with your boyfriend, or pushes grandma down
+the stairs to save her from the terrible secret of space, it's not our fault.
=head1 SYNOPSIS
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
Foo::Bar->new({ attr1 => 3 });
+=head2 BUILDARGS
+
+This feature from Moose is not yet supported.
+
=head2 BUILDALL
Don't override (or probably even call) this method. Instead, you can define
extends 'Parent::Class';
-Declares base class
+Declares base class. Multiple superclasses can be passed for multiple
+inheritance (but please use roles instead).
+
+Calling extends more than once will REPLACE your superclasses, not add to
+them like 'use base' would.
=head2 with
=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:
L<Sub::Quote aware|/SUB QUOTE AWARE>
+=end hide
+
=item * trigger
Takes a coderef which will get called any time the attribute is set. Coderef
will be invoked against the object with the new value as an argument.
+Note that Moose also passes the old value, if any; this feature is not yet
+supported.
+
L<Sub::Quote aware|/SUB QUOTE AWARE>
=item * default
-Takes a coderef which will get called to populate an attribute.
+Takes a coderef which will get called with $self as its only argument
+to populate an attribute if no value is supplied to the constructor - or
+if the attribute is lazy, when the attribute is first retrieved if no
+value has yet been provided.
+
+Note that if your default is fired during new() there is no guarantee that
+other attributes have been populated yet so you should not rely on their
+existence.
L<Sub::Quote aware|/SUB QUOTE AWARE>
=item * predicate
-Takes a method name which will return true if an attribute has been set.
+Takes a method name which will return true if an attribute has a value.
A common example of this would be to call it C<has_$foo>, implying that the
object has a C<$foo> set.
=item * builder
-Takes a method name which will be called to create the attribute.
+Takes a method name which will be called to create the attribute - functions
+exactly like default except that instead of calling
+
+ $default->($self);
+
+Moo will call
+
+ $self->$builder;
=item * clearer
See L<< Class::Method::Modifiers/after method(s) => sub { ... } >> for full
documentation.
-
=head1 SUB QUOTE AWARE
L<Sub::Quote/quote_sub> allows us to create coderefs that are "inlineable,"
giving us a handy, XS-free speed boost. Any option that is L<Sub::Quote>
aware can take advantage of this.
-=head1 INCOMPATIBILITIES
+=head1 INCOMPATIBILITIES WITH MOOSE
You can only compose one role at a time. If your application is large or
complex enough to warrant complex composition, you wanted L<Moose>.
need complex types, just make a library of coderefs, or better yet, functions
that return quoted subs.
-C<initializer> is not supported in core, but with an extension it is supported.
+C<initializer> is not supported in core since the author considers it to be a
+bad idea but may be supported by an extension in future.
There is no meta object. If you need this level of complexity you wanted
-L<Moose>.
+L<Moose> - Moo succeeds at being small because it explicitly does not
+provide a metaprotocol.
-No support for C<super>, C<override>, C<inner>, or C<augment>.
+No support for C<super>, C<override>, C<inner>, or C<augment> - override can
+be handled by around albeit with a little more typing, and the author considers
+augment to be a bad idea.
L</default> only supports coderefs, because doing otherwise is usually a
mistake anyway.
C<lazy_build> is not supported per se, but of course it will work if you
manually set all the options it implies.
-C<auto_deref> is not supported.
+C<auto_deref> is not supported since the author considers it a bad idea.
-C<documentation> is not supported.
+C<documentation> is not supported since it's a very poor replacement for POD.