Method pyimport

src/_pytest/_py/path.py:1070–1157

Return path as an imported python module. If modname is None, look for the containing package and construct an according module name. The module will be put/looked up in sys.modules. if ensuresyspath is True then the root dir for importing the file (taking __

(self, modname=None, ensuresyspath=True)

                    sys.path.insert(0, s)

    def pyimport(self, modname=None, ensuresyspath=True):
        class="st">"""Return path as an imported python module.

        If modname is None, look for the containing package
        and construct an according module name.
        The module will be put/looked up in sys.modules.
        if ensuresyspath is True then the root dir for importing
        the file (taking __init__.py files into account) will
        be prepended to sys.path if it isn&class="cm">#x27;t there already.
        If ensuresyspath==class="st">"append" the root dir will be appended
        if it isn&class="cm">#x27;t already contained in sys.path.
        if ensuresyspath is False no modification of syspath happens.

        Special value of ensuresyspath==class="st">"importlib" is intended
        purely for using in pytest, it is capable only of importing
        separate .py files outside packages, e.g. for test suite
        without any __init__.py file. It effectively allows having
        same-named test modules in different places and offers
        mild opt-in via this option. Note that it works only in
        recent versions of python.
        class="st">"""
        if not self.check():
            raise error.ENOENT(self)

        if ensuresyspath == class="st">"importlib":
            if modname is None:
                modname = self.purebasename
            spec = importlib.util.spec_from_file_location(modname, str(self))
            if spec is None or spec.loader is None:
                raise ImportError(fclass="st">"Can&class="cm">#x27;t find module {modname} at location {self!s}")
            mod = importlib.util.module_from_spec(spec)
            spec.loader.exec_module(mod)
            return mod

        pkgpath = None
        if modname is None:
            pkgpath = self.pypkgpath()
            if pkgpath is not None:
                pkgroot = pkgpath.dirpath()
                names = self.new(ext=class="st">"").relto(pkgroot).split(self.sep)
                if names[-1] == class="st">"__init__":
                    names.pop()
                modname = class="st">".".join(names)
            else:
                pkgroot = self.dirpath()
                modname = self.purebasename

            self._ensuresyspath(ensuresyspath, pkgroot)
            __import__(modname)
            mod = sys.modules[modname]
            if self.basename == class="st">"__init__.py":
                return mod  class="cm"># we don't check anything as we might
                class="cm"># be in a namespace package ... too icky to check
            modfile = mod.__file__
            assert modfile is not None
            if modfile[-4:] in (class="st">".pyc", class="st">".pyo"):
                modfile = modfile[:-1]
            elif modfile.endswith(class="st">"$py.class"):