C<config> is a HoH (hashes of hashrefs) produced by reading an INI (IOD)
configuration file using modules like L<Config::IOD::Reader>.
Hashref argument C<args> will be set by parameters in C<config>, while C<plugins>
will be set by parameters in C<[plugin=...]> sections in C<config>. For example,
with this configuration:
arg1=val1
arg2=val2
-special_arg1=val3
-special_arg2=val4
[plugin=DumpArgs]
-event=before_validation
[plugin=Foo]
arg1=val1
C<args> will become:
{
arg1=>"val1",
arg2=>"val2",
-special_arg1=>"val3",
-special_arg2=>"val4",
}
and C<plugins> will become:
[
'DumpArgs@before_validation' => {},
Foo => {arg1=>val},
]
This function is not exported by default, but exportable.
Arguments ('*' denotes required arguments):
=over 4
=item * B<args> => I<hash>
=item * B<common_opts> => I<any>
=item * B<config> => I<any>
=item * B<config_profile> => I<any>
=item * B<meta> => I<any>
=item * B<meta_is_normalized> => I<any>
=item * B<plugins> => I<array>
=item * B<r> => I<any>
=item * B<subcommand_name> => I<any>
=back
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status code
(200 means OK, 4xx caller error, 5xx function error). Second element
($reason) is a string containing error message, or something like "OK" if status is
200. Third element ($payload) is the actual result, but usually not present when enveloped result is an error response ($status_code is not 2xx). Fourth
element (%result_meta) is called result metadata and is optional, a hash
that contains extra information, much like how HTTP response headers provide additional metadata.
This function is not exported by default, but exportable.
No arguments.
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status code
(200 means OK, 4xx caller error, 5xx function error). Second element
($reason) is a string containing error message, or something like "OK" if status is
200. Third element ($payload) is the actual result, but usually not present when enveloped result is an error response ($status_code is not 2xx). Fourth
element (%result_meta) is called result metadata and is optional, a hash
that contains extra information, much like how HTTP response headers provide additional metadata.
This function is not exported by default, but exportable.
Arguments ('*' denotes required arguments):
=over 4
=item * B<config_dirs> => I<any>
=item * B<config_filename> => I<any>
=item * B<config_paths> => I<any>
=item * B<hook_section> => I<any>
=item * B<program_name> => I<any>
=back
Returns an enveloped result (an array).
First element ($status_code) is an integer containing HTTP-like status code
(200 means OK, 4xx caller error, 5xx function error). Second element
($reason) is a string containing error message, or something like "OK" if status is
200. Third element ($payload) is the actual result, but usually not present when enveloped result is an error response ($status_code is not 2xx). Fourth
element (%result_meta) is called result metadata and is optional, a hash
that contains extra information, much like how HTTP response headers provide additional metadata.