X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse%2FMeta%2FModule.pm;h=dd463138834023c4d51677d8b6e3a313d8e2c6ab;hp=25e6cb38d1e76c410ff4daaaa31adb9546315328;hb=HEAD;hpb=01e830f796a9ecdec0d977f2b88110363ebf013f diff --git a/lib/Mouse/Meta/Module.pm b/lib/Mouse/Meta/Module.pm old mode 100755 new mode 100644 index 25e6cb3..dd46313 --- a/lib/Mouse/Meta/Module.pm +++ b/lib/Mouse/Meta/Module.pm @@ -1,5 +1,5 @@ package Mouse::Meta::Module; -use Mouse::Util qw/:meta get_code_package get_code_ref load_class not_supported/; # enables strict and warnings +use Mouse::Util qw/:meta/; # enables strict and warnings use Carp (); use Scalar::Util (); @@ -14,12 +14,6 @@ if(Mouse::Util::MOUSE_XS){ *CLONE = sub { Mouse::Util::__register_metaclass_storage(\%METAS, 1) }; } -sub _metaclass_cache { # DEPRECATED - my($class, $name) = @_; - Carp::cluck('_metaclass_cache() has been deprecated. Use Mouse::Util::get_metaclass_by_name() instead'); - return $METAS{$name}; -} - sub initialize { my($class, $package_name, @args) = @_; @@ -38,6 +32,9 @@ sub reinitialize { ($package_name && !ref($package_name)) || $class->throw_error("You must pass a package name and it cannot be blessed"); + if(exists $METAS{$package_name}) { + unshift @args, %{ $METAS{$package_name} }; + } delete $METAS{$package_name}; return $class->initialize($package_name, @args); } @@ -49,7 +46,8 @@ sub _class_of{ } # Means of accessing all the metaclasses that have -# been initialized thus far +# been initialized thus far. +# The public versions are aliased into Mouse::Util::*. #sub _get_all_metaclasses { %METAS } sub _get_all_metaclass_instances { values %METAS } sub _get_all_metaclass_names { keys %METAS } @@ -63,19 +61,6 @@ sub name; sub namespace; -# The followings are Class::MOP specific methods - -#sub version { no strict 'refs'; ${shift->name.'::VERSION'} } -#sub authority { no strict 'refs'; ${shift->name.'::AUTHORITY'} } -#sub identifier { -# my $self = shift; -# return join '-' => ( -# $self->name, -# ($self->version || ()), -# ($self->authority || ()), -# ); -#} - # add_attribute is an abstract method sub get_attribute_map { # DEPRECATED @@ -89,51 +74,44 @@ sub remove_attribute { delete $_[0]->{attributes}->{$_[1]} } sub get_attribute_list{ keys %{$_[0]->{attributes}} } -# XXX: for backward compatibility +# XXX: not completely compatible with Moose my %foreign = map{ $_ => undef } qw( Mouse Mouse::Role Mouse::Util Mouse::Util::TypeConstraints Carp Scalar::Util List::Util ); -sub _code_is_mine{ -# my($self, $code) = @_; - - return !exists $foreign{ get_code_package($_[1]) }; +sub _get_method_body { + my($self, $method_name) = @_; + my $code = Mouse::Util::get_code_ref($self->{package}, $method_name); + return $code && !exists $foreign{ Mouse::Util::get_code_package($code) } + ? $code + : undef; } sub add_method; sub has_method { my($self, $method_name) = @_; - defined($method_name) or $self->throw_error('You must define a method name'); - return defined($self->{methods}{$method_name}) || do{ - my $code = get_code_ref($self->{package}, $method_name); - $code && $self->_code_is_mine($code); - }; + return defined( $self->{methods}{$method_name} ) + || defined( $self->_get_method_body($method_name) ); } sub get_method_body { my($self, $method_name) = @_; - defined($method_name) or $self->throw_error('You must define a method name'); - return $self->{methods}{$method_name} ||= do{ - my $code = get_code_ref($self->{package}, $method_name); - $code && $self->_code_is_mine($code) ? $code : undef; - }; + return $self->{methods}{$method_name} + ||= $self->_get_method_body($method_name); } -sub get_method{ +sub get_method { my($self, $method_name) = @_; if(my $code = $self->get_method_body($method_name)){ - my $method_metaclass = $self->method_metaclass; - load_class($method_metaclass); - - return $method_metaclass->wrap( + return Mouse::Util::load_class($self->method_metaclass)->wrap( body => $code, name => $method_name, package => $self->name, @@ -150,168 +128,194 @@ sub get_method_list { return grep { $self->has_method($_) } keys %{ $self->namespace }; } -{ - my $ANON_SERIAL = 0; - - my %IMMORTALS; +sub _collect_methods { # Mouse specific, used for method modifiers + my($meta, @args) = @_; - sub create { - my($self, $package_name, %options) = @_; - - my $class = ref($self) || $self; - $self->throw_error('You must pass a package name') if @_ < 2; - - my $superclasses; - if(exists $options{superclasses}){ - if(Mouse::Util::is_a_metarole($self)){ - delete $options{superclasses}; + my @methods; + foreach my $arg(@args){ + if(my $type = ref $arg){ + if($type eq 'Regexp'){ + push @methods, grep { $_ =~ $arg } $meta->get_all_method_names; + } + elsif($type eq 'ARRAY'){ + push @methods, @{$arg}; } else{ - $superclasses = delete $options{superclasses}; - (ref $superclasses eq 'ARRAY') - || $self->throw_error("You must pass an ARRAY ref of superclasses"); + my $subname = ( caller(1) )[3]; + $meta->throw_error( + sprintf( + 'Methods passed to %s must be provided as a list,' + . ' ArrayRef or regular expression, not %s', + $subname, + $type, + ) + ); } - } + } + else{ + push @methods, $arg; + } + } + return @methods; +} - my $attributes = delete $options{attributes}; - if(defined $attributes){ - (ref $attributes eq 'ARRAY' || ref $attributes eq 'HASH') - || $self->throw_error("You must pass an ARRAY ref of attributes"); - } - my $methods = delete $options{methods}; - if(defined $methods){ - (ref $methods eq 'HASH') - || $self->throw_error("You must pass a HASH ref of methods"); +my $ANON_SERIAL = 0; # anonymous class/role id +my %IMMORTALS; # immortal anonymous classes + +sub create { + my($self, $package_name, %options) = @_; + + my $class = ref($self) || $self; + $self->throw_error('You must pass a package name') if @_ < 2; + + my $superclasses; + if(exists $options{superclasses}){ + if(Mouse::Util::is_a_metarole($self)){ + delete $options{superclasses}; } - my $roles = delete $options{roles}; - if(defined $roles){ - (ref $roles eq 'ARRAY') - || $self->throw_error("You must pass an ARRAY ref of roles"); - } - my $mortal; - my $cache_key; - - if(!defined $package_name){ # anonymous - $mortal = !$options{cache}; - - # anonymous but immortal - if(!$mortal){ - # something like Super::Class|Super::Class::2=Role|Role::1 - $cache_key = join '=' => ( - join('|', @{$superclasses || []}), - join('|', sort @{$roles || []}), - ); - return $IMMORTALS{$cache_key} if exists $IMMORTALS{$cache_key}; - } - $options{anon_serial_id} = ++$ANON_SERIAL; - $package_name = $class . '::__ANON__::' . $ANON_SERIAL; + else{ + $superclasses = delete $options{superclasses}; + (ref $superclasses eq 'ARRAY') + || $self->throw_error("You must pass an ARRAY ref of superclasses"); } + } - # instantiate a module - { - no strict 'refs'; - ${ $package_name . '::VERSION' } = delete $options{version} if exists $options{version}; - ${ $package_name . '::AUTHORITY' } = delete $options{authority} if exists $options{authority}; + my $attributes = delete $options{attributes}; + if(defined $attributes){ + (ref $attributes eq 'ARRAY' || ref $attributes eq 'HASH') + || $self->throw_error("You must pass an ARRAY ref of attributes"); + } + my $methods = delete $options{methods}; + if(defined $methods){ + (ref $methods eq 'HASH') + || $self->throw_error("You must pass a HASH ref of methods"); + } + my $roles = delete $options{roles}; + if(defined $roles){ + (ref $roles eq 'ARRAY') + || $self->throw_error("You must pass an ARRAY ref of roles"); + } + my $mortal; + my $cache_key; + + if(!defined $package_name){ # anonymous + $mortal = !$options{cache}; + + # anonymous but immortal + if(!$mortal){ + # something like Super::Class|Super::Class::2=Role|Role::1 + $cache_key = join '=' => ( + join('|', @{$superclasses || []}), + join('|', sort @{$roles || []}), + ); + return $IMMORTALS{$cache_key} if exists $IMMORTALS{$cache_key}; } + $options{anon_serial_id} = ++$ANON_SERIAL; + $package_name = $class . '::__ANON__::' . $ANON_SERIAL; + } - my $meta = $self->initialize( $package_name, %options); - - Scalar::Util::weaken $METAS{$package_name} - if $mortal; - - $meta->add_method(meta => sub{ - $self->initialize(ref($_[0]) || $_[0]); - }); - - $meta->superclasses(@{$superclasses}) - if defined $superclasses; - - # NOTE: - # process attributes first, so that they can - # install accessors, but locally defined methods - # can then overwrite them. It is maybe a little odd, but - # I think this should be the order of things. - if (defined $attributes) { - if(ref($attributes) eq 'ARRAY'){ - # array of Mouse::Meta::Attribute - foreach my $attr (@{$attributes}) { - $meta->add_attribute($attr); - } - } - else{ - # hash map of name and attribute spec pairs - while(my($name, $attr) = each %{$attributes}){ - $meta->add_attribute($name => $attr); - } + + # instantiate a module + { + no strict 'refs'; + ${ $package_name . '::VERSION' } = delete $options{version} if exists $options{version}; + ${ $package_name . '::AUTHORITY' } = delete $options{authority} if exists $options{authority}; + } + + my $meta = $self->initialize( $package_name, %options); + + Scalar::Util::weaken($METAS{$package_name}) + if $mortal; + + $meta->add_method(meta => sub { + $self->initialize(ref($_[0]) || $_[0]); + }); + + $meta->superclasses(@{$superclasses}) + if defined $superclasses; + + # NOTE: + # process attributes first, so that they can + # install accessors, but locally defined methods + # can then overwrite them. It is maybe a little odd, but + # I think this should be the order of things. + if (defined $attributes) { + if(ref($attributes) eq 'ARRAY'){ + # array of Mouse::Meta::Attribute + foreach my $attr (@{$attributes}) { + $meta->add_attribute($attr); } } - if (defined $methods) { - while(my($method_name, $method_body) = each %{$methods}){ - $meta->add_method($method_name, $method_body); + else{ + # hash map of name and attribute spec pairs + while(my($name, $attr) = each %{$attributes}){ + $meta->add_attribute($name => $attr); } } - if (defined $roles){ - Mouse::Util::apply_all_roles($package_name, @{$roles}); - } - - if($cache_key){ - $IMMORTALS{$cache_key} = $meta; + } + if (defined $methods) { + while(my($method_name, $method_body) = each %{$methods}){ + $meta->add_method($method_name, $method_body); } + } + if (defined $roles and !$options{in_application_to_instance}){ + Mouse::Util::apply_all_roles($package_name, @{$roles}); + } - return $meta; + if($cache_key){ + $IMMORTALS{$cache_key} = $meta; } - sub DESTROY{ - my($self) = @_; + return $meta; +} - return if $Mouse::Util::in_global_destruction; +sub DESTROY{ + my($self) = @_; - my $serial_id = $self->{anon_serial_id}; + return if $Mouse::Util::in_global_destruction; - return if !$serial_id; + my $serial_id = $self->{anon_serial_id}; + return if !$serial_id; - # @ISA is a magical variable, so we clear it manually. - @{$self->{superclasses}} = () if exists $self->{superclasses}; + # XXX: cleaning stash with threads causes panic/SEGV on legacy perls. + if(exists $INC{'threads.pm'}) { + # (caller)[2] indicates the caller's line number, + # which is zero when the current thread is joining (destroying). + return if( (caller)[2] == 0); + } - # Then, clear the symbol table hash - %{$self->namespace} = (); + # clean up mortal anonymous class stuff - my $name = $self->name; - delete $METAS{$name}; + # @ISA is a magical variable, so we must clear it manually. + @{$self->{superclasses}} = () if exists $self->{superclasses}; - $name =~ s/ $serial_id \z//xms; + # Then, clear the symbol table hash + %{$self->namespace} = (); - no strict 'refs'; - delete ${$name}{ $serial_id . '::' }; + my $name = $self->name; + delete $METAS{$name}; - return; - } + $name =~ s/ $serial_id \z//xms; + no strict 'refs'; + delete ${$name}{ $serial_id . '::' }; + return; } -sub throw_error{ - my($class, $message, %args) = @_; - - local $Carp::CarpLevel = $Carp::CarpLevel + 1 + ($args{depth} || 0); - local $Carp::MaxArgNums = 20; # default is 8, usually we use named args which gets messier though - - if(exists $args{longmess} && !$args{longmess}){ # intentionaly longmess => 0 - Carp::croak($message); - } - else{ - Carp::confess($message); - } -} 1; __END__ =head1 NAME -Mouse::Meta::Module - The base class for Mouse::Meta::Class and Mouse::Meta::Role +Mouse::Meta::Module - The common base class of Mouse::Meta::Class and Mouse::Meta::Role =head1 VERSION -This document describes Mouse version 0.49 +This document describes Mouse version 0.95 + +=head1 DESCRIPTION + +This class is an abstract base class of meta classes and meta roles. =head1 SEE ALSO