README
1Config-Versioned
2
3Config::Versioned allows an application to access configuration parameters
4not only by parameter name, but also by version number. This allows for
5the configuration subsystem to store previous versions of the configuration
6parameters. When requesting the value for a specific attribute, the programmer
7specifies whether to fetch the most recent value or a previous value.
8
9This is useful for long-running tasks such as in a workflow-based application
10where task-specific values (e.g.: profiles) are static over the life of a
11workflow, while global values (e.g.: name of an LDAP server to be queried)
12should always be the most recent.
13
14Config::Versioned handles the versions by storing the configuration data
15in an internal Git repository. Each import of configuration files into
16the repository is documented with a commit. When a value is fetched, it is
17this commit that is referenced directly when specifying the version.
18
19The access to the individual attributes is via a named-parameter scheme, where
20the key is a dot-separated string.
21
22Currently, Config::Std is used for the import of the data files into the
23internal Git repository. Support for other configuration modules (e.g.:
24Config::Any) is planned.
25
26INSTALLATION
27
28To install this module, run the following commands:
29
30 perl Makefile.PL
31 make
32 make test
33 make install
34
35SUPPORT AND DOCUMENTATION
36
37After installing, you can find documentation for this module with the
38perldoc command.
39
40 perldoc Config::Versioned
41
42You can also look for information at:
43
44 RT, CPAN's request tracker
45 http://rt.cpan.org/NoAuth/Bugs.html?Dist=Config-Versioned
46
47 AnnoCPAN, Annotated CPAN documentation
48 http://annocpan.org/dist/Config-Versioned
49
50 CPAN Ratings
51 http://cpanratings.perl.org/d/Config-Versioned
52
53 Search CPAN
54 http://search.cpan.org/dist/Config-Versioned/
55
56
57COPYRIGHT AND LICENCE
58
59Copyright (C) 2011 Scott T. Hardin
60
61This program is free software; you can redistribute it and/or modify it
62under the same terms as Perl itself.
63
64