diff options
| author | Brett Cannon <brettcannon@users.noreply.github.com> | 2018-01-12 23:08:59 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2018-01-12 23:08:59 (GMT) |
| commit | bca42186b69e2e615d29d0d4fdb493c9fe71c48b (patch) | |
| tree | fffc97d389a1f85f43312a11b31e83cb1c5c3b39 /Misc/NEWS.d/next/Library/2017-12-15-15-34-12.bpo-32248.zmO8G2.rst | |
| parent | 5b76bdba071e7bbd9fda0b9b100d1506d95c04bd (diff) | |
| download | cpython-bca42186b69e2e615d29d0d4fdb493c9fe71c48b.zip cpython-bca42186b69e2e615d29d0d4fdb493c9fe71c48b.tar.gz cpython-bca42186b69e2e615d29d0d4fdb493c9fe71c48b.tar.bz2 | |
bpo-32248: Introduce the concept of Loader.get_resource_reader() (GH-5108)
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`. |