aja-codeintel 0.1.7__tar.gz → 0.1.9__tar.gz

{aja_codeintel-0.1.7 → aja_codeintel-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aja-codeintel
-Version: 0.1.7
+Version: 0.1.9
 Summary: CodeIntel CLI tool
 Author: Shiva Areti
 License: MIT License
@@ -340,6 +340,99 @@ aja models
 
 ---
 
+### `aja fastapi-scan .`
+
+**What it does:** Full FastAPI project scan — resolves complete route paths including `APIRouter` prefixes and `include_router` prefix stacking, extracts Pydantic DTOs (with required/optional fields, default values, nested models), and extracts SQLAlchemy entity models (columns, types, primary keys, foreign keys, relationships). Produces structured JSON matching the same schema as the Java Spring Boot scanner.
+
+**When to use it:** Deep analysis of a FastAPI codebase. Generating API + data model inventory. Feeding structured metadata into AI tools or documentation pipelines.
+
+```bash
+# JSON report (default) — same schema as Java scanner
+aja fastapi-scan .
+
+# Human-readable text
+aja fastapi-scan . --format text
+
+# Only paths under /api
+aja fastapi-scan . --only-api
+
+# Skip DTOs or models from output
+aja fastapi-scan . --no-dtos
+aja fastapi-scan . --no-models
+```
+
+**Output schema (JSON):**
+```json
+{
+  "endpoints": [
+    {
+      "method": "POST",
+      "path": "/api/v1/users",
+      "file": "app/routers/users.py",
+      "line": 24,
+      "handler": "create_user",
+      "framework": "fastapi",
+      "controller": "CreateUserRequest"
+    }
+  ],
+  "dtos": [
+    {
+      "name": "CreateUserRequest",
+      "file": "app/schemas/user.py",
+      "kind": "pydantic",
+      "bases": ["BaseModel"],
+      "fields": [
+        { "name": "name",  "type": "str",          "required": true,  "default": null },
+        { "name": "email", "type": "str",          "required": true,  "default": null },
+        { "name": "age",   "type": "Optional[int]","required": false, "default": "None" }
+      ]
+    }
+  ],
+  "models": [
+    {
+      "name": "User",
+      "file": "app/models/user.py",
+      "kind": "sqlalchemy",
+      "table": "users",
+      "columns": [
+        { "name": "id",    "type": "Integer", "primary_key": true,  "foreign_key": null },
+        { "name": "email", "type": "String",  "primary_key": false, "foreign_key": null }
+      ],
+      "relationships": [
+        { "name": "posts", "target": "Post", "kind": "relationship" }
+      ]
+    }
+  ]
+}
+```
+
+**What the FastAPI scanner resolves:**
+
+| Pattern | Resolved path |
+|---|---|
+| `APIRouter(prefix="/users")` + `@router.get("/")` | `/users` |
+| `app.include_router(router, prefix="/api")` | `/api/users` |
+| `app.include_router(router, prefix="/v1")` + router prefix `/api` | `/v1/api/users` |
+| `@router.api_route("/ping", methods=["GET","HEAD"])` | `GET /ping` + `HEAD /ping` |
+
+**What the Pydantic extractor captures:**
+
+- `class X(BaseModel)` — direct BaseModel subclass
+- `class X(SomeBase)` — inherited from another Pydantic model in the same project
+- Required vs optional fields (`Optional[T]`, `T | None`, `Field(...)`, no default)
+- Default values including `Field(default=…)`
+- List types (`List[str]`, `list[int]`)
+
+**What the SQLAlchemy extractor captures:**
+
+- Classic declarative style: `Column(Integer, primary_key=True)`
+- Modern mapped style: `id: Mapped[int] = mapped_column(primary_key=True)`
+- Foreign keys: `Column(Integer, ForeignKey("users.id"))`
+- Relationships: `relationship("Post", back_populates="author")`
+- `__tablename__`
+
+---
+
 ### `aja copy <file>`
 
 **What it does:** Copies the full contents of a file (or multiple files) to your clipboard — ready to paste into a code review, chat, or AI tool.
@@ -377,10 +470,10 @@ Prints the current AJA version.
 
 ## Supported Languages
 
-| Language | Analysis | Imports | Symbols | Services | Models |
-|----------|----------|---------|---------|----------|--------|
-| Java | ✅ | ✅ | ✅ | ✅ | ✅ |
-| Python | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Language | Analysis | Imports | Symbols | Services | Models | Endpoints |
+|----------|----------|---------|---------|----------|--------|-----------|
+| Java (Spring Boot) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Python (FastAPI) | ✅ | ✅ | ✅ | ✅ | ✅ (Pydantic + SQLAlchemy) | ✅ (prefix-resolved) |
 
 > Static analysis only — no compilation, no runtime, no build tools required.
 

{aja_codeintel-0.1.7 → aja_codeintel-0.1.9}/README.md

@@ -303,6 +303,99 @@ aja models
 
 ---
 
+### `aja fastapi-scan .`
+
+**What it does:** Full FastAPI project scan — resolves complete route paths including `APIRouter` prefixes and `include_router` prefix stacking, extracts Pydantic DTOs (with required/optional fields, default values, nested models), and extracts SQLAlchemy entity models (columns, types, primary keys, foreign keys, relationships). Produces structured JSON matching the same schema as the Java Spring Boot scanner.
+
+**When to use it:** Deep analysis of a FastAPI codebase. Generating API + data model inventory. Feeding structured metadata into AI tools or documentation pipelines.
+
+```bash
+# JSON report (default) — same schema as Java scanner
+aja fastapi-scan .
+
+# Human-readable text
+aja fastapi-scan . --format text
+
+# Only paths under /api
+aja fastapi-scan . --only-api
+
+# Skip DTOs or models from output
+aja fastapi-scan . --no-dtos
+aja fastapi-scan . --no-models
+```
+
+**Output schema (JSON):**
+```json
+{
+  "endpoints": [
+    {
+      "method": "POST",
+      "path": "/api/v1/users",
+      "file": "app/routers/users.py",
+      "line": 24,
+      "handler": "create_user",
+      "framework": "fastapi",
+      "controller": "CreateUserRequest"
+    }
+  ],
+  "dtos": [
+    {
+      "name": "CreateUserRequest",
+      "file": "app/schemas/user.py",
+      "kind": "pydantic",
+      "bases": ["BaseModel"],
+      "fields": [
+        { "name": "name",  "type": "str",          "required": true,  "default": null },
+        { "name": "email", "type": "str",          "required": true,  "default": null },
+        { "name": "age",   "type": "Optional[int]","required": false, "default": "None" }
+      ]
+    }
+  ],
+  "models": [
+    {
+      "name": "User",
+      "file": "app/models/user.py",
+      "kind": "sqlalchemy",
+      "table": "users",
+      "columns": [
+        { "name": "id",    "type": "Integer", "primary_key": true,  "foreign_key": null },
+        { "name": "email", "type": "String",  "primary_key": false, "foreign_key": null }
+      ],
+      "relationships": [
+        { "name": "posts", "target": "Post", "kind": "relationship" }
+      ]
+    }
+  ]
+}
+```
+
+**What the FastAPI scanner resolves:**
+
+| Pattern | Resolved path |
+|---|---|
+| `APIRouter(prefix="/users")` + `@router.get("/")` | `/users` |
+| `app.include_router(router, prefix="/api")` | `/api/users` |
+| `app.include_router(router, prefix="/v1")` + router prefix `/api` | `/v1/api/users` |
+| `@router.api_route("/ping", methods=["GET","HEAD"])` | `GET /ping` + `HEAD /ping` |
+
+**What the Pydantic extractor captures:**
+
+- `class X(BaseModel)` — direct BaseModel subclass
+- `class X(SomeBase)` — inherited from another Pydantic model in the same project
+- Required vs optional fields (`Optional[T]`, `T | None`, `Field(...)`, no default)
+- Default values including `Field(default=…)`
+- List types (`List[str]`, `list[int]`)
+
+**What the SQLAlchemy extractor captures:**
+
+- Classic declarative style: `Column(Integer, primary_key=True)`
+- Modern mapped style: `id: Mapped[int] = mapped_column(primary_key=True)`
+- Foreign keys: `Column(Integer, ForeignKey("users.id"))`
+- Relationships: `relationship("Post", back_populates="author")`
+- `__tablename__`
+
+---
+
 ### `aja copy <file>`
 
 **What it does:** Copies the full contents of a file (or multiple files) to your clipboard — ready to paste into a code review, chat, or AI tool.
@@ -340,10 +433,10 @@ Prints the current AJA version.
 
 ## Supported Languages
 
-| Language | Analysis | Imports | Symbols | Services | Models |
-|----------|----------|---------|---------|----------|--------|
-| Java | ✅ | ✅ | ✅ | ✅ | ✅ |
-| Python | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Language | Analysis | Imports | Symbols | Services | Models | Endpoints |
+|----------|----------|---------|---------|----------|--------|-----------|
+| Java (Spring Boot) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Python (FastAPI) | ✅ | ✅ | ✅ | ✅ | ✅ (Pydantic + SQLAlchemy) | ✅ (prefix-resolved) |
 
 > Static analysis only — no compilation, no runtime, no build tools required.
 

{aja_codeintel-0.1.7 → aja_codeintel-0.1.9}/aja_codeintel.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aja-codeintel
-Version: 0.1.7
+Version: 0.1.9
 Summary: CodeIntel CLI tool
 Author: Shiva Areti
 License: MIT License
@@ -340,6 +340,99 @@ aja models
 
 ---
 
+### `aja fastapi-scan .`
+
+**What it does:** Full FastAPI project scan — resolves complete route paths including `APIRouter` prefixes and `include_router` prefix stacking, extracts Pydantic DTOs (with required/optional fields, default values, nested models), and extracts SQLAlchemy entity models (columns, types, primary keys, foreign keys, relationships). Produces structured JSON matching the same schema as the Java Spring Boot scanner.
+
+**When to use it:** Deep analysis of a FastAPI codebase. Generating API + data model inventory. Feeding structured metadata into AI tools or documentation pipelines.
+
+```bash
+# JSON report (default) — same schema as Java scanner
+aja fastapi-scan .
+
+# Human-readable text
+aja fastapi-scan . --format text
+
+# Only paths under /api
+aja fastapi-scan . --only-api
+
+# Skip DTOs or models from output
+aja fastapi-scan . --no-dtos
+aja fastapi-scan . --no-models
+```
+
+**Output schema (JSON):**
+```json
+{
+  "endpoints": [
+    {
+      "method": "POST",
+      "path": "/api/v1/users",
+      "file": "app/routers/users.py",
+      "line": 24,
+      "handler": "create_user",
+      "framework": "fastapi",
+      "controller": "CreateUserRequest"
+    }
+  ],
+  "dtos": [
+    {
+      "name": "CreateUserRequest",
+      "file": "app/schemas/user.py",
+      "kind": "pydantic",
+      "bases": ["BaseModel"],
+      "fields": [
+        { "name": "name",  "type": "str",          "required": true,  "default": null },
+        { "name": "email", "type": "str",          "required": true,  "default": null },
+        { "name": "age",   "type": "Optional[int]","required": false, "default": "None" }
+      ]
+    }
+  ],
+  "models": [
+    {
+      "name": "User",
+      "file": "app/models/user.py",
+      "kind": "sqlalchemy",
+      "table": "users",
+      "columns": [
+        { "name": "id",    "type": "Integer", "primary_key": true,  "foreign_key": null },
+        { "name": "email", "type": "String",  "primary_key": false, "foreign_key": null }
+      ],
+      "relationships": [
+        { "name": "posts", "target": "Post", "kind": "relationship" }
+      ]
+    }
+  ]
+}
+```
+
+**What the FastAPI scanner resolves:**
+
+| Pattern | Resolved path |
+|---|---|
+| `APIRouter(prefix="/users")` + `@router.get("/")` | `/users` |
+| `app.include_router(router, prefix="/api")` | `/api/users` |
+| `app.include_router(router, prefix="/v1")` + router prefix `/api` | `/v1/api/users` |
+| `@router.api_route("/ping", methods=["GET","HEAD"])` | `GET /ping` + `HEAD /ping` |
+
+**What the Pydantic extractor captures:**
+
+- `class X(BaseModel)` — direct BaseModel subclass
+- `class X(SomeBase)` — inherited from another Pydantic model in the same project
+- Required vs optional fields (`Optional[T]`, `T | None`, `Field(...)`, no default)
+- Default values including `Field(default=…)`
+- List types (`List[str]`, `list[int]`)
+
+**What the SQLAlchemy extractor captures:**
+
+- Classic declarative style: `Column(Integer, primary_key=True)`
+- Modern mapped style: `id: Mapped[int] = mapped_column(primary_key=True)`
+- Foreign keys: `Column(Integer, ForeignKey("users.id"))`
+- Relationships: `relationship("Post", back_populates="author")`
+- `__tablename__`
+
+---
+
 ### `aja copy <file>`
 
 **What it does:** Copies the full contents of a file (or multiple files) to your clipboard — ready to paste into a code review, chat, or AI tool.
@@ -377,10 +470,10 @@ Prints the current AJA version.
 
 ## Supported Languages
 
-| Language | Analysis | Imports | Symbols | Services | Models |
-|----------|----------|---------|---------|----------|--------|
-| Java | ✅ | ✅ | ✅ | ✅ | ✅ |
-| Python | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Language | Analysis | Imports | Symbols | Services | Models | Endpoints |
+|----------|----------|---------|---------|----------|--------|-----------|
+| Java (Spring Boot) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Python (FastAPI) | ✅ | ✅ | ✅ | ✅ | ✅ (Pydantic + SQLAlchemy) | ✅ (prefix-resolved) |
 
 > Static analysis only — no compilation, no runtime, no build tools required.
 

{aja_codeintel-0.1.7 → aja_codeintel-0.1.9}/aja_codeintel.egg-info/SOURCES.txt

@@ -26,6 +26,7 @@ codeintel_cli/commands/project/context_cmd.py
 codeintel_cli/commands/project/debug_cmd.py
 codeintel_cli/commands/project/endpoints_cmd.py
 codeintel_cli/commands/project/errors_cmd.py
+codeintel_cli/commands/project/fastapi_cmd.py
 codeintel_cli/commands/project/folder_cmd.py
 codeintel_cli/commands/project/frontend_cmd.py
 codeintel_cli/commands/project/imports_cmd.py
@@ -36,6 +37,7 @@ codeintel_cli/commands/project/overview_cmd.py
 codeintel_cli/commands/project/resolve_cmd.py
 codeintel_cli/commands/project/scan_cmd.py
 codeintel_cli/commands/project/servicemap_cmd.py
+codeintel_cli/commands/project/trace_cmd.py
 codeintel_cli/commands/project/tree_cmd.py
 codeintel_cli/commands/project/types_cmd.py
 codeintel_cli/commands/project/version_cmd.py
@@ -58,6 +60,7 @@ codeintel_cli/db/cache.py
 codeintel_cli/db/operations.py
 codeintel_cli/db/schema.py
 codeintel_cli/endpoints/__init__.py
+codeintel_cli/endpoints/fastapi_scanner.py
 codeintel_cli/endpoints/java_spring.py
 codeintel_cli/endpoints/models.py
 codeintel_cli/endpoints/openapi_spec.py
@@ -73,12 +76,17 @@ codeintel_cli/lang/__init__.py
 codeintel_cli/lang/router.py
 codeintel_cli/lang/java/__init__.py
 codeintel_cli/lang/java/ast_engine.py
+codeintel_cli/lang/java/auth.py
+codeintel_cli/lang/java/base_path.py
 codeintel_cli/lang/java/call_graph.py
 codeintel_cli/lang/java/engine.py
+codeintel_cli/lang/java/enums.py
 codeintel_cli/lang/java/method_index.py
 codeintel_cli/lang/java/models.py
+codeintel_cli/lang/java/pagination.py
 codeintel_cli/lang/java/resolve.py
 codeintel_cli/lang/java/types.py
+codeintel_cli/lang/java/validation.py
 codeintel_cli/lang/python/__init__.py
 codeintel_cli/lang/python/engine.py
 codeintel_cli/lang/python/models.py
@@ -89,4 +97,5 @@ codeintel_cli/scanner/__init__.py
 codeintel_cli/scanner/scanner.py
 codeintel_cli/terminal/__init__.py
 codeintel_cli/terminal/error_parser.py
-codeintel_cli/terminal/printer.py
+codeintel_cli/terminal/printer.py
+tests/test_fastapi_scanner.py

{aja_codeintel-0.1.7 → aja_codeintel-0.1.9}/codeintel_cli/commands/nav/open_cmd.py

@@ -13,6 +13,4 @@ def register_open(app: typer.Typer) -> None:
         yes: bool = typer.Option(False, "--yes", "-y", help="Open without confirmation"),
     ):
         target, _root = resolve_target_file(query)
