MooseX::App::Meta::Role::Attribute::Option - Meta attribute role for options
This meta attribute role will automatically be applied to all attributes that should be used as options.
In your app and command classes you can use the following attributes in option or parameter definitions.
option 'myoption' => ( is => 'rw', isa => 'ArrayRef[Str]', documentation => 'My special option', cmd_flag => 'myopt', cmd_aliases => [qw(mopt localopt)], cmd_tags => [qw(Important!)], cmd_position => 1, cmd_split => qr/,/, );
Use this name instead of the attribute name as the option name
Option to mark if this attribute should be used as an option or parameter value.
Allowed values are:
option - Command line option
proto - Command line option that should be processed prior to other options (eg. a config-file option that sets other attribues) Usually only used for plugin developmemt
parameter - Positional parameter command line value
Arrayref of alternative option names
Extra option tags displayed in the usage information (in brackets)
Override the order of the parameters in the usage message.
Splits multiple values at the given separator string or regular expression. Only works in conjunction with an 'ArrayRef[*]' type constraint (isa).
These methods are only of interest to plugin authors.
my @names = $attribute->cmd_name_possible();
Returns a list of all possible option names.
my $name = $attribute->cmd_name_primary();
Returns the primary option name
my $name = $attribute->cmd_usage_name();
Returns the name as used by the usage text
my $name = $attribute->cmd_usage_description();
Returns the description as used by the usage text
my @tags = $attribute->cmd_tags_list();
Returns a list of tags
my $bool = $attribute->cmd_is_bool();
Returns true, false or undef depending on the type constraint and default of the attribute:
undef: Does not have a boolean type constraint
true: Has a boolean type constraint
false: Has a boolean type constraint, and a true default value
To install MooseX::App, copy and paste the appropriate command in to your terminal.
cpanm
cpanm MooseX::App
CPAN shell
perl -MCPAN -e shell install MooseX::App
For more information on module installation, please visit the detailed CPAN module installation guide.