Revision history for Perinci-CmdLine

0.59     2012-07-27 (SHARYANTO)

         - Tweak: run_history(): Do not format date/time, let
           Data::Format::Pretty::Console do it for us

         - Fix: --verbose, --quiet, et al didn't work before.

0.58     2012-07-26 (SHARYANTO)

         - Allow setting undo => 0 in subcommand, to disable undo/transaction
           for that subcommand.

0.57     2012-07-26 (SHARYANTO)

         - Add 'extra_opts' attribute.

0.56     2012-07-25 (SHARYANTO)

         No functional changes. Increase dep version
         Data::Format::Pretty::Console 0.16.

0.55     2012-07-23 (SHARYANTO)

         Support 'cmdline_src' arg spec key (Rinci 1.1.20+).

0.54     2012-07-19 (SHARYANTO)

         No functional changes. Add dependencies to
         Perinci::Access::TCP::{Server,Client} for convenience. Requires
         Perinci::Sub::GetArgs::Argv 0.18 which supports parsing nonscalar
         arguments as JSON as well as YAML, also for convenience.

0.53     2012-07-12 (SHARYANTO)


         - Add 'default_subcommand' attribute. If set, subcommand name will be
           taken from this instead of first command-line argument. To access
           other subcommands, users will need to give --cmd command-line option.

         - Common options --list will only be added if there are subcommands

         [BUG FIXES]

         - A couple of fixes to tab completion and perl undef warnings.


         - Example script 'symlink-with-undo' renamed to 'u-symlink' (to make it
           consistent with the upcoming 'u-trash' script; see

0.52     2012-06-26 (SHARYANTO)


         - Remove options --yaml, --json, --text, --text-pretty, --text-simple;
           use --format for now. This is to reduce the possibility of collision
           with function argument options (especially things like --text are
           common as function arguments).

           In general Perinci::CmdLine should introduce as few command-line
           options as possible to avoid collisions.


         - Fix typo that cause list of known result formats to be empty in error
           message when passed --format=BOGUS

0.51     2012-06-22 (SHARYANTO)


         - Don't use transactions when dry run, so transaction list is not full
           with dry run calls.

0.50     2012-06-22 (SHARYANTO)


         - Interpret --dry-run (or environment DRY_RUN=1) and pass -dry_run=>1
           to functions that have the dry_run feature.

         - Don't treat 304 status as error (still return exit code 0).

0.49     2012-06-22 (SHARYANTO)


         - Implement undo (--undo, --redo, --history, --clear-history).

0.48     2012-06-15 (SHARYANTO)


         - Add module: Perinci::CmdLine::Easy

0.47     2012-04-03 (SHARYANTO)


         - Better handle case when common options like --help, --list, --version
           clash with function arguments with the same name. Now the behavior is
           to invoke common action (like help, version), unless
           --action=subcommand is specified, where it will set function
           arguments instead. Note that this is a non-issue when none of the
           function arguments happen to have names of 'help', 'list', 'version',

0.46     2012-03-30 (SHARYANTO)

         No functional changes. Fix typo.

0.45     2012-03-30 (SHARYANTO)


         - Split formatting to Perinci::Result::Format (in Perinci dist).


         - Rename --pretty (-p) and --nopretty (-P) to --text-pretty and

0.44     2012-03-29 (SHARYANTO)


         - Make it easy to add more output formats: added --format and formats()


         - --json now outputs compact JSON instead of pretty ones. To
           pretty-print the output one can pipe it to a formatter program.


         - Bash completion: list of common options was incomplete (but we still
           can't complete common option's value like --format <tab>).

0.43     2012-03-23 (SHARYANTO)


         - Show default argument value in --help message.

0.42     2012-03-16 (SHARYANTO)


         - Localized/translatable messages. English and Indonesian included.

         - Read environment variable PERINCI_CMDLINE_PROGRAM_NAME.

         - peri-run: Accept --subcommand (-s) to specify subcommands.

         - Allow choosing PAGER via result metadata key 'cmdline.pager'.

0.41     2012-03-08 (SHARYANTO)

         [BUG FIXES]

         - Fix do not empty envelope when 'cmdline.display_result' is false.

0.40     2012-03-08 (SHARYANTO)


         - Observe function result metadata: 'cmdline.display_result' (no longer
           observe 'cmdline.result_importance').


         - Observe function result metadata: 'cmdline.page_result' to send
           result to PAGER.

0.39     2012-03-03 (SHARYANTO)


         - Add short options for --yaml (-y), --json (-j), --pretty (-p),
           and --nopretty (-P).

         - Observe function result metadata: 'cmdline.result_importance' (if set
           to 'low', won't display result).


         - Common options (like --yaml, --help, -l) now won't override options
           for function arguments of the same name.


         - Remove support for PHP serialization output (will be re-added later
           via --format, which can use any Data::Format::Pretty::* module).

0.38     2012-02-23 (SHARYANTO)

         Rename distribution from Sub-Spec-CmdLine to Perinci-CmdLine. Now
         Rinci/Riap-based (transparent remote access). Refactor into OO. Some
         features missing for now. Tests not updated yet.

0.37     2012-01-20 (SHARYANTO)

         No functional changes. Mark deprecation.

0.36     2011-08-25 (SHARYANTO)

         No functional changes. gen_usage() split to its own dist:
         Sub-Spec-To-Text. Update to Sub::Spec 0.15.

0.35     2011-08-11 (SHARYANTO)

         Uses Data::Format::Pretty for result formatting. JSON output is now
         pretty-printed by default.

0.34     2011-08-03 (SHARYANTO)

         No functional changes. Fixed test script to adjust to new
         Object::BlankStr [CT]. Updated dependencies.

0.33     2011-07-26 (SHARYANTO)


         Refactoring: move parse_argv() to


         Localize Getopt::Long::Configure() effect.

0.32     2011-07-10 (SHARYANTO)

         [BUG FIXES]

         * runpm: fix -I.

0.31     2011-07-10 (SHARYANTO)


         * bin/runpm: add --help (-h) and -I (--library) options.

         * run(): add dash_to_underscore option to allow subcommands using
           dashes instead of underscores.

0.30     2011-06-05 (SHARYANTO)


         * To reduce the trap of implicit YAML parsing, parsing is only done for
           nonscalar arguments.

0.29     2011-06-01 (SHARYANTO)

         No functional changes.


         - Update to latest version of Sub::Spec::Runner.

0.28     2011-04-14 (SHARYANTO)

         [BUG FIXES]

         - Remove extra name line in usage message.

0.27     2011-04-14 (SHARYANTO)


         - run(): For convenience, allow general options (e.g. --version,
           --help, --json, etc) to be specified after subcommand name, if it
           doesn't collide with spec arg


         - Replace Clone::Any with Data::Clone (Clone::Any fallbacks to Storable
           which doesn't support storing Regexp, so tests will fail if Clone is
           not available).

0.26     2011-03-04 (SHARYANTO)

         Require Sub::Spec::Runner 0.09.

0.25     2011-02-28 (SHARYANTO)

         On non-success response from sub, print output (error message) even if
         spec enables cmdline_suppress_output.

0.24     2011-02-28 (SHARYANTO)

         Now based on Sub::Spec::Runner for dependency checking before run.

0.23     2011-02-23 (SHARYANTO)

         Fix dependency (Sub::Spec version).

         Don't add error message when Getopt::Long already prints to stderr.

0.22     2011-02-22 (SHARYANTO)

         Use Sub::Spec::Utils.

0.21     2011-02-21 (SHARYANTO)

         Add some more documentation.

         Requires recent versions of Test::More & Sub::Spec::BashComplete.

0.20     2011-02-18 (SHARYANTO)

         Escape completion output since BashComplete now doesn't.

         Added some doc.

0.19     2011-02-18 (SHARYANTO)

         Provide runpm script.

0.18     2011-02-18 (SHARYANTO)

         run(): More fixes for completion.

         spec: cmdline_aliases is renamed to arg_aliases.

         Fix test [CT].

0.17     2011-02-17 (SHARYANTO)

         run(): Fixed stupid parenthesis bug.

0.16     2011-02-17 (SHARYANTO)

         run(): A couple more fixes for bash completion.

         parse_argv(): Also add --nofoo for bool cmdline_aliases.

0.15     2011-02-17 (SHARYANTO)

         Yet more fixes for bash completion.

         Fixed: parse_argv(): do not convert all remaining $argv to YAML so they
         can be reused (e.g. parse_argv'd) again

         run(): add option 'custom_completer' to pass to

0.14     2011-02-17 (SHARYANTO)

         Fixes for bash completion.

0.13     2011-02-17 (SHARYANTO)


         run(): rename 'require' argument to 'load'.


         parse_argv(): Respect arg spec: 'cmdline_aliases' for specifying
         option aliases.

         run(): Allow 'subcommands' argument to be coderef.

         run(): Pass more info (arguments) to coderef 'help' argument.

         run(): Add option 'allow_unknown_args' for non-strict argv parsing.

         gen_usage(): Add option: 'options_name'.

0.12     2011-02-16 (SHARYANTO)

         Fixes for bash completion.

         Add arguments to run(): help, spec, run, per-subcommand category.

         Other bug fixes.

0.11     2011-02-16 (SHARYANTO)

         Add support for bash completion (requires Sub::Spec::BashComplete).

0.10     2011-02-16 (SHARYANTO)

         Add strict=>0 option in parse_argv(), for use by

         Some small refactoring.

0.09     2011-02-15 (SHARYANTO)

         Add --version.

0.08     2011-02-15 (SHARYANTO)

         Fixes for subcommands support.

         Respect spec clause: cmdline_suppress_output.

0.07     2011-02-11 (SHARYANTO)

         Formatting fix: missing newline in error message.

0.06     2011-02-11 (SHARYANTO)

         Add 'cmd' option to gen_usage().

         Formatting tweaks.

0.05     2011-02-11 (SHARYANTO)

         Remove 'required_args'.

0.04     2011-02-10 (SHARYANTO)

         Formatting fixes.

0.03     2011-02-10 (SHARYANTO)

         Formatting tweaks.

         Fix schema clause ('in', not 'choices').

0.02     2011-02-09 (SHARYANTO)

         Incompatible change: rename arg_order to arg_pos.


0.01     2011-02-09 (SHARYANTO)

         First release.