1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
package MooseX::Getopt::Meta::Attribute;
use Moose;
use Moose::Util::TypeConstraints;
our $VERSION = '0.05';
our $AUTHORITY = 'cpan:STEVAN';
extends 'Moose::Meta::Attribute'; # << Moose extending Moose :)
with 'MooseX::Getopt::Meta::Attribute::Trait';
no Moose;
# register this as a metaclass alias ...
package # stop confusing PAUSE
Moose::Meta::Attribute::Custom::Getopt;
sub register_implementation { 'MooseX::Getopt::Meta::Attribute' }
1;
__END__
=pod
=head1 NAME
MooseX::Getopt::Meta::Attribute - Optional meta attribute for custom option names
=head1 SYNOPSIS
package App;
use Moose;
with 'MooseX::Getopt';
has 'data' => (
metaclass => 'MooseX::Getopt::Meta::Attribute',
is => 'ro',
isa => 'Str',
default => 'file.dat',
# tells MooseX::Getopt to use --somedata as the
# command line flag instead of the normal
# autogenerated one (--data)
cmd_flag => 'somedata',
# tells MooseX::Getopt to also allow --moosedata,
# -m, and -d as aliases for this same option on
# the commandline.
cmd_aliases => [qw/ moosedata m d /],
# Or, you can use a plain scalar for a single alias:
cmd_aliases => 'm',
);
=head1 DESCRIPTION
This is a custom attribute metaclass which can be used to specify a
the specific command line flag to use instead of the default one
which L<MooseX::Getopt> will create for you.
This is certainly not the prettiest way to go about this, but for
now it works for those who might need such a feature.
=head2 Custom Metaclass alias
This now takes advantage of the Moose 0.19 feature to support
custom attribute metaclass aliases. This means you can also
use this as the B<Getopt> alias, like so:
has 'foo' => (metaclass => 'Getopt', cmd_flag => 'f');
=head1 METHODS
These methods are of little use to most users, they are used interally
within L<MooseX::Getopt>.
=over 4
=item B<cmd_flag>
Changes the commandline flag to be this value, instead of the default,
which is the same as the attribute name.
=item B<cmd_aliases>
Adds more aliases for this commandline flag, useful for short options
and such.
=item B<has_cmd_flag>
=item B<has_cmd_aliases>
=item B<meta>
=back
=head1 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.
=head1 AUTHOR
Stevan Little E<lt>stevan@iinteractive.comE<gt>
Brandon L. Black, E<lt>blblack@gmail.comE<gt>
=head1 COPYRIGHT AND LICENSE
Copyright 2007-2008 by Infinity Interactive, Inc.
L<http://www.iinteractive.com>
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
=cut
|
