ast-outline-cli 2.1.0__py3-none-any.whl

ast_outline_cli/__init__.py

@@ -0,0 +1,117 @@
+"""ast-outline CLI installer — downloads the Rust binary on first run."""
+
+import os
+import sys
+import stat
+import platform
+import subprocess
+from pathlib import Path
+
+import httpx
+
+VERSION = "2.1.0"
+GITHUB_REPO = "aeroxy/ast-outline"
+BINARY_NAME = "ast-outline"
+
+
+def get_cache_dir() -> Path:
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "Caches" / "ast-outline"
+    elif sys.platform == "linux":
+        return Path.home() / ".cache" / "ast-outline"
+    else:
+        return Path.home() / ".cache" / "ast-outline"
+
+
+def get_platform() -> tuple[str, str]:
+    """Return (os, arch) for download URL."""
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    os_map = {"darwin": "macos", "linux": "linux", "windows": "windows"}
+    arch_map = {"arm64": "arm64", "aarch64": "arm64", "x86_64": "x86_64", "amd64": "x86_64"}
+
+    os_name = os_map.get(system)
+    arch = arch_map.get(machine)
+
+    if not os_name or not arch:
+        raise RuntimeError(
+            f"No pre-built binary for {system}/{machine}. "
+            f"Build from source: cargo install ast-outline"
+        )
+
+    # Check if pre-built binary exists (only macos-arm64 for now)
+    available = {("macos", "arm64")}
+    if (os_name, arch) not in available:
+        raise RuntimeError(
+            f"No pre-built binary for {os_name}-{arch} yet (available: macos-arm64). "
+            f"Build from source: cargo install ast-outline"
+        )
+
+    return os_name, arch
+
+
+def download_binary() -> Path:
+    """Download the ast-outline binary to cache dir."""
+    cache_dir = get_cache_dir()
+    cache_dir.mkdir(parents=True, exist_ok=True)
+
+    os_name, arch = get_platform()
+    ext = ".zip" if os_name == "windows" else ".tar.gz"
+    binary_ext = ".exe" if os_name == "windows" else ""
+    binary_path = cache_dir / f"{BINARY_NAME}{binary_ext}"
+
+    # Check if already downloaded
+    if binary_path.exists():
+        return binary_path
+
+    url = f"https://github.com/{GITHUB_REPO}/releases/download/{VERSION}/{BINARY_NAME}-{os_name}-{arch}{ext}"
+    print(f"Downloading ast-outline {VERSION} for {os_name}-{arch}...")
+    print(f"  {url}")
+
+    archive_path = cache_dir / f"archive{ext}"
+
+    with httpx.Client(follow_redirects=True) as client:
+        resp = client.get(url)
+        resp.raise_for_status()
+        archive_path.write_bytes(resp.content)
+
+    # Extract
+    import tarfile
+    import zipfile
+
+    if ext == ".tar.gz":
+        with tarfile.open(archive_path, "r:gz") as tar:
+            tar.extractall(path=cache_dir)
+    else:
+        with zipfile.ZipFile(archive_path) as zf:
+            zf.extractall(path=cache_dir)
+
+    archive_path.unlink()
+
+    # Make executable
+    if sys.platform != "windows":
+        binary_path.chmod(binary_path.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
+
+    print(f"Installed ast-outline to {binary_path}")
+    return binary_path
+
+
+def get_binary_path() -> Path:
+    """Get path to the ast-outline binary, downloading if needed."""
+    cache_dir = get_cache_dir()
+    os_name, _ = get_platform()
+    ext = ".exe" if os_name == "windows" else ""
+    binary_path = cache_dir / f"{BINARY_NAME}{ext}"
+
+    if not binary_path.exists():
+        return download_binary()
+    return binary_path
+
+
+def main():
+    """CLI entry point — forwards to the Rust binary."""
+    binary = get_binary_path()
+    args = sys.argv[1:]
+    result = subprocess.run([str(binary)] + args, cwd=os.getcwd())
+    sys.exit(result.returncode)

ast_outline_cli/__main__.py

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

ast_outline_cli-2.1.0.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: ast-outline-cli
+Version: 2.1.0
+Summary: Fast, AST-based code-navigation toolkit — downloads the Rust binary on install
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aeroxy/ast-outline
+Project-URL: Repository, https://github.com/aeroxy/ast-outline
+Project-URL: Documentation, https://github.com/aeroxy/ast-outline#readme
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+
+# ast-outline-cli
+
+[![PyPI](https://img.shields.io/pypi/v/ast-outline-cli)](https://pypi.org/project/ast-outline-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/aeroxy/ast-outline/blob/main/LICENSE)
+
+CLI installer for [ast-outline](https://github.com/aeroxy/ast-outline) — a fast, AST-based code-navigation toolkit for source files. Downloads the pre-built Rust binary on first run.
+
+## Install
+
+```bash
+pip install ast-outline-cli
+```
+
+## Usage
+
+```bash
+# Map the structure of a file (signatures + line ranges, no bodies)
+ast-outline map src/player.rs
+
+# Show the exact source of a specific method
+ast-outline show Player.cs TakeDamage
+
+# Compact digest of a whole module
+ast-outline digest src/services/
+
+# True public API (resolves pub use / __all__ re-exports)
+ast-outline surface .
+
+# Find all implementations of a type
+ast-outline implements IDamageable src/
+
+# Dependency graph
+ast-outline deps src/auth.rs --depth 2
+ast-outline reverse-deps src/auth.rs
+ast-outline cycles
+
+# Call graph (AST-accurate)
+ast-outline callers TakeDamage
+ast-outline callees Player.TakeDamage
+
+# Hybrid BM25 + dense semantic search
+ast-outline search "how does login work"
+
+# Find semantically similar code
+ast-outline find-related src/auth/login.rs:42
+```
+
+On first run, the CLI downloads the pre-built binary for your platform from [GitHub releases](https://github.com/aeroxy/ast-outline/releases) and caches it locally.
+
+| Platform | Cache directory |
+|---|---|
+| macOS | `~/Library/Caches/ast-outline/` |
+| Linux | `~/.cache/ast-outline/` |
+
+## Supported Platforms
+
+| Platform | Status |
+|---|---|
+| macOS ARM64 | Pre-built binary available |
+| Other platforms | Build from source (see below) |
+
+For unsupported platforms, build from source:
+
+```bash
+cargo install ast-outline
+```
+
+## What is ast-outline?
+
+[ast-outline](https://github.com/aeroxy/ast-outline) is a fast, AST-based code-navigation toolkit built for LLM coding agents and humans. It uses [tree-sitter](https://github.com/tree-sitter/tree-sitter) via [ast-grep](https://github.com/ast-grep/ast-grep) to parse source files and provide:
+
+- **File shape** — `map` / `digest` / `show` for signatures with line ranges (95% token savings vs reading full files)
+- **True public API** — `surface` resolves re-export graphs across Rust, Python, TypeScript, and more
+- **Dependency graph** — `deps` / `reverse-deps` / `cycles` / `graph` for import analysis
+- **Call graph** — `callers` / `callees` with AST accuracy across 14 languages
+- **Semantic search** — hybrid BM25 + dense embeddings via `search` and `find-related`
+- **MCP server** — every command exposed as an MCP tool for LLM agents
+
+Supports Rust, Python, TypeScript, JavaScript, Java, C#, Kotlin, Scala, Go, PHP, Ruby, SQL, and Markdown.
+
+## Links
+
+- [ast-outline source code](https://github.com/aeroxy/ast-outline)
+- [npm package](https://www.npmjs.com/package/@ast-outline/cli) (Node.js installer)
+- [crates.io](https://crates.io/crates/ast-outline) (Rust library)
+
+## License
+
+[MIT](https://github.com/aeroxy/ast-outline/blob/main/LICENSE)

ast_outline_cli-2.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+ast_outline_cli/__init__.py,sha256=F00ZgOwO6iAdwes2suMhZ9SrKejWK9pBQySITEwaJAM,3507
+ast_outline_cli/__main__.py,sha256=9AxeJX7Z2wuYiWJZXeI4MuP1RMpoduTjhhtGtOCJFSk,41
+ast_outline_cli-2.1.0.dist-info/METADATA,sha256=8HJ51ZdSkpa6OC8KiOndwcqu6NmrHDjQi974gXZTM6U,3574
+ast_outline_cli-2.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ast_outline_cli-2.1.0.dist-info/entry_points.txt,sha256=FyEnLtu8pfQDJkatbViREiVxH3-l6MbDdtmmCADeo8g,53
+ast_outline_cli-2.1.0.dist-info/top_level.txt,sha256=dBmBeo178aLD2igGWw-0yZIfctOGEta3UcJuPFC00zs,16
+ast_outline_cli-2.1.0.dist-info/RECORD,,

ast_outline_cli-2.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ast_outline_cli-2.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ast-outline = ast_outline_cli:main

ast_outline_cli-2.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ast_outline_cli