Merge branch 'stable'
[gitmo/Class-MOP.git] / lib / Class / MOP / Module.pm
index 532860e..f8d22b2 100644 (file)
@@ -4,21 +4,41 @@ package Class::MOP::Module;
 use strict;
 use warnings;
 
+use Carp         'confess';
 use Scalar::Util 'blessed';
 
-our $VERSION   = '0.61';
+our $VERSION   = '1.12';
+$VERSION = eval $VERSION;
 our $AUTHORITY = 'cpan:STEVAN';
 
 use base 'Class::MOP::Package';
 
+sub _new {
+    my $class = shift;
+    return Class::MOP::Class->initialize($class)->new_object(@_)
+        if $class ne __PACKAGE__;
+
+    my $params = @_ == 1 ? $_[0] : {@_};
+    return bless {
+
+        # from Class::MOP::Package
+        package   => $params->{package},
+        namespace => \undef,
+
+        # attributes
+        version   => \undef,
+        authority => \undef
+    } => $class;
+}
+
 sub version {  
     my $self = shift;
-    ${$self->get_package_symbol({ sigil => '$', type => 'SCALAR', name => 'VERSION' })};
+    ${$self->get_or_add_package_symbol('$VERSION')};
 }
 
 sub authority {  
     my $self = shift;
-    ${$self->get_package_symbol({ sigil => '$', type => 'SCALAR', name => 'AUTHORITY' })};
+    ${$self->get_or_add_package_symbol('$AUTHORITY')};
 }
 
 sub identifier {
@@ -30,6 +50,25 @@ sub identifier {
     );
 }
 
+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;
 
 __END__
@@ -42,36 +81,35 @@ Class::MOP::Module - Module Meta Object
 
 =head1 DESCRIPTION
 
-This is an abstraction of a Perl 5 module, it is a superclass of
-L<Class::MOP::Class>. A module essentially a package with metadata, 
-in our case the version and authority. 
+A module is essentially a L<Class::MOP::Package> with metadata, in our
+case the version and authority.
 
-=head1 METHODS
+=head1 INHERITANCE
 
-=over 4
+B<Class::MOP::Module> is a subclass of L<Class::MOP::Package>.
 
-=item B<meta>
+=head1 METHODS
 
-Returns a metaclass for this package.
+=over 4
 
-=item B<initialize ($package_name)>
+=item B<< $metamodule->version >>
 
-This will initialize a Class::MOP::Module instance which represents 
-the module of C<$package_name>.
+This is a read-only attribute which returns the C<$VERSION> of the
+package, if one exists.
 
-=item B<version>
+=item B<< $metamodule->authority >>
 
-This is a read-only attribute which returns the C<$VERSION> of the 
-package for the given instance.
+This is a read-only attribute which returns the C<$AUTHORITY> of the
+package, if one exists.
 
-=item B<authority>
+=item B<< $metamodule->identifier >>
 
-This is a read-only attribute which returns the C<$AUTHORITY> of the 
-package for the given instance.
+This constructs a string which combines the name, version and
+authority.
 
-=item B<identifier>
+=item B<< Class::MOP::Module->meta >>
 
-This constructs a string of the name, version and authority.
+This will return a L<Class::MOP::Class> instance for this class.
 
 =back
 
@@ -81,11 +119,11 @@ Stevan Little E<lt>stevan@iinteractive.comE<gt>
 
 =head1 COPYRIGHT AND LICENSE
 
-Copyright 2006-2008 by Infinity Interactive, Inc.
+Copyright 2006-2010 by Infinity Interactive, Inc.
 
 L<http://www.iinteractive.com>
 
 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