Move as_file to the global namespace and update documentation accordi…

…ngly. Closes python#86.
jaraco · Mar 5, 2020 · a4cf54d · a4cf54d
1 parent 6e91e7f
commit a4cf54d
Show file tree

Hide file tree

Showing 2 changed files with 3 additions and 2 deletions.
diff --git a/importlib_resources/__init__.py b/importlib_resources/__init__.py
@@ -3,12 +3,14 @@
 import sys
 
 from ._compat import metadata
+from .trees import as_file
 
 
 __all__ = [
     'Package',
     'Resource',
     'ResourceReader',
+    'as_file',
     'contents',
     'files',
     'is_resource',

diff --git a/importlib_resources/docs/using.rst b/importlib_resources/docs/using.rst
@@ -155,8 +155,7 @@ to this temporary file as a :py:class:`pathlib.Path` object.  In order to
 properly clean up this temporary file, what's actually returned is a context
 manager that you can use in a ``with``-statement::
 
-    from importlib_resources import files
-    from importlib_resources.trees import as_file
+    from importlib_resources import files, as_file
 
     source = files(email.tests.data).joinpath('message.eml')
     with as_file(source) as eml: