Make some constants as class attributes
[gitmo/Mouse.git] / lib / Mouse / PurePerl.pm
CommitLineData
ccb38d0b 1package Mouse::PurePerl;
2
a52cca04 3require Mouse::Util;
4
df6dd016 5package
6 Mouse::Util;
7
8use strict;
9use warnings;
10
11use warnings FATAL => 'redefine'; # to avoid to load Mouse::PurePerl
12
13use B ();
14
15sub is_class_loaded {
16 my $class = shift;
17
18 return 0 if ref($class) || !defined($class) || !length($class);
19
20 # walk the symbol table tree to avoid autovififying
21 # \*{${main::}{"Foo::"}} == \*main::Foo::
22
23 my $pack = \%::;
24 foreach my $part (split('::', $class)) {
25 my $entry = \$pack->{$part . '::'};
26 return 0 if ref($entry) ne 'GLOB';
27 $pack = *{$entry}{HASH} or return 0;
28 }
29
30 # check for $VERSION or @ISA
31 return 1 if exists $pack->{VERSION}
32 && defined *{$pack->{VERSION}}{SCALAR} && defined ${ $pack->{VERSION} };
33 return 1 if exists $pack->{ISA}
34 && defined *{$pack->{ISA}}{ARRAY} && @{ $pack->{ISA} } != 0;
35
36 # check for any method
37 foreach my $name( keys %{$pack} ) {
38 my $entry = \$pack->{$name};
39 return 1 if ref($entry) ne 'GLOB' || defined *{$entry}{CODE};
40 }
41
42 # fail
43 return 0;
44}
45
46
47# taken from Sub::Identify
48sub get_code_info {
49 my ($coderef) = @_;
50 ref($coderef) or return;
51
52 my $cv = B::svref_2object($coderef);
53 $cv->isa('B::CV') or return;
54
55 my $gv = $cv->GV;
56 $gv->isa('B::GV') or return;
57
58 return ($gv->STASH->NAME, $gv->NAME);
59}
60
61sub get_code_package{
62 my($coderef) = @_;
63
64 my $cv = B::svref_2object($coderef);
65 $cv->isa('B::CV') or return '';
66
67 my $gv = $cv->GV;
68 $gv->isa('B::GV') or return '';
69
70 return $gv->STASH->NAME;
71}
72
7d96ae4d 73sub get_code_ref{
74 my($package, $name) = @_;
75 no strict 'refs';
76 no warnings 'once';
77 use warnings FATAL => 'uninitialized';
78 return *{$package . '::' . $name}{CODE};
79}
80
e3540312 81sub generate_isa_predicate_for {
1d5ecd5f 82 my($for_class, $name) = @_;
83
f48920c1 84 my $predicate = sub{ Scalar::Util::blessed($_[0]) && $_[0]->isa($for_class) };
1d5ecd5f 85
86 if(defined $name){
87 no strict 'refs';
88 *{ caller() . '::' . $name } = $predicate;
89 return;
90 }
91
92 return $predicate;
93}
94
95
f48920c1 96package
97 Mouse::Util::TypeConstraints;
98
99use Scalar::Util qw(blessed looks_like_number openhandle);
100
7d96ae4d 101sub Any { 1 }
102sub Item { 1 }
7d96ae4d 103
104sub Bool { $_[0] ? $_[0] eq '1' : 1 }
105sub Undef { !defined($_[0]) }
106sub Defined { defined($_[0]) }
107sub Value { defined($_[0]) && !ref($_[0]) }
108sub Num { !ref($_[0]) && looks_like_number($_[0]) }
109sub Int { defined($_[0]) && !ref($_[0]) && $_[0] =~ /^-?[0-9]+$/ }
110sub Str { defined($_[0]) && !ref($_[0]) }
111
112sub Ref { ref($_[0]) }
113sub ScalarRef { ref($_[0]) eq 'SCALAR' }
114sub ArrayRef { ref($_[0]) eq 'ARRAY' }
115sub HashRef { ref($_[0]) eq 'HASH' }
116sub CodeRef { ref($_[0]) eq 'CODE' }
117sub RegexpRef { ref($_[0]) eq 'Regexp' }
118sub GlobRef { ref($_[0]) eq 'GLOB' }
119
120sub FileHandle {
121 openhandle($_[0]) || (blessed($_[0]) && $_[0]->isa("IO::Handle"))
122}
123
124sub Object { blessed($_[0]) && blessed($_[0]) ne 'Regexp' }
125
126sub ClassName { Mouse::Util::is_class_loaded($_[0]) }
127sub RoleName { (Mouse::Util::class_of($_[0]) || return 0)->isa('Mouse::Meta::Role') }
128
619338ac 129sub _parameterize_ArrayRef_for {
130 my($type_parameter) = @_;
131 my $check = $type_parameter->_compiled_type_constraint;
132
133 return sub {
134 foreach my $value (@{$_}) {
135 return undef unless $check->($value);
136 }
137 return 1;
138 }
139}
140
141sub _parameterize_HashRef_for {
142 my($type_parameter) = @_;
143 my $check = $type_parameter->_compiled_type_constraint;
144
145 return sub {
146 foreach my $value(values %{$_}){
147 return undef unless $check->($value);
148 }
149 return 1;
150 };
151}
152
153# 'Maybe' type accepts 'Any', so it requires parameters
154sub _parameterize_Maybe_for {
155 my($type_parameter) = @_;
156 my $check = $type_parameter->_compiled_type_constraint;
157
158 return sub{
159 return !defined($_) || $check->($_);
160 };
161};
162
163
7d96ae4d 164
43165725 165package
166 Mouse::Meta::Module;
167
926404f2 168sub name { $_[0]->{package} }
169
170sub _method_map { $_[0]->{methods} }
c5f6ad05 171sub _attribute_map{ $_[0]->{attributes} }
43165725 172
2591e962 173sub namespace{
174 my $name = $_[0]->{package};
175 no strict 'refs';
176 return \%{ $name . '::' };
177}
178
3e44140b 179sub add_method {
180 my($self, $name, $code) = @_;
181
182 if(!defined $name){
183 $self->throw_error('You must pass a defined name');
184 }
185 if(!defined $code){
186 $self->throw_error('You must pass a defined code');
187 }
188
189 if(ref($code) ne 'CODE'){
190 $code = \&{$code}; # coerce
191 }
192
193 $self->{methods}->{$name} = $code; # Moose stores meta object here.
194
195 my $pkg = $self->name;
196 no strict 'refs';
197 no warnings 'redefine', 'once';
198 *{ $pkg . '::' . $name } = $code;
199 return;
200}
201
202
43165725 203package
204 Mouse::Meta::Class;
205
e058b279 206sub method_metaclass { $_[0]->{method_metaclass} || 'Mouse::Meta::Method' }
207sub attribute_metaclass { $_[0]->{attribute_metaclass} || 'Mouse::Meta::Attribute' }
208
209sub constructor_class { $_[0]->{constructor_class} || 'Mouse::Meta::Method::Constructor' }
210sub destructor_class { $_[0]->{destructor_class} || 'Mouse::Meta::Method::Destructor' }
4e7e3250 211
43165725 212sub is_anon_class{
213 return exists $_[0]->{anon_serial_id};
214}
215
216sub roles { $_[0]->{roles} }
217
cccb83de 218sub linearized_isa { @{ get_linear_isa($_[0]->{package}) } }
219
da4432f3 220sub get_all_attributes {
221 my($self) = @_;
047d7af0 222 my %attrs = map { %{ $self->initialize($_)->{attributes} } } reverse $self->linearized_isa;
da4432f3 223 return values %attrs;
224}
225
4e7e3250 226sub _initialize_object{
227 my($self, $object, $args, $ignore_triggers) = @_;
228
229 my @triggers_queue;
230
231 foreach my $attribute ($self->get_all_attributes) {
232 my $init_arg = $attribute->init_arg;
233 my $slot = $attribute->name;
234
235 if (defined($init_arg) && exists($args->{$init_arg})) {
236 $object->{$slot} = $attribute->_coerce_and_verify($args->{$init_arg}, $object);
237
238 weaken($object->{$slot})
239 if ref($object->{$slot}) && $attribute->is_weak_ref;
240
241 if ($attribute->has_trigger) {
242 push @triggers_queue, [ $attribute->trigger, $object->{$slot} ];
243 }
244 }
245 else { # no init arg
246 if ($attribute->has_default || $attribute->has_builder) {
247 if (!$attribute->is_lazy) {
248 my $default = $attribute->default;
249 my $builder = $attribute->builder;
250 my $value = $builder ? $object->$builder()
251 : ref($default) eq 'CODE' ? $object->$default()
252 : $default;
253
254 $object->{$slot} = $attribute->_coerce_and_verify($value, $object);
255
256 weaken($object->{$slot})
257 if ref($object->{$slot}) && $attribute->is_weak_ref;
258 }
259 }
260 elsif($attribute->is_required) {
261 $self->throw_error("Attribute (".$attribute->name.") is required");
262 }
263 }
264 }
265
266 if(!$ignore_triggers){
267 foreach my $trigger_and_value(@triggers_queue){
268 my($trigger, $value) = @{$trigger_and_value};
269 $trigger->($object, $value);
270 }
271 }
272
273 if($self->is_anon_class){
274 $object->{__METACLASS__} = $self;
275 }
276
277 return;
278}
279
280
43165725 281package
282 Mouse::Meta::Role;
283
e058b279 284sub method_metaclass{ $_[0]->{method_metaclass} || 'Mouse::Meta::Role::Method' }
285
43165725 286sub is_anon_role{
287 return exists $_[0]->{anon_serial_id};
288}
289
290sub get_roles { $_[0]->{roles} }
291
292package
293 Mouse::Meta::Attribute;
294
e058b279 295require Mouse::Meta::Method::Accessor;
296
297sub accessor_metaclass{ $_[0]->{accessor_metaclass} || 'Mouse::Meta::Method::Accessor' }
43165725 298
299# readers
300
301sub name { $_[0]->{name} }
302sub associated_class { $_[0]->{associated_class} }
303
304sub accessor { $_[0]->{accessor} }
305sub reader { $_[0]->{reader} }
306sub writer { $_[0]->{writer} }
307sub predicate { $_[0]->{predicate} }
308sub clearer { $_[0]->{clearer} }
309sub handles { $_[0]->{handles} }
310
311sub _is_metadata { $_[0]->{is} }
312sub is_required { $_[0]->{required} }
313sub default { $_[0]->{default} }
314sub is_lazy { $_[0]->{lazy} }
315sub is_lazy_build { $_[0]->{lazy_build} }
316sub is_weak_ref { $_[0]->{weak_ref} }
317sub init_arg { $_[0]->{init_arg} }
318sub type_constraint { $_[0]->{type_constraint} }
319
320sub trigger { $_[0]->{trigger} }
321sub builder { $_[0]->{builder} }
322sub should_auto_deref { $_[0]->{auto_deref} }
323sub should_coerce { $_[0]->{coerce} }
324
d899d3e7 325sub documentation { $_[0]->{documentation} }
326
43165725 327# predicates
328
329sub has_accessor { exists $_[0]->{accessor} }
330sub has_reader { exists $_[0]->{reader} }
331sub has_writer { exists $_[0]->{writer} }
332sub has_predicate { exists $_[0]->{predicate} }
333sub has_clearer { exists $_[0]->{clearer} }
334sub has_handles { exists $_[0]->{handles} }
335
336sub has_default { exists $_[0]->{default} }
337sub has_type_constraint { exists $_[0]->{type_constraint} }
338sub has_trigger { exists $_[0]->{trigger} }
339sub has_builder { exists $_[0]->{builder} }
340
d899d3e7 341sub has_documentation { exists $_[0]->{documentation} }
342
43165725 343package
344 Mouse::Meta::TypeConstraint;
345
346sub name { $_[0]->{name} }
347sub parent { $_[0]->{parent} }
348sub message { $_[0]->{message} }
349
350sub _compiled_type_constraint{ $_[0]->{compiled_type_constraint} }
351
93540011 352sub _compiled_type_coercion { $_[0]->{_compiled_type_coercion} }
df6dd016 353
93540011 354sub has_coercion{ exists $_[0]->{_compiled_type_coercion} }
df6dd016 355
f790c46b 356
357sub compile_type_constraint{
358 my($self) = @_;
359
360 # add parents first
361 my @checks;
362 for(my $parent = $self->{parent}; defined $parent; $parent = $parent->{parent}){
363 if($parent->{hand_optimized_type_constraint}){
364 unshift @checks, $parent->{hand_optimized_type_constraint};
365 last; # a hand optimized constraint must include all the parents
366 }
367 elsif($parent->{constraint}){
368 unshift @checks, $parent->{constraint};
369 }
370 }
371
372 # then add child
373 if($self->{constraint}){
374 push @checks, $self->{constraint};
375 }
376
377 if($self->{type_constraints}){ # Union
378 my @types = map{ $_->{compiled_type_constraint} } @{ $self->{type_constraints} };
379 push @checks, sub{
380 foreach my $c(@types){
381 return 1 if $c->($_[0]);
382 }
383 return 0;
384 };
385 }
386
387 if(@checks == 0){
388 $self->{compiled_type_constraint} = \&Mouse::Util::TypeConstraints::Any;
389 }
390 else{
391 $self->{compiled_type_constraint} = sub{
392 my(@args) = @_;
393 local $_ = $args[0];
394 foreach my $c(@checks){
395 return undef if !$c->(@args);
396 }
397 return 1;
398 };
399 }
400 return;
401}
402
aa2d2e2c 403package
404 Mouse::Object;
405
406
407sub BUILDARGS {
408 my $class = shift;
f790c46b 409
aa2d2e2c 410 if (scalar @_ == 1) {
411 (ref($_[0]) eq 'HASH')
412 || $class->meta->throw_error("Single parameters to new() must be a HASH ref");
413
414 return {%{$_[0]}};
415 }
416 else {
417 return {@_};
418 }
419}
f790c46b 420
af04626d 421sub new {
422 my $class = shift;
423
424 $class->meta->throw_error('Cannot call new() on an instance') if ref $class;
425
426 my $args = $class->BUILDARGS(@_);
427
428 my $meta = Mouse::Meta::Class->initialize($class);
429 my $self = $meta->new_object($args);
430
431 # BUILDALL
432 if( $self->can('BUILD') ) {
433 for my $class (reverse $meta->linearized_isa) {
434 my $build = Mouse::Util::get_code_ref($class, 'BUILD')
435 || next;
436
437 $self->$build($args);
438 }
439 }
440
441 return $self;
442}
443
a5c683f6 444sub DESTROY {
445 my $self = shift;
446
447 return unless $self->can('DEMOLISH'); # short circuit
448
449 local $?;
450
451 my $e = do{
452 local $@;
453 eval{
454
455 # DEMOLISHALL
456
457 # We cannot count on being able to retrieve a previously made
458 # metaclass, _or_ being able to make a new one during global
459 # destruction. However, we should still be able to use mro at
460 # that time (at least tests suggest so ;)
461
462 foreach my $class (@{ Mouse::Util::get_linear_isa(ref $self) }) {
463 my $demolish = Mouse::Util::get_code_ref($class, 'DEMOLISH')
464 || next;
465
466 $self->$demolish();
467 }
468 };
469 $@;
470 };
471
472 no warnings 'misc';
473 die $e if $e; # rethrow
474}
475
df6dd016 4761;
477__END__
ccb38d0b 478
479=head1 NAME
480
481Mouse::PurePerl - A Mouse guts in pure Perl
482
483=head1 VERSION
484
1e582397 485This document describes Mouse version 0.40_06
ccb38d0b 486
487=head1 SEE ALSO
488
489L<Mouse::XS>
490
491=cut