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 | 13 |
1 files changed, 13 insertions, 0 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 new file mode 100644 index 0000000..a41fde9 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2017-12-15-15-34-12.bpo-32248.zmO8G2.rst @@ -0,0 +1,13 @@ +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`. |