/ 
MooseX-Meta-Attribute-Lvalue-0.05
River stage zero No dependents
/ MooseX::Meta::Attribute::Lvalue

NAME

MooseX::Meta::Attribute::Lvalue - Immplements lvalue attributes via meta-attribute trait

VERSION

Version 0.04

SYNOPSIS

package App;
    use Moose;
    with 'MooseX::Meta::Attribute::Lvalue';

    has 'name' => (
        is          => 'rw' ,
        isa         => 'Str' ,
        required    => 1 ,
        traits      => [ 'Lvalue' ] ,   # REQUIRED
    );


package main;
    my $app = App->new( name => 'Foo' );

    $app->name = "Bar";      
    print $app->name;       # Bar

DESCRIPTION

WARNING: This module provides syntactic sugar at the expense of some Moose's encapsulation. The Moose framework does not support type checking of Lvalue attributes. You should only use this role when the convenience of the Lvalue attributes outweighs the need to type checking.

This package provides a Moose meta attribute via a role/trait that provides Lvalue accessors to your Moose attributes. Which means that instead of writing:

$myclass->name( "Foo" );

You can use the more functional and natural appearing:

$myclass->name = "Foo";

For details of Lvalue implementation in Perl, please see: http://perldoc.perl.org/perlsub.html#Lvalue-subroutines

INTERNAL METHODS

_install_lvalue_writer

This method does the work of installing lvalue writers for attributes that are: 1) read-write 2) the attribute does MooseX::Meta::Attribute::Trait::Lvalue

BUILD

This is a dummy sub that does nothing. It allows the method modifier 'after BUILD' which installs the lvalue writer subs.

EXPORT

None by default.

AUTHOR

Christopher Brown, <cbrown at opendatagroup.com>

BUGS

Please report any bugs or feature requests to bug-moosex-attribute-lvalue at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=MooseX-Attribute-Lvalue. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc MooseX::Meta::Attribute::Lvalue

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2008 Christopher Brown, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.