= OVERVIEW =

The Connector is generic connection to a data set, typically configuration data in a hierarchical structure. Each connector object accepts the get(KEY) method, which, when given a key, returns the associated value from the connector's data source.

Typically, a connector acts as a proxy to a simple data source like YAML, Config::Std, Config::Versioned, or to a more complex data source like an LDAP server or Proc::SafeExec. The standard calling convention via get(KEY) makes the connectors interchangeable.

In addition, a set of meta-connectors may be used to combine multiple connectors into more complex chains. The Connector::Multi, for example, allows for redirection to delegate connectors via symbolic links. If you have a list of connectors and want to use them in a load-balancing, round-robin fashion or have the list iterated until a value is found, use Connector::List and choose the algorithm to perform.

= USAGE =

In general, the following steps are needed (replace MODULENAME with the name of the Connector module you need):

use Connector::MODULENAME;

my $conn = Connector::MODULENAME->new({
    LOCATION => $path_to_config_for_module,
});

my $val = $conn->get('full.name.of.key');

See the POD for the modules as well as the test scripts for more details and examples on the individual connectors.