mirror of https://github.com/python/cpython
Merge
This commit is contained in:
commit
4a57846efe
|
@ -739,7 +739,7 @@ how the command-line arguments should be handled. The supported actions are:
|
||||||
|
|
||||||
* ``'version'`` - This expects a ``version=`` keyword argument in the
|
* ``'version'`` - This expects a ``version=`` keyword argument in the
|
||||||
:meth:`~ArgumentParser.add_argument` call, and prints version information
|
:meth:`~ArgumentParser.add_argument` call, and prints version information
|
||||||
and exits when invoked.
|
and exits when invoked::
|
||||||
|
|
||||||
>>> import argparse
|
>>> import argparse
|
||||||
>>> parser = argparse.ArgumentParser(prog='PROG')
|
>>> parser = argparse.ArgumentParser(prog='PROG')
|
||||||
|
@ -791,8 +791,8 @@ single action to be taken. The ``nargs`` keyword argument associates a
|
||||||
different number of command-line arguments with a single action. The supported
|
different number of command-line arguments with a single action. The supported
|
||||||
values are:
|
values are:
|
||||||
|
|
||||||
* ``N`` (an integer). ``N`` arguments from the command line will be gathered together into a
|
* ``N`` (an integer). ``N`` arguments from the command line will be gathered
|
||||||
list. For example::
|
together into a list. For example::
|
||||||
|
|
||||||
>>> parser = argparse.ArgumentParser()
|
>>> parser = argparse.ArgumentParser()
|
||||||
>>> parser.add_argument('--foo', nargs=2)
|
>>> parser.add_argument('--foo', nargs=2)
|
||||||
|
@ -861,7 +861,7 @@ values are:
|
||||||
|
|
||||||
* ``argparse.REMAINDER``. All the remaining command-line arguments are gathered
|
* ``argparse.REMAINDER``. All the remaining command-line arguments are gathered
|
||||||
into a list. This is commonly useful for command line utilities that dispatch
|
into a list. This is commonly useful for command line utilities that dispatch
|
||||||
to other command line utilities.
|
to other command line utilities::
|
||||||
|
|
||||||
>>> parser = argparse.ArgumentParser(prog='PROG')
|
>>> parser = argparse.ArgumentParser(prog='PROG')
|
||||||
>>> parser.add_argument('--foo')
|
>>> parser.add_argument('--foo')
|
||||||
|
@ -884,7 +884,8 @@ the various :class:`ArgumentParser` actions. The two most common uses of it are
|
||||||
|
|
||||||
* When :meth:`~ArgumentParser.add_argument` is called with
|
* When :meth:`~ArgumentParser.add_argument` is called with
|
||||||
``action='store_const'`` or ``action='append_const'``. These actions add the
|
``action='store_const'`` or ``action='append_const'``. These actions add the
|
||||||
``const`` value to one of the attributes of the object returned by :meth:`~ArgumentParser.parse_args`. See the action_ description for examples.
|
``const`` value to one of the attributes of the object returned by
|
||||||
|
:meth:`~ArgumentParser.parse_args`. See the action_ description for examples.
|
||||||
|
|
||||||
* When :meth:`~ArgumentParser.add_argument` is called with option strings
|
* When :meth:`~ArgumentParser.add_argument` is called with option strings
|
||||||
(like ``-f`` or ``--foo``) and ``nargs='?'``. This creates an optional
|
(like ``-f`` or ``--foo``) and ``nargs='?'``. This creates an optional
|
||||||
|
@ -1595,7 +1596,7 @@ FileType objects
|
||||||
The :class:`FileType` factory creates objects that can be passed to the type
|
The :class:`FileType` factory creates objects that can be passed to the type
|
||||||
argument of :meth:`ArgumentParser.add_argument`. Arguments that have
|
argument of :meth:`ArgumentParser.add_argument`. Arguments that have
|
||||||
:class:`FileType` objects as their type will open command-line arguments as files
|
:class:`FileType` objects as their type will open command-line arguments as files
|
||||||
with the requested modes and buffer sizes:
|
with the requested modes and buffer sizes::
|
||||||
|
|
||||||
>>> parser = argparse.ArgumentParser()
|
>>> parser = argparse.ArgumentParser()
|
||||||
>>> parser.add_argument('--output', type=argparse.FileType('wb', 0))
|
>>> parser.add_argument('--output', type=argparse.FileType('wb', 0))
|
||||||
|
@ -1604,7 +1605,7 @@ FileType objects
|
||||||
|
|
||||||
FileType objects understand the pseudo-argument ``'-'`` and automatically
|
FileType objects understand the pseudo-argument ``'-'`` and automatically
|
||||||
convert this into ``sys.stdin`` for readable :class:`FileType` objects and
|
convert this into ``sys.stdin`` for readable :class:`FileType` objects and
|
||||||
``sys.stdout`` for writable :class:`FileType` objects:
|
``sys.stdout`` for writable :class:`FileType` objects::
|
||||||
|
|
||||||
>>> parser = argparse.ArgumentParser()
|
>>> parser = argparse.ArgumentParser()
|
||||||
>>> parser.add_argument('infile', type=argparse.FileType('r'))
|
>>> parser.add_argument('infile', type=argparse.FileType('r'))
|
||||||
|
|
Loading…
Reference in New Issue