X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse.pm;h=7cdd2438554c0376cc29eb93cda092fea84e3e6f;hp=0d5e4432de94a88e39f3f6122c540f7c6b0ec722;hb=448fbe3285470e2885ab4e105044fa84bdc9e078;hpb=9090e5fe93ed204d746dfea6d09925ec54b194c4 diff --git a/lib/Mouse.pm b/lib/Mouse.pm index 0d5e443..7cdd243 100644 --- a/lib/Mouse.pm +++ b/lib/Mouse.pm @@ -4,15 +4,7 @@ use warnings; use 5.006; use base 'Exporter'; -our $VERSION = '0.15'; - -BEGIN { - if ($ENV{MOUSE_DEBUG}) { - *DEBUG = sub (){ 1 }; - } else { - *DEBUG = sub (){ 0 }; - } -} +our $VERSION = '0.24'; use Carp 'confess'; use Scalar::Util 'blessed'; @@ -23,24 +15,13 @@ use Mouse::Meta::Class; use Mouse::Object; use Mouse::Util::TypeConstraints; -our @EXPORT = qw(extends has before after around blessed confess with); +our @EXPORT = qw(extends has before after around override super blessed confess with); sub extends { Mouse::Meta::Class->initialize(caller)->superclasses(@_) } sub has { my $meta = Mouse::Meta::Class->initialize(caller); - - my $names = shift; - $names = [$names] if !ref($names); - - for my $name (@$names) { - if ($name =~ s/^\+//) { - Mouse::Meta::Attribute->clone_parent($meta, $name, @_); - } - else { - Mouse::Meta::Attribute->create($meta, $name, @_); - } - } + $meta->add_attribute(@_); } sub before { @@ -77,13 +58,52 @@ sub with { Mouse::Util::apply_all_roles((caller)[0], @_); } +our $SUPER_PACKAGE; +our $SUPER_BODY; +our @SUPER_ARGS; + +sub super { + # This check avoids a recursion loop - see + # t/100_bugs/020_super_recursion.t + return if defined $SUPER_PACKAGE && $SUPER_PACKAGE ne caller(); + return unless $SUPER_BODY; $SUPER_BODY->(@SUPER_ARGS); +} + +sub override { + my $meta = Mouse::Meta::Class->initialize(caller); + my $pkg = $meta->name; + + my $name = shift; + my $code = shift; + + my $body = $pkg->can($name) + or confess "You cannot override '$name' because it has no super method"; + + $meta->add_method($name => sub { + local $SUPER_PACKAGE = $pkg; + local @SUPER_ARGS = @_; + local $SUPER_BODY = $body; + + $code->(@_); + }); +} + sub import { my $class = shift; strict->import; warnings->import; - my $caller = caller; + my $opts = do { + if (ref($_[0]) && ref($_[0]) eq 'HASH') { + shift @_; + } else { + +{ }; + } + }; + my $level = delete $opts->{into_level}; + $level = 0 unless defined $level; + my $caller = caller($level); # we should never export to main if ($caller eq 'main') { @@ -95,12 +115,15 @@ sub import { $meta->superclasses('Mouse::Object') unless $meta->superclasses; + # make a subtype for each Mouse class + class_type($caller) unless find_type_constraint($caller); + no strict 'refs'; no warnings 'redefine'; *{$caller.'::meta'} = sub { $meta }; if (@_) { - __PACKAGE__->export_to_level( 1, $class, @_); + __PACKAGE__->export_to_level( $level+1, $class, @_); } else { # shortcut for the common case of no type character no strict 'refs'; @@ -168,6 +191,12 @@ sub is_class_loaded { return 0; } +sub class_of { + return unless defined $_[0]; + my $class = blessed($_[0]) || $_[0]; + return Mouse::Meta::Class::get_metaclass_by_name($class); +} + 1; __END__ @@ -204,21 +233,18 @@ Mouse - Moose minus the antlers =head1 DESCRIPTION -L is wonderful. +L is wonderful. B -Unfortunately, it's a little slow. Though significant progress has been made -over the years, the compile time penalty is a non-starter for some +Unfortunately, Moose has a compile-time penalty. Though significant progress has +been made over the years, the compile time penalty is a non-starter for some applications. -Mouse aims to alleviate this by providing a subset of Moose's -functionality, faster. In particular, L is missing only a few -expert-level features. +Mouse aims to alleviate this by providing a subset of Moose's functionality, +faster. -We're also going as light on dependencies as possible. Most functions we use -from L are copied into this dist. L is required if -you'd like weak references; there's simply no way to do it from pure Perl. -L is required if you want support for L, -L, and L. +We're also going as light on dependencies as possible. +L or L is required if you want support +for L, L, and L. =head2 MOOSE COMPAT @@ -229,10 +255,8 @@ runs the test suite 4x faster. The idea is that, if you need the extra power, you should be able to run C on your codebase and have nothing break. To that end, -nothingmuch has written L (part of this distribution) which will act -as Mouse unless Moose is loaded, in which case it will act as Moose. - -Mouse also has the blessings of Moose's author, stevan. +we have written L which will act as Mouse unless Moose is loaded, +in which case it will act as Moose. =head2 MouseX @@ -287,10 +311,16 @@ the attribute. =item isa => TypeConstraint -Provides basic type checking in the constructor and accessor. Basic types such -as C, C, C are supported. Any unknown type is taken to -be a class check (e.g. isa => 'DateTime' would accept only L -objects). +Provides type checking in the constructor and accessor. The following types are +supported. Any unknown type is taken to be a class check (e.g. isa => +'DateTime' would accept only L objects). + + Any Item Bool Undef Defined Value Num Int Str ClassName + Ref ScalarRef ArrayRef HashRef CodeRef RegexpRef GlobRef + FileHandle Object + +For more documentation on type constraints, see L. + =item required => 0|1 @@ -400,6 +430,12 @@ Returns whether this class is actually loaded or not. It uses a heuristic which involves checking for the existence of C<$VERSION>, C<@ISA>, and any locally-defined method. +=head1 SOURCE CODE ACCESS + +We have a public git repo: + + git clone git://jules.scsys.co.uk/gitmo/Mouse.git + =head1 AUTHORS Shawn M Moore, C<< >> @@ -410,11 +446,15 @@ tokuhirom Yappo +wu-lee + with plenty of code borrowed from L and L =head1 BUGS -No known bugs. +There is a known issue with Mouse on 5.6.2 regarding the @ISA tests. Until +this is resolve the minimum version of Perl for Mouse is set to 5.8.0. Patches +to resolve these tests are more than welcome. Please report any bugs through RT: email C, or browse