X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse.pm;h=fb72d26b41d5d147c77df0ed4d3b4040cfb450d6;hb=56be135d2a8975f724deddf9814446b385985d66;hp=5f6ea376450f40f135b2044f8c1ab824a7250fbf;hpb=c4ec764243251d46cffa30ae028beef530b0a432;p=gitmo%2FMouse.git diff --git a/lib/Mouse.pm b/lib/Mouse.pm index 5f6ea37..fb72d26 100644 --- a/lib/Mouse.pm +++ b/lib/Mouse.pm @@ -4,7 +4,7 @@ use warnings; use 5.006; use base 'Exporter'; -our $VERSION = '0.19'; +our $VERSION = '0.27'; use Carp 'confess'; use Scalar::Util 'blessed'; @@ -88,6 +88,46 @@ sub override { }); } +sub init_meta { + # This used to be called as a function. This hack preserves + # backwards compatibility. + if ( $_[0] ne __PACKAGE__ ) { + return __PACKAGE__->init_meta( + for_class => $_[0], + base_class => $_[1], + metaclass => $_[2], + ); + } + + shift; + my %args = @_; + + my $class = $args{for_class} + or Carp::croak( + "Cannot call init_meta without specifying a for_class"); + my $base_class = $args{base_class} || 'Mouse::Object'; + my $metaclass = $args{metaclass} || 'Mouse::Meta::Class'; + + Carp::croak("The Metaclass $metaclass must be a subclass of Mouse::Meta::Class.") + unless $metaclass->isa('Mouse::Meta::Class'); + + # make a subtype for each Mouse class + class_type($class) + unless find_type_constraint($class); + + my $meta = $metaclass->initialize($class); + $meta->superclasses($base_class) + unless $meta->superclasses; + + { + no strict 'refs'; + no warnings 'redefine'; + *{$class.'::meta'} = sub { $meta }; + } + + return $meta; +} + sub import { my $class = shift; @@ -111,13 +151,9 @@ sub import { return; } - my $meta = Mouse::Meta::Class->initialize($caller); - $meta->superclasses('Mouse::Object') - unless $meta->superclasses; - - no strict 'refs'; - no warnings 'redefine'; - *{$caller.'::meta'} = sub { $meta }; + Mouse->init_meta( + for_class => $caller, + ); if (@_) { __PACKAGE__->export_to_level( $level+1, $class, @_); @@ -188,6 +224,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__ @@ -224,19 +266,21 @@ 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 -applications. +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 very specific applications. If you are writing a command-line application +or CGI script where startup time is essential, you may not be able to use +Moose. We recommend that you instead use L and FastCGI for the +latter, if possible. -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. -L or L is required if you want support -for L, L, and L. +L or L is required +if you want support for L, L, and L. =head2 MOOSE COMPAT @@ -247,9 +291,14 @@ 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. -L is a more high-tech L. +we have written L which will act as Mouse unless Moose is loaded, +in which case it will act as Moose. Since Mouse is a little sloppier than +Moose, if you run into weird errors, it would be worth running: + + ANY_MOOSE=Moose perl your-script.pl + +to see if the bug is caused by Mouse. Moose's diagnostics and validation are +also much better. =head2 MouseX @@ -259,6 +308,12 @@ should upgrade to Moose. We don't need two parallel sets of extensions! If you really must write a Mouse extension, please contact the Moose mailing list or #moose on IRC beforehand. +=head2 Maintenance + +The original author of this module has mostly stepped down from maintaining +Mouse. See L. +If you would like to help maintain this module, please get in touch with us. + =head1 KEYWORDS =head2 meta -> Mouse::Meta::Class @@ -304,10 +359,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 @@ -417,6 +478,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<< >> @@ -427,11 +494,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