Christopher Brown > MooseX-Meta-Attribute-Lvalue-0.05 > MooseX::Meta::Attribute::Lvalue

Download:
MooseX-Meta-Attribute-Lvalue-0.05.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.05   Source  

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.

syntax highlighting: