New submission from Antony Lee <[email protected]>:
The stdlib docs intro include the following sentences:
It also describes some of the optional components that are commonly
included in Python distributions.
For Unix-like operating systems Python is normally provided as a collection
of packages, so it may be necessary to use the packaging tools provided with
the operating system to obtain some or all of the optional components.
However, as far as I can tell, there is no easy way to actually know what parts
of the stdlib are "optional". The _thread module's doc does state "The module
is optional.", and the threading module's doc also implies that it is optional
("The dummy_threading module is provided for situations where threading cannot
be used because _thread is missing.") (yes, I know support for threadless
builds is going away in 3.7; that's irrelevant here.), but even ensurepip's
docs don't state that it may be missing (even though I believe(?) that it is
indeed removed (and intended to be so) from some linux distribution's Pythons).
A master list of "optional" features would thus be welcome. Its usefulness is
to know what parts of the stdlib we can actually rely on; e.g. in
https://github.com/matplotlib/matplotlib/issues/10866 a Matplotlib user noted
that bz2 is not present in all Python installs.
----------
assignee: docs@python
components: Documentation
messages: 317140
nosy: Antony.Lee, docs@python
priority: normal
severity: normal
status: open
title: Document "optional components that are commonly included in Python
distributions."
_______________________________________
Python tracker <[email protected]>
<https://bugs.python.org/issue33581>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
