# grep -r 'from imp import ' *
# grep -r ' imp\.' *
# XXX generate this document programmatically?
#
#
# Markers:
#   + part of import system
#   - tests
#   o tools


usage of the imp module in CPython (.py files):
------------------------------------------------

imp.get_importer()
    Lib/runpy.py

imp.load_package()
    - Lib/test/test_imp.py

imp.load_source()
    - Lib/test/test_imp.py

imp.load_compiled()
    - Lib/test/test_imp.py

imp.lock_held()
    - Lib/test/test_socketserver.py
    - Lib/test/test_imp.py
    - Lib/test/test_threaded_import.py

imp.release_lock()
    + Lib/importlib/_bootstrap.py
    - Lib/test/test_fork1.py
    - Lib/test/test_imp.py

imp.acquire_lock()
    + Lib/importlib/_bootstrap.py
    - Lib/test/test_imp.py
    - Lib/test/test_fork1.py
    
imp.load_dynamic()
    + Lib/importlib/_bootstrap.py
    o Mac/Tools/bundlebuilder.py
    o setup.py
    
imp._fix_co_filename()
    + Lib/importlib/_bootstrap.py

imp.get_frozen_object()
    + Lib/importlib/_bootstrap.py

imp.init_frozen()
    + Lib/importlib/_bootstrap.py

imp.init_builtin()
    + Lib/importlib/_bootstrap.py

imp.is_builtin()
    + Lib/importlib/_bootstrap.py

imp.is_frozen()
    + Lib/importlib/_bootstrap.py

imp.NullImporter
    + Lib/importlib/_bootstrap.py
    - Lib/importlib/test/import_/test_path.py
    - Lib/importlib/test/test_api.py
    - Lib/test/test_sys.py
    - Lib/test/test_imp.py
    Lib/runpy.py

imp.new_module()
    + Lib/importlib/_bootstrap.py
    - Lib/importlib/test/source/test_abc_loader.py
    - Lib/importlib/test/source/test_file_loader.py
    - Lib/importlib/test/frozen/test_loader.py
    - Lib/importlib/test/util.py
    - Lib/importlib/test/test_util.py
    - Lib/importlib/test/benchmark.py
    - Lib/test/test_pkgutil.py
    - Lib/test/test_pdb.py
    Lib/runpy.py
    
imp.C_BUILTIN
    Lib/modulefinder.py

imp.C_EXTENSION
    Lib/pkgutil.py

imp.PY_COMPILED
    Lib/pkgutil.py

imp.PKG_DIRECTORY
    o Mac/Tools/bundlebuilder.py
    o Tools/i18n/pygettext.py
    Lib/modulefinder.py
    Lib/pyclbr.py
    Lib/pkgutil.py

imp.C_EXTENSION
    - Lib/importlib/test/extension/util.py
    o Misc/TextMate/Python-Dev.tmbundle/Commands/2 to 3 - Module Deletion.tmCommand
    Lib/pkgutil.py

imp.PY_SOURCE
    - Lib/test/test_imp.py
    o Tools/i18n/pygettext.py
    o Misc/TextMate/Python-Dev.tmbundle/Commands/2 to 3 - Module Deletion.tmCommand
    Lib/packaging/create.py
    Lib/pkgutil.py
    Lib/pydoc.py
    Lib/idlelib/EditorWindow.py
    Lib/modulefinder.py
    Lib/pyclbr.py

imp.PY_COMPILED
    Lib/pydoc.py
    Lib/modulefinder.py
    Lib/pkgutil.py

imp.get_magic()
    + Lib/importlib/_bootstrap.py
    - Lib/importlib/test/source/test_abc_loader.py
    - Lib/importlib/test/source/test_file_loader.py
    - Lib/test/test_zipimport.py
    - Lib/test/test_compileall.py
    o Mac/Tools/bundlebuilder.py
    o Tools/scripts/checkpyc.py
    Lib/pydoc.py
    Lib/compileall.py
    Lib/modulefinder.py
    Lib/importlib/abc.py
    Lib/pkgutil.py
    Lib/py_compile.py

imp.get_suffixes()
    + Lib/importlib/_bootstrap.py
    - Lib/importlib/test/extension/util.py
    o Mac/Tools/bundlebuilder.py
    o Misc/TextMate/Python-Dev.tmbundle/Commands/2 to 3 - Module Deletion.tmCommand
    o Tools/i18n/pygettext.py
    Lib/ctypes/util.py
    Lib/inspect.py
    Lib/idlelib/PathBrowser.py
    Lib/modulefinder.py

imp.cache_from_source()
    + Lib/importlib/_bootstrap.py
    - Lib/distutils/tests/test_install_lib.py
    - Lib/importlib/test/source/test_abc_loader.py
    - Lib/importlib/test/source/test_file_loader.py
    - Lib/importlib/test/benchmark.py
    - Lib/packaging/tests/test_command_install_lib.py
    - Lib/test/test_zipimport.py
    - Lib/test/test_py_compile.py
    - Lib/test/test_imp.py
    - Lib/test/test_compileall.py
    - Lib/test/test_import.py
    - Lib/test/support.py
    Lib/compileall.py
    Lib/py_compile.py
    Lib/zipfile.py
    Lib/distutils/util.py
    Lib/packaging/util.py

imp.source_from_cache()
    - Lib/test/test_zipfile.py
    - Lib/test/test_imp.py

imp.get_tag()
    - Lib/distutils/tests/test_build_py.py
    - Lib/distutils/tests/test_bdist_dumb.py
    - Lib/distutils/tests/test_install.py
    - Lib/packaging/tests/test_command_install_dist.py
    - Lib/packaging/tests/test_command_build_py.py
    - Lib/packaging/tests/test_command_bdist_dumb.py
    - Lib/test/test_imp.py
    - Lib/test/test_import.py

