-------------------------
This release is intended to be the last one before 1.0. Therefore a major
cleanup was done. This **breaks backward compatibility**. If your code is
really outdated, please read this list carefully and grep your code.
- Removed decorator `alias` (deprecated since v.0.19).
- Removed decorator `plain_signature` (deprecated since v.0.20).
- Dropped support for old-style functions that implicitly expected namespace
objects (deprecated since v.0.21). The `expects_obj` decorator is now
mandatory for such functions.
- Removed decorator `command` (deprecated since v.0.21).
- The `wrap_errors` decorator now strictly requires that the error classes
are given as a list (old behaviour was deprecated since v.0.22).
- The `allow_warnings` argument is removed from
`argh.completion.autocomplete()`. Debug-level logging is used instead.
(The warnings were deprecated since v.0.25).
Deprecated:
- Deprecated arguments `title`, `help` and `description` in `add_commands()`
helper function. See documentation and issue 60.
Other changes:
- Improved representation of default values in the help.
- Dispatcher can be configured to skip unknown arguments (issue 57).
- Added `add_subcommands()` helper function (a convenience wrapper
for `add_commands()`).
- `EntryPoint` now stores kwargs for the parser.
- Added support for default command *with* nested commands (issue 78).
This only works with Python 3.4+ due to incorrect behaviour or earlier
versions of Argparse (including the stand-alone one as of 1.2.1).
Due to argparse peculiarities the function assignment technique relies
on a special `ArghNamespace` object. It is used by default in `ArghParser`
and the shortcuts, but if you call the vanilla `ArgumentParser.parse_args()`
method, you now *have* to supply the proper namespace object.
Fixed bugs:
- Help formatter was broken for arguments with empty strings as default values
(issue 76).