2 package Class::MOP::Package;
7 use Scalar::Util 'blessed';
10 our $VERSION = '0.02';
15 require Class::MOP::Class;
16 Class::MOP::Class->initialize(blessed($_[0]) || $_[0]);
23 my $package_name = shift;
24 # we hand-construct the class
25 # until we can bootstrap it
28 '$:package' => $package_name,
29 '%:namespace' => \%{$package_name . '::'},
36 # all these attribute readers will be bootstrapped
37 # away in the Class::MOP bootstrap section
39 sub name { $_[0]->{'$:package'} }
40 sub namespace { $_[0]->{'%:namespace'} }
52 sub _deconstruct_variable_name {
53 my ($self, $variable) = @_;
56 || confess "You must pass a variable name";
58 my ($sigil, $name) = ($variable =~ /^(.)(.*)$/);
61 || confess "The variable name must include a sigil";
63 (exists $SIGIL_MAP{$sigil})
64 || confess "I do not recognize that sigil '$sigil'";
66 return ($name, $sigil, $SIGIL_MAP{$sigil});
72 # ... these functions have to touch the symbol table itself,.. yuk
74 sub add_package_symbol {
75 my ($self, $variable, $initial_value) = @_;
77 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
80 no warnings 'redefine', 'misc';
81 *{$self->name . '::' . $name} = ref $initial_value ? $initial_value : \$initial_value;
84 sub remove_package_glob {
85 my ($self, $name) = @_;
87 delete ${$self->name . '::'}{$name};
90 # ... these functions deal with stuff on the namespace level
92 sub has_package_symbol {
93 my ($self, $variable) = @_;
95 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
97 return 0 unless exists $self->namespace->{$name};
100 # For some really stupid reason
101 # a typeglob will have a default
102 # value of \undef in the SCALAR
103 # slot, so we need to work around
104 # this. Which of course means that
105 # if you put \undef in your scalar
106 # then this is broken.
108 if ($type eq 'SCALAR') {
109 my $val = *{$self->namespace->{$name}}{$type};
110 defined $$val ? 1 : 0;
113 defined *{$self->namespace->{$name}}{$type} ? 1 : 0;
117 sub get_package_symbol {
118 my ($self, $variable) = @_;
120 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
122 $self->add_package_symbol($variable)
123 unless exists $self->namespace->{$name};
124 return *{$self->namespace->{$name}}{$type};
127 sub remove_package_symbol {
128 my ($self, $variable) = @_;
130 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
133 # no doubt this is grossly inefficient and
134 # could be done much easier and faster in XS
136 my ($scalar, $array, $hash, $code);
137 if ($type eq 'SCALAR') {
138 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
139 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
140 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
142 elsif ($type eq 'ARRAY') {
143 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
144 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
145 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
147 elsif ($type eq 'HASH') {
148 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
149 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
150 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
152 elsif ($type eq 'CODE') {
153 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
154 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
155 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
158 confess "This should never ever ever happen";
161 $self->remove_package_glob($name);
163 $self->add_package_symbol(('$' . $name) => $scalar) if defined $scalar;
164 $self->add_package_symbol(('@' . $name) => $array) if defined $array;
165 $self->add_package_symbol(('%' . $name) => $hash) if defined $hash;
166 $self->add_package_symbol(('&' . $name) => $code) if defined $code;
169 sub list_all_package_symbols {
171 return keys %{$self->namespace};
182 Class::MOP::Package - Package Meta Object
200 =item B<add_package_symbol>
202 =item B<get_package_symbol>
204 =item B<has_package_symbol>
206 =item B<remove_package_symbol>
208 =item B<remove_package_glob>
210 =item B<list_all_package_symbols>
216 Stevan Little E<lt>stevan@iinteractive.comE<gt>
218 Yuval Kogman E<lt>nothingmuch@woobling.comE<gt>
220 =head1 COPYRIGHT AND LICENSE
222 Copyright 2006 by Infinity Interactive, Inc.
224 L<http://www.iinteractive.com>
226 This library is free software; you can redistribute it and/or modify
227 it under the same terms as Perl itself.