X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMouse%2FMeta%2FAttribute.pm;h=d9a44dbf2c1ae8e5f2b6c7b325418fd80a109f6b;hb=d58887328353bfd216406ff7d686b5a4877d1731;hp=0624a574dd71a44c7f48476ff3d8bbe78247e30b;hpb=e9148d131f7c3d6a1e3fc9e7c491f80fb5dde90b;p=gitmo%2FMouse.git diff --git a/lib/Mouse/Meta/Attribute.pm b/lib/Mouse/Meta/Attribute.pm index 0624a57..d9a44db 100644 --- a/lib/Mouse/Meta/Attribute.pm +++ b/lib/Mouse/Meta/Attribute.pm @@ -5,6 +5,46 @@ use Carp (); use Mouse::Meta::TypeConstraint; +my %valid_options = map { $_ => undef } ( + 'accessor', + 'auto_deref', + 'builder', + 'clearer', + 'coerce', + 'default', + 'documentation', + 'does', + 'handles', + 'init_arg', + 'insertion_order', + 'is', + 'isa', + 'lazy', + 'lazy_build', + 'name', + 'predicate', + 'reader', + 'required', + 'traits', + 'trigger', + 'type_constraint', + 'weak_ref', + 'writer', + + # internally used + 'associated_class', + 'associated_methods', + + # Moose defines, but Mouse doesn't + #'definition_context', + #'initializer', + + # special case for AttributeHelpers + 'provides', + 'curries', +); + +our @CARP_NOT = qw(Mouse::Meta::Class); sub new { my $class = shift; @@ -12,15 +52,32 @@ sub new { my $args = $class->Mouse::Object::BUILDARGS(@_); - # XXX: for backward compatibility (with method modifiers) - if($class->can('canonicalize_args') != \&canonicalize_args){ - %{$args} = $class->canonicalize_args($name, %{$args}); - } - $class->_process_options($name, $args); $args->{name} = $name; + # check options + # (1) known by core + my @bad = grep{ !exists $valid_options{$_} } keys %{$args}; + + # (2) known by subclasses + if(@bad && $class ne __PACKAGE__){ + my %valid_attrs = ( + map { $_ => undef } + grep { defined } + map { $_->init_arg() } + $class->meta->get_all_attributes() + ); + @bad = grep{ !exists $valid_attrs{$_} } @bad; + } + + # (3) bad options found + if(@bad){ + Carp::carp( + "Found unknown argument(s) passed to '$name' attribute constructor in '$class': " + . Mouse::Util::english_list(@bad)); + } + my $self = bless $args, $class; # extra attributes @@ -28,24 +85,12 @@ sub new { $class->meta->_initialize_object($self, $args); } -# XXX: there is no fast way to check attribute validity -# my @bad = ...; -# if(@bad){ -# @bad = sort @bad; -# Carp::cluck("Found unknown argument(s) passed to '$name' attribute constructor in '$class': @bad"); -# } - return $self; } sub has_read_method { $_[0]->has_reader || $_[0]->has_accessor } sub has_write_method { $_[0]->has_writer || $_[0]->has_accessor } -sub _create_args { # DEPRECATED - $_[0]->{_create_args} = $_[1] if @_ > 1; - $_[0]->{_create_args} -} - sub interpolate_class{ my($class, $args) = @_; @@ -80,27 +125,9 @@ sub interpolate_class{ return( $class, @traits ); } -sub canonicalize_args{ # DEPRECATED - my ($self, $name, %args) = @_; - - Carp::cluck("$self->canonicalize_args has been deprecated." - . "Use \$self->_process_options instead."); - - return %args; -} - -sub create { # DEPRECATED - my ($self, $class, $name, %args) = @_; - - Carp::cluck("$self->create has been deprecated." - . "Use \$meta->add_attribute and \$attr->install_accessors instead."); - - # noop - return $self; -} - sub _coerce_and_verify { - my($self, $value, $instance) = @_; + #my($self, $value, $instance) = @_; + my($self, $value) = @_; my $type_constraint = $self->{type_constraint}; return $value if !defined $type_constraint; @@ -134,49 +161,44 @@ sub _throw_type_constraint_error { ); } +sub illegal_options_for_inheritance { + return qw(reader writer accessor clearer predicate); +} + sub clone_and_inherit_options{ my $self = shift; my $args = $self->Mouse::Object::BUILDARGS(@_); - my($attribute_class, @traits) = ref($self)->interpolate_class($args); + foreach my $illegal($self->illegal_options_for_inheritance) { + if(exists $args->{$illegal} and exists $self->{$illegal}) { + $self->throw_error("Illegal inherited option: $illegal"); + } + } - $args->{traits} = \@traits if @traits; - # do not inherit the 'handles' attribute foreach my $name(keys %{$self}){ - if(!exists $args->{$name} && $name ne 'handles'){ - $args->{$name} = $self->{$name}; + if(!exists $args->{$name}){ + $args->{$name} = $self->{$name}; # inherit from self } } - return $attribute_class->new($self->name, $args); -} - -sub clone_parent { # DEPRECATED - my $self = shift; - my $class = shift; - my $name = shift; - my %args = ($self->get_parent_args($class, $name), @_); - - Carp::cluck("$self->clone_parent has been deprecated." - . "Use \$meta->add_attribute and \$attr->install_accessors instead."); - $self->clone_and_inherited_args($class, $name, %args); -} + my($attribute_class, @traits) = ref($self)->interpolate_class($args); + $args->{traits} = \@traits if @traits; -sub get_parent_args { # DEPRECATED - my $self = shift; - my $class = shift; - my $name = shift; + # remove temporary caches + foreach my $attr(keys %{$args}){ + if($attr =~ /\A _/xms){ + delete $args->{$attr}; + } + } - for my $super ($class->linearized_isa) { - my $super_attr = $super->can("meta") && $super->meta->get_attribute($name) - or next; - return %{ $super_attr->_create_args }; + # remove default if lazy_build => 1 + if($args->{lazy_build}) { + delete $args->{default}; } - $self->throw_error("Could not find an attribute by the name of '$name' to inherit from"); + return $attribute_class->new($self->name, $args); } - sub get_read_method { return $_[0]->reader || $_[0]->accessor } @@ -237,7 +259,8 @@ sub clear_value { sub associate_method{ - my ($attribute, $method_name) = @_; + #my($attribute, $method_name) = @_; + my($attribute) = @_; $attribute->{associated_methods}++; return; } @@ -262,6 +285,10 @@ sub install_accessors{ my %handles = $attribute->_canonicalize_handles($attribute->{handles}); while(my($handle, $method_to_call) = each %handles){ + if($metaclass->has_method($handle)) { + $attribute->throw_error("You cannot overwrite a locally defined method ($handle) with a delegation"); + } + $metaclass->add_method($handle => $attribute->_make_delegation_method( $handle, $method_to_call)); @@ -270,15 +297,12 @@ sub install_accessors{ } } - if($attribute->can('create') != \&create){ - # backword compatibility - $attribute->create($metaclass, $attribute->name, %{$attribute}); - } - return; } -sub delegation_metaclass() { 'Mouse::Meta::Method::Delegation' } +sub delegation_metaclass() { ## no critic + 'Mouse::Meta::Method::Delegation' +} sub _canonicalize_handles { my($self, $handles) = @_; @@ -312,10 +336,8 @@ sub _canonicalize_handles { sub _make_delegation_method { my($self, $handle, $method_to_call) = @_; - my $delegator = $self->delegation_metaclass; - Mouse::Util::load_class($delegator); - - return $delegator->_generate_delegation($self, $handle, $method_to_call); + return Mouse::Util::load_class($self->delegation_metaclass) + ->_generate_delegation($self, $handle, $method_to_call); } sub throw_error{ @@ -334,7 +356,12 @@ Mouse::Meta::Attribute - The Mouse attribute metaclass =head1 VERSION -This document describes Mouse version 0.50 +This document describes Mouse version 0.68 + +=head1 DESCRIPTION + +This is a meta object protocol for Mouse attributes, +which is a subset of Moose::Meta::Attribute. =head1 METHODS