Unix and Linux Discussions Tagged with usage |
|
Thread / Thread Starter |
Last Post |
Replies |
Views |
Forum |
|
|
|
5 |
11,982 |
UNIX for Advanced & Expert Users |
|
|
|
6 |
9,365 |
UNIX for Advanced & Expert Users |
|
|
|
3 |
14,494 |
UNIX for Advanced & Expert Users |
|
|
|
2 |
5,360 |
UNIX for Beginners Questions & Answers |
|
|
|
7 |
6,494 |
Shell Programming and Scripting |
|
|
|
0 |
2,560 |
UNIX for Beginners Questions & Answers |
|
|
|
2 |
3,128 |
Programming |
|
|
|
10 |
9,219 |
Ubuntu |
|
|
|
5 |
1,304 |
Shell Programming and Scripting |
|
|
|
8 |
14,986 |
Shell Programming and Scripting |
|
|
|
4 |
1,783 |
UNIX for Beginners Questions & Answers |
|
|
|
3 |
1,315 |
UNIX for Beginners Questions & Answers |
|
|
|
5 |
2,866 |
UNIX for Advanced & Expert Users |
|
|
|
2 |
7,397 |
UNIX for Advanced & Expert Users |
|
|
|
7 |
16,023 |
UNIX for Dummies Questions & Answers |
|
|
|
2 |
2,296 |
Red Hat |
|
|
|
1 |
7,223 |
UNIX for Dummies Questions & Answers |
|
|
|
2 |
5,864 |
Filesystems, Disks and Memory |
|
|
|
0 |
2,216 |
OS X Support RSS |
|
|
|
6 |
7,898 |
Shell Programming and Scripting |
|
|
|
4 |
14,367 |
HP-UX |
|
|
|
0 |
2,999 |
UNIX and Linux RSS News |
|
|
|
3 |
6,601 |
AIX |
|
|
|
2 |
5,369 |
Programming |
|
|
|
2 |
2,252 |
UNIX for Dummies Questions & Answers |
|
|
|
4 |
2,313 |
Shell Programming and Scripting |
|
|
|
8 |
5,899 |
Shell Programming and Scripting |
|
|
|
2 |
3,521 |
UNIX and Linux Applications |
|
|
|
2 |
5,839 |
UNIX for Dummies Questions & Answers |
|
|
|
0 |
2,337 |
Solaris BigAdmin RSS |
|
|
|
5 |
3,308 |
UNIX for Dummies Questions & Answers |
|
|
|
6 |
1,990 |
Shell Programming and Scripting |
|
|
|
28 |
9,947 |
UNIX for Dummies Questions & Answers |
|
|
|
5 |
2,976 |
Shell Programming and Scripting |
|
|
|
7 |
40,119 |
UNIX for Advanced & Expert Users |
|
|
|
7 |
20,771 |
Shell Programming and Scripting |
|
|
|
6 |
4,060 |
UNIX for Advanced & Expert Users |
|
|
|
14 |
32,577 |
Gentoo |
|
|
|
3 |
4,602 |
UNIX for Advanced & Expert Users |
|
|
|
8 |
5,656 |
Programming |
Getopt::Usaginator(3pm) User Contributed Perl Documentation Getopt::Usaginator(3pm)
NAME
Getopt::Usaginator - Conjure up a usage function for your applications
VERSION
version 0.0012
SYNOPSIS
use Getopt::Usaginator <<_END_;
Usage: xyzzy <options>
--derp Derp derp derp
--durp Durp durp durp
-h, --help This usage
_END_
# The 'usage' subroutine is now installed
...
$options = parse_options( @ARGV ); # Not supplied by Usaginator
usage if $options{help}; # Print usage and exit with status 0
if ( ! $options{derp} ) {
# Print warning and usage and exit with status -1
usage "You should really derp";
}
if ( $options{durp} ) {
# Print warning and usage and exit with status 2
usage 2 => "--durp is not ready yet";
}
...
usage 3 # Print usage and exit with status 3
DESCRIPTION
Getopt::Usaginator is a tool for creating a handy usage subroutine for commandline applications
It does not do any option parsing, but is best paired with Getopt::Long or any of the other myriad of option parsers
USAGE
use Getopt::Usaginator <usage>
Install a "usage" subroutine configured with the <usage> text
$code = Getopt::Usaginator->usaginator( <usage> )
Return a subroutine configured with the <usage> text
...
More advanced usage is possible, peek under the hood for more information
perldoc -m Getopt::Usaginator
An example:
use Getopt::Usaginator
# Called with the error
error => sub { ... },
# Called when usage printing is needed
usage => sub { ... },
...
;
An example with Getopt::Long parsing
use Getopt::Usaginator ...
sub run {
my $self = shift;
my @arguments = @_;
usage 0 unless @arguments;
my ( $help );
{
local @ARGV = @arguments;
GetOptions(
'help|h|?' => $help,
);
}
usage 0 if $help;
...
}
AUTHOR
Robert Krimen <robertkrimen@gmail.com>
COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Robert Krimen.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
perl v5.10.1 2010-06-05 Getopt::Usaginator(3pm)