Function module_name_from_path

src/_pytest/pathlib.py:761–789

Return a dotted module name based on the given path, anchored on root. For example: path="projects/src/tests/test_foo.py" and root="/projects", the resulting module name will be "src.tests.test_foo".

(path: Path, root: Path)

def module_name_from_path(path: Path, root: Path) -> str:
    class="st">"""
    Return a dotted module name based on the given path, anchored on root.

    For example: path=class="st">"projects/src/tests/test_foo.py" and root=class="st">"/projects", the
    resulting module name will be class="st">"src.tests.test_foo".
    class="st">"""
    path = path.with_suffix(class="st">"")
    try:
        relative_path = path.relative_to(root)
    except ValueError:
        class="cm"># If we can't get a relative path to root, use the full path, except
        class="cm"># for the first part (class="st">"d:\\" or class="st">"/" depending on the platform, for example).
        path_parts = path.parts[1:]
    else:
        class="cm"># Use the parts for the relative path to the root path.
        path_parts = relative_path.parts

    class="cm"># Module name for packages do not contain the __init__ file, unless
    class="cm"># the `__init__.py` file is at the root.
    if len(path_parts) >= 2 and path_parts[-1] == class="st">"__init__":
        path_parts = path_parts[:-1]

    class="cm"># Module names cannot contain class="st">".", normalize them to class="st">"_". This prevents
    class="cm"># a directory having a class="st">"." in the name (class="st">".env.310" for example) causing extra intermediate modules.
    class="cm"># Also, important to replace class="st">"." at the start of paths, as those are considered relative imports.
    path_parts = tuple(x.replace(class="st">".", class="st">"_") for x in path_parts)

    return class="st">".".join(path_parts)


def insert_missing_modules(modules: dict[str, ModuleType], module_name: str) -> None: