X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FMooseX%2FAttributeHelpers%2FCounter.pm;h=38d98751e03bcbca082ab86c685d2183be3f1db8;hb=refs%2Ftags%2F0.17;hp=0e8fb70ba37f1aca1e1dc0f9d92f154c7b6f1730;hpb=21c7045b59fb515ba35d15a0314939b58dd51284;p=gitmo%2FMooseX-AttributeHelpers.git diff --git a/lib/MooseX/AttributeHelpers/Counter.pm b/lib/MooseX/AttributeHelpers/Counter.pm index 0e8fb70..38d9875 100644 --- a/lib/MooseX/AttributeHelpers/Counter.pm +++ b/lib/MooseX/AttributeHelpers/Counter.pm @@ -1,35 +1,52 @@ package MooseX::AttributeHelpers::Counter; use Moose; -use Moose::Util::TypeConstraints; -our $VERSION = '0.01'; +our $VERSION = '0.17'; +$VERSION = eval $VERSION; our $AUTHORITY = 'cpan:STEVAN'; +use MooseX::AttributeHelpers::MethodProvider::Counter; + extends 'MooseX::AttributeHelpers::Base'; +has '+method_provider' => ( + default => 'MooseX::AttributeHelpers::MethodProvider::Counter' +); + sub helper_type { 'Num' } -has '+method_constructors' => ( - default => sub { - return +{ - inc => sub { - my $attr = shift; - return sub { $attr->set_value($_[0], $attr->get_value($_[0]) + 1) }; - }, - dec => sub { - my $attr = shift; - return sub { $attr->set_value($_[0], $attr->get_value($_[0]) - 1) }; - }, - } +before 'process_options_for_provides' => sub { + my ($self, $options, $name) = @_; + + # Set some default attribute options here unless already defined + if ((my $type = $self->helper_type) && !exists $options->{isa}){ + $options->{isa} = $type; } -); + $options->{is} = 'ro' unless exists $options->{is}; + $options->{default} = 0 unless exists $options->{default}; +}; + +after 'check_provides_values' => sub { + my $self = shift; + my $provides = $self->provides; + + unless (scalar keys %$provides) { + my $method_constructors = $self->method_constructors; + my $attr_name = $self->name; + + foreach my $method (keys %$method_constructors) { + $provides->{$method} = ($method . '_' . $attr_name); + } + } +}; + no Moose; -no Moose::Util::TypeConstraints; # register the alias ... -package Moose::Meta::Attribute::Custom::Counter; +package # hide me from search.cpan.org + Moose::Meta::Attribute::Custom::Counter; sub register_implementation { 'MooseX::AttributeHelpers::Counter' } 1; @@ -46,15 +63,17 @@ MooseX::AttributeHelpers::Counter package MyHomePage; use Moose; + use MooseX::AttributeHelpers; has 'counter' => ( metaclass => 'Counter', - is => 'rw', - isa => 'Int', + is => 'ro', + isa => 'Num', default => sub { 0 }, provides => { inc => 'inc_counter', dec => 'dec_counter', + reset => 'reset_counter', } ); @@ -64,8 +83,66 @@ MooseX::AttributeHelpers::Counter =head1 DESCRIPTION +This module provides a simple counter attribute, which can be +incremented and decremeneted. + +If your attribute definition does not include any of I, I, +I or I but does use the C metaclass, +then this module applies defaults as in the L +above. This allows for a very basic counter definition: + + has 'foo' => (metaclass => 'Counter'); + $obj->inc_foo; + =head1 METHODS +=over 4 + +=item B + +=item B + +=item B + +=item B + +=item B + +Run before its superclass method. + +=item B + +Run after its superclass method. + +=back + +=head1 PROVIDED METHODS + +It is important to note that all those methods do in place +modification of the value stored in the attribute. + +=over 4 + +=item I + +Set the counter to the specified value. + +=item I + +Increments the value stored in this slot by 1. Providing an argument will +cause the counter to be increased by specified amount. + +=item I + +Decrements the value stored in this slot by 1. Providing an argument will +cause the counter to be increased by specified amount. + +=item I + +Resets the value stored in this slot to it's default value. + +=back + =head1 BUGS All complex software has bugs lurking in it, and this module is no @@ -78,11 +155,11 @@ Stevan Little Estevan@iinteractive.comE =head1 COPYRIGHT AND LICENSE -Copyright 2007 by Infinity Interactive, Inc. +Copyright 2007-2008 by Infinity Interactive, Inc. L This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. -=cut \ No newline at end of file +=cut