bpo-37726: Prefer argparse over getopt in stdlib tutorial (GH-15052) (#15070)
(cherry picked from commit 2491134029
)
Co-authored-by: mental <m3nta1@yahoo.com>
This commit is contained in:
parent
462f07040b
commit
dcc53ebbff
|
@ -72,10 +72,21 @@ three`` at the command line::
|
|||
>>> print(sys.argv)
|
||||
['demo.py', 'one', 'two', 'three']
|
||||
|
||||
The :mod:`getopt` module processes *sys.argv* using the conventions of the Unix
|
||||
:func:`getopt` function. More powerful and flexible command line processing is
|
||||
provided by the :mod:`argparse` module.
|
||||
The :mod:`argparse` module provides a mechanism to process command line arguments.
|
||||
It should always be preferred over directly processing ``sys.argv`` manually.
|
||||
|
||||
Take, for example, the below snippet of code::
|
||||
|
||||
>>> import argparse
|
||||
>>> from getpass import getuser
|
||||
>>> parser = argparse.ArgumentParser(description='An argparse example.')
|
||||
>>> parser.add_argument('name', nargs='?', default=getuser(), help='The name of someone to greet.')
|
||||
>>> parser.add_argument('--verbose', '-v', action='count')
|
||||
>>> args = parser.parse_args()
|
||||
>>> greeting = ["Hi", "Hello", "Greetings! its very nice to meet you"][args.verbose % 3]
|
||||
>>> print(f'{greeting}, {args.name}')
|
||||
>>> if not args.verbose:
|
||||
>>> print('Try running this again with multiple "-v" flags!')
|
||||
|
||||
.. _tut-stderr:
|
||||
|
||||
|
|
|
@ -0,0 +1,2 @@
|
|||
Stop recommending getopt in the tutorial for command line argument parsing
|
||||
and promote argparse.
|
Loading…
Reference in New Issue