New submission from Graylin Kim <graylin....@gmail.com>:
When using argparse I frequently run into situations where my helper text is a
mix of prose and bullets or options. I need the RawTextFormatter for the
bullets, and I need the default formatter for the prose (so the line wraps
intelligently).
The current HelpFormatter classes are marked as public by name only, so
sub-classing them with overrides to get the desired functionality isn't great
unless it gets pushed upstream. To that end, I've attached a subclass
implementation that I've been using for the following effect:
Example:
>>> parser = argparse.ArgumentParser(formatter_class=FlexiFormatter)
>>> parser.add_argument('--example', help='''\
... This argument's help text will have this first long line\
... wrapped to fit the target window size so that your text\
... remains flexible.
...
... 1. This option list
... 2. is still persisted
... 3. and the option strings get wrapped like this with an\
... indent for readability.
...
... You must use backslashes at the end of lines to indicate that\
... you want the text to wrap instead of preserving the newline.
...
... As with docstrings, the leading space to the text block is\
... ignored.
... ''')
>>> parser.parse_args(['-h'])
usage: argparse_formatter.py [-h] [--example EXAMPLE]
optional arguments:
-h, --help show this help message and exit
--example EXAMPLE This argument's help text will have this first
long line wrapped to fit the target window size
so that your text remains flexible.
1. This option list
2. is still persisted
3. and the option strings get wrapped like
this with an indent for readability.
You must use backslashes at the end of lines to
indicate that you want the text to wrap instead
of preserving the newline.
As with docstrings, the leading space to the
text block is ignored.
1. This option list
2. is still persisted
3. and the option strings get wrapped like
this with an indent for readability.
You must use backslashes at the end of lines to
indicate that you want the text to wrap instead
of preserving the newline.
As with docstrings, the leading space to the
text block is ignored.
If there is interest in this sort of thing I'd be happy to fix it up for
inclusion.
----------
components: Library (Lib)
files: argparse_formatter.py
messages: 142651
nosy: GraylinKim
priority: normal
severity: normal
status: open
title: argparse: Hybrid help text formatter
versions: Python 2.7
Added file: http://bugs.python.org/file22977/argparse_formatter.py
_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue12806>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
