Sarıcı sınıfı
Bu, hem varsayılanları göstermek hem argparse.RawTextHelpFormatter
de aynı anda başka bir formatlayıcı kullanmak için şimdiye kadar bulduğum en güvenilir ve KURU yaklaşımdır :
#!/usr/bin/env python3
import argparse
class ArgumentParserWithDefaults(argparse.ArgumentParser):
def add_argument(self, *args, help=None, default=None, **kwargs):
if help is not None:
kwargs['help'] = help
if default is not None and args[0] != '-h':
kwargs['default'] = default
if help is not None:
kwargs['help'] += ' Default: {}'.format(default)
super().add_argument(*args, **kwargs)
parser = ArgumentParserWithDefaults(
formatter_class=argparse.RawTextHelpFormatter
)
parser.add_argument('-a', default=13, help='''my help
for a''')
parser.add_argument('-b', default=42, help='''my help
for b''')
parser.add_argument('--no-default', help='''my help
for no-default''')
parser.add_argument('--no-help', default=101)
parser.print_help()
print()
print(parser.parse_args())
Çıktı:
usage: main.py [-h] [-a A] [-b B] [--no-default NO_DEFAULT]
[--no-help NO_HELP]
optional arguments:
-h, --help show this help message and exit
-a A my help
for a Default: 13
-b B my help
for b Default: 42
--no-default NO_DEFAULT
my help
for no-default
--no-help NO_HELP
Namespace(a=13, b=42, no_default=None, no_help=101)
ArgumentDefaultsHelpFormatter
+ RawTextHelpFormatter
çoklu kalıtım
Birden fazla miras sadece işe yarar, ancak herkese açık API gibi görünmüyor:
#!/usr/bin/env python3
import argparse
class RawTextArgumentDefaultsHelpFormatter(
argparse.ArgumentDefaultsHelpFormatter,
argparse.RawTextHelpFormatter
):
pass
parser = argparse.ArgumentParser(
formatter_class=RawTextArgumentDefaultsHelpFormatter
)
parser.add_argument('-a', default=13, help='''my help
for a''')
parser.add_argument('-b', default=42, help='''my help
for b''')
parser.print_help()
Çıktı:
usage: a.py [-h] [-a A] [-b B]
optional arguments:
-h, --help show this help message and exit
-a A my help
for a (default: 13)
-b B my help
for b (default: 42)
Sadece çalışır, çünkü https://github.com/python/cpython/blob/v3.6.5/Lib/argparse.py#L648 kaynaklarından önemsiz olarak gördüğümüz için :
RawTextHelpFormatter
uygular _split_lines
ArgumentDefaultsHelpFormatter
uygular _get_help_string
böylece birlikte iyi çalışacaklarını tahmin edebiliriz.
Ancak, bu genel API gibi görünmüyor ve ne yöntemleri formatter_class
, bu yüzden şu anda bunu yapmak için genel bir API yolu olduğunu sanmıyorum. argparse
docstring diyor ki:
Bu modüldeki diğer tüm sınıflar uygulama ayrıntıları olarak kabul edilir. (Ayrıca, HelpFormatter ve RawDescriptionHelpFormatter öğelerinin yalnızca nesne adları olarak herkese açık olarak kabul edildiğini unutmayın - biçimlendirici nesnelerinin API'sı yine de bir uygulama ayrıntısı olarak kabul edilir.)
Ayrıca bkz: Argparse yardım mesajını özelleştirme
Python 3.6.5 üzerinde test edilmiştir.