NAME

Getopt::WonderBra - Lift and Separate Command Line Options

SYNOPSIS

use Getopt::WonderBra;
@ARGV = getopt( 'opts:-:', @ARGV );

sub help() { print "Useless help message"; };
sub version() { print "Useless version message"; };
while ( ( $_ = shift ) ne '--' ) {
	if    (/^-o$/) { $opt_o++ }
	elsif (/^-p$/) { $opt_p++ }
	elsif (/^-t$/) { $opt_t++ }
	elsif (/^-s$/) { push( @opt_s, shift ); }
	elsif (/^--/)  { push( @opt_long, $_ ); }
	else           { die 'I do not grok -', $_; }
}
print "-o given $opt_o times" if $opt_o;
print "-p given $opt_p times" if $opt_p;
print "-t given $opt_t times" if $opt_t;
print "-s given with arg $_" for @opt_s;
print "long opt $_ given" for @opt_long;
print "";
print "  param: $_" for @ARGV;

REQUIRES

perl5.008006, Carp, Exporter

EXPORTS

getopt($@)

DESCRIPTION

See eg/WonderBra.pl for an example of usage.

There just weren't enough command line processessing modules, so I had to write my own. Actually, it exists because it made it easy to port shell scripts to perl: it acts just like the getopt program. Oddly, none of the modules that are actually named after it do. (Though some act like the C function) The following sequence chops your args up and gives 'em to you straight:

HELP

main::help() must exist prior to calling getopt(). It is wrapped by this module. This is done to ensure correct behavior for programs that use getopt. (e.g. error messages to stdout if --help in specified, so $ foo --help | less has the desired results)

main::help() is replaced by a wrapper that will exit the program. If it gets args, it will select STDERR, call your help function, print the passed args, and exit non-zero.

Otherwise, it will select STDOUT, call your help function, and exit non-zero.

Note that the program will exit if you call help after calling getopt, as well. This is not a bug. It's for issuing error messages while handling the parsed args.

The wrapper sub never returns.

VERSION

If you define a main::version() sub, it will be called if the user specified --version, and the program will terminate.

STDOUT will always be selected.