Console_CommandLinepear.php.netA full featured command line options and arguments parserConsole_CommandLine is a full featured package for managing command-line
options and arguments highly inspired from python optparse module, it allows
the developer to easily build complex command line interfaces.
Main features:
* handles sub commands (ie. $ myscript.php -q subcommand -f file),
* can be completely built from an xml definition file,
* generate --help and --version options automatically,
* can be completely customized,
* builtin support for i18n,
* and much more...David JEAN LOUISiziizimobil@gmail.comyes2009-11-111.1.11.1.1stablestableMIT
Bugfix release:
* fixed bug #16507: typo in code example (thanks Richard)
* fixed bug #16497: cascade command properties to sub-commands
* fixed bug #16370: allow pre-processing of arguments for list (thanks rquadling for the patch)
* fixed bug #16764: Invalid Package.xml (thanks mklappstuhl for the patch)
* fixed some test cases
5.1.01.4.0b10.1.00.1.0alphaalpha2007-12-19MIT License
Initial release.
0.1.10.1.1alphaalpha2007-12-21MIT License
* bugs
- fixed bug #12711,
- fixed wrong error triggered when argument name is invalid.
* changes
- some cosmetic changes,
- added a lot of phpt test files.
0.2.00.2.0betabeta2008-01-09MIT License
- fixed a bug in Option::toString() (values were not displayed for short options),
- fixed a parsing bug: if "-" is passed on the command line it should be treated as an argument,
- stop option parsing when a "--" is found as gnu getopt does,
- added a "force_posix" boolean attribute that tells the parser to be POSIX compliant, POSIX demands the following behavior: the first non-option stops option processing,
- added more regression tests.
0.2.10.2.1betabeta2008-01-09MIT License
fixed bug #12859: xmlschema.rng gets searched at the wrong folder
1.0.0RC11.0.0RC1betabeta2008-01-18MIT License
- fixed a missing check when a short option require an argument and is the last
in the argv array,
- more GNU getopt compliance: long option/argument can also be separated by a
space now and long options abbreviations are supported,
- added a "Password" action: with this action it is possible to specify a
password on the command line, and if it is missing it will be prompted to
user (and will not be echo on stdin on UNIX systems),
- allow "force_posix" option to be passed to the constructor,
- added more tests.
1.0.0RC21.0.0RC2betabeta2008-03-10MIT License
- allow "force_posix" option to be passed to the constructor;
- fixed bug #13038 changed the signature of the parse method to allow the
developer to pass argc and argv array (instead of using $_SERVER values);
- fixed bug #13132 : "choices" not supported in xml definition (also added
"force_posix" attribute support in xml).
1.0.0RC31.0.0RC3betabeta2008-03-12MIT
- fixed a strict standards notice: Console_CommandLine_Exception::build() should be static;
- changed behaviour when a StoreArray option is positioned at the end;
- now use pfm (so removed package.php and package2.xml).
1.0.0RC31.0.0RC3betabeta2008-03-12MIT
- fixed a strict standards notice: Console_CommandLine_Exception::build() should be static;
- changed behaviour when a StoreArray option is positioned at the end;
- now use pfm (so removed package.php and package2.xml).
1.0.01.0.0stablestable2008-05-22MIT
- doc is now in peardoc format (thanks to cweiske for his precious help);
- better handling of custom instances (added an accept() method);
- added an AllTests.php file to make phpunit happy;
- added tests for xml usage;
- some cosmetic changes.
1.0.11.0.1stablestable2008-08-01MIT
- Better code coverage of tests (nearly 100%);
- fixed two bad include_once;
- fixed bug #14435 (own -h short option doesn't remove help short option) and did the same for "version" option;
- fixed bug #14436 (Typo in error message) and some fixed other typos.
1.0.21.0.2stablestable2008-08-22MIT
- fixed bug #14454 (Console_Commandline hangs when called via browser);
- fixed outputter bug (STDOUT/STDERR not defined with php-cgi);
- Console_CommandLine can now handle web requests (it convert automatically a request to options/arguments).
1.0.31.0.3stablestable2008-09-30MIT
- now handles stdin with the "-" special switch;
- fixed bug #14717 (Password not optional when parser built from an xml file);
- added relevant unit tests;
- removed useless require_once's in some tests.
1.0.41.0.4stablestable2008-10-09MIT
- implemented feature request #14753 (add_list_option parameter for --list-XXX option);
- fixed bug #14762 (error message always tells me to use "-h" for help);
- added relevant unit tests;
- cleaned up phpdoc tags and some cosmetic changes.
1.0.51.0.5stablestable2008-12-06MIT
* implemented feature request #15251: Allow specifying optional arguments for
sub-commands,
* use "name" instead of "help_name" when generating list-xxx options,
* updated relevant unit tests,
* added examples for sub-commands usage.
1.0.61.0.6stablestable2008-12-26MIT
Bugfix release:
* fixed bug #15374 (RelaxNG validation should be less strict);
* fixed bug #15375 (Cannot add a comment before the root node of the xml file);
* fixed bug #15376 (short option and long options in separated lines in help);
* fixed bug #15377 (StoreFalse/True actions should have a boolean default value);
* added relevant unit tests.
1.1.01.1.0stablestable2009-06-19MIT
* changed sources layout to make easier to use / run tests without installing the package with pear
* implemented subcommand aliases (as requested by Greg for pyrus)
* implemented request #15325: add ability to detect missing sub-command (patch by gauthierm, thanks)
* implemented request #15324: add ability to set custom error messages (patch by gauthierm, thanks)
* fixed bug #16320: storeArray default value not cleared when options arguments given (patch by Richard Quadling, thanks!)
* fixed bug #16329: sub command aliases do not work (was a "too early documentation" issue)
* fixed bug #16330: nested subCommands help output not quite right
* implemented request #16332: add support for optional arguments in XML (patch by gauthierm, thanks)