use Sub::Name 'subname';
use B 'svref_2object';
-our $VERSION = '0.15';
+our $VERSION = '0.17';
+
+use base 'Class::MOP::Module';
use Class::MOP::Instance;
sub meta { Class::MOP::Class->initialize(blessed($_[0]) || $_[0]) }
+# Class globals ...
+
+# NOTE:
+# we need a sufficiently annoying prefix
+# this should suffice for now, this is
+# used in a couple of places below, so
+# need to put it up here for now.
+my $ANON_CLASS_PREFIX = 'Class::MOP::Class::__ANON__::SERIAL::';
+
# Creation
{
|| confess "You must pass a package name and it cannot be blessed";
$METAS{$package_name} = undef;
$class->construct_class_instance(':package' => $package_name, @_);
- }
-
- # NOTE:
- # we need a sufficiently annoying prefix
- # this should suffice for now
- my $ANON_CLASS_PREFIX = 'Class::MOP::Class::__ANON__::SERIAL::';
-
- {
- # NOTE:
- # this should be sufficient, if you have a
- # use case where it is not, write a test and
- # I will change it.
- my $ANON_CLASS_SERIAL = 0;
-
- sub create_anon_class {
- my ($class, %options) = @_;
- my $package_name = $ANON_CLASS_PREFIX . ++$ANON_CLASS_SERIAL;
- return $class->create($package_name, '0.00', %options);
- }
- }
+ }
# NOTE: (meta-circularity)
# this is a special form of &construct_instance
# annoyingly enough during global destruction)
return $METAS{$package_name}
if exists $METAS{$package_name} && defined $METAS{$package_name};
+
+ # NOTE:
+ # we need to deal with the possibility
+ # of class immutability here, and then
+ # get the name of the class appropriately
+ $class = (blessed($class)
+ ? ($class->is_immutable
+ ? $class->get_mutable_metaclass_name()
+ : blessed($class))
+ : $class);
+
$class = blessed($class) || $class;
# now create the metaclass
my $meta;
- if ($class =~ /^Class::MOP::/) {
+ if ($class =~ /^Class::MOP::Class$/) {
$meta = bless {
'$:package' => $package_name,
'%:attributes' => {},
$meta;
}
- # NOTE:
- # this will only get called for
- # anon-classes, all other calls
- # are assumed to occur during
- # global destruction and so don't
- # really need to be handled explicitly
- sub DESTROY {
- my $self = shift;
- return unless $self->name =~ /^$ANON_CLASS_PREFIX/;
- my ($serial_id) = ($self->name =~ /^$ANON_CLASS_PREFIX(\d+)/);
- no strict 'refs';
- foreach my $key (keys %{$ANON_CLASS_PREFIX . $serial_id}) {
- delete ${$ANON_CLASS_PREFIX . $serial_id}{$key};
- }
- delete ${'main::' . $ANON_CLASS_PREFIX}{$serial_id . '::'};
- }
-
sub check_metaclass_compatability {
my $self = shift;
foreach my $class_name (@class_list) {
my $meta = $METAS{$class_name} || next;
- ($self->isa(blessed($meta)))
+
+ # NOTE:
+ # we need to deal with the possibility
+ # of class immutability here, and then
+ # get the name of the class appropriately
+ my $meta_type = ($meta->is_immutable
+ ? $meta->get_mutable_metaclass_name()
+ : blessed($meta));
+
+ ($self->isa($meta_type))
|| confess $self->name . "->meta => (" . (blessed($self)) . ")" .
" is not compatible with the " .
- $class_name . "->meta => (" . (blessed($meta)) . ")";
+ $class_name . "->meta => (" . ($meta_type) . ")";
# NOTE:
# we also need to check that instance metaclasses
# are compatabile in the same the class.
}
}
+## ANON classes
+
+{
+ # NOTE:
+ # this should be sufficient, if you have a
+ # use case where it is not, write a test and
+ # I will change it.
+ my $ANON_CLASS_SERIAL = 0;
+
+ sub create_anon_class {
+ my ($class, %options) = @_;
+ my $package_name = $ANON_CLASS_PREFIX . ++$ANON_CLASS_SERIAL;
+ return $class->create($package_name, '0.00', %options);
+ }
+}
+
+# NOTE:
+# this will only get called for
+# anon-classes, all other calls
+# are assumed to occur during
+# global destruction and so don't
+# really need to be handled explicitly
+sub DESTROY {
+ my $self = shift;
+ return unless $self->name =~ /^$ANON_CLASS_PREFIX/;
+ my ($serial_id) = ($self->name =~ /^$ANON_CLASS_PREFIX(\d+)/);
+ no strict 'refs';
+ foreach my $key (keys %{$ANON_CLASS_PREFIX . $serial_id}) {
+ delete ${$ANON_CLASS_PREFIX . $serial_id}{$key};
+ }
+ delete ${'main::' . $ANON_CLASS_PREFIX}{$serial_id . '::'};
+}
+
+# creating classes with MOP ...
+
sub create {
my ($class, $package_name, $package_version, %options) = @_;
(defined $package_name && $package_name)
# all these attribute readers will be bootstrapped
# away in the Class::MOP bootstrap section
-sub name { $_[0]->{'$:package'} }
sub get_attribute_map { $_[0]->{'%:attributes'} }
sub attribute_metaclass { $_[0]->{'$:attribute_metaclass'} }
sub method_metaclass { $_[0]->{'$:method_metaclass'} }
return $clone;
}
-# Informational
-
-# &name should be here too, but it is above
-# because it gets bootstrapped away
-
-sub version {
- my $self = shift;
- ${$self->get_package_variable('$VERSION')};
-}
-
# Inheritance
sub superclasses {
my $self = shift;
- no strict 'refs';
if (@_) {
my @supers = @_;
- @{$self->name . '::ISA'} = @supers;
+ @{$self->get_package_symbol('@ISA')} = @supers;
# NOTE:
# we need to check the metaclass
# compatability here so that we can
# we don't know about
$self->check_metaclass_compatability();
}
- @{$self->name . '::ISA'};
+ @{$self->get_package_symbol('@ISA')};
}
sub class_precedence_list {
|| confess "Your code block must be a CODE reference";
my $full_method_name = ($self->name . '::' . $method_name);
+ # FIXME:
+ # dont bless subs, its bad mkay
$method = $self->method_metaclass->wrap($method) unless blessed($method);
- no strict 'refs';
- no warnings 'redefine';
- *{$full_method_name} = subname $full_method_name => $method;
+ $self->add_package_symbol("&${method_name}" => subname $full_method_name => $method);
}
{
# use reftype here to allow for blessed subs ...
('CODE' eq (reftype($method) || ''))
|| confess "Your code block must be a CODE reference";
- my $full_method_name = ($self->name . '::' . $method_name);
+ # FIXME:
+ # dont bless subs, its bad mkay
$method = $self->method_metaclass->wrap($method) unless blessed($method);
- no strict 'refs';
- no warnings 'redefine';
- *{$full_method_name} = $method;
+ $self->add_package_symbol("&${method_name}" => $method);
+}
+
+sub find_method_by_name {
+ my ($self, $method_name) = @_;
+ return $self->name->can($method_name);
}
sub has_method {
my ($self, $method_name) = @_;
(defined $method_name && $method_name)
|| confess "You must define a method name";
-
- my $sub_name = ($self->name . '::' . $method_name);
- no strict 'refs';
- return 0 if !defined(&{$sub_name});
- my $method = \&{$sub_name};
+ return 0 if !$self->has_package_symbol("&${method_name}");
+ my $method = $self->get_package_symbol("&${method_name}");
return 0 if (svref_2object($method)->GV->STASH->NAME || '') ne $self->name &&
(svref_2object($method)->GV->NAME || '') ne '__ANON__';
-
- # at this point we are relatively sure
- # it is our method, so we bless/wrap it
+
+ # FIXME:
+ # dont bless subs, its bad mkay
$self->method_metaclass->wrap($method) unless blessed($method);
+
return 1;
}
|| confess "You must define a method name";
return unless $self->has_method($method_name);
-
- no strict 'refs';
- return \&{$self->name . '::' . $method_name};
+
+ return $self->get_package_symbol("&${method_name}");
}
sub remove_method {
my $removed_method = $self->get_method($method_name);
- no strict 'refs';
- delete ${$self->name . '::'}{$method_name}
+ $self->remove_package_symbol("&${method_name}")
if defined $removed_method;
return $removed_method;
sub get_method_list {
my $self = shift;
- no strict 'refs';
- grep { $self->has_method($_) } keys %{$self->name . '::'};
+ grep { $self->has_method($_) } $self->list_all_package_symbols;
}
sub compute_all_applicable_methods {
$attribute->attach_to_class($self);
$attribute->install_accessors();
$self->get_attribute_map->{$attribute->name} = $attribute;
-
- # FIXME
- # in theory we have to tell everyone the slot structure may have changed
}
sub has_attribute {
return;
}
-# Class attributes
-
-sub add_package_variable {
- my ($self, $variable, $initial_value) = @_;
- (defined $variable && $variable =~ /^[\$\@\%]/)
- || confess "variable name does not have a sigil";
-
- my ($sigil, $name) = ($variable =~ /^(.)(.*)$/);
- if (defined $initial_value) {
- no strict 'refs';
- *{$self->name . '::' . $name} = $initial_value;
- }
- else {
- my $e;
- {
- # NOTE:
- # We HAVE to localize $@ or all
- # hell breaks loose. It is not
- # good, believe me, not good.
- local $@;
- eval $sigil . $self->name . '::' . $name;
- $e = $@ if $@;
- }
- confess "Could not create package variable ($variable) because : $e" if $e;
- }
-}
-
-sub has_package_variable {
- my ($self, $variable) = @_;
- (defined $variable && $variable =~ /^[\$\@\%]/)
- || confess "variable name does not have a sigil";
- my ($sigil, $name) = ($variable =~ /^(.)(.*)$/);
- no strict 'refs';
- defined ${$self->name . '::'}{$name} ? 1 : 0;
-}
-
-sub get_package_variable {
- my ($self, $variable) = @_;
- (defined $variable && $variable =~ /^[\$\@\%]/)
- || confess "variable name does not have a sigil";
- my ($sigil, $name) = ($variable =~ /^(.)(.*)$/);
- my ($ref, $e);
- {
- # NOTE:
- # We HAVE to localize $@ or all
- # hell breaks loose. It is not
- # good, believe me, not good.
- local $@;
- $ref = eval '\\' . $sigil . $self->name . '::' . $name;
- $e = $@ if $@;
- }
- confess "Could not get the package variable ($variable) because : $e" if $e;
- # if we didn't die, then we can return it
- return $ref;
-}
-
-sub remove_package_variable {
- my ($self, $variable) = @_;
- (defined $variable && $variable =~ /^[\$\@\%]/)
- || confess "variable name does not have a sigil";
- my ($sigil, $name) = ($variable =~ /^(.)(.*)$/);
- no strict 'refs';
- delete ${$self->name . '::'}{$name};
-}
-
## Class closing
sub is_mutable { 1 }
sub is_immutable { 0 }
sub make_immutable {
- my ($class) = @_;
- return Class::MOP::Class::Immutable->make_metaclass_immutable($class);
+ return Class::MOP::Class::Immutable->make_metaclass_immutable(@_);
}
1;
This will return a CODE reference of the specified C<$method_name>,
or return undef if that method does not exist.
+=item B<find_method_by_name ($method_name>
+
+This will return a CODE reference of the specified C<$method_name>,
+or return undef if that method does not exist.
+
+Unlike C<get_method> this will also look in the superclasses.
+
=item B<remove_method ($method_name)>
This will attempt to remove a given C<$method_name> from the class.
=over 4
-=item B<add_package_variable ($variable_name, ?$initial_value)>
+=item B<add_package_symbol ($variable_name, ?$initial_value)>
Given a C<$variable_name>, which must contain a leading sigil, this
method will create that variable within the package which houses the
reference of the same type as the sigil of the C<$variable_name>
implies.
-=item B<get_package_variable ($variable_name)>
+=item B<get_package_symbol ($variable_name)>
This will return a reference to the package variable in
C<$variable_name>.
-=item B<has_package_variable ($variable_name)>
+=item B<has_package_symbol ($variable_name)>
Returns true (C<1>) if there is a package variable defined for
C<$variable_name>, and false (C<0>) otherwise.
-=item B<remove_package_variable ($variable_name)>
+=item B<remove_package_symbol ($variable_name)>
This will attempt to remove the package variable at C<$variable_name>.
=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.