NAME

MooseX::Role::Cmd::Meta::Attribute::Trait - Optional meta attribute trait for custom option names

SYNOPSIS

    package MyApp::Cmd::SomeScript;
    
    with 'MooseX::Role::Cmd';
    
    has 'basic'   => (
        isa             => 'Str',
        is              => 'rw',
    );
    
    has 'prefix'   => (
        traits          => [ 'CmdOpt' ],
        isa             => 'Str',
        is              => 'rw',
        cmdopt_prefix   => '-',
    );
    
    has 'rename'   => (
        traits          => [ 'CmdOpt' ],
        isa             => 'Str',
        is              => 'rw',
        cmdopt_name     => '+alt_name',
    );
    
    
    $cmd = MyApp::Cmd::SomeScript->new( basic => 'foo', prefix => 'bar', rename => 'foobar' );
    
    $cmd->run();
    
    # somescript --basic foo -prefix bar +alt_name foobar

DESCRIPTION

Provides some extra markup to help MooseX::Role::Cmd decide how to use command line parameters.

ATTRIBUTES

cmdopt_prefix

Forces the command prefix to be a certain character. This was introduced to allow parameters to be specified as "-param" or "--param"

has_cmdopt_prefix

Test for attribute above

cmdopt_name

Forces the command options name to be the passed string. This was introduced to allow parameters to have a different name to the attribute.

This option will override the cmdopt_prefix attribute.

has_cmdopt_name

Test for attribute above

cmdopt_env

This attribute trait can be used to specify an environment variable rather than a command line option.

    has 'home_dir' => (
        traits => [ 'CmdOpt' ],
        is => 'rw',
        isa => 'Str',
        cmdopt_env => 'APP_HOME',
        default => '/my/app/home'
    );
    
    # $ENV{APP_HOME} = /my/app/home

has_cmdopt_env

Test for attribute above

BUGS

All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to cpan-RT.

AUTHOR

Ian Sillitoe <ian.sillitoe@gmail.com>

SEE ALSO

The idea for this code was ripped kicking and screaming from MooseX::Getopt::Meta::Attribute::Trait

COPYRIGHT AND LICENSE

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