package MooseX::UndefTolerant::Attribute;
use Moose::Role;
-around('initialize_instance_slot', sub{
+around('initialize_instance_slot', sub {
my $orig = shift;
my $self = shift;
- # If the parameter passed in was undef, quietly do nothing but return
- return unless defined($_->[2]);
+ my $ia = $self->init_arg;
- # If it was defined, call the real init slot method
+ # $_[2] is the hashref of options passed to the constructor. If our
+ # parameter passed in was undef, pop it off the args...
+ pop unless (defined $ia && defined($_[2]->{$ia}));
+
+ # Invoke the real init, as the above line cleared the unef
$self->$orig(@_)
});
-1;
\ No newline at end of file
+1;
+
+# ABSTRACT: Make your attribute(s) tolerant to undef intitialization
+
+__END__
+
+=head1 SYNOPSIS
+
+ package My:Class;
+ use Moose;
+
+ use MooseX::UndefTolerant::Attribute;
+
+ has 'bar' => (
+ traits => [ qw(MooseX::UndefTolerant::Attribute)],
+ is => 'ro',
+ isa => 'Num',
+ predicate => 'has_bar'
+ );
+
+ # Meanwhile, under the city...
+
+ # Doesn't explode
+ my $class = My::Class->new(bar => undef);
+ $class->has_bar # False!
+
+=head1 DESCRIPTION
+
+Applying this trait to your attribute makes it's initialization tolerant of
+of undef. If you specify the value of undef to any of the attributes they
+will not be initialized (or will be set to the default, if applicable).
+Effectively behaving as if you had not provided a value at all.
+
+=cut