Skip to content

gh-121607: Edited source file import recipe to make it more clear #121519

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Sep 13, 2024
Merged

gh-121607: Edited source file import recipe to make it more clear #121519

Changes from 1 commit
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
08917bd
edited source file import recipe to make it more clear
ChrisBarker-NOAA Jul 8, 2024
bab2fa8
added a note about deprecation of the load_module() method.
ChrisBarker-NOAA Jul 8, 2024
81885ad
Update Doc/library/importlib.rst
ChrisBarker-NOAA Jul 10, 2024
7905ab0
Update Doc/library/importlib.rst
ChrisBarker-NOAA Jul 10, 2024
c78a1a6
removed the note directive.
ChrisBarker-NOAA Jul 10, 2024
b9cb5d3
Update importlib.rst
ChrisBarker-NOAA Jul 10, 2024
73e4c94
added intro paragraph to Importing a source file directly recipe with…
ChrisBarker-NOAA Jul 15, 2024
fed1797
Update Doc/library/importlib.rst
ChrisBarker-NOAA Jul 15, 2024
e5a864e
Update Doc/library/importlib.rst
ChrisBarker-NOAA Jul 15, 2024
e6a1965
Wrap lines to 80 columns
brettcannon Sep 13, 2024
5a74186
Merge branch 'main' into importlib_docs
brettcannon Sep 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions Doc/library/importlib.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1584,9 +1584,10 @@ Note that if ``name`` is a submodule (contains a dot),
Importing a source file directly
''''''''''''''''''''''''''''''''

``SourceFileLoader.load_module()`` has been deprecated -- this recipe should be used instead.
This recipe should be used with caution: it is an approximation of an import statement where the file path is specified directly, rather than `sys.path` being searched.
Alternatives should first be considered, such as modifying `sys.path` when a proper module is required, or using `runpy.run_path()` when the global namespace resulting from running a Python file is appropriate.

To import a Python source file directly, use the following recipe::
To import a Python source file directly from a path, use the following recipe::

import importlib.util
import sys
Expand Down Expand Up @@ -1632,7 +1633,6 @@ The example below shows how to implement lazy imports::
False



Setting up an importer
''''''''''''''''''''''

Expand Down