# 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.