aja-codeintel 0.1.8__tar.gz → 0.2.0__tar.gz

{aja_codeintel-0.1.8 → aja_codeintel-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aja-codeintel
-Version: 0.1.8
+Version: 0.2.0
 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.8 → aja_codeintel-0.2.0}/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.8 → aja_codeintel-0.2.0}/aja_codeintel.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aja-codeintel
-Version: 0.1.8
+Version: 0.2.0
 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.8 → aja_codeintel-0.2.0}/aja_codeintel.egg-info/SOURCES.txt

@@ -25,7 +25,9 @@ codeintel_cli/commands/project/__init__.py
 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/entire_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 +38,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 +61,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
@@ -71,6 +75,7 @@ codeintel_cli/graph/query.py
 codeintel_cli/graph/traverse.py
 codeintel_cli/lang/__init__.py
 codeintel_cli/lang/router.py
+codeintel_cli/lang/shared_models.py
 codeintel_cli/lang/java/__init__.py
 codeintel_cli/lang/java/ast_engine.py
 codeintel_cli/lang/java/auth.py
@@ -94,4 +99,7 @@ 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_entire_cmd.py
+tests/test_fastapi_scanner.py
+tests/test_trace_cmd.py

{aja_codeintel-0.1.8 → aja_codeintel-0.2.0}/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.8 → aja_codeintel-0.2.0}/codeintel_cli/commands/project/__init__.py

@@ -19,6 +19,9 @@ 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
+    from .entire_cmd import register_entire
 
     register_overview(app)
     register_models(app)
@@ -35,4 +38,7 @@ 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)
+    register_entire(app)

{aja_codeintel-0.1.8 → aja_codeintel-0.2.0}/codeintel_cli/commands/project/endpoints_cmd.py

@@ -14,7 +14,7 @@ from ...core.project import find_project_root
 from ...endpoints.java_spring import extract_spring_endpoints
 from ...endpoints.python_web import extract_python_endpoints
 from ...endpoints.scan import EndpointScanOptions, iter_supported_source_files
-from ...endpoints.openapi_spec import extract_openapi_endpoints  # NEW
+from ...endpoints.openapi_spec import extract_openapi_endpoints
 from ...errors import InvalidPathError