2 package Class::MOP::Package;
7 use Scalar::Util 'blessed';
10 our $VERSION = '0.02';
11 our $AUTHORITY = 'cpan:STEVAN';
13 use base 'Class::MOP::Object';
18 require Class::MOP::Class;
19 Class::MOP::Class->initialize(blessed($_[0]) || $_[0]);
26 my $package_name = shift;
27 # we hand-construct the class
28 # until we can bootstrap it
31 '$:package' => $package_name,
32 '%:namespace' => \%{$package_name . '::'},
39 # all these attribute readers will be bootstrapped
40 # away in the Class::MOP bootstrap section
42 sub name { $_[0]->{'$:package'} }
43 sub namespace { $_[0]->{'%:namespace'} }
55 sub _deconstruct_variable_name {
56 my ($self, $variable) = @_;
59 || confess "You must pass a variable name";
61 my ($sigil, $name) = ($variable =~ /^(.)(.*)$/);
64 || confess "The variable name must include a sigil";
66 (exists $SIGIL_MAP{$sigil})
67 || confess "I do not recognize that sigil '$sigil'";
69 return ($name, $sigil, $SIGIL_MAP{$sigil});
75 # ... these functions have to touch the symbol table itself,.. yuk
77 sub add_package_symbol {
78 my ($self, $variable, $initial_value) = @_;
80 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
83 no warnings 'redefine', 'misc';
84 *{$self->name . '::' . $name} = ref $initial_value ? $initial_value : \$initial_value;
87 sub remove_package_glob {
88 my ($self, $name) = @_;
90 delete ${$self->name . '::'}{$name};
93 # ... these functions deal with stuff on the namespace level
95 sub has_package_symbol {
96 my ($self, $variable) = @_;
98 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
100 return 0 unless exists $self->namespace->{$name};
103 # For some really stupid reason
104 # a typeglob will have a default
105 # value of \undef in the SCALAR
106 # slot, so we need to work around
107 # this. Which of course means that
108 # if you put \undef in your scalar
109 # then this is broken.
111 if ($type eq 'SCALAR') {
112 my $val = *{$self->namespace->{$name}}{$type};
113 defined $$val ? 1 : 0;
116 defined *{$self->namespace->{$name}}{$type} ? 1 : 0;
120 sub get_package_symbol {
121 my ($self, $variable) = @_;
123 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
125 $self->add_package_symbol($variable)
126 unless exists $self->namespace->{$name};
127 return *{$self->namespace->{$name}}{$type};
130 sub remove_package_symbol {
131 my ($self, $variable) = @_;
133 my ($name, $sigil, $type) = $self->_deconstruct_variable_name($variable);
136 # no doubt this is grossly inefficient and
137 # could be done much easier and faster in XS
139 my ($scalar, $array, $hash, $code);
140 if ($type eq 'SCALAR') {
141 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
142 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
143 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
145 elsif ($type eq 'ARRAY') {
146 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
147 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
148 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
150 elsif ($type eq 'HASH') {
151 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
152 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
153 $code = $self->get_package_symbol('&' . $name) if $self->has_package_symbol('&' . $name);
155 elsif ($type eq 'CODE') {
156 $scalar = $self->get_package_symbol('$' . $name) if $self->has_package_symbol('$' . $name);
157 $array = $self->get_package_symbol('@' . $name) if $self->has_package_symbol('@' . $name);
158 $hash = $self->get_package_symbol('%' . $name) if $self->has_package_symbol('%' . $name);
161 confess "This should never ever ever happen";
164 $self->remove_package_glob($name);
166 $self->add_package_symbol(('$' . $name) => $scalar) if defined $scalar;
167 $self->add_package_symbol(('@' . $name) => $array) if defined $array;
168 $self->add_package_symbol(('%' . $name) => $hash) if defined $hash;
169 $self->add_package_symbol(('&' . $name) => $code) if defined $code;
172 sub list_all_package_symbols {
174 return keys %{$self->namespace};
185 Class::MOP::Package - Package Meta Object
203 =item B<add_package_symbol>
205 =item B<get_package_symbol>
207 =item B<has_package_symbol>
209 =item B<remove_package_symbol>
211 =item B<remove_package_glob>
213 =item B<list_all_package_symbols>
219 Stevan Little E<lt>stevan@iinteractive.comE<gt>
221 Yuval Kogman E<lt>nothingmuch@woobling.comE<gt>
223 =head1 COPYRIGHT AND LICENSE
225 Copyright 2006 by Infinity Interactive, Inc.
227 L<http://www.iinteractive.com>
229 This library is free software; you can redistribute it and/or modify
230 it under the same terms as Perl itself.