use Carp 'confess';
use Scalar::Util 'blessed', 'reftype', 'weaken';
-our $VERSION = '0.08';
+our $VERSION = '0.11';
+our $AUTHORITY = 'cpan:STEVAN';
sub meta {
require Class::MOP::Class;
}
# NOTE: (meta-circularity)
-# This method will be replaces in the
+# This method will be replaced in the
# boostrap section of Class::MOP, by
# a new version which uses the
# &Class::MOP::Class::construct_instance
reader => $options{reader},
writer => $options{writer},
predicate => $options{predicate},
+ clearer => $options{clearer},
init_arg => $options{init_arg},
default => $options{default},
# keep a weakened link to the
# NOTE:
# this is a primative (and kludgy) clone operation
-# for now, it will be repleace in the Class::MOP
+# for now, it will be replaced in the Class::MOP
# bootstrap with a proper one, however we know
# that this one will work fine for now.
sub clone {
sub has_reader { defined($_[0]->{reader}) ? 1 : 0 }
sub has_writer { defined($_[0]->{writer}) ? 1 : 0 }
sub has_predicate { defined($_[0]->{predicate}) ? 1 : 0 }
+sub has_clearer { defined($_[0]->{clearer}) ? 1 : 0 }
sub has_init_arg { defined($_[0]->{init_arg}) ? 1 : 0 }
sub has_default { defined($_[0]->{default}) ? 1 : 0 }
sub reader { $_[0]->{reader} }
sub writer { $_[0]->{writer} }
sub predicate { $_[0]->{predicate} }
+sub clearer { $_[0]->{clearer} }
sub init_arg { $_[0]->{init_arg} }
# end bootstrapped away method section.
$self->{associated_class} = undef;
}
+## Slot management
+
+sub set_value {
+ my ( $self, $instance, $value ) = @_;
+
+ Class::MOP::Class->initialize(Scalar::Util::blessed($instance))
+ ->get_meta_instance
+ ->set_slot_value( $instance, $self->name, $value );
+}
+
+sub get_value {
+ my ( $self, $instance ) = @_;
+
+ Class::MOP::Class->initialize(Scalar::Util::blessed($instance))
+ ->get_meta_instance
+ ->get_slot_value( $instance, $self->name );
+}
+
## Method generation helpers
sub generate_accessor_method {
- my $self = shift;
- my $attr_name = $self->name;
+ my $attr = shift;
return sub {
- my $meta_instance = Class::MOP::Class->initialize(Scalar::Util::blessed($_[0]))->get_meta_instance;
- $meta_instance->set_slot_value($_[0], $attr_name, $_[1]) if scalar(@_) == 2;
- $meta_instance->get_slot_value($_[0], $attr_name);
+ $attr->set_value( $_[0], $_[1] ) if scalar(@_) == 2;
+ $attr->get_value( $_[0] );
};
}
my $meta_instance = $self->associated_class->instance_metaclass;
my $code = eval 'sub {'
- . $meta_instance->inline_set_slot_value('$_[0]', $attr_name, '$_[1]') . ' if scalar(@_) == 2; '
- . $meta_instance->inline_get_slot_value('$_[0]', $attr_name)
+ . $meta_instance->inline_set_slot_value('$_[0]', "'$attr_name'", '$_[1]') . ' if scalar(@_) == 2; '
+ . $meta_instance->inline_get_slot_value('$_[0]', "'$attr_name'")
. '}';
confess "Could not generate inline accessor because : $@" if $@;
}
sub generate_reader_method {
- my $self = shift;
- my $attr_name = $self->name;
+ my $attr = shift;
return sub {
confess "Cannot assign a value to a read-only accessor" if @_ > 1;
- Class::MOP::Class->initialize(Scalar::Util::blessed($_[0]))
- ->get_meta_instance
- ->get_slot_value($_[0], $attr_name);
+ $attr->get_value( $_[0] );
};
}
my $code = eval 'sub {'
. 'confess "Cannot assign a value to a read-only accessor" if @_ > 1;'
- . $meta_instance->inline_get_slot_value('$_[0]', $attr_name)
+ . $meta_instance->inline_get_slot_value('$_[0]', "'$attr_name'")
. '}';
confess "Could not generate inline accessor because : $@" if $@;
}
sub generate_writer_method {
- my $self = shift;
- my $attr_name = $self->name;
- return sub {
- Class::MOP::Class->initialize(Scalar::Util::blessed($_[0]))
- ->get_meta_instance
- ->set_slot_value($_[0], $attr_name, $_[1]);
+ my $attr = shift;
+ return sub {
+ $attr->set_value( $_[0], $_[1] );
};
}
my $meta_instance = $self->associated_class->instance_metaclass;
my $code = eval 'sub {'
- . $meta_instance->inline_set_slot_value('$_[0]', $attr_name, '$_[1]')
+ . $meta_instance->inline_set_slot_value('$_[0]', "'$attr_name'", '$_[1]')
. '}';
confess "Could not generate inline accessor because : $@" if $@;
};
}
+sub generate_clearer_method {
+ my $self = shift;
+ my $attr_name = $self->name;
+ return sub {
+ Class::MOP::Class->initialize(Scalar::Util::blessed($_[0]))
+ ->get_meta_instance
+ ->deinitialize_slot($_[0], $attr_name);
+ };
+}
+
sub generate_predicate_method_inline {
my $self = shift;
my $attr_name = $self->name;
my $meta_instance = $self->associated_class->instance_metaclass;
my $code = eval 'sub {'
- . 'defined ' . $meta_instance->inline_get_slot_value('$_[0]', $attr_name) . ' ? 1 : 0'
+ . 'defined ' . $meta_instance->inline_get_slot_value('$_[0]', "'$attr_name'") . ' ? 1 : 0'
. '}';
- confess "Could not generate inline accessor because : $@" if $@;
+ confess "Could not generate inline predicate because : $@" if $@;
+
+ return $code;
+}
+
+sub generate_clearer_method_inline {
+ my $self = shift;
+ my $attr_name = $self->name;
+ my $meta_instance = $self->associated_class->instance_metaclass;
+
+ my $code = eval 'sub {'
+ . $meta_instance->inline_deinitialize_slot('$_[0]', "'$attr_name'")
+ . '}';
+ confess "Could not generate inline clearer because : $@" if $@;
return $code;
}
my ($self, $type, $accessor, $generate_as_inline_methods) = @_;
if (reftype($accessor)) {
(reftype($accessor) eq 'HASH')
- || confess "bad accessor/reader/writer/predicate format, must be a HASH ref";
- my ($name, $method) = each %{$accessor};
+ || confess "bad accessor/reader/writer/predicate/clearer format, must be a HASH ref";
+ my ($name, $method) = %{$accessor};
return ($name, Class::MOP::Attribute::Accessor->wrap($method));
}
else {
$self->process_accessors('predicate' => $self->predicate(), $inline)
) if $self->has_predicate();
+ $class->add_method(
+ $self->process_accessors('clearer' => $self->clearer(), $inline)
+ ) if $self->has_clearer();
+
return;
}
$_remove_accessor->($self->reader(), $self->associated_class()) if $self->has_reader();
$_remove_accessor->($self->writer(), $self->associated_class()) if $self->has_writer();
$_remove_accessor->($self->predicate(), $self->associated_class()) if $self->has_predicate();
+ $_remove_accessor->($self->clearer(), $self->associated_class()) if $self->has_clearer();
return;
}
=back
-The I<accessor>, I<reader>, I<writer> and I<predicate> keys can
-contain either; the name of the method and an appropriate default
-one will be generated for you, B<or> a HASH ref containing exactly one
-key (which will be used as the name of the method) and one value,
-which should contain a CODE reference which will be installed as
-the method itself.
+The I<accessor>, I<reader>, I<writer>, I<predicate> and I<clearer> keys can
+contain either; the name of the method and an appropriate default one will be
+generated for you, B<or> a HASH ref containing exactly one key (which will be
+used as the name of the method) and one value, which should contain a CODE
+reference which will be installed as the method itself.
=over 4
C<undef>. It will return true (C<1>) if the attribute's value is
defined, and false (C<0>) otherwise.
+=item I<clearer>
+
+This is the a method that will uninitialize the attr, reverting lazy values
+back to their "unfulfilled" state.
+
=back
=item B<clone (%options)>
=back
+=head2 Value management
+
+=over 4
+
+=item set_value $instance, $value
+
+Set the value without going through the accessor. Note that this may be done to
+even attributes with just read only accessors.
+
+=item get_value $instance
+
+Return the value without going through the accessor. Note that this may be done
+even to attributes with just write only accessors.
+
+=back
+
=head2 Informational
These are all basic read-only value accessors for the values
=item B<predicate>
+=item B<clearer>
+
=item B<init_arg>
+=item B<is_default_a_coderef>
+
=item B<default (?$instance)>
As noted in the documentation for C<new> above, if the I<default>
=item B<has_predicate>
+=item B<has_clearer>
+
=item B<has_init_arg>
=item B<has_default>
=item B<generate_predicate_method>
+=item B<generate_clearer_method>
+
=item B<generate_reader_method>
=item B<generate_writer_method>
=back
+=over 4
+
+=item B<generate_accessor_method_inline>
+
+=item B<generate_predicate_method_inline>
+
+=item B<generate_clearer_method_inline>
+
+=item B<generate_reader_method_inline>
+
+=item B<generate_writer_method_inline>
+
+=back
+
=item B<remove_accessors>
This allows the attribute to remove the method for it's own
-I<accessor/reader/writer/predicate>. This is called by
+I<accessor/reader/writer/predicate/clearer>. This is called by
C<Class::MOP::Class::remove_attribute>.
=back
=back
-=head1 AUTHOR
+=head1 AUTHORS
Stevan Little E<lt>stevan@iinteractive.comE<gt>
+Yuval Kogman E<lt>nothingmuch@woobling.comE<gt>
+
=head1 COPYRIGHT AND LICENSE
Copyright 2006 by Infinity Interactive, Inc.
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
+
+
projects / gitmo/Class-MOP.git / blobdiff