NAME
    Getopt::optparse - optparse style processing of command line options

    This library only supports double dash options: --

SYNOPSIS
        use Getopt::optparse;
        my $parser = Getopt::optparse->new();
        $parser->add_option(
            '--hostname', 
            {
                dest => 'hostname',
                help => 'Remote hostname',
                default => 'localhost.localdomain'
            }
        );
        $parser->add_option( 
            '--global',
            dest    => 'global',
            action  => 'store_true',
            help    => 'Show global',
            default => 0
        )
        $parser->add_option(
            '--username', 
            {
                dest   => 'username',
                action => 'append',
                help   => 'Usernames to analyze'
            }
        );
        $parser->add_option(
            '--v', 
            {
                dest   => 'verbose',
                action => 'count',
                help   => 'Increment verbosity'
            }
        );

        my $options = $parser->parse_args();
        printf("Hostname is: %s\n", $options->{hostname});
        printf("Username is: %s\n", $options->{username});
        if ($options->{global}) {

        }

DESCRIPTION
    Library which allows Python optparse style processing of command line
    options.

CONSTRUCTOR
    $parser = Getopt::optparse->new( \%options )
        Construct a new "Getopt::optparse" object and return it. Hash
        reference argument may be provided though none are required.

METHODS
    The following methods are available:

    Getopt::optparse->add_option()
            $parser->add_option(
                '--hostname',
                {
                    dest => 'hostname',
                    help => 'Remote hostname',
                    default => 'localhost.localdomain'
                }
            )

        Add option to be parsed from command line. Accepts two arguments:

        Option Name
            Value to be parsed from command line. --hostname in the above
            example. This library uses only double dash.

        Option Attributes. A hash reference.
            These may include:

            dest
                Name of key were parsed option will be stored.

            default (optional)
                Value of dest if no option is parsed on command line.

            help (optional)
                Text message displayed when --help is found on command line.

            action (optional)
                The following actions are supported.

                store_true
                    Using this makes dest true or false. (0 or 1). If the
                    option is found.

                append
                    Using this appends each occurrance of an option to an
                    array reference.

                count
                    using this increments dest by one for every occurrence.

    Getopt::optparse->parse_args()
            my $options = $parser->parse_args();
            printf("Hostname is: %s\n", $options->{hostname});
            printf("Username is: %s\n", $options->{username});

        Parse added options from command line and return their values as a
        hash reference.

AUTHOR
    Matt Hersant <matt_hersant@yahoo.com>

