diff options
author | Barry Warsaw <barry@python.org> | 2018-01-24 20:36:21 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2018-01-24 20:36:21 (GMT) |
commit | 6f6eb35f9bee18f54945f09664344f2d118ed89f (patch) | |
tree | e1e7432ccc9f7755d85da2803181f04504ac3894 /Misc | |
parent | 789e359f51d2b27bea01b8c6c3bf090aaedf8839 (diff) | |
download | cpython-6f6eb35f9bee18f54945f09664344f2d118ed89f.zip cpython-6f6eb35f9bee18f54945f09664344f2d118ed89f.tar.gz cpython-6f6eb35f9bee18f54945f09664344f2d118ed89f.tar.bz2 |
bpo-32248 - Implement `ResourceReader` and `get_resource_reader()` for zipimport (#5248)
Diffstat (limited to 'Misc')
-rw-r--r-- | Misc/NEWS.d/next/Library/2017-12-15-15-34-12.bpo-32248.zmO8G2.rst | 19 |
1 files changed, 6 insertions, 13 deletions
diff --git a/Misc/NEWS.d/next/Library/2017-12-15-15-34-12.bpo-32248.zmO8G2.rst b/Misc/NEWS.d/next/Library/2017-12-15-15-34-12.bpo-32248.zmO8G2.rst index a41fde9..d821cf9 100644 --- a/Misc/NEWS.d/next/Library/2017-12-15-15-34-12.bpo-32248.zmO8G2.rst +++ b/Misc/NEWS.d/next/Library/2017-12-15-15-34-12.bpo-32248.zmO8G2.rst @@ -1,13 +1,6 @@ -Add :class:`importlib.abc.ResourceReader` as an ABC to provide a -unified API for reading resources contained within packages. Loaders -wishing to support resource reading are expected to implement the -``get_resource_reader(fullname)`` method. - -Also add :mod:`importlib.resources` as the stdlib port of the -``importlib_resources`` PyPI package. The modules provides a high-level -API for end-users to read resources in a nicer fashion than having to -directly interact with low-level details such as loaders. - -Thanks to this work, :class:`importlib.abc.ResourceLoader` has now -been documented as deprecated due to its under-specified nature and -lack of features as provided by :class:`importlib.abc.ResourceReader`. +Add :mod:`importlib.resources` and :class:`importlib.abc.ResourceReader` as +the unified API for reading resources contained within packages. Loaders +wishing to support resource reading must implement the +:meth:`get_resource_reader()` method. File-based and zipimport-based loaders +both implement these APIs. :class:`importlib.abc.ResourceLoader` is +deprecated in favor of these new APIs. |