X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FClass%2FMOP%2FModule.pm;h=8a3d27d1174cbe98292a24eda369e059390eca6b;hb=a02f24cbc720ab9fd5e04ed96f36406654f3740a;hp=7e18bdc6e87b3a8b2ac2f049357f78645a4c93e8;hpb=9d6dce77cd867d92c418eb4fcfd199eaca6efc10;p=gitmo%2FClass-MOP.git diff --git a/lib/Class/MOP/Module.pm b/lib/Class/MOP/Module.pm index 7e18bdc..8a3d27d 100644 --- a/lib/Class/MOP/Module.pm +++ b/lib/Class/MOP/Module.pm @@ -4,41 +4,70 @@ package Class::MOP::Module; use strict; use warnings; +use Carp 'confess'; use Scalar::Util 'blessed'; -our $VERSION = '0.02'; -#our $AUTHORITY = { -# cpan => 'STEVAN', -# mailto => 'stevan@iinteractive.com', -# http => '//www.iinteractive.com/' -#}; +our $VERSION = '0.94'; +$VERSION = eval $VERSION; +our $AUTHORITY = 'cpan:STEVAN'; use base 'Class::MOP::Package'; -# introspection +sub _new { + my $class = shift; + return Class::MOP::Class->initialize($class)->new_object(@_) + if $class ne __PACKAGE__; -sub meta { - require Class::MOP::Class; - Class::MOP::Class->initialize(blessed($_[0]) || $_[0]); -} + my $params = @_ == 1 ? $_[0] : {@_}; + return bless { + + # from Class::MOP::Package + package => $params->{package}, + namespace => \undef, -# QUESTION: -# can the version be an attribute of the -# module? I think it should be, but we need -# to somehow assure that it always is stored -# in the symbol table instead of being stored -# into the instance structure itself + # attributes + version => \undef, + authority => \undef + } => $class; +} sub version { my $self = shift; - ${$self->get_package_symbol('$VERSION')}; + ${$self->get_package_symbol({ sigil => '$', type => 'SCALAR', name => 'VERSION' })}; } -#sub authority { -# my $self = shift; -# $self->get_package_symbol('$AUTHORITY'); -#} +sub authority { + my $self = shift; + ${$self->get_package_symbol({ sigil => '$', type => 'SCALAR', name => 'AUTHORITY' })}; +} +sub identifier { + my $self = shift; + join '-' => ( + $self->name, + ($self->version || ()), + ($self->authority || ()), + ); +} + +sub create { + confess "The Class::MOP::Module->create method has been made a private object method.\n"; +} + +sub _instantiate_module { + my($self, $version, $authority) = @_; + my $package_name = $self->name; + + Class::MOP::_is_valid_class_name($package_name) + || confess "creation of $package_name failed: invalid package name"; + + no strict 'refs'; + scalar %{ $package_name . '::' }; # touch the stash + ${ $package_name . '::VERSION' } = $version if defined $version; + ${ $package_name . '::AUTHORITY' } = $authority if defined $authority; + + return; +} 1; @@ -50,17 +79,37 @@ __END__ Class::MOP::Module - Module Meta Object -=head1 SYNOPSIS - =head1 DESCRIPTION +A module is essentially a L with metadata, in our +case the version and authority. + +=head1 INHERITANCE + +B is a subclass of L. + =head1 METHODS =over 4 -=item B +=item B<< $metamodule->version >> + +This is a read-only attribute which returns the C<$VERSION> of the +package, if one exists. -=item B +=item B<< $metamodule->authority >> + +This is a read-only attribute which returns the C<$AUTHORITY> of the +package, if one exists. + +=item B<< $metamodule->identifier >> + +This constructs a string which combines the name, version and +authority. + +=item B<< Class::MOP::Module->meta >> + +This will return a L instance for this class. =back @@ -68,15 +117,13 @@ Class::MOP::Module - Module Meta Object Stevan Little Estevan@iinteractive.comE -Yuval Kogman Enothingmuch@woobling.comE - =head1 COPYRIGHT AND LICENSE -Copyright 2006 by Infinity Interactive, Inc. +Copyright 2006-2009 by Infinity Interactive, Inc. L 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