-
-        if yes or typer.confirm(f"Open this file?\n{target}"):
-            open_file(target)
+        open_file(target)

{aja_codeintel-0.1.7 → aja_codeintel-0.1.9}/codeintel_cli/commands/project/__init__.py

@@ -19,6 +19,8 @@ def register_project_commands(app: typer.Typer) -> None:
     from .frontend_cmd import register_frontend
     from .errors_cmd import register_errors
     from .debug_cmd import register_debug
+    from .fastapi_cmd import register_fastapi_scan
+    from .trace_cmd import register_trace
 
     register_overview(app)
     register_models(app)
@@ -35,4 +37,6 @@ def register_project_commands(app: typer.Typer) -> None:
     register_version(app)
     register_frontend(app)
     register_errors(app)
-    register_debug(app)
+    register_debug(app)
+    register_fastapi_scan(app)
+    register_trace(app)

aja_codeintel-0.1.9/codeintel_cli/commands/project/fastapi_cmd.py

@@ -0,0 +1,144 @@
+"""
+fastapi-scan command – full FastAPI project scan with prefix resolution.
+
+Outputs a JSON report matching the same schema as the Java Spring Boot scanner:
+  {
+    "endpoints": [ { method, path, file, line, handler, framework, ... } ],
+    "dtos":      [ { name, file, kind, bases, fields: [{name, type, required, default}] } ],
+    "models":    [ { name, file, kind, table, columns: [...], relationships: [...] } ]
+  }
+"""
+
+from __future__ import annotations
+
+import json
+import time
+from pathlib import Path
+
+import typer
+
+from ...core.project import find_project_root
+from ...endpoints.fastapi_scanner import scan_fastapi_project
+from ...endpoints.scan import EndpointScanOptions, iter_supported_source_files
+from ...errors import InvalidPathError
+
+
+def _validate_folder(path: str) -> Path:
+    folder = Path(path).resolve()
+    if not folder.exists() or not folder.is_dir():
+        raise InvalidPathError(message="Invalid folder", path=folder)
+    return folder
+
+
+def _norm(p: str) -> str:
+    return p.replace("\\", "/")
+
+
+def register_fastapi_scan(app: typer.Typer) -> None:
+    @app.command("fastapi-scan", help="Scan a FastAPI project (endpoints + DTOs + models).")
+    def fastapi_scan(
+        path: str = typer.Argument(".", help="FastAPI project root folder"),
+        fmt: str = typer.Option("json", "--format", "-f", help="json | text"),
+        hidden: bool = typer.Option(False, "--hidden", help="Include hidden dotfiles/folders"),
+        no_gitignore: bool = typer.Option(False, "--no-gitignore", help="Do not apply .gitignore rules"),
+        only_api: bool = typer.Option(False, "--only-api", help="Only show paths starting with /api"),
+        dedupe: bool = typer.Option(True, "--dedupe/--no-dedupe", help="Remove duplicate method+path pairs"),
+        no_dtos: bool = typer.Option(False, "--no-dtos", help="Omit Pydantic DTOs from output"),
+        no_models: bool = typer.Option(False, "--no-models", help="Omit SQLAlchemy models from output"),
+    ) -> None:
+        folder = _validate_folder(path)
+        project_root = find_project_root(folder)
+
+        opts = EndpointScanOptions(
+            show_hidden=hidden,
+            use_gitignore=not no_gitignore,
+        )
+
+        t0 = time.perf_counter()
+
+        # Collect .py files via the shared scanner (respects gitignore / hidden)
+        py_files = [
+            f for f in iter_supported_source_files(project_root, opts)
+            if f.suffix.lower() == ".py"
+        ]
+
+        endpoints, dtos, sqla_models = scan_fastapi_project(
+            project_root, files=py_files
+        )
+
+        # Post-processing
+        if only_api:
+            endpoints = [e for e in endpoints if e.path.startswith("/api")]
+
+        if dedupe:
+            seen: set[tuple[str, str]] = set()
+            uniq = []
+            for e in endpoints:
+                key = (e.method, e.path)
+                if key not in seen:
+                    seen.add(key)
+                    uniq.append(e)
+            endpoints = uniq
+
+        endpoints.sort(key=lambda e: (e.path, e.method))
+
+        elapsed = time.perf_counter() - t0
+        fmt_norm = fmt.strip().lower()
+
+        # ------------------------------------------------------------------
+        # JSON output (default)  — same schema as Java scanner
+        # ------------------------------------------------------------------
+        if fmt_norm == "json":
+            report: dict = {
+                "endpoints": [e.to_dict() for e in endpoints],
+                "dtos": [] if no_dtos else [d.to_dict() for d in dtos],
+                "models": [] if no_models else [m.to_dict() for m in sqla_models],
+            }
+            typer.echo(json.dumps(report, indent=2))
+            return
+
+        # ------------------------------------------------------------------
+        # Text output
+        # ------------------------------------------------------------------
+        typer.echo(f"FastAPI project: {project_root}")
+        typer.echo(f"Scanned {len(py_files)} Python files in {elapsed:.3f}s")
+        typer.echo("")
+
+        if endpoints:
+            typer.echo(f"ENDPOINTS ({len(endpoints)})")
+            typer.echo("─" * 60)
+            for e in endpoints:
+                handler_info = f"  → {e.handler}"
+                if e.controller:   # request body model stored here
+                    handler_info += f"  [body: {e.controller}]"
+                typer.echo(f"  {e.method:7} {e.path}")
+                typer.echo(f"  {handler_info}  ({_norm(e.file)}:{e.line})")
+            typer.echo("")
+        else:
+            typer.echo("No FastAPI endpoints found.")
+            typer.echo("")
+
+        if not no_dtos and dtos:
+            typer.echo(f"PYDANTIC DTOS ({len(dtos)})")
+            typer.echo("─" * 60)
+            for d in dtos:
+                bases = ", ".join(d.bases) if d.bases else ""
+                typer.echo(f"  {d.name}({bases})  {_norm(d.file)}")
+                for f_def in d.fields:
+                    req_marker = "*" if f_def.required else " "
+                    default_str = f" = {f_def.default}" if f_def.default is not None else ""
+                    typer.echo(f"    {req_marker} {f_def.name}: {f_def.type}{default_str}")
+            typer.echo("")
+
+        if not no_models and sqla_models:
+            typer.echo(f"SQLALCHEMY MODELS ({len(sqla_models)})")
+            typer.echo("─" * 60)
+            for m in sqla_models:
+                typer.echo(f"  {m.name}  table={m.table_name}  {_norm(m.file)}")
+                for col in m.columns:
+                    pk_marker = " [PK]" if col.primary_key else ""
+                    fk_marker = f" [FK→{col.foreign_key}]" if col.foreign_key else ""
+                    typer.echo(f"    {col.name}: {col.col_type}{pk_marker}{fk_marker}")
+                for rel in m.relationships:
+                    typer.echo(f"    {rel.name}: → {rel.target}")
+            typer.echo("")