mirror of https://github.com/python/cpython.git
55 lines
1.8 KiB
Python
55 lines
1.8 KiB
Python
"""Subset of importlib.abc used to reduce importlib.util imports."""
|
|
from . import _bootstrap
|
|
import abc
|
|
import warnings
|
|
|
|
|
|
class Loader(metaclass=abc.ABCMeta):
|
|
|
|
"""Abstract base class for import loaders."""
|
|
|
|
def create_module(self, spec):
|
|
"""Return a module to initialize and into which to load.
|
|
|
|
This method should raise ImportError if anything prevents it
|
|
from creating a new module. It may return None to indicate
|
|
that the spec should create the new module.
|
|
"""
|
|
# By default, defer to default semantics for the new module.
|
|
return None
|
|
|
|
# We don't define exec_module() here since that would break
|
|
# hasattr checks we do to support backward compatibility.
|
|
|
|
def load_module(self, fullname):
|
|
"""Return the loaded module.
|
|
|
|
The module must be added to sys.modules and have import-related
|
|
attributes set properly. The fullname is a str.
|
|
|
|
ImportError is raised on failure.
|
|
|
|
This method is deprecated in favor of loader.exec_module(). If
|
|
exec_module() exists then it is used to provide a backwards-compatible
|
|
functionality for this method.
|
|
|
|
"""
|
|
if not hasattr(self, 'exec_module'):
|
|
raise ImportError
|
|
# Warning implemented in _load_module_shim().
|
|
return _bootstrap._load_module_shim(self, fullname)
|
|
|
|
def module_repr(self, module):
|
|
"""Return a module's repr.
|
|
|
|
Used by the module type when the method does not raise
|
|
NotImplementedError.
|
|
|
|
This method is deprecated.
|
|
|
|
"""
|
|
warnings.warn("importlib.abc.Loader.module_repr() is deprecated and "
|
|
"slated for removal in Python 3.12", DeprecationWarning)
|
|
# The exception will cause ModuleType.__repr__ to ignore this method.
|
|
raise NotImplementedError
|