diff options
author | Brett Cannon <brett@python.org> | 2016-07-08 18:00:00 (GMT) |
---|---|---|
committer | Brett Cannon <brett@python.org> | 2016-07-08 18:00:00 (GMT) |
commit | fdcdd9ed80d2b4bf7e7dac04ed2d22e9cb747ff6 (patch) | |
tree | f9a0574f99b8d6541266b0c61230a9052ee6d8ad /Lib/pkgutil.py | |
parent | 15552c39e09426988d9ad0901a2aafc624e46e33 (diff) | |
download | cpython-fdcdd9ed80d2b4bf7e7dac04ed2d22e9cb747ff6.zip cpython-fdcdd9ed80d2b4bf7e7dac04ed2d22e9cb747ff6.tar.gz cpython-fdcdd9ed80d2b4bf7e7dac04ed2d22e9cb747ff6.tar.bz2 |
Issue #26896: Disambiguate uses of "importer" with "finder".
Thanks to Oren Milman for the patch.
Diffstat (limited to 'Lib/pkgutil.py')
-rw-r--r-- | Lib/pkgutil.py | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/Lib/pkgutil.py b/Lib/pkgutil.py index a04b7d1..15b3ae1 100644 --- a/Lib/pkgutil.py +++ b/Lib/pkgutil.py @@ -45,7 +45,7 @@ def read_code(stream): def walk_packages(path=None, prefix='', onerror=None): - """Yields (module_loader, name, ispkg) for all modules recursively + """Yields (module_finder, name, ispkg) for all modules recursively on path, or, if path is None, all accessible modules. 'path' should be either None or a list of paths to look for @@ -102,7 +102,7 @@ def walk_packages(path=None, prefix='', onerror=None): def iter_modules(path=None, prefix=''): - """Yields (module_loader, name, ispkg) for all submodules on path, + """Yields (module_finder, name, ispkg) for all submodules on path, or, if path is None, all top-level modules on sys.path. 'path' should be either None or a list of paths to look for @@ -184,10 +184,10 @@ def _import_imp(): imp = importlib.import_module('imp') class ImpImporter: - """PEP 302 Importer that wraps Python's "classic" import algorithm + """PEP 302 Finder that wraps Python's "classic" import algorithm - ImpImporter(dirname) produces a PEP 302 importer that searches that - directory. ImpImporter(None) produces a PEP 302 importer that searches + ImpImporter(dirname) produces a PEP 302 finder that searches that + directory. ImpImporter(None) produces a PEP 302 finder that searches the current sys.path, plus any modules that are frozen or built-in. Note that ImpImporter does not currently support being used by placement @@ -395,9 +395,9 @@ except ImportError: def get_importer(path_item): - """Retrieve a PEP 302 importer for the given path item + """Retrieve a PEP 302 finder for the given path item - The returned importer is cached in sys.path_importer_cache + The returned finder is cached in sys.path_importer_cache if it was newly created by a path hook. The cache (or part of it) can be cleared manually if a @@ -419,16 +419,16 @@ def get_importer(path_item): def iter_importers(fullname=""): - """Yield PEP 302 importers for the given module name + """Yield PEP 302 finders for the given module name - If fullname contains a '.', the importers will be for the package + If fullname contains a '.', the finders will be for the package containing fullname, otherwise they will be all registered top level - importers (i.e. those on both sys.meta_path and sys.path_hooks). + finders (i.e. those on both sys.meta_path and sys.path_hooks). If the named module is in a package, that package is imported as a side effect of invoking this function. - If no module name is specified, all top level importers are produced. + If no module name is specified, all top level finders are produced. """ if fullname.startswith('.'): msg = "Relative module name {!r} not supported".format(fullname) |