package Moose::Meta::Attribute::Native::Trait::Counter;
use Moose::Role;
-our $VERSION = '1.02';
-$VERSION = eval $VERSION;
-our $AUTHORITY = 'cpan:STEVAN';
-
-use Moose::Meta::Attribute::Native::MethodProvider::Counter;
-
-with 'Moose::Meta::Attribute::Native::Trait';
-
-has 'method_provider' => (
- is => 'ro',
- isa => 'ClassName',
- predicate => 'has_method_provider',
- default => 'Moose::Meta::Attribute::Native::MethodProvider::Counter',
-);
+with 'Moose::Meta::Attribute::Native::Trait' =>
+ { -excludes => ['_root_types'] };
sub _default_default { 0 }
sub _default_is { 'ro' }
sub _helper_type { 'Num' }
+sub _root_types { 'Num', 'Int' }
no Moose::Role;
1;
+# ABSTRACT: Helper trait for Int attributes which represent counters
+
__END__
=pod
-=head1 NAME
-
-Moose::Meta::Attribute::Native::Trait::Counter - Helper trait for counters
-
=head1 SYNOPSIS
package MyHomePage;
use Moose;
has 'counter' => (
- traits => ['Counter'],
- is => 'ro',
- isa => 'Num',
- default => 0,
- handles => {
+ traits => ['Counter'],
+ is => 'ro',
+ isa => 'Num',
+ default => 0,
+ handles => {
inc_counter => 'inc',
dec_counter => 'dec',
reset_counter => 'reset',
);
my $page = MyHomePage->new();
- $page->inc_counter; # same as $page->counter( $page->counter + 1 );
- $page->dec_counter; # same as $page->counter( $page->counter - 1 );
-
+ $page->inc_counter; # same as $page->counter( $page->counter + 1 );
+ $page->dec_counter; # same as $page->counter( $page->counter - 1 );
+
my $count_by_twos = 2;
$page->inc_counter($count_by_twos);
=head1 DESCRIPTION
-This module provides a simple counter attribute, which can be
-incremented and decremented by arbitrary amounts. The default
-amount of change is one.
+This trait provides native delegation methods for counters. A counter can be
+any sort of number (integer or not). The delegation methods allow you to
+increment, decrement, or reset the value.
-=head1 PROVIDED METHODS
+=head1 DEFAULT TYPE
-These methods are implemented in
-L<Moose::Meta::Attribute::Native::MethodProvider::Counter>. It is important to
-note that all those methods do in place modification of the value stored in
-the attribute.
+If you don't provide an C<isa> value for your attribute, it will default to
+C<Num>.
-=over 4
+=head1 PROVIDED METHODS
-=item B<set($value)>
+=over 4
-Set the counter to the specified value.
+=item * B<set($value)>
-=item B<inc($arg)>
+Sets the counter to the specified value and returns the new value.
-Increase the attribute value by the amount of the argument.
-No argument increments the value by 1.
+This method requires a single argument.
-=item B<dec($arg)>
+=item * B<inc>
-Decrease the attribute value by the amount of the argument.
-No argument decrements the value by 1.
+=item * B<inc($arg)>
-=item B<reset>
+Increases the attribute value by the amount of the argument, or by 1 if no
+argument is given. This method returns the new value.
-Resets the value stored in this slot to it's default value.
+This method accepts a single argument.
-=back
+=item * B<dec>
-=head1 METHODS
+=item * B<dec($arg)>
-=over 4
+Decreases the attribute value by the amount of the argument, or by 1 if no
+argument is given. This method returns the new value.
-=item B<meta>
+This method accepts a single argument.
-=item B<method_provider>
+=item * B<reset>
-=item B<has_method_provider>
+Resets the value stored in this slot to its default value, and returns the new
+value.
=back
See L<Moose/BUGS> for details on reporting bugs.
-=head1 AUTHOR
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=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.
-
=cut