ast-bro 2.2.0__py3-none-any.whl

ast_bro-2.2.0.dist-info/METADATA

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: ast-bro
+Version: 2.2.0
+Summary: Fast, AST-based code-navigation: shape, public API, deps & call graphs, hybrid semantic search, structural rewrite. MCP server included.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aeroxy/ast-bro
+Project-URL: Repository, https://github.com/aeroxy/ast-bro
+Project-URL: Documentation, https://github.com/aeroxy/ast-bro#readme
+Keywords: ast,tree-sitter,mcp,refactoring,code-search
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.24.0
+
+# ast-bro
+
+[![PyPI](https://img.shields.io/pypi/v/ast-bro)](https://pypi.org/project/ast-bro/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/aeroxy/ast-bro/blob/main/LICENSE)
+
+PyPI installer for [ast-bro](https://github.com/aeroxy/ast-bro) — a fast, AST-based code-navigation toolkit for source files (shape, public API, dep & call graphs, hybrid semantic search, structural rewrite, MCP server). Downloads the pre-built Rust binary on first run.
+
+> **Formerly `ast-outline-cli`.** Same project under a new name (the `ast-outline` name became overloaded after the tool grew beyond outlining). The `ast-outline` command is still installed as a thin proxy that forwards to `ast-bro`, so existing scripts keep working.
+
+## Install
+
+```bash
+pip install ast-bro
+```
+
+This installs three commands, all forwarding to the same binary:
+
+- `ast-bro` — canonical name
+- `sb` — short alias (same tool, fewer keystrokes)
+- `ast-outline` — backward-compat shim
+
+## Usage
+
+```bash
+# Map the structure of a file (signatures + line ranges, no bodies)
+ast-bro map src/player.rs
+
+# Show the exact source of a specific method
+ast-bro show Player.cs TakeDamage
+
+# Compact digest of a whole module
+ast-bro digest src/services/
+
+# True public API (resolves pub use / __all__ re-exports)
+ast-bro surface .
+
+# Find all implementations of a type
+ast-bro implements IDamageable src/
+
+# Dependency graph
+ast-bro deps src/auth.rs --depth 2
+ast-bro reverse-deps src/auth.rs
+ast-bro cycles
+
+# Call graph (AST-accurate)
+ast-bro callers TakeDamage
+ast-bro callees Player.TakeDamage
+
+# Hybrid BM25 + dense semantic search
+ast-bro search "how does login work"
+
+# Find semantically similar code
+ast-bro find-related src/auth/login.rs:42
+
+# AST-aware structural search and rewrite (with metavariables)
+ast-bro run -p '$FUNC($$$)' -l rust
+ast-bro run -p 'foo($A)' -r 'bar($A)' --write    # apply to disk
+```
+
+On first run, the CLI downloads the pre-built binary for your platform from [GitHub releases](https://github.com/aeroxy/ast-bro/releases) and caches it locally.
+
+| Platform | Cache directory |
+|---|---|
+| macOS | `~/Library/Caches/ast-bro/` |
+| Linux | `~/.cache/ast-bro/` |
+
+## 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-bro
+```
+
+## What is ast-bro?
+
+[ast-bro](https://github.com/aeroxy/ast-bro) 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`
+- **Structural rewrite** — `run` for AST-aware pattern matching with metavariables (find + replace)
+- **MCP server** — every command exposed as an MCP tool for LLM agents
+
+Supports Rust, Python, TypeScript, JavaScript, Java, C#, C++, Kotlin, Scala, Go, PHP, Ruby, SQL, and Markdown.
+
+## Links
+
+- [ast-bro source code](https://github.com/aeroxy/ast-bro)
+- [npm package](https://www.npmjs.com/package/@ast-bro/cli) (Node.js installer)
+- [crates.io](https://crates.io/crates/ast-bro) (Rust library)
+
+## License
+
+[MIT](https://github.com/aeroxy/ast-bro/blob/main/LICENSE)

ast_bro-2.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+ast_bro_cli/__init__.py,sha256=ffYTlR077W_LcImxrdtG4GUEQrJDvLle4ONWhDW-mWo,3570
+ast_bro_cli/__main__.py,sha256=Kf7RCGT4hFbSZkrR2sPmJ9kdfybbh2o-TSvr1yQeBCA,37
+ast_bro-2.2.0.dist-info/METADATA,sha256=sFIAptpOPQF0ol4HUIYIcpKtAhqPvbmK4CGjpfk2NI4,4690
+ast_bro-2.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ast_bro-2.2.0.dist-info/entry_points.txt,sha256=HGLmo1XXXz8Z85Oq76PvkcMA2vUgW9eO8oNGlV9KMYc,98
+ast_bro-2.2.0.dist-info/top_level.txt,sha256=4ROcmqhI_CXEmHACEZ-tptfjAsXXV6mpoBJjtmYfjdc,12
+ast_bro-2.2.0.dist-info/RECORD,,

ast_bro-2.2.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_bro-2.2.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+ast-bro = ast_bro_cli:main
+ast-outline = ast_bro_cli:main
+sb = ast_bro_cli:main

ast_bro-2.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ast_bro_cli

ast_bro_cli/__init__.py

@@ -0,0 +1,119 @@
+"""ast-bro 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.2.0"
+GITHUB_REPO = "aeroxy/ast-bro"
+BINARY_NAME = "ast-bro"
+
+
+def get_cache_dir() -> Path:
+    if sys.platform == "darwin":
+        return Path.home() / "Library" / "Caches" / "ast-bro"
+    elif sys.platform == "linux":
+        return Path.home() / ".cache" / "ast-bro"
+    else:
+        return Path.home() / ".cache" / "ast-bro"
+
+
+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-bro"
+        )
+
+    # 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-bro"
+        )
+
+    return os_name, arch
+
+
+def download_binary() -> Path:
+    """Download the ast-bro binary to cache dir."""
+    cache_dir = get_cache_dir()
+    cache_dir.mkdir(parents=True, exist_ok=True)
+
+    os_name, arch = get_platform()
+    # All platform release artifacts are `.zip` (same archive Homebrew pulls).
+    # If we ever ship a Linux `.tar.gz` build, branch here on os_name.
+    ext = ".zip"
+    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-bro {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-bro to {binary_path}")
+    return binary_path
+
+
+def get_binary_path() -> Path:
+    """Get path to the ast-bro 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_bro_cli/__main__.py

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