1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129
|
package Class::MOP::Module;
use strict;
use warnings;
use Carp 'confess';
use Scalar::Util 'blessed';
our $VERSION = '1.04';
$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' })};
}
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;
__END__
=pod
=head1 NAME
Class::MOP::Module - Module Meta Object
=head1 DESCRIPTION
A module is essentially a L<Class::MOP::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<< $metamodule->version >>
This is a read-only attribute which returns the C<$VERSION> of the
package, if one exists.
=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<Class::MOP::Class> instance for this class.
=back
=head1 AUTHORS
Stevan Little E<lt>stevan@iinteractive.comE<gt>
=head1 COPYRIGHT AND LICENSE
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
|