2 package Class::MOP::Package;
7 use Scalar::Util 'blessed';
10 our $VERSION = '0.02';
11 our $AUTHORITY = 'cpan:STEVAN';
16 require Class::MOP::Class;
17 Class::MOP::Class->initialize(blessed($_[0]) || $_[0]);
24 my $package_name = shift;
25 # we hand-construct the class
26 # until we can bootstrap it
29 '$:package' => $package_name,
30 '%:namespace' => \%{$package_name . '::'},
37 # all these attribute readers will be bootstrapped
38 # away in the Class::MOP bootstrap section
40 sub name { $_[0]->{'$:package'} }
41 sub namespace { $_[0]->{'%:namespace'} }
53 sub _deconstruct_variable_name {
54 my ($self, $variable) = @_;
57 || confess "You must pass a variable name";
59 my ($sigil, $name) = ($variable =~ /^(.)(.*)$/);
62 || confess "The variable name must include a sigil";
64 (exists $SIGIL_MAP{$sigil})
65 || confess "I do not recognize that sigil '$sigil'";
67 return ($name, $sigil, $SIGIL_MAP{$sigil});
73 # ... these functions have to touch the symbol table itself,.. yuk
75 sub add_package_symbol {
76 my ($self, $variable, $initial_value) = @_;
78 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
81 no warnings 'redefine', 'misc';
82 *{$self->name . '::' . $name} = ref $initial_value ? $initial_value : \$initial_value;
85 sub remove_package_glob {
86 my ($self, $name) = @_;
88 delete ${$self->name . '::'}{$name};
91 # ... these functions deal with stuff on the namespace level
93 sub has_package_symbol {
94 my ($self, $variable) = @_;
96 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
98 return 0 unless exists $self->namespace->{$name};
101 # For some really stupid reason
102 # a typeglob will have a default
103 # value of \undef in the SCALAR
104 # slot, so we need to work around
105 # this. Which of course means that
106 # if you put \undef in your scalar
107 # then this is broken.
109 if ($type eq 'SCALAR') {
110 my $val = *{$self->namespace->{$name}}{$type};
111 defined $$val ? 1 : 0;
114 defined *{$self->namespace->{$name}}{$type} ? 1 : 0;
118 sub get_package_symbol {
119 my ($self, $variable) = @_;
121 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
123 $self->add_package_symbol($variable)
124 unless exists $self->namespace->{$name};
125 return *{$self->namespace->{$name}}{$type};
128 sub remove_package_symbol {
129 my ($self, $variable) = @_;
131 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
134 # no doubt this is grossly inefficient and
135 # could be done much easier and faster in XS
137 my ($scalar, $array, $hash, $code);
138 if ($type eq 'SCALAR') {
139 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
140 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
141 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
143 elsif ($type eq 'ARRAY') {
144 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
145 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
146 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
148 elsif ($type eq 'HASH') {
149 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
150 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
151 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
153 elsif ($type eq 'CODE') {
154 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
155 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
156 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
159 confess "This should never ever ever happen";
162 $self->remove_package_glob($name);
164 $self->add_package_symbol(('$' . $name) => $scalar) if defined $scalar;
165 $self->add_package_symbol(('@' . $name) => $array) if defined $array;
166 $self->add_package_symbol(('%' . $name) => $hash) if defined $hash;
167 $self->add_package_symbol(('&' . $name) => $code) if defined $code;
170 sub list_all_package_symbols {
172 return keys %{$self->namespace};
183 Class::MOP::Package - Package Meta Object
201 =item B<add_package_symbol>
203 =item B<get_package_symbol>
205 =item B<has_package_symbol>
207 =item B<remove_package_symbol>
209 =item B<remove_package_glob>
211 =item B<list_all_package_symbols>
217 Stevan Little E<lt>stevan@iinteractive.comE<gt>
219 Yuval Kogman E<lt>nothingmuch@woobling.comE<gt>
221 =head1 COPYRIGHT AND LICENSE
223 Copyright 2006 by Infinity Interactive, Inc.
225 L<http://www.iinteractive.com>
227 This library is free software; you can redistribute it and/or modify
228 it under the same terms as Perl itself.