Aran Clary Deltac > MooseX-SingleArg-0.04 > MooseX::SingleArg

Download:
MooseX-SingleArg-0.04.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.04   Source  

NAME ^

MooseX::SingleArg - No-fuss instantiation of Moose objects using a single argument.

SYNOPSIS ^

    package Person;
    use Moose;
    
    use MooseX::SingleArg;
    
    single_arg 'name';
    
    has name => ( is=>'ro', isa=>'Str' );
    
    my $john = Person->new( 'John Doe' );
    print $john->name();

DESCRIPTION ^

This module allows Moose instances to be constructed with a single argument. Your class or role must use this module and then use the single_arg method to declare which attribute will be assigned the single argument value.

If the class is constructed using the typical argument list name/value pairs, or with a hashref, then things work as is usual. But, if the arguments are a single non-hashref value then that argument will be assigned to whatever attribute you have declared.

The reason for this module's existence is that when people want this feature they usually find Moose::Cookbook::Basics::Recipe10 which asks that something like the following be written:

    around BUILDARGS => sub{
        my $orig = shift;
        my $self = shift;
        
        if (@_==1 and ref($_[0]) ne 'HASH') {
            return $self->$orig( foo => $_[0] );
        }
        
        return $self->$orig( @_ );
    };

The above is complex boilerplate for a simple feature. This module aims to make it simple and fool-proof to support single-argument Moose object construction.

FORCING SINGLE ARG PROCESSING ^

An optional force parameter may be specified:

    single_arg name => (
        force => 1,
    );

This causes constructor argument processing to only work in single-argument mode. If more than one argument is passed then an error will be thrown. The benefit of forcing single argument processing is that hashrefs may now be used as the value of the single argument when force is on.

SEE ALSO ^

MooseX::OneArgNew solves the same problem that this module solves. I considered using OneArgNew for my own needs, but found it oddly combersom and confusing. Maybe thats just me, but I hope that this module's design is much simpler to comprehend and more natural to use.

AUTHOR ^

Aran Clary Deltac <bluefeet@gmail.com>

LICENSE ^

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

syntax highlighting: