NAME

Config::Layered::Source::Getopt - The Command Line Source

DESCRIPTION

The Getopt source provides access to Getopt::Long and will configure it based on the default data structure.

The configuration of the Getopt::Long options is done in the following way:

• If the default value of a key is 0 or 1, it is treated as a boolean, and the key! directive is used. This will enable --no* options to work as expected.

• If the value is a hash reference, the key% directive is used, and options are configured as --key name=value. New hash keys will be added, previously used hash keys (i.e. default configuration, previously run sources) will be replaced.

• If the value if an array reference, the key@ directive is used, and options are configured as --key value --key value. An array entered by this source will replace a previously entered array (i.e. default configuration, previous run sources).

• All other situations will result in a simple string, key=s.

EXAMPLE

    my $config = Config::Layered->load_config( 
        sources => [ 'ConfigAny' => { file => "/etc/myapp" } ],
        default => {
            foo         => "bar",
            blee        => 1,
            size        => 20,
            bax         => { chicken => "eggs", }
            baz         => [ wq( foo bar blee ) ]
        }
    );

The above data structure would create the following Getopt::Long configuration:

    Getopts( \%config,
        "foo=s",
        "blee!",
        "size",
        "bax%",
        "baz@",
    );
    

SOURCE ARGUMENTS

• None