NAME

       Test2::Harness::Settings - Configuration settings for Test2::Harness.

DESCRIPTION

       This module represents the options provided at the command line. Each option has a prefix,
       and each prefix can be accessed from the settings.

SYNOPSIS

           # You will rarely if ever need to construct settings yourself, usually a
           # component of Test2::Harness will expose them to you.
           my $settings = $thing->settings;

           # All prefixes have a method generated for them via AUTOLOAD
           my $display = $settings->display;

           # You can also use the prefix method
           my $display = $settings->prefix('display');

           # The prefix can be used in a similar way
           my $verbose = $settings->display->verbose;

       See Test2::Harness::Settings::Prefix for more details on how to use the prefixes.

METHODS

       Note that any prefix that does not conflict with the predefined methods can be accessed
       via AUTOLOAD generating the methods as needed.

       $settings->define_prefix($prefix_name)
           This is used to create a prefix.

       $bool = $settings->check_prefix($prefix_name)
           This is used to check if a prefix is defined or not.

       $prefix = $settings->prefix($prefix_name)
       $prefix = $settings->$prefix_name
           This will retrieve a prefix if it exists. If the prefix is not defined this will throw
           an exception. If you are unsure if a prefix exists use
           "$settings-"check_prefix($prefix_name)>.

       $thing = $settings->build($prefix_name, $class, @args)
           This will create an instance of $class passing the key/value pairs from the specified
           prefix as arguments. Additional arguments can be provided in @args.

       $hashref = $settings->TO_JSON()
           This method allows settings to be serialized into JSON.

SOURCE

       The source code repository for Test2-Harness can be found at
       http://github.com/Test-More/Test2-Harness/.

MAINTAINERS

       Chad Granum <exodist@cpan.org>

AUTHORS

       Chad Granum <exodist@cpan.org>

COPYRIGHT

       Copyright 2020 Chad Granum <exodist7@gmail.com>.

       This program is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.

       See http://dev.perl.org/licenses/