mirror of
https://github.com/python/cpython.git
synced 2025-07-24 11:44:31 +00:00
6f3c2c8d04
* Remove getopt and optparse deprecation notices
* Add new docs sections for command line app helper libraries
* Add guidance on choosing a CLI parsing library to the optparse docs
* Link to the new guidance from the argparse and getopt docs
* Reword intro in docs section for superseded stdlib modules
* Reframe the optparse->argparse guide as a migration guide
rather than as an upgrade guide
---------
(cherry picked from commit 831b6de6d7)
Co-authored-by: Alyssa Coghlan <ncoghlan@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
26 lines
1 KiB
ReStructuredText
26 lines
1 KiB
ReStructuredText
.. _superseded:
|
|
|
|
******************
|
|
Superseded Modules
|
|
******************
|
|
|
|
The modules described in this chapter have been superseded by other modules
|
|
for most use cases, and are retained primarily to preserve backwards compatibility.
|
|
|
|
Modules may appear in this chapter because they only cover a limited subset of
|
|
a problem space, and a more generally applicable solution is available elsewhere
|
|
in the standard library (for example, :mod:`getopt` covers the very specific
|
|
task of "mimic the C :c:func:`!getopt` API in Python", rather than the broader
|
|
command line option parsing and argument parsing capabilities offered by
|
|
:mod:`optparse` and :mod:`argparse`).
|
|
|
|
Alternatively, modules may appear in this chapter because they are deprecated
|
|
outright, and awaiting removal in a future release, or they are
|
|
:term:`soft deprecated` and their use is actively discouraged in new projects.
|
|
With the removal of various obsolete modules through :pep:`594`, there are
|
|
currently no modules in this latter category.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
getopt.rst
|