| 1 |
.. _superseded: |
| 2 |
|
| 3 |
****************** |
| 4 |
Superseded Modules |
| 5 |
****************** |
| 6 |
|
| 7 |
The modules described in this chapter have been superseded by other modules |
| 8 |
for most use cases, and are retained primarily to preserve backwards compatibility. |
| 9 |
|
| 10 |
Modules may appear in this chapter because they only cover a limited subset of |
| 11 |
a problem space, and a more generally applicable solution is available elsewhere |
| 12 |
in the standard library (for example, :mod:`getopt` covers the very specific |
| 13 |
task of "mimic the C :c:func:`!getopt` API in Python", rather than the broader |
| 14 |
command line option parsing and argument parsing capabilities offered by |
| 15 |
:mod:`optparse` and :mod:`argparse`). |
| 16 |
|
| 17 |
Alternatively, modules may appear in this chapter because they are deprecated |
| 18 |
outright, and awaiting removal in a future release, or they are |
| 19 |
:term:`soft deprecated` and their use is actively discouraged in new projects. |
| 20 |
With the removal of various obsolete modules through :pep:`594`, there are |
| 21 |
currently no modules in this latter category. |
| 22 |
|
| 23 |
.. toctree:: |
| 24 |
:maxdepth: 1 |
| 25 |
|
| 26 |
getopt.rst |