Skip to content

Dependency

dependency

AST projection of declared dependency modules using the SDK read resolver.

dependency_package(symbol)

Parse only the resolved module, never import or index a whole environment.

Source code in packages/axm-ast/src/axm_ast/tools/dependency.py
Python
14
15
16
17
18
19
20
21
22
23
24
25
26
27
def dependency_package(symbol: str) -> tuple[PackageInfo, str] | None:
    """Parse only the resolved module, never import or index a whole environment."""
    resolved = session_dependencies().resolve_symbol(symbol)
    if resolved is None:
        return None
    path, module, member = resolved
    # PackageInfo.module_names derives qualified names relative to this root.
    parts = module.split(".")
    root = path.parent
    count = len(parts) if path.name == "__init__.py" else len(parts) - 1
    for _ in range(count):
        root = root.parent
    package = PackageInfo(name=parts[0], root=root, modules=[extract_module_info(path)])
    return package, member

inspect_with_dependencies(pkg, symbol, *, source=False)

Keep local precedence; resolve missing qualified names in declared sources.

Source code in packages/axm-ast/src/axm_ast/tools/dependency.py
Python
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
def inspect_with_dependencies(
    pkg: PackageInfo, symbol: str, *, source: bool = False
) -> ToolResult:
    """Keep local precedence; resolve missing qualified names in declared sources."""
    from axm_ast.tools.inspect_resolve import inspect_dotted

    result = inspect_dotted(pkg, symbol, source=source)
    if result.success:
        return result
    external = dependency_package(symbol)
    if external is None:
        return result
    if "." in external[1]:
        from axm_ast.tools.inspect_resolve import resolve_class_method

        method = resolve_class_method(external[0], external[1], source=source)
        if method is not None:
            return method
    module = external[0].module_names[0]
    qualified = f"{module}.{external[1]}" if external[1] else module
    return inspect_dotted(external[0], qualified, source=source)