Function _resolve_module_name

scripts/update_lib/cmd_deps.py:332–383

Resolve module name through redirects. Returns a list of module names (usually 1, but test support files may expand to multiple).

(
    name: str,
    cpython_prefix: str,
    lib_prefix: str,
)

def _resolve_module_name(
    name: str,
    cpython_prefix: str,
    lib_prefix: str,
) -> list[str]:
    """Resolve module name through redirects.

    Returns a list of module names (usually 1, but test support files may expand to multiple).
    """
    import pathlib

    from update_lib.deps import (
        _build_test_import_graph,
        get_lib_paths,
        get_test_paths,
        resolve_hard_dep_parent,
        resolve_test_to_lib,
    )

    # Resolve test to library group (e.g., test_urllib2 -> urllib)
    if name.startswith("test_"):
        lib_group = resolve_test_to_lib(name)
        if lib_group:
            return [lib_group]
        name = name[5:]

    # Resolve hard_dep to parent
    parent = resolve_hard_dep_parent(name, cpython_prefix)
    if parent:
        return [parent]

    # Check if it's a valid module
    lib_paths = get_lib_paths(name, cpython_prefix)
    test_paths = get_test_paths(name, cpython_prefix)
    if any(p.exists() for p in lib_paths) or any(p.exists() for p in test_paths):
        return [name]

    # Check for test support files (e.g., string_tests -> bytes, str, userstring)
    test_support_path = pathlib.Path(cpython_prefix) / "Lib" / "test" / f"{name}.py"
    if test_support_path.exists():
        test_dir = pathlib.Path(lib_prefix) / "test"
        if test_dir.exists():
            import_graph, _ = _build_test_import_graph(test_dir)
            importing_tests = []
            for file_key, imports in import_graph.items():
                if name in imports and file_key.startswith("test_"):
                    importing_tests.append(file_key)
            if importing_tests:
                # Resolve test names to module names (test_bytes -> bytes)
                return sorted(set(t[5:] for t in importing_tests))

    return [name]


def show_deps(