load_files( \%args )

    Config::Any->load_files( { files => \@files } );
    Config::Any->load_files( { files => \@files, filter  => \&filter } );
    Config::Any->load_files( { files => \@files, use_ext => 1 } );
    Config::Any->load_files( { files => \@files, flatten_to_hash => 1 } );

"load_files()" attempts to load configuration from the list of files passed in the "files" parameter, if the file exists.

If the "filter" parameter is set, it is used as a callback to modify the configuration data before it is returned. It will be passed a single hash-reference parameter which it should modify in-place.

If the "use_ext" parameter is defined, the loader will attempt to parse the file extension from each filename and will skip the file unless it matches a standard extension for the loading plugins. Only plugins whose standard extensions match the file extension will be used. For efficiency reasons, its use is encouraged, but be aware that you will lose flexibility -- for example, a file called "myapp.cfg" containing YAML data will not be offered to the YAML plugin, whereas "myapp.yml" or "myapp.yaml" would be.

When the "flatten_to_hash" parameter is defined, the loader will return a hash keyed on the file names, as opposed to the usual list of single-key hashes.

"load_files()" also supports a 'force_plugins' parameter, whose value should be an arrayref of plugin names like "Config::Any::INI". Its intended use is to allow the use of a non-standard file extension while forcing it to be offered to a particular parser. It is not compatible with 'use_ext'.

You can supply a "driver_args" hashref to pass special options to a particular parser object. Example:

    Config::Any->load_files( { files => \@files, driver_args => {
        General => { -LowerCaseNames => 1 }
    } )

load_stems( \%args )

    Config::Any->load_stems( { stems => \@stems } );
    Config::Any->load_stems( { stems => \@stems, filter  => \&filter } );
    Config::Any->load_stems( { stems => \@stems, use_ext => 1 } );
    Config::Any->load_stems( { stems => \@stems, flatten_to_hash => 1 } );

"load_stems()" attempts to load configuration from a list of files which it generates by combining the filename stems list passed in the "stems" parameter with the potential filename extensions from each loader, which you can check with the "extensions()" classmethod described below. Once this list of possible filenames is built it is treated exactly as in "load_files()" above, as which it takes the same parameters. Please read the "load_files()" documentation before using this method.

finder( )

plugins( )

extensions( )