Code Index:

package MooseX::Meta::Attribute::Lvalue
- BUILD
- _install_lvalue_writer
package MooseX::Meta::Attribute::Trait::Lvalue
package Moose::Meta::Attribute::Custom::Trait::Lvalue
- register_implementation
__END__
EOF

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:

* RT: CPAN's request tracker: http://rt.cpan.org/NoAuth/Bugs.html?Dist=MooseX-Meta-Attribute-Lvalue
* AnnoCPAN: Annotated CPAN documentation: http://annocpan.org/dist/MooseX-Meta-Attribute-Lvalue
* CPAN Ratings: http://cpanratings.perl.org/d/MooseX-Meta-Attribute-Lvalue
* Search CPAN: http://search.cpan.org/dist/MooseX-Meta-Attribute-Lvalue

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

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