use Class::MOP;
use Carp 'confess';
-use Scalar::Util 'weaken', 'blessed';
+use Scalar::Util 'weaken', 'blessed', 'reftype';
-our $VERSION = '0.04';
+our $VERSION = '0.05';
use base 'Class::MOP::Class';
default => sub { [] }
));
+sub initialize {
+ my $class = shift;
+ my $pkg = shift;
+ $class->SUPER::initialize($pkg,
+ ':attribute_metaclass' => 'Moose::Meta::Attribute',
+ ':instance_metaclass' => 'Moose::Meta::Instance',
+ @_);
+}
+
sub add_role {
my ($self, $role) = @_;
(blessed($role) && $role->isa('Moose::Meta::Role'))
return 0;
}
+sub new_object {
+ my ($class, %params) = @_;
+ my $self = $class->SUPER::new_object(%params);
+ foreach my $attr ($class->compute_all_applicable_attributes()) {
+ next unless $params{$attr->init_arg} && $attr->can('has_trigger') && $attr->has_trigger;
+ $attr->trigger->($self, $params{$attr->init_arg}, $attr);
+ }
+ return $self;
+}
+
sub construct_instance {
my ($class, %params) = @_;
- my $instance = $params{'__INSTANCE__'} || {};
+ my $meta_instance = $class->get_meta_instance;
+ my $instance = $params{'__INSTANCE__'} || $meta_instance->create_instance();
foreach my $attr ($class->compute_all_applicable_attributes()) {
- my $init_arg = $attr->init_arg();
- # try to fetch the init arg from the %params ...
- my $val;
- if (exists $params{$init_arg}) {
- $val = $params{$init_arg};
- }
- else {
- # skip it if it's lazy
- next if $attr->is_lazy;
- # and die if it is required
- confess "Attribute (" . $attr->name . ") is required"
- if $attr->is_required
- }
- # if nothing was in the %params, we can use the
- # attribute's default value (if it has one)
- if (!defined $val && $attr->has_default) {
- $val = $attr->default($instance);
- }
- if (defined $val) {
- if ($attr->has_type_constraint) {
- if ($attr->should_coerce && $attr->type_constraint->has_coercion) {
- $val = $attr->type_constraint->coercion->coerce($val);
- }
- (defined($attr->type_constraint->check($val)))
- || confess "Attribute (" . $attr->name . ") does not pass the type contraint with '$val'";
- }
- }
- $instance->{$attr->name} = $val;
- if (defined $val && $attr->is_weak_ref) {
- weaken($instance->{$attr->name});
- }
+ $attr->initialize_instance_slot($meta_instance, $instance, \%params)
}
return $instance;
}
return $self->SUPER::has_method($method_name);
}
+sub add_attribute {
+ my ($self, $name, %params) = @_;
+
+ my @delegations;
+ if ( my $delegation = delete $params{handles} ) {
+ my @method_names_or_hashes = $self->compute_delegation( $name, $delegation, \%params );
+ @delegations = $self->get_delegatable_methods( @method_names_or_hashes );
+ }
+
+ my $ret = $self->SUPER::add_attribute( $name, %params );
+
+ if ( @delegations ) {
+ my $attr = $self->get_attribute( $name );
+ $self->generate_delgate_method( $attr, $_ ) for $self->filter_delegations( $attr, @delegations );
+ }
+
+ return $ret;
+}
+
+sub filter_delegations {
+ my ( $self, $attr, @delegations ) = @_;
+ grep {
+ my $new_name = $_->{new_name} || $_->{name};
+ no warnings "uninitialized";
+ !$self->name->can( $new_name ) and
+ $attr->accessor ne $new_name and
+ $attr->reader ne $new_name and
+ $attr->writer ne $new_name
+ } @delegations;
+}
+
+sub generate_delgate_method {
+ my ( $self, $attr, $method ) = @_;
+
+ # FIXME like generated accessors these methods must be regenerated
+ # FIXME the reader may not work for subclasses with weird instances
+
+ my $make = $method->{generator} || sub {
+ my ( $self, $attr, $method ) =@_;
+
+ my $method_name = $method->{name};
+ my $reader = $attr->generate_reader_method();
+
+ return sub {
+ if ( Scalar::Util::blessed( my $delegate = shift->$reader ) ) {
+ return $delegate->$method_name( @_ );
+ }
+ return;
+ };
+ };
+
+ my $new_name = $method->{new_name} || $method->{name};
+ $self->add_method( $new_name, $make->( $self, $attr, $method ) );
+}
+
+sub compute_delegation {
+ my ( $self, $attr_name, $delegation, $params ) = @_;
+
+
+ # either it's a concrete list of method names
+ return $delegation unless ref $delegation; # single method name
+ return @$delegation if reftype($delegation) eq "ARRAY";
+
+ # or it's a generative api
+ my $delegator_meta = $self->_guess_attr_class_or_role( $attr_name, $params );
+ $self->generate_delegation_list( $delegation, $delegator_meta );
+}
+
+sub get_delegatable_methods {
+ my ( $self, @names_or_hashes ) = @_;
+ map { ref($_) ? $_ : { name => $_ } } @names_or_hashes;
+}
+
+sub generate_delegation_list {
+ my ( $self, $delegation, $delegator_meta ) = @_;
+
+ if ( reftype($delegation) eq "CODE" ) {
+ return $delegation->( $self, $delegator_meta );
+ } elsif ( blessed($delegation) eq "Regexp" ) {
+ confess "For regular expression support the delegator class/role must use a Class::MOP::Class metaclass"
+ unless $delegator_meta->isa( "Class::MOP::Class" );
+ return grep { $_->{name} =~ /$delegation/ } $delegator_meta->compute_all_applicable_methods();
+ } else {
+ confess "The 'handles' specification '$delegation' is not supported";
+ }
+}
+
+sub _guess_attr_class_or_role {
+ my ( $self, $attr, $params ) = @_;
+
+ my ( $isa, $does ) = @{ $params }{qw/isa does/};
+
+ confess "Generative delegations must explicitly specify a class or a role for the attribute's type"
+ unless $isa || $does;
+
+ for (grep { blessed($_) } $isa, $does) {
+ confess "You must use classes/roles, not type constraints to use delegation ($_)"
+ unless $_->isa( "Moose::Meta::Class" );
+ }
+
+ confess "Cannot have an isa option and a does option if the isa does not do the does"
+ if $isa and $does and $isa->can("does") and !$isa->does( $does );
+
+ # if it's a class/role name make it into a meta object
+ for ($isa, $does) {
+ $_ = $_->meta if defined and !ref and $_->can("meta");
+ }
+
+ $isa = Class::MOP::Class->initialize($isa) if $isa and !ref($isa);
+
+ return $isa || $does;
+}
sub add_override_method_modifier {
my ($self, $name, $method, $_super_package) = @_;
=over 4
+=item B<initialize>
+
+=item B<new_object>
+
+We override this method to support the C<trigger> attribute option.
+
=item B<construct_instance>
This provides some Moose specific extensions to this method, you
=item B<add_override_method_modifier ($name, $method)>
+This will create an C<override> method modifier for you, and install
+it in the package.
+
=item B<add_augment_method_modifier ($name, $method)>
+This will create an C<augment> method modifier for you, and install
+it in the package.
+
=item B<roles>
+This will return an array of C<Moose::Meta::Role> instances which are
+attached to this class.
+
=item B<add_role ($role)>
+This takes an instance of C<Moose::Meta::Role> in C<$role>, and adds it
+to the list of associated roles.
+
=item B<does_role ($role_name)>
+This will test if this class C<does> a given C<$role_name>. It will
+not only check it's local roles, but ask them as well in order to
+cascade down the role hierarchy.
+
+=item B<add_attribute $attr_name, %params>
+
+This method does the same thing as L<Class::MOP::Class/add_attribute>, but adds
+suport for delegation.
+
+=back
+
+=head1 INTERNAL METHODS
+
+=over 4
+
+=item compute_delegation
+
+=item generate_delegation_list
+
+=item generate_delgate_method
+
+=item get_delegatable_methods
+
=back
=head1 BUGS
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
-=cut
\ No newline at end of file
+=cut