gh-85935: Explicitly document the case nargs=0 in argparse (GH-125302)

This commit is contained in:
Serhiy Storchaka 2024-10-12 14:53:00 +03:00 committed by GitHub
parent a6c0c64de0
commit 07c2d15977
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -751,6 +751,9 @@ how the command-line arguments should be handled. The supplied actions are:
.. versionadded:: 3.8
Only actions that consume command-line arguments (e.g. ``'store'``,
``'append'`` or ``'extend'``) can be used with positional arguments.
You may also specify an arbitrary action by passing an Action subclass or
other object that implements the same interface. The ``BooleanOptionalAction``
is available in ``argparse`` and adds support for boolean actions such as
@ -878,6 +881,8 @@ See also :ref:`specifying-ambiguous-arguments`. The supported values are:
If the ``nargs`` keyword argument is not provided, the number of arguments consumed
is determined by the action_. Generally this means a single command-line argument
will be consumed and a single item (not a list) will be produced.
Actions that do not consume command-line arguments (e.g.
``'store_const'``) set ``nargs=0``.
.. _const: