X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FClass%2FMOP%2FModule.pm;h=9faade524c25d5f2dc11b650ec8b1320c8e33547;hb=097eeb20923df544ba145c1e61bc773d7df5857a;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..9faade5 100644
--- a/lib/Class/MOP/Module.pm
+++ b/lib/Class/MOP/Module.pm
@@ -4,41 +4,53 @@ 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.77_01';
+$VERSION = eval $VERSION;
+our $AUTHORITY = 'cpan:STEVAN';
 
 use base 'Class::MOP::Package';
 
-# introspection
-
-sub meta { 
-    require Class::MOP::Class;
-    Class::MOP::Class->initialize(blessed($_[0]) || $_[0]);
+sub version {  
+    my $self = shift;
+    ${$self->get_package_symbol({ sigil => '$', type => 'SCALAR', name => 'VERSION' })};
 }
 
-# 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
+sub authority {  
+    my $self = shift;
+    ${$self->get_package_symbol({ sigil => '$', type => 'SCALAR', name => 'AUTHORITY' })};
+}
 
-sub version {  
+sub identifier {
     my $self = shift;
-    ${$self->get_package_symbol('$VERSION')};
+    join '-' => (
+        $self->name,
+        ($self->version   || ()),
+        ($self->authority || ()),
+    );
 }
 
-#sub authority {  
-#    my $self = shift;
-#    $self->get_package_symbol('$AUTHORITY');
-#}
+sub create {
+    my ( $class, %options ) = @_;
+
+    my $package_name = $options{package};
 
+    (defined $package_name && $package_name)
+        || confess "You must pass a package name";
+
+    my $code = "package $package_name;";
+    $code .= "\$$package_name\:\:VERSION = '" . $options{version} . "';"
+        if exists $options{version};
+    $code .= "\$$package_name\:\:AUTHORITY = '" . $options{authority} . "';"
+        if exists $options{authority};
+
+    eval $code;
+    confess "creation of $package_name failed : $@" if $@;
+
+    return; # XXX: should this return some kind of meta object? ~sartak
+}
 
 1;
 
@@ -50,33 +62,60 @@ __END__
 
 Class::MOP::Module - Module Meta Object
 
-=head1 SYNOPSIS
-
 =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. 
+
+=head1 INHERITANCE
+
+B<Class::MOP::Module> is a subclass of L<Class::MOP::Package>
+
 =head1 METHODS
 
 =over 4
 
 =item B<meta>
 
+Returns a metaclass for this package.
+
+=item B<initialize ($package_name)>
+
+This will initialize a Class::MOP::Module instance which represents 
+the module of C<$package_name>.
+
 =item B<version>
 
+This is a read-only attribute which returns the C<$VERSION> of the 
+package for the given instance.
+
+=item B<authority>
+
+This is a read-only attribute which returns the C<$AUTHORITY> of the 
+package for the given instance.
+
+=item B<identifier>
+
+This constructs a string of the name, version and authority.
+
+=item B<create>
+
+This creates the module; it does not return a useful result.
+
 =back
 
 =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.
+Copyright 2006-2008 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