From 0ce968b7f49b3364059f2b5524b3f608ca306e22 Mon Sep 17 00:00:00 2001 From: "Jason R. Coombs" Date: Fri, 23 Sep 2022 18:31:40 -0400 Subject: [PATCH 1/2] [3.10] gh-96845: Correct reference to Traversable* classes. --- Doc/library/importlib.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst index 3981cc6f2d9650..23655571e0fc99 100644 --- a/Doc/library/importlib.rst +++ b/Doc/library/importlib.rst @@ -930,7 +930,7 @@ The following functions are available. .. function:: files(package) - Returns an :class:`importlib.resources.abc.Traversable` object + Returns an :class:`importlib.abc.Traversable` object representing the resource container for the package (think directory) and its resources (think files). A Traversable may contain other containers (think subdirectories). @@ -942,7 +942,7 @@ The following functions are available. .. function:: as_file(traversable) - Given a :class:`importlib.resources.abc.Traversable` object representing + Given a :class:`importlib.abc.Traversable` object representing a file, typically from :func:`importlib.resources.files`, return a context manager for use in a :keyword:`with` statement. The context manager provides a :class:`pathlib.Path` object. From 462c490aff6ada2922e76196ec70ff9f77172bd7 Mon Sep 17 00:00:00 2001 From: "Jason R. Coombs" Date: Fri, 23 Sep 2022 18:32:12 -0400 Subject: [PATCH 2/2] [3.10] gh-96845: Add a note about the pending move of resources.abcs. --- Doc/library/importlib.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst index 23655571e0fc99..1addba3fb47f99 100644 --- a/Doc/library/importlib.rst +++ b/Doc/library/importlib.rst @@ -854,6 +854,8 @@ ABC hierarchy:: Read contents of self as text. + Note: In Python 3.11 and later, this class is found in ``importlib.resources.abc``. + .. class:: TraversableResources @@ -868,6 +870,8 @@ ABC hierarchy:: .. versionadded:: 3.9 + Note: In Python 3.11 and later, this class is found in ``importlib.resources.abc``. + :mod:`importlib.resources` -- Resources ---------------------------------------