diff options
Diffstat (limited to 'Misc/NEWS.d/next/Library/2017-12-15-15-34-12.bpo-32248.zmO8G2.rst')
| -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. |