imp.load_module()
    - Lib/test/test_imp.py
    - Lib/test/test_importhooks.py
    - Lib/test/test_import.py
    Lib/pydoc.py
    Lib/idlelib/EditorWindow.py:
    Lib/pkgutil.py
    Lib/packaging/create.py
    Lib/multiprocessing/forking.py
    Python/makeopcodetargets.py

imp.find_module()
    - Lib/test/test_imp.py
    - Lib/test/test_unicode.py
    - Lib/test/test_importhooks.py
    - Lib/test/test_import.py
    o Mac/Tools/bundlebuilder.py
    o Python/makeopcodetargets.py
    o Tools/i18n/pygettext.py
    Lib/idlelib/EditorWindow.py
    Lib/modulefinder.py
    Lib/pkgutil.py
    Lib/pyclbr.py
    Lib/multiprocessing/forking.py

imp.reload()
    - Lib/test/test_imp.py
    - Lib/test/test_imp.py
    - Lib/test/test_imp.py
    - Lib/test/test_import.py
    o Doc/tutorial/modules.rst
    o Doc/faq/programming.rst
    o Doc/faq/programming.rst


imp.get_loader()
    Lib/runpy.py

PyImport_GetImporter()
    Lib/runpy.py


usage of __import__ in CPython (.py files):
--------------------------------------------

builtins.__import__()
    + Lib/importlib/_bootstrap.py
    - Lib/ctypes/test/__init__.py
    - Lib/unittest/mock.py
    - Lib/unittest/main.py
    - Lib/unittest/test/testmock/__init__.py
    - Lib/unittest/test/__init__.py
    - Lib/unittest/loader.py
    - Lib/distutils/tests/__init__.py
    - Lib/importlib/test/regrtest.py
    - Lib/importlib/test/import_/test_caching.py
    - Lib/importlib/test/import_/util.py
    - Lib/importlib/test/import_/test_api.py
    - Lib/importlib/test/import_/test_relative_imports.py
    - Lib/importlib/test/__main__.py
    - Lib/importlib/test/benchmark.py
    - Lib/lib2to3/tests/__init__.py
    - Lib/packaging/tests/test_dist.py
    - Lib/packaging/tests/__init__.py
    - Lib/test/test_zipimport.py
    - Lib/test/test_runpy.py
    - Lib/test/test_support.py
    - Lib/test/test_strlit.py
    - Lib/test/test_dbm.py
    - Lib/test/test_modulefinder.py
    - Lib/test/test_pyclbr.py
    - Lib/test/regrtest.py
    - Lib/test/test_imp.py
    - Lib/test/test_exceptions.py
    - Lib/test/test_multiprocessing.py
    - Lib/test/test_pkgimport.py
    - Lib/test/test_coding.py
    - Lib/test/test_email/test_email.py
    - Lib/test/test_fork1.py
    - Lib/test/test_importhooks.py
    - Lib/test/test_import.py
    - Lib/test/xmltests.py
    - Lib/test/test_builtin.py
    - Lib/test/support.py
    - Lib/test/test_uuid.py
    - Lib/test/test_pkg.py
    - Lib/test/json_tests/__init__.py
    - Lib/doctest.py
    o Tools/pynche/PyncheWidget.py
    o Tools/iobench/iobench.py
    o Tools/ccbench/ccbench.py
    o Misc/Vim/vim_syntax.py
    Lib/turtle.py
    Lib/ctypes/__init__.py
    Lib/warnings.py
    Lib/pydoc.py
    Lib/dbm/__init__.py
    Lib/pickle.py
    Lib/xml/sax/__init__.py
    Lib/xml/dom/domreg.py
    Lib/idlelib/EditorWindow.py
    Lib/idlelib/PyShell.py
    Lib/distutils/ccompiler.py
    Lib/distutils/dist.py
    Lib/turtledemo/__main__.py
    Lib/importlib/__init__.py
    Lib/encodings/__init__.py
    Lib/smtpd.py
    Lib/lib2to3/refactor.py
    Lib/logging/config.py
    Lib/pkgutil.py
    Lib/optparse.py
    Lib/packaging/util.py


usage of pkgutil module in CPython (.py files):
------------------------------------------------

pkgutil.iter_modules()
    - Lib/test/test_pkgutil.py
    Lib/pydoc.py

pkgutil.walk_packages()
    - Lib/test/test_pkgutil.py
    Lib/pydoc.py

pkgutil.extend_path()
    Lib/pkgutil.py

pkgutil.get_data()
    - Lib/test/test_pkgutil.py

pkgutil.get_loader()
    - Lib/test/test_doctest.py
    Lib/runpy.py

pkgutil.read_code()
    Lib/runpy.py


usage of compileall module in CPython:
---------------------------------------

compile_dir()
    - Lib/test/test_compileall.py


usage of pycompile module in CPython:
--------------------------------------

compile()
    + Lib/compileall.py
    - Lib/importlib/test/source/test_file_loader.py
    - Lib/importlib/test/source/test_finder.py
    - Lib/importlib/test/benchmark.py
    - Lib/test/test_runpy.py
    - Lib/test/test_py_compile.py
    - Lib/test/test_compileall.py
    - Lib/test/test_import.py
    - Lib/test/test_cmd_line_script.py
    o PC/bdist_wininst/install.c
    Lib/distutils/util.py
    Lib/packaging/util.py
    Lib/zipfile.py


PyCompileError
    Lib/compileall.py
    Lib/zipfile.py


usage of the import state in CPython:
--------------------------------------

sys.modules

sys.builtin_module_names

sys.dont_write_bytecode

sys.path

sys.meta_path

sys.path_importer_cache

sys.path_hooks