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
|
use strict;
use warnings;
package App::Cmd::Subdispatch::DashedStyle 0.338;
use App::Cmd::Subdispatch;
BEGIN { our @ISA = 'App::Cmd::Subdispatch' };
# ABSTRACT: "app cmd --subcmd" style subdispatching
#pod =method get_command
#pod
#pod my ($subcommand, $opt, $args) = $subdispatch->get_command(@args)
#pod
#pod A version of get_command that chooses commands as options in the following
#pod style:
#pod
#pod mytool mycommand --mysubcommand
#pod
#pod =cut
sub get_command {
my ($self, @args) = @_;
my (undef, $opt, @sub_args)
= $self->App::Cmd::Command::prepare($self->app, @args);
if (my $cmd = delete $opt->{subcommand}) {
delete $opt->{$cmd}; # useless boolean
return ($cmd, $opt, @sub_args);
} else {
return (undef, $opt, @sub_args);
}
}
#pod =method opt_spec
#pod
#pod A version of C<opt_spec> that calculates the getopt specification from the
#pod subcommands.
#pod
#pod =cut
sub opt_spec {
my ($self, $app) = @_;
my $subcommands = $self->_command;
my %plugins = map {
$_ => [ $_->command_names ],
} values %$subcommands;
foreach my $opt_spec (values %plugins) {
$opt_spec = join("|", grep { /^\w/ } @$opt_spec);
}
my @subcommands = map { [ $plugins{$_} => $_->abstract ] } keys %plugins;
return (
[ subcommand => hidden => { one_of => \@subcommands } ],
$self->global_opt_spec($app),
{ getopt_conf => [ 'pass_through' ] },
);
}
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
App::Cmd::Subdispatch::DashedStyle - "app cmd --subcmd" style subdispatching
=head1 VERSION
version 0.338
=head1 PERL VERSION
This library should run on perls released even a long time ago. It should
work on any version of perl released in the last five years.
Although it may work on older versions of perl, no guarantee is made that the
minimum required version will not be increased. The version may be increased
for any reason, and there is no promise that patches will be accepted to
lower the minimum required perl.
=head1 METHODS
=head2 get_command
my ($subcommand, $opt, $args) = $subdispatch->get_command(@args)
A version of get_command that chooses commands as options in the following
style:
mytool mycommand --mysubcommand
=head2 opt_spec
A version of C<opt_spec> that calculates the getopt specification from the
subcommands.
=head1 AUTHOR
Ricardo Signes <cpan@semiotic.systems>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2025 by Ricardo Signes.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|
