[Python-checkins] bpo-43644: Add docs for importlib.resources.as_file. (GH-25048)
miss-islington
webhook-mailer at python.org
Sat Mar 27 20:49:00 EDT 2021
https://github.com/python/cpython/commit/138e039ff9e5330709643b1bfe623eeac8fdc681
commit: 138e039ff9e5330709643b1bfe623eeac8fdc681
branch: 3.9
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2021-03-27T17:48:53-07:00
summary:
bpo-43644: Add docs for importlib.resources.as_file. (GH-25048)
(cherry picked from commit af50c84643ce21cfbdfdabbdfae6bd5e1368c542)
Co-authored-by: Jason R. Coombs <jaraco at jaraco.com>
files:
M Doc/library/importlib.rst
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index cb2a5686a95a5..61a81e02ff88f 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -888,6 +888,22 @@ The following functions are available.
.. versionadded:: 3.9
+.. function:: as_file(traversable)
+
+ Given a :class:`importlib.resources.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.
+
+ Exiting the context manager cleans up any temporary file created when the
+ resource was extracted from e.g. a zip file.
+
+ Use ``as_file`` when the Traversable methods
+ (``read_text``, etc) are insufficient and an actual file on
+ the file system is required.
+
+ .. versionadded:: 3.9
+
.. function:: open_binary(package, resource)
Open for binary reading the *resource* within *package*.
More information about the Python-checkins
mailing list