Feb 5, 2024 · Jan 15, 2024 · Jan 15, 2024 · Jan 15, 2024 · Jan 15, 2024 · Jan 15, 2024
diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
   * dest_ - The name of the attribute to be added to the object returned by
     :meth:`parse_args`.

   * deprecated_ - Whether or not the usage of the argument is deprecated.

 The following sections describe how each of these are used.


   >>> parser.parse_args('--foo XXX'.split())
   Namespace(bar='XXX')


 .. _deprecated::

 deprecated
 ^^^^^^^^^^

 During projects lifecycle some arguments could be removed from the
 command line, before removing these arguments definitively you would inform
 your user that arguments are deprecated and will be removed.
 The ``deprecated`` keyword argument of
 :meth:`~ArgumentParser.add_argument`, whose value default to ``False``,
 specifies if the argument is deprecated and will be removed
 from the command-line available arguments in the future.
 For arguments, if ``deprecated`` is ``True`` then a warning will be
 printed to the standard error if the argument is given by user in the
 command line parameters::

   >>> import argparse
   >>> parser = argparse.ArgumentParser(prog='snake.py')
   >>> parser.add_argument('--legs', default=0, deprecated=True)
   >>> parser.parse_args([])
   Namespace(legs='0')
   >>> parser.parse_args(['--legs', '4'])
   snake.py: warning: usage of option '--legs' is deprecated
   Namespace(legs='4')

 .. versionchanged:: 3.13


 Action classes
 ^^^^^^^^^^^^^^


       {foo,bar}   additional help

   Furthermore, ``add_parser`` supports an additional ``aliases`` argument,
   Furthermore, :meth:`~_SubParsersAction.add_parser` supports an additional
   *aliases* argument,
   which allows multiple strings to refer to the same subparser. This example,
   like ``svn``, aliases ``co`` as a shorthand for ``checkout``::

     >>> parser.parse_args(['co', 'bar'])
     Namespace(foo='bar')

   :meth:`~_SubParsersAction.add_parser` supports also an additional
   *deprecated* argument, which allows to deprecate the subparser.

      >>> import argparse
      >>> parser = argparse.ArgumentParser(prog='chicken.py')
      >>> subparsers = parser.add_subparsers()
      >>> run = subparsers.add_parser('run')
      >>> fly = subparsers.add_parser('fly', deprecated=True)
      >>> parser.parse_args(['fly'])
      chicken.py: warning: usage of command 'fly' is deprecated
      Namespace()

   .. versionadded:: 3.13

   One particularly effective way of handling sub-commands is to combine the use
   of the :meth:`add_subparsers` method with calls to :meth:`set_defaults` so
   that each subparser knows which Python function it should execute.  For
diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst
  possible to obtain an optimized ``AST``.
  (Contributed by Irit Katriel in :gh:`108113`).

 argrapse
 --------

 * Add parameter *deprecated* in methods
  :meth:`~argparse.ArgumentParser.add_argument` and :meth:`!add_parser`
  which allows to deprecate command-line options, positional arguments and
  subcommands.

 array
 -----
Original file line number	Diff line number	Diff line change
Expand Up		@@ -777,6 +777,8 @@ The add_argument() method
		* dest_ - The name of the attribute to be added to the object returned by
		:meth:`parse_args`.

		* deprecated_ - Whether or not the usage of the argument is deprecated.
serhiy-storchaka marked this conversation as resolved. Show resolvedHide resolved

		The following sections describe how each of these are used.


Expand DownExpand Up		@@ -1439,6 +1441,35 @@ behavior::
		>>> parser.parse_args('--foo XXX'.split())
		Namespace(bar='XXX')


		.. _deprecated::

		deprecated
		^^^^^^^^^^

		During projects lifecycle some arguments could be removed from the
		command line, before removing these arguments definitively you would inform
		your user that arguments are deprecated and will be removed.
serhiy-storchaka marked this conversation as resolved. Show resolvedHide resolved
		The ``deprecated`` keyword argument of
		:meth:`~ArgumentParser.add_argument`, whose value default to ``False``,
		specifies if the argument is deprecated and will be removed
		from the command-line available arguments in the future.
serhiy-storchaka marked this conversation as resolved. Show resolvedHide resolved
		For arguments, if ``deprecated`` is ``True`` then a warning will be
		printed to the standard error if the argument is given by user in the
		command line parameters::
serhiy-storchaka marked this conversation as resolved. Show resolvedHide resolved

		>>> import argparse
		>>> parser = argparse.ArgumentParser(prog='snake.py')
		>>> parser.add_argument('--legs', default=0, deprecated=True)
		>>> parser.parse_args([])
		Namespace(legs='0')
		>>> parser.parse_args(['--legs', '4'])
		snake.py: warning: usage of option '--legs' is deprecated
		Namespace(legs='4')

		.. versionchanged:: 3.13


		Action classes
		^^^^^^^^^^^^^^

Expand DownExpand Up		@@ -1842,7 +1873,8 @@ Sub-commands

		{foo,bar} additional help

		Furthermore, ``add_parser`` supports an additional ``aliases`` argument,
		Furthermore, :meth:`~_SubParsersAction.add_parser` supports an additional
		aliases argument,
		which allows multiple strings to refer to the same subparser. This example,
		like ``svn``, aliases ``co`` as a shorthand for ``checkout``::

Expand All		@@ -1853,6 +1885,20 @@ Sub-commands
		>>> parser.parse_args(['co', 'bar'])
		Namespace(foo='bar')

		:meth:`~_SubParsersAction.add_parser` supports also an additional
		deprecated argument, which allows to deprecate the subparser.

		>>> import argparse
		>>> parser = argparse.ArgumentParser(prog='chicken.py')
		>>> subparsers = parser.add_subparsers()
		>>> run = subparsers.add_parser('run')
		>>> fly = subparsers.add_parser('fly', deprecated=True)
		>>> parser.parse_args(['fly'])
		chicken.py: warning: usage of command 'fly' is deprecated
		Namespace()

		.. versionadded:: 3.13

		One particularly effective way of handling sub-commands is to combine the use
		of the :meth:`add_subparsers` method with calls to :meth:`set_defaults` so
		that each subparser knows which Python function it should execute. For
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -154,6 +154,14 @@ ast
		possible to obtain an optimized ``AST``.
		(Contributed by Irit Katriel in :gh:`108113`).

		argrapse
serhiy-storchaka marked this conversation as resolved. Show resolvedHide resolved
		--------

		* Add parameter deprecated in methods
		:meth:`~argparse.ArgumentParser.add_argument` and :meth:`!add_parser`
		which allows to deprecate command-line options, positional arguments and
		subcommands.

		array
		-----

Expand Down