cmap-core 0.1.0__tar.gz

cmap_core-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+.venv/
+__pycache__/
+.pytest_cache/
+*.pyc

cmap_core-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.5
+Name: cmap-core
+Version: 0.1.0
+Summary: Code Map: inspect Python code structure and relationships from the terminal.
+Requires-Python: >=3.12
+Requires-Dist: rich<15,>=13.9
+Requires-Dist: typer<1,>=0.16

cmap_core-0.1.0/README.md

@@ -0,0 +1,22 @@
+# CMap
+
+CMap (Code Map) is a terminal-first Python code analysis tool. It scans Python source with the standard-library AST and exposes symbols, calls, imports, call traces, dependency information, and circular dependency detection.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run cmap-core --help
+```
+
+## Commands
+
+```bash
+cmap-core scan .
+cmap-core trace . main
+cmap-core callers . parse
+cmap-core callees . main
+cmap-core deps .
+cmap-core circular .
+```

cmap_core-0.1.0/examples/basic/main.py

@@ -0,0 +1,11 @@
+def load() -> str:
+    return "data"
+
+def parse(value: str) -> dict[str, str]:
+    return {"value": value}
+
+def main() -> dict[str, str]:
+    return parse(load())
+
+if __name__ == "__main__":
+    print(main())

cmap_core-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "cmap-core"
+version = "0.1.0"
+description = "Code Map: inspect Python code structure and relationships from the terminal."
+requires-python = ">=3.12"
+dependencies = ["typer>=0.16,<1", "rich>=13.9,<15"]
+
+[project.scripts]
+cmap-core = "cmap_core.main:app"
+
+[dependency-groups]
+dev = ["pytest>=8,<9"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cmap_core"]

cmap_core-0.1.0/src/cmap_core/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

cmap_core-0.1.0/src/cmap_core/__main__.py

@@ -0,0 +1,3 @@
+from .main import app
+
+app()

cmap_core-0.1.0/src/cmap_core/cmap_analyzer.py

@@ -0,0 +1,68 @@
+import ast
+from pathlib import Path
+from .cmap_models import Call, CodeMap, Import, Symbol
+
+class Analyzer(ast.NodeVisitor):
+    def __init__(self, path: Path) -> None:
+        self.path = path
+        self.result = CodeMap()
+        self.scope: list[str] = []
+
+    @property
+    def current(self) -> str:
+        return ".".join(self.scope) or "<module>"
+
+    def visit_FunctionDef(self, node: ast.FunctionDef) -> None:
+        self._visit_function(node)
+
+    def visit_AsyncFunctionDef(self, node: ast.AsyncFunctionDef) -> None:
+        self._visit_function(node)
+
+    def _visit_function(self, node: ast.FunctionDef | ast.AsyncFunctionDef) -> None:
+        parent = self.current if self.scope else None
+        symbol_id = f"{self.path}:{'.'.join((*self.scope, node.name))}"
+        self.result.symbols.append(Symbol(symbol_id, node.name, "function", str(self.path), node.lineno, parent))
+        self.scope.append(node.name)
+        self.generic_visit(node)
+        self.scope.pop()
+
+    def visit_ClassDef(self, node: ast.ClassDef) -> None:
+        parent = self.current if self.scope else None
+        symbol_id = f"{self.path}:{'.'.join((*self.scope, node.name))}"
+        self.result.symbols.append(Symbol(symbol_id, node.name, "class", str(self.path), node.lineno, parent))
+        self.scope.append(node.name)
+        self.generic_visit(node)
+        self.scope.pop()
+
+    def visit_Call(self, node: ast.Call) -> None:
+        if isinstance(node.func, ast.Name):
+            callee = node.func.id
+        elif isinstance(node.func, ast.Attribute):
+            callee = ast.unparse(node.func)
+        else:
+            callee = ast.unparse(node.func)
+        self.result.calls.append(Call(self.current, callee, str(self.path), node.lineno))
+        self.generic_visit(node)
+
+    def visit_Import(self, node: ast.Import) -> None:
+        for alias in node.names:
+            self.result.imports.append(Import(alias.name, str(self.path), node.lineno))
+
+    def visit_ImportFrom(self, node: ast.ImportFrom) -> None:
+        module = "." * node.level + (node.module or "")
+        self.result.imports.append(Import(module, str(self.path), node.lineno))
+
+def analyze(path: Path) -> CodeMap:
+    from .cmap_ast import parse
+    analyzer = Analyzer(path)
+    analyzer.visit(parse(path))
+    return analyzer.result
+
+def analyze_paths(paths: list[Path]) -> CodeMap:
+    result = CodeMap()
+    for path in paths:
+        current = analyze(path)
+        result.symbols.extend(current.symbols)
+        result.calls.extend(current.calls)
+        result.imports.extend(current.imports)
+    return result

cmap_core-0.1.0/src/cmap_core/cmap_ast.py

@@ -0,0 +1,5 @@
+import ast
+from pathlib import Path
+
+def parse(path: Path) -> ast.Module:
+    return ast.parse(path.read_text(encoding="utf-8"), filename=str(path))

cmap_core-0.1.0/src/cmap_core/cmap_graph.py

@@ -0,0 +1,67 @@
+from collections import defaultdict
+from pathlib import Path
+from .cmap_models import CodeMap
+
+def callers(graph: CodeMap, target: str) -> list[str]:
+    return sorted({call.caller for call in graph.calls if call.callee == target})
+
+def callees(graph: CodeMap, target: str) -> list[str]:
+    return sorted({call.callee for call in graph.calls if call.caller == target})
+
+def dependencies(graph: CodeMap) -> dict[str, set[str]]:
+    result: dict[str, set[str]] = defaultdict(set)
+    for item in graph.imports:
+        result[item.file].add(item.module)
+    return dict(result)
+
+def _module_name(path: str, root: Path) -> str:
+    relative = Path(path).relative_to(root)
+    parts = list(relative.with_suffix("").parts)
+    if parts[-1] == "__init__":
+        parts.pop()
+    return ".".join(parts)
+
+def circular_dependencies(graph: CodeMap, root: Path) -> list[list[str]]:
+    files = {Path(symbol.file) for symbol in graph.symbols}
+    modules = {_module_name(str(path), root): path for path in files}
+    edges: dict[Path, set[Path]] = defaultdict(set)
+    for item in graph.imports:
+        source = Path(item.file)
+        for module, target in modules.items():
+            if item.module == module or item.module.startswith(f"{module}."):
+                edges[source].add(target)
+    visited: set[Path] = set()
+    stack: list[Path] = []
+    found: list[list[str]] = []
+
+    def visit(node: Path) -> None:
+        if node in stack:
+            cycle = stack[stack.index(node):] + [node]
+            names = [str(item) for item in cycle]
+            if names not in found:
+                found.append(names)
+            return
+        if node in visited:
+            return
+        visited.add(node)
+        stack.append(node)
+        for target in edges.get(node, ()):
+            visit(target)
+        stack.pop()
+
+    for node in files:
+        visit(node)
+    return found
+
+def trace(graph: CodeMap, target: str) -> list[tuple[str, str]]:
+    result: list[tuple[str, str]] = []
+    queue = [target]
+    seen = {target}
+    while queue:
+        current = queue.pop(0)
+        for callee in callees(graph, current):
+            result.append((current, callee))
+            if callee not in seen:
+                seen.add(callee)
+                queue.append(callee)
+    return result

cmap_core-0.1.0/src/cmap_core/cmap_models.py

@@ -0,0 +1,29 @@
+from dataclasses import dataclass, field
+
+@dataclass(frozen=True, slots=True)
+class Symbol:
+    id: str
+    name: str
+    kind: str
+    file: str
+    line: int
+    parent: str | None = None
+
+@dataclass(frozen=True, slots=True)
+class Call:
+    caller: str
+    callee: str
+    file: str
+    line: int
+
+@dataclass(frozen=True, slots=True)
+class Import:
+    module: str
+    file: str
+    line: int
+
+@dataclass(slots=True)
+class CodeMap:
+    symbols: list[Symbol] = field(default_factory=list)
+    calls: list[Call] = field(default_factory=list)
+    imports: list[Import] = field(default_factory=list)

cmap_core-0.1.0/src/cmap_core/cmap_render.py

@@ -0,0 +1,14 @@
+import json
+from dataclasses import asdict
+from .cmap_models import CodeMap
+
+def text(graph: CodeMap) -> str:
+    lines = [f"{symbol.kind} {symbol.name}  {symbol.file}:{symbol.line}" for symbol in graph.symbols]
+    if graph.calls:
+        lines += ["", "Calls", *[f"  {call.caller} -> {call.callee}" for call in graph.calls]]
+    if graph.imports:
+        lines += ["", "Imports", *[f"  {item.file} -> {item.module}" for item in graph.imports]]
+    return "\n".join(lines)
+
+def json_output(graph: CodeMap) -> str:
+    return json.dumps({"symbols": [asdict(item) for item in graph.symbols], "calls": [asdict(item) for item in graph.calls], "imports": [asdict(item) for item in graph.imports]}, indent=2)

cmap_core-0.1.0/src/cmap_core/cmap_scan.py

@@ -0,0 +1,6 @@
+from pathlib import Path
+
+def python_files(root: Path) -> list[Path]:
+    if root.is_file():
+        return [root] if root.suffix == ".py" else []
+    return sorted(path for path in root.rglob("*.py") if ".venv" not in path.parts and "__pycache__" not in path.parts)

cmap_core-0.1.0/src/cmap_core/main.py

@@ -0,0 +1,66 @@
+from pathlib import Path
+from typing import Annotated
+import json
+import typer
+from rich.console import Console
+from . import __version__
+from .cmap_analyzer import analyze_paths
+from .cmap_graph import callers, callees, circular_dependencies, dependencies, trace
+from .cmap_render import json_output, text
+from .cmap_scan import python_files
+
+app = typer.Typer(help="CMap — Code Map for Python.", no_args_is_help=True)
+console = Console()
+
+@app.command()
+def version() -> None:
+    """Show the CMap version."""
+    typer.echo(__version__)
+
+@app.command()
+def scan(path: Annotated[Path, typer.Argument(exists=True, readable=True)], json_mode: Annotated[bool, typer.Option("--json")] = False) -> None:
+    """Scan Python files and show their structure."""
+    graph = analyze_paths(python_files(path))
+    typer.echo(json_output(graph) if json_mode else text(graph))
+
+@app.command("trace")
+def trace_code(path: Annotated[Path, typer.Argument(exists=True, readable=True)], target: Annotated[str, typer.Argument()], json_mode: Annotated[bool, typer.Option("--json")] = False) -> None:
+    """Show the reachable calls from a function."""
+    graph = analyze_paths(python_files(path))
+    result = trace(graph, target)
+    typer.echo(json.dumps(result) if json_mode else "\n".join(f"{a} -> {b}" for a, b in result))
+
+@app.command("callers")
+def callers_code(path: Annotated[Path, typer.Argument(exists=True, readable=True)], target: Annotated[str, typer.Argument()]) -> None:
+    """Show callers of a function."""
+    graph = analyze_paths(python_files(path))
+    typer.echo("\n".join(callers(graph, target)))
+
+@app.command("callees")
+def callees_code(path: Annotated[Path, typer.Argument(exists=True, readable=True)], target: Annotated[str, typer.Argument()]) -> None:
+    """Show functions called by a function."""
+    graph = analyze_paths(python_files(path))
+    typer.echo("\n".join(callees(graph, target)))
+
+@app.command()
+def deps(path: Annotated[Path, typer.Argument(exists=True, readable=True)]) -> None:
+    """Show Python import dependencies."""
+    graph = analyze_paths(python_files(path))
+    for source, modules in dependencies(graph).items():
+        typer.echo(source)
+        for module in sorted(modules):
+            typer.echo(f"  -> {module}")
+
+@app.command()
+def circular(path: Annotated[Path, typer.Argument(exists=True, readable=True)]) -> None:
+    """Find circular local import dependencies."""
+    graph = analyze_paths(python_files(path))
+    cycles = circular_dependencies(graph)
+    if not cycles:
+        typer.echo("No circular dependencies found.")
+        return
+    for cycle in cycles:
+        typer.echo(" -> ".join(cycle))
+
+if __name__ == "__main__":
+    app()

cmap_core-0.1.0/tests/test_analyzer.py

@@ -0,0 +1,10 @@
+from pathlib import Path
+from cmap_core.cmap_analyzer import analyze
+
+def test_analyze_collects_symbols_calls_and_imports(tmp_path: Path) -> None:
+    path = tmp_path / "example.py"
+    path.write_text("import os\n\ndef main():\n    print(os.getcwd())\n", encoding="utf-8")
+    graph = analyze(path)
+    assert any(symbol.name == "main" for symbol in graph.symbols)
+    assert any(call.callee == "print" for call in graph.calls)
+    assert graph.imports[0].module == "os"

cmap_core-0.1.0/tests/test_ast.py

@@ -0,0 +1,8 @@
+from pathlib import Path
+from cmap_core.cmap_ast import parse
+
+def test_parse(tmp_path: Path) -> None:
+    path = tmp_path / "example.py"
+    path.write_text("def main():\n    print('ok')\n", encoding="utf-8")
+    tree = parse(path)
+    assert tree.body[0].name == "main"

cmap_core-0.1.0/tests/test_graph.py

@@ -0,0 +1,7 @@
+from cmap_core.cmap_graph import CodeMap, Call, callers, callees, trace
+
+def test_graph_queries() -> None:
+    graph = CodeMap(calls=[Call("main", "load", "x.py", 1), Call("load", "parse", "x.py", 2)])
+    assert callers(graph, "load") == ["main"]
+    assert callees(graph, "main") == ["load"]
+    assert trace(graph, "main") == [("main", "load"), ("load", "parse")]

cmap_core-0.1.0/uv.lock

@@ -0,0 +1,154 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "annotated-doc"
+version = "0.0.5"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5a/8e/38aa427ed5402449e226975b649c5dc73ccadfefeb95e6aecb8f8ea4b6b6/annotated_doc-0.0.5.tar.gz", hash = "sha256:c7e58ce09192557605d8bbd92836d7e1d520ac9580096042c0bfd197efacf1bb", size = 10758, upload-time = "2026-07-28T13:50:58.129Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3e/30/e900b21425a860e195f32e37657aa1f7c7f2b1bfb26f03ca209b90933c06/annotated_doc-0.0.5-py3-none-any.whl", hash = "sha256:117bac03a25ede5df5440e855b32d556049ca169ead221505badf432fed4b101", size = 5302, upload-time = "2026-07-28T13:50:57.239Z" },
+]
+
+[[package]]
+name = "cmap-core"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "rich" },
+    { name = "typer" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "rich", specifier = ">=13.9,<15" },
+    { name = "typer", specifier = ">=0.16,<1" },
+]
+
+[package.metadata.requires-dev]
+dev = [{ name = "pytest", specifier = ">=8,<9" }]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/ff/7841249c247aa650a76b9ee4bbaeae59370dc8bfd2f6c01f3630c35eb134/markdown_it_py-4.2.0.tar.gz", hash = "sha256:04a21681d6fbb623de53f6f364d352309d4094dd4194040a10fd51833e418d49", size = 82454, upload-time = "2026-05-07T12:08:28.36Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/81/4da04ced5a082363ecfa159c010d200ecbd959ae410c10c0264a38cac0f5/markdown_it_py-4.2.0-py3-none-any.whl", hash = "sha256:9f7ebbcd14fe59494226453aed97c1070d83f8d24b6fc3a3bcf9a38092641c4a", size = 91687, upload-time = "2026-05-07T12:08:27.182Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.21.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "8.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a3/5c/00a0e072241553e1a7496d638deababa67c5058571567b92a7eaa258397c/pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01", size = 1519618, upload-time = "2025-09-04T14:34:22.711Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a8/a4/20da314d277121d6534b3a980b29035dcd51e6744bd79075a6ce8fa4eb8d/pytest-8.4.2-py3-none-any.whl", hash = "sha256:872f880de3fc3a5bdc88a11b39c9710c3497a547cfa9320bc3c5e62fbf272e79", size = 365750, upload-time = "2025-09-04T14:34:20.226Z" },
+]
+
+[[package]]
+name = "rich"
+version = "14.3.4"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e9/67/cae617f1351490c25a4b8ac3b8b63a4dda609295d8222bad12242dfdc629/rich-14.3.4.tar.gz", hash = "sha256:817e02727f2b25b40ef56f5aa2217f400c8489f79ca8f46ea2b70dd5e14558a9", size = 230524, upload-time = "2026-04-11T02:57:45.419Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/76/6d163cfac87b632216f71879e6b2cf17163f773ff59c00b5ff4900a80fa3/rich-14.3.4-py3-none-any.whl", hash = "sha256:07e7adb4690f68864777b1450859253bed81a99a31ac321ac1817b2313558952", size = 310480, upload-time = "2026-04-11T02:57:47.484Z" },
+]
+
+[[package]]
+name = "shellingham"
+version = "1.5.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" },
+]
+
+[[package]]
+name = "typer"
+version = "0.27.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-doc" },
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "rich" },
+    { name = "shellingham" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/16/f7/57713ba479fd405eb76de31404b2c744c289e336b2d999511ebf51e496f7/typer-0.27.2.tar.gz", hash = "sha256:269b7eb9d3c202ca84b4bc9618cb04ebb43d3d4d1e567e4c768607232c05f945", size = 204045, upload-time = "2026-08-28T10:26:55.046Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/bf/205d0004930ede8f542fb58f601526fccf4ae7626075ca1e6c4de5d3d652/typer-0.27.2-py3-none-any.whl", hash = "sha256:b3a5fc4342d5fc8fda8fc3010b1cf117e9249aab7fae800c2eff62fd3842d97d", size = 123130, upload-time = "2026-08-28T10:26:53.752Z" },
+]