Path: usenet.cise.ufl.edu!huron.eel.ufl.edu!usenet.eel.ufl.edu!uky.edu!news.campus.mci.net!calwebnntp!206.165.113.230.MISMATCH!nntpX.primenet.com!nntp.primenet.com!cpk-news-hub1.bbnplanet.com!cam-news-hub1.bbnplanet.com!news.bbnplanet.com!news.mathworks.com!uunet!in2.uu.net!news.neta.com!not-for-mail
From:
[email protected] (Andy Wardley)
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules
Subject: ANNOUNCE: App::Config 1.07 released
Followup-To: comp.lang.perl.modules
Date: 9 Jul 1998 13:59:33 GMT
Organization: Canon Research Centre Europe, Ltd.
Lines: 119
Approved:
[email protected] (comp.lang.perl.announce)
Message-ID: <
[email protected]>
NNTP-Posting-Host: gadget.cscaper.com
X-Disclaimer: The "Approved" header verifies header information for article transmission and does not imply approval of content.
Xref: usenet.cise.ufl.edu comp.lang.perl.announce:86 comp.lang.perl.modules:2626
A new version of App::Config (1.07) has been uploaded to CPAN.
This version contains a number of minor bug fixes and enhancements. See
the "Changes" file in the distribution for further details.
Extracts from the documentation are included below.
A
========================================================================
NAME
App::Config - Perl5 extension for managing global application
configuration information.
SYNOPSIS
use App::Config;
my $cfg = new App::Config;
$cfg->define("foo"); # very simple variable definition
$cfg->set("foo", 123); # trivial set/get examples
$fval = $cfg->get("foo");
$cfg->foo(456); # direct variable access
$cfg->cfg_file(".myconfigrc"); # read config file
$cfg->cmd_line(\@ARGV); # process command line
OVERVIEW
App::Config is a Perl5 module to handle global configuration
variables for perl programs. The advantages of using such a
module over the standard "global variables" approach include:
* Reduction of clutter in the main namespace.
* Default values can be specified.
* Multiple names (aliases) can refer to the same variable.
* Configuration values can be set directly from config files
and/or command line arguments.
* Data values can be automatically validated by pattern matching
(e.g. "\d+" to accept digits only) or through user-supplied
routines.
* User-defined routines can be called automatically when
configuration values are changed.
PREREQUISITES
App::Config requires Perl version 5.004 or later. If you have an
older version of Perl, please upgrade to latest version. Perl
5.004 is known to be stable and includes new features and bug
fixes over previous versions. Perl itself is available from your
nearest CPAN site (see
http://www.perl.com/CPAN).
INSTALLATION
To install this module type the following:
perl Makefile.PL
make
make install
The 'make install' will install the module on your system. You
may need root access to perform this task. If you install the
module in a local directory (for example, by executing "perl
Makefile.PL LIB=~/lib" in the above - see `perldoc MakeMaker'
for full details), you will need to ensure that the PERL5LIB
environment variable is set to include the location, or add a
line to your scripts explicitly naming the library location: use
lib '/local/path/to/lib';
AUTHOR
Andy Wardley, `<
[email protected]>'
Web Technology Group, Canon Research Centre Europe Ltd.
App::Config is based in part on the ConfigReader module, v0.5,
by Andrew Wilcox (currently untraceable).
Thanks to all the people who have reported bugs and made
suggestions. Extra special thanks to those who sent patches:
Mik Firestone <
[email protected]>
* GLOBAL arguments
Blair Zajac <
[email protected]>
* getpw*() check for Win32 compatibility
REVISION
$Revision: 1.7 $
COPYRIGHT
Copyright (C) 1997,98 Canon Research Centre Europe Ltd. All
Rights Reserved.
This module is free software; you can redistribute it and/or
modify it under the term of the Perl Artistic License.
SEE ALSO
Andy Wardley's Home Page
http://www.kfs.org/~abw/
Canon Research Centre Europe
http://www.cre.canon.co.uk/perl/
The ConfigReader module.
The module which provided inspiration and ideas for the
development of App::Config.
--
Andy Wardley <
[email protected]> Signature regenerating. Please remain seated.
<
[email protected]> For a good time:
http://www.kfs.org/~abw/