diff options
author | Thomas Grainger <tagrain@gmail.com> | 2022-07-17 01:07:53 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-07-17 01:07:53 (GMT) |
commit | 6da988a46c8955755624ad9878288d5214fceb4e (patch) | |
tree | bc3d48d836bb49b52f76761f776ec8c0440793a2 /Doc | |
parent | 2e9da8e3522764d09f1d6054a2be567e91a30812 (diff) | |
download | cpython-6da988a46c8955755624ad9878288d5214fceb4e.zip cpython-6da988a46c8955755624ad9878288d5214fceb4e.tar.gz cpython-6da988a46c8955755624ad9878288d5214fceb4e.tar.bz2 |
gh-91181: drop support for bytes on sys.path (GH-31934)
Support for bytes broke sometime between Python 3.2 and 3.6 and has been broken ever since. Trying to bring back supports is surprisingly difficult in the face of -b and checking for keys in sys.path_importer_cache. Since the support was broken for so long, trying to overcome the difficulty of bringing back the support has been deemed not worth it.
Co-authored-by: Eryk Sun <eryksun@gmail.com>
Co-authored-by: Brett Cannon <brett@python.org>
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/sys.rst | 2 | ||||
-rw-r--r-- | Doc/reference/import.rst | 6 |
2 files changed, 3 insertions, 5 deletions
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst index 7e24684..d9799f8 100644 --- a/Doc/library/sys.rst +++ b/Doc/library/sys.rst @@ -1158,7 +1158,7 @@ always available. line option or the :envvar:`PYTHONSAFEPATH` environment variable? A program is free to modify this list for its own purposes. Only strings - and bytes should be added to :data:`sys.path`; all other data types are + should be added to :data:`sys.path`; all other data types are ignored during import. diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 29d402e..1e6b08f 100644 --- a/Doc/reference/import.rst +++ b/Doc/reference/import.rst @@ -800,10 +800,8 @@ environment variable and various other installation- and implementation-specific defaults. Entries in :data:`sys.path` can name directories on the file system, zip files, and potentially other "locations" (see the :mod:`site` module) that should be searched for modules, such as -URLs, or database queries. Only strings and bytes should be present on -:data:`sys.path`; all other data types are ignored. The encoding of bytes -entries is determined by the individual :term:`path entry finders <path entry -finder>`. +URLs, or database queries. Only strings should be present on +:data:`sys.path`; all other data types are ignored. The :term:`path based finder` is a :term:`meta path finder`, so the import machinery begins the :term:`import path` search by calling the path |