X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse.pm;h=18c60d1688e30390e9467fa66ba5fc6392dee08f;hb=3b46bd4991dea7ead4e7f52a089222d24554e2bd;hp=c529135f91715e4846dd42383f9e84d66eaf921d;hpb=7a024324a4bc51897bafff2b9cf86998ae7cbe98;p=gitmo%2FMouse.git diff --git a/lib/Mouse.pm b/lib/Mouse.pm index c529135..18c60d1 100644 --- a/lib/Mouse.pm +++ b/lib/Mouse.pm @@ -1,19 +1,27 @@ -#!/usr/bin/env perl package Mouse; use strict; use warnings; +use 5.006; use base 'Exporter'; -our $VERSION = '0.10'; -use 5.006; +our $VERSION = '0.15'; + +BEGIN { + if ($ENV{MOUSE_DEBUG}) { + *DEBUG = sub (){ 1 }; + } else { + *DEBUG = sub (){ 0 }; + } +} use Carp 'confess'; -use Mouse::Util 'blessed'; +use Scalar::Util 'blessed'; +use Mouse::Util; use Mouse::Meta::Attribute; use Mouse::Meta::Class; use Mouse::Object; -use Mouse::TypeRegistry; +use Mouse::Util::TypeConstraints; our @EXPORT = qw(extends has before after around blessed confess with); @@ -66,22 +74,23 @@ sub around { } sub with { - my $meta = Mouse::Meta::Class->initialize(caller); - - my $role = shift; - - confess "Mouse::Role only supports 'with' on individual roles at a time" if @_; - - Mouse::load_class($role); - $role->meta->apply($meta); + Mouse::Util::apply_all_roles((caller)[0], @_); } sub import { + my $class = shift; + strict->import; warnings->import; my $caller = caller; + # we should never export to main + if ($caller eq 'main') { + warn qq{$class does not export its sugar to the 'main' package.\n}; + return; + } + my $meta = Mouse::Meta::Class->initialize($caller); $meta->superclasses('Mouse::Object') unless $meta->superclasses; @@ -90,7 +99,15 @@ sub import { no warnings 'redefine'; *{$caller.'::meta'} = sub { $meta }; - Mouse->export_to_level(1, @_); + if (@_) { + __PACKAGE__->export_to_level( 1, $class, @_); + } else { + # shortcut for the common case of no type character + no strict 'refs'; + for my $keyword (@EXPORT) { + *{ $caller . '::' . $keyword } = *{__PACKAGE__ . '::' . $keyword}; + } + } } sub unimport { @@ -110,6 +127,7 @@ sub load_class { confess "Invalid class name ($display)"; } + return 1 if $class eq 'Mouse::Object'; return 1 if is_class_loaded($class); (my $file = "$class.pm") =~ s{::}{/}g; @@ -216,33 +234,6 @@ as Mouse unless Moose is loaded, in which case it will act as Moose. Mouse also has the blessings of Moose's author, stevan. -=head2 MISSING FEATURES - -=head3 Roles - -We're working on fixing this one! stevan has suggested an implementation -strategy. Mouse currently ignores methods, so that needs to be fixed next. -Roles that consist entirely of attributes may be usable in this very version. - -=head3 Complex types - -User-defined type constraints and parameterized types may be implemented. Type -coercions probably not (patches welcome). - -=head3 Bootstrapped meta world - -Very handy for extensions to the MOP. Not pressing, but would be nice to have. - -=head3 Modification of attribute metaclass - -When you declare an attribute with L, you get the inlined accessors -installed immediately. Modifying the attribute metaclass, even if possible, -does nothing. - -=head3 Lots more.. - -MouseX? - =head1 KEYWORDS =head2 meta -> Mouse::Meta::Class @@ -299,9 +290,10 @@ Whether this attribute is required to have a value. If the attribute is lazy or has a builder, then providing a value for the attribute in the constructor is optional. -=item init_arg => Str +=item init_arg => Str | Undef -Allows you to use a different key name in the constructor. +Allows you to use a different key name in the constructor. If undef, the +attribue can't be passed to the constructor. =item default => Value | CodeRef @@ -359,6 +351,11 @@ context. In scalar context, the reference is returned (NOT the list length or bucket status). You must specify an appropriate type constraint to use auto_deref. +=item lazy_build => 0|1 + +Automatically define lazy => 1 as well as builder => "_build_$attr", clearer => +"clear_$attr', predicate => 'has_$attr' unless they are already defined. + =back =head2 confess error -> BOOM @@ -395,12 +392,16 @@ 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 AUTHOR +=head1 AUTHORS Shawn M Moore, C<< >> Yuval Kogman, C<< >> +tokuhirom + +Yappo + with plenty of code borrowed from L and L =head1 BUGS