NAME
MooseX::LvalueAttribute - lvalue attributes for Moose
SYNOPSIS
package MyThing;
use Moose;
use MooseX::LvalueAttribute;
has name => (
traits => ['Lvalue'],
is => 'rw',
isa => 'Str',
required => 1,
);
has size => (
traits => ['Lvalue'],
is => 'rw',
isa => 'Int',
default => 0,
);
package main;
my $thing = MyThing->new(name => 'Foo');
$thing->name = "Bar";
print $thing->name; # Bar
$thing->size++;
print $thing->size; # 1
DESCRIPTION
This package provides a Moose attribute trait that provides Lvalue accessors. Which means that instead of writing:
$thing->name("Foo");
You can use the more natural looking:
$thing->name = "Foo";
For details of Lvalue implementation in Perl, please see: http://perldoc.perl.org/perlsub.html#Lvalue-subroutines
Type constraints and coercions still work for lvalue attributes. Triggers still fire. Everything should just work. (Unless it doesn't.)
You can optionally import a constants called lvalue
that expands to the full name of the attribute trait, allowing:
use MooseX::LvalueAttribute 'lvalue';
has name => (
traits => [ lvalue ],
is => 'rw',
isa => 'Str',
required => 1,
);
This may allow Moose to compile your attribute very, very, slightly faster, but the main advantage is aesthetic.
BUGS
Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=MooseX-LvalueAttribute.
SEE ALSO
MooX::LvalueAttribute, Object::Tiny::Lvalue.
AUTHOR
Toby Inkster <tobyink@cpan.org>.
Based on work by Christopher Brown, <cbrown at opendatagroup.com>
COPYRIGHT AND LICENCE
This software is copyright (c) 2013 by Toby Inkster; 2008 by Christopher Brown.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
DISCLAIMER OF WARRANTIES
THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.