Rewrite argument parsing in rb-site to use Python's argparse module.
Review Request #11369 — Created Jan. 12, 2021 and submitted
rb-site has historically used the legacy
optparsemodule, which had a
number of drawbacks:
Options were defined in a global pool, so they could only be defined
by a single command.
Options for one command were therefore "allowed" by a second command.
When running management commands special
--option was required to
separate rb-site's arguments from the management command's.
There wasn't a good way to define per-command help.
This change addresses all this by moving to
argparse and redoing a bit
of our command handling. Now, each command is its own sub-parser with
its own help text and arguments. Collision is no longer possible, and
each command can be considered fully independent.
-- argument is no longer needed when running management commands,
argparse allows us to capture any remaining options and pass them
argparse is not perfect, and we had to work around some
issues. For instance, multi-paragraph help text is not doable by
default, so we had to apply some custom logic (overriding "private"
functions that haven't changed since it was introduced) to format text
Another gotcha is that they recommend using
nargs='+' to capture one
or more unknown arguments (for our management command), but it's
actually pretty incompatible with sub-parsers. Instead, we have to use
an undocumented option,
nargs=argparse.PARSER, to get the desired
behavior. Despite being undocumented, it forms the basis of sub-parsers,
does exactly what we need, and is heavily referenced in bug reports as a
better (yet undocumented) option for this purpose.
While there are things left to be desired, this is a far more
future-proof way of performing argument parsing, and provides a
foundation for further improvements.
Unit tests pass on all supported versions of Python.
Manually ran each command with all the variations in configuration that
made sense (such as
upgradewith/without a site directory or
managewith all sorts of management commands and options).
Repeated those tests for Python 2.7, 3.6, and 3.9, to check for any
regressions in behavior across versions.
- Added some missing wrap width setup for help text that got left out of the posted change.
- Removed a duplicate test method.
Revision 2 (+1306 -286)
Checks run (2 succeeded)