| 1 |
############################################################################# |
| 2 |
# CHANGE LOG |
| 3 |
############################################################################# |
| 4 |
|
| 5 |
VERSION 1.12 |
| 6 |
x Added a copyright statement at the request of a Debian administrator. |
| 7 |
https://rt.cpan.org/Public/Bug/Display.html?id=62017 |
| 8 |
|
| 9 |
VERSION 1.11 |
| 10 |
x Added prefixadmin to the MANIFEST |
| 11 |
|
| 12 |
VERSION 1.1 |
| 13 |
x Supports the "secure" option attribute. (Also, all options which end in "pass" or "password" |
| 14 |
are assumed to be secure.) The value is a security level: 1=[don't print the value in a help screen]. |
| 15 |
2=[ensure that the value can never be supplied on a command line or from the environment but |
| 16 |
only from a file that only the user running the program has read/write access to] |
| 17 |
|
| 18 |
VERSION 1.07 |
| 19 |
x Automagically add $PREFIX/lib/perl5 to @INC (only if it exists), else $PREFIX/lib/perl |
| 20 |
Also check $PREFIX/share/perl and add it to @INC if it exists. |
| 21 |
Surprisingly, $PREFIX/share/perl and $PREFIX/lib/perl seem to be the directories created |
| 22 |
and used under Ubuntu 8.04's perl. |
| 23 |
x Allow dashes ("-") as a variable name (i.e. foo-bar = 1). |
| 24 |
In doing this, I actually allow that any characters other than spaces/tabs/= can make up the variable name |
| 25 |
x Trim leading and trailing tabs (as well as spaces) from the line |
| 26 |
|
| 27 |
VERSION 1.06 |
| 28 |
x Remove trailing \r from option files (for Windows-edited .conf files) |
| 29 |
|
| 30 |
VERSION 1.05 |
| 31 |
x Substitutions of ${prefix} in option files now works even if only defined by assumption |
| 32 |
This is particularly valuable for portability between environments of CGI scripts and cron scripts. |
| 33 |
|
| 34 |
VERSION 1.04 |
| 35 |
x Fixed RT Bug #33597: Problem of ignoring drive letter on Win32 filesystem. |
| 36 |
|
| 37 |
VERSION 1.03 |
| 38 |
x better use of /\s*/ instead of / */ so that tabs don't catch you off-guard |
| 39 |
x enable application use of App::Options objects to read additional data structures |
| 40 |
* $option_processor = App::Options->new(@args); |
| 41 |
* $option_processor->read_option_files(\%values, [$file]); |
| 42 |
x allow for subclassing (App::Options::YAML, etc.) |
| 43 |
* made App::Options object-oriented to allow for subclassing |
| 44 |
* split read_option_files() method out of the read_options() method (for subclassing) |
| 45 |
x save the import arguments for later print_usage or later reparsing (as $self->{init_args}) |
| 46 |
|
| 47 |
VERSION 1.02 |
| 48 |
x ENV{FOO} = x in app.conf sets environment variable "FOO" (i.e. LD_LIBRARY_PATH) |
| 49 |
x added perl_restart option to re-exec() the program so that it picks up a new LD_LIBRARY_PATH |
| 50 |
x save original @ARGV to @App::Options::ARGV (used for perl_restart/re-exec()) |
| 51 |
x line continuation characters strip off newlines and leading spaces |
| 52 |
|
| 53 |
VERSION 1.01 |
| 54 |
x removed dependency in Makefile.PL on Config.pm (which was causing a false error on "make test") |
| 55 |
|
| 56 |
VERSION 1.00 |
| 57 |
x clean up for v1.00. no dependency on Module::Build (which has been giving problems) |
| 58 |
x add default values for MANPATH, LD_LIBRARY_PATH to bin/prefix |
| 59 |
x added t/file.txt so the test process doesn't spew warnings |
| 60 |
|
| 61 |
VERSION 0.99 |
| 62 |
x fixed a condition that didn't work on Windows when executing in current dir |
| 63 |
x fix double slash /usr/rubicon/test/bin//app.conf |
| 64 |
x improved --debug_options, --debug_options=[1-7] output |
| 65 |
|
| 66 |
VERSION 0.98 |
| 67 |
x disabled some tests that cause failure on MSWin32 |
| 68 |
|
| 69 |
VERSION 0.97 |
| 70 |
x enable "here documents", var = <<EOF |
| 71 |
x enable file/cmd variables, var = < filename (or "cmd|") |
| 72 |
x allow line continuation chars, i.e. var = hello \\nworld |
| 73 |
|
| 74 |
VERSION 0.96 |
| 75 |
x cleaned up some of the --debug_options output |
| 76 |
x tests run clean on Win32 |
| 77 |
x used File::Spec to make file/directory manipulation platform-independent (i.e. Win32) |
| 78 |
NOTE: I used a mix of platform-independent File::Spec functions and explicit |
| 79 |
conversion from "\" paths to POSIX-compliant "/" paths. This is because the |
| 80 |
purist form of leaving "\" paths for Win32 was causing weirdness. When |
| 81 |
I would interpolated the string or use it in a regular expression, the |
| 82 |
backslashes were interacting badly. The only reason I'm not going to 1.0 |
| 83 |
with this is that I want to see it pass Win32 tests on the CPAN testers |
| 84 |
farm before giving it that number. |
| 85 |
|
| 86 |
VERSION 0.95 |
| 87 |
x made a change (hack) to Build.PL to get it to work with the CPAN shell |
| 88 |
|
| 89 |
VERSION 0.94 |
| 90 |
x use Module::Build instead of ExtUtils::MakeMaker |
| 91 |
x add a META.yaml file to the distribution (from "Build distmeta") |
| 92 |
x add --version support (print out versions of all modules) |
| 93 |
x make prefix authoritative before defaults so that we can use ${prefix} in substitutions |
| 94 |
x set defaults in order of "options" to ensure the correct order for variable substitution |
| 95 |
|
| 96 |
VERSION 0.93 |
| 97 |
x prefix can now be set in $prog_dir/app.conf to find $prefix/etc/app/app.conf |
| 98 |
x single-line sections in option files are no longer independent of the |
| 99 |
section they are in. Both the section-condition and the line-condition |
| 100 |
must now be satisfied for a value to be set. |
| 101 |
|
| 102 |
VERSION 0.92 |
| 103 |
x cleaned up some warnings which appeared under -w (concatenation of undef) |
| 104 |
x add system-supplied hostname and host options |
| 105 |
x variable substitution works with environment vars (url = http://$ENV{HOST}) |
| 106 |
x auto-import of environment vars named "APP_*" even if not otherwise defined |
| 107 |
x usage: undefined values appear as "[undef]" rather than "[]" |
| 108 |
x usage: options appear as "--var=<value>" rather than "--var=<var>" |
| 109 |
x usage: "args_description" describes what's left on cmd line after options removed |
| 110 |
x usage: "value_description" describes option value (instead of "<value>") |
| 111 |
x added an examples directory |
| 112 |
x added a benchmark directory |
| 113 |
x default is $Config{prefix} instead of /usr/local |
| 114 |
x improve debug_options (env vars, etc.) (implemented 6 levels of debug_options) |
| 115 |
|
| 116 |
VERSION 0.91 |
| 117 |
x show_all is off by default whenever "option" or "options" used |
| 118 |
x remove app_path_info |
| 119 |
|
| 120 |
VERSION 0.90 |
| 121 |
x new "use App::Options (...);" syntax (rather than ->init(...) syntax) |
| 122 |
|
| 123 |
VERSION 0.64 |
| 124 |
x added $VERSION to App::Options (use VERSION_FROM in Makefile.PL) |
| 125 |
x fixed bug where "show_all" wasn't showing all on --help |
| 126 |
x touched up titles on pod documentation |
| 127 |
x implement import() method to use module outside the BEGIN block (i.e. use App::Options (@args)) |
| 128 |
x update documentation with new syntax using import() method |
| 129 |
x improve show_all logic: show_all = 1 by default always unless overridden |
| 130 |
|
| 131 |
VERSION 0.63 |
| 132 |
x improve documentation (api reference, logic flow, usage tutorial) |
| 133 |
x "integer" type now matches integers with underscores (i.e. 1_000_000) |
| 134 |
x "float" type now matches numbers with underscores (i.e. 1_000.000_001) |
| 135 |
x added /etc/app/app.conf to the end of the option file search path |
| 136 |
x default "prefix" is now "/usr/local" instead of "." |
| 137 |
x {env} attribute of "" means don't search any env variable |
| 138 |
|
| 139 |
VERSION 0.62 |
| 140 |
x [prog] matches "prog" only. [/prog/] matches by regular expression. |
| 141 |
In version 0.61, the section [list] would match ($app =~ /list/). |
| 142 |
In version 0.62, the section [list] only matches ($app eq "list"), |
| 143 |
while [/list/] matches ($app =~ /list/). |
| 144 |
x type="/regexp/" matches regexp. unknown types ignored. |
| 145 |
In version 0.61, an option type which was not one of the known |
| 146 |
option types (integer, float, date, datetime, etc.), was considered |
| 147 |
automatically as a regular expression. |
| 148 |
In version 0.62, only types which take the form "/regexp/" are |
| 149 |
actually regular expressions. All other unknown "types" are ignored. |
| 150 |
This sets the groundwork for better forward-compatibility when new |
| 151 |
types are introduced, they will not break older versions of the code. |
| 152 |
It also just seems clearer. |
| 153 |
x "show_all" option - shows all defined options, not just in [ options ] |
| 154 |
In version 0.61, the --help option would show all variables defined |
| 155 |
in the code, on the command line, or in any of the files (i.e.show_all=1). |
| 156 |
However, if the "options" argument is used in the init() method in the |
| 157 |
code, only those enumerated options would be shown (i.e. show_all=0). |
| 158 |
In version 0.62, the same behavior applies unless the "show_all" |
| 159 |
parameter is given explicitly. |
| 160 |
x quoting, var = " hello world " |
| 161 |
In version 0.61, variable values in the option file had leading and |
| 162 |
trailing spaces removed. This meant that a value of a single space |
| 163 |
was not possible. |
| 164 |
In version 0.62, the same behavior applies. However, if the |
| 165 |
remaining text starts with " and ends with ", those quote marks are |
| 166 |
removed. i.e. var = " " will result in the value of a single space, |
| 167 |
and message = "Hello world. " will have a trailing space. |
| 168 |
x check list of configurable environment vars ("env") instead of |
| 169 |
"APP_${uc_var}" |
| 170 |
In version 0.61, variable values could be supplied by specifying the |
| 171 |
variable prefixed with "APP_". (i.e. "path" could be specified |
| 172 |
with "APP_PATH") |
| 173 |
In version 0.62, a list of environment variable names may be given |
| 174 |
and the first with a supplied value is used for the value. |
| 175 |
(i.e. options => { path => { env => "PATH" } } will cause the |
| 176 |
"path" variable to be set from the "PATH" environment variable.) |
| 177 |
|
| 178 |
VERSION 0.61 |
| 179 |
x Initial release |
| 180 |
|