add shallow_clone to Array and Hash traits
[gitmo/Moose.git] / lib / Moose / Meta / Attribute / Native / Trait / Bool.pm
index 20cf24c..1b60fc8 100644 (file)
 package Moose::Meta::Attribute::Native::Trait::Bool;
 use Moose::Role;
-use Moose::Meta::Attribute::Native::MethodProvider::Bool;
-
-our $VERSION   = '0.87';
-$VERSION = eval $VERSION;
-our $AUTHORITY = 'cpan:STEVAN';
 
 with 'Moose::Meta::Attribute::Native::Trait';
 
-sub _default_is { 'rw' }
+sub _default_is  { 'rw' }
 sub _helper_type { 'Bool' }
 
-# NOTE: we don't use the method provider for this module since many of
-# the names of the provided methods would conflict with keywords - SL
-
-has 'method_provider' => (
-    is        => 'ro',
-    isa       => 'ClassName',
-    predicate => 'has_method_provider',
-    default   => 'Moose::Meta::Attribute::Native::MethodProvider::Bool'
-);
-
 no Moose::Role;
 
 1;
 
-=pod
+# ABSTRACT: Helper trait for Bool attributes
 
-=head1 NAME
+__END__
 
-Moose::Meta::Attribute::Native::Trait::Bool
+=pod
 
 =head1 SYNOPSIS
 
   package Room;
   use Moose;
-  use Moose::AttributeHelpers;
 
   has 'is_lit' => (
-      metaclass => 'Bool',
-      is        => 'rw',
-      isa       => 'Bool',
-      default   => 0,
-      handles   => {
+      traits  => ['Bool'],
+      is      => 'rw',
+      isa     => 'Bool',
+      default => 0,
+      handles => {
           illuminate  => 'set',
           darken      => 'unset',
           flip_switch => 'toggle',
           is_dark     => 'not',
-      }
+      },
   );
 
   my $room = Room->new();
-  $room->illuminate;     # same as $room->is_lit(1);
-  $room->darken;         # same as $room->is_lit(0);
-  $room->flip_switch;    # same as $room->is_lit(not $room->is_lit);
-  return $room->is_dark; # same as !$room->is_lit
+  $room->illuminate;        # same as $room->is_lit(1);
+  $room->darken;            # same as $room->is_lit(0);
+  $room->flip_switch;       # same as $room->is_lit(not $room->is_lit);
+  return $room->is_dark;    # same as !$room->is_lit
 
 =head1 DESCRIPTION
 
-This provides a simple boolean attribute, which supports most of the
-basic math operations.
-
-=head1 METHODS
-
-=over 4
-
-=item B<meta>
-
-=item B<method_constructors>
+This trait provides native delegation methods for boolean values. A boolean is
+a scalar which can be C<1>, C<0>, C<"">, or C<undef>.
 
-=item B<has_method_provider>
+=head1 DEFAULT TYPE
 
-=item B<method_provider>
-
-=back
+If you don't provide an C<isa> value for your attribute, it will default to
+C<Bool>.
 
 =head1 PROVIDED METHODS
 
-It is important to note that all those methods do in place
-modification of the value stored in the attribute.
+None of these methods accept arguments.
 
 =over 4
 
-=item I<set>
+=item * B<set>
+
+Sets the value to C<1> and returns C<1>.
 
-Sets the value to C<1>.
+=item * B<unset>
 
-=item I<unset>
+Set the value to C<0> and returns C<0>.
 
-Set the value to C<0>.
+=item * B<toggle>
 
-=item I<toggle>
+Toggles the value. If it's true, set to false, and vice versa.
 
-Toggle the value. If it's true, set to false, and vice versa.
+Returns the new value.
 
-=item I<not>
+=item * B<not>
 
 Equivalent of 'not C<$value>'.
 
@@ -102,21 +78,6 @@ Equivalent of 'not C<$value>'.
 
 =head1 BUGS
 
-All complex software has bugs lurking in it, and this module is no
-exception. If you find a bug please either email me, or add the bug
-to cpan-RT.
-
-=head1 AUTHOR
-
-Jason May
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2007-2009 by Infinity Interactive, Inc.
-
-L<http://www.iinteractive.com>
-
-This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself.
+See L<Moose/BUGS> for details on reporting bugs.
 
 =cut