django-orm-lens 1.0.2__tar.gz → 1.0.4__tar.gz

{django_orm_lens-1.0.2 → django_orm_lens-1.0.4}/PKG-INFO

@@ -1,191 +1,193 @@
-Metadata-Version: 2.4
-Name: django-orm-lens
-Version: 1.0.2
-Summary: Static analysis + MCP server for Django models. Sidebar tree, ER diagrams, and JSON output for terminals and AI coding agents.
-Author: frowningdev
-License: MIT
-Project-URL: Homepage, https://github.com/FROWNINGdev/django-orm-lens
-Project-URL: Repository, https://github.com/FROWNINGdev/django-orm-lens
-Project-URL: Bug Tracker, https://github.com/FROWNINGdev/django-orm-lens/issues
-Project-URL: Changelog, https://github.com/FROWNINGdev/django-orm-lens/blob/main/CHANGELOG.md
-Project-URL: VS Code Marketplace, https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens
-Keywords: django,orm,models,er-diagram,mermaid,mcp,ai-agents,cursor,aider,code-analysis,static-analysis
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Framework :: Django
-Classifier: Framework :: Django :: 4.0
-Classifier: Framework :: Django :: 4.1
-Classifier: Framework :: Django :: 4.2
-Classifier: Framework :: Django :: 5.0
-Classifier: Framework :: Django :: 5.1
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Documentation
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Utilities
-Classifier: Typing :: Typed
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Provides-Extra: mcp
-Requires-Dist: mcp>=1.0; extra == "mcp"
-Provides-Extra: dev
-Requires-Dist: pytest>=8; extra == "dev"
-Requires-Dist: ruff>=0.5; extra == "dev"
-Requires-Dist: mypy>=1.10; extra == "dev"
-Requires-Dist: build>=1.2; extra == "dev"
-Requires-Dist: twine>=5.1; extra == "dev"
-
-# django-orm-lens
-
-<!-- mcp-name: io.github.frowningdev/django-orm-lens -->
-
-**Static analysis + MCP server for Django models.** Terminal- and AI-agent-friendly.
-
-Ships with a zero-dependency parser, a JSON/Markdown/table CLI, and an optional
-MCP (Model Context Protocol) server so any AI coding agent — Cursor, Aider,
-Continue, and any other MCP client — can navigate your Django schema without
-importing Django or spinning up your app.
-
-Companion to the [Django ORM Lens VS Code
-extension](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens).
-
----
-
-## Install
-
-```bash
-# Core CLI (zero third-party deps)
-pip install django-orm-lens
-
-# With the MCP server (adds the `mcp` package)
-pip install "django-orm-lens[mcp]"
-```
-
-Requires Python **3.9+**. Works on Linux, macOS, and Windows.
-
----
-
-## CLI usage
-
-```bash
-# Scan a Django project for models (JSON, Markdown, or table)
-django-orm-lens scan -f json
-django-orm-lens scan -f markdown
-django-orm-lens scan -f table
-
-# Describe one model
-django-orm-lens describe blog.Post
-django-orm-lens describe Post -f json
-
-# Compact hover card (great for pipeing into your editor)
-django-orm-lens hover blog.Post
-
-# Flat list — pipes into fzf, grep, etc.
-django-orm-lens list | fzf
-
-# Emit a Mermaid ER diagram
-django-orm-lens er > schema.mmd
-django-orm-lens er -o schema.mmd
-```
-
-Every command accepts `--path <dir>` and repeatable `--exclude <glob>`. Defaults
-skip `migrations/`, `venv/`, `.venv/`, `env/`, and `node_modules/`.
-
----
-
-## MCP server — for AI coding agents
-
-The MCP server exposes five read-only tools that any MCP-compatible agent can
-call while it edits your Django project:
-
-| Tool | Purpose |
-| --- | --- |
-| `list_apps` | Every Django app in the workspace with model counts |
-| `list_models` | Flat `app.Model` list, optional app filter |
-| `describe_model` | Full field / relation / Meta detail for one model |
-| `find_relations` | Inbound + outbound relations for one model |
-| `er_diagram` | Mermaid `erDiagram` string for the whole workspace |
-
-### Start the server manually
-
-```bash
-django-orm-lens-mcp     # dedicated entry point
-# or
-django-orm-lens mcp     # subcommand
-```
-
-By default the server scans the current working directory. Override with
-`DJANGO_ORM_LENS_ROOT=/abs/path/to/project`.
-
-### Register it with an agent
-
-**Cursor** — add to `~/.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "django-orm-lens": {
-      "command": "django-orm-lens-mcp",
-      "env": { "DJANGO_ORM_LENS_ROOT": "/abs/path/to/your/project" }
-    }
-  }
-}
-```
-
-**Aider / Continue.dev / Zed / any MCP client** — same shape, the tool is
-generic. Point `command` at the installed `django-orm-lens-mcp` binary and set
-the workspace root via env.
-
----
-
-## Why?
-
-Django's ORM is Python, and Python is dynamic. AI agents that only see
-`models.py` as raw text miss:
-
-* which fields belong to which model;
-* the direction and cardinality of every relation;
-* what `Meta.ordering`, `unique_together`, and `constraints` actually contain;
-* which app owns which model when the project uses split `models/` packages.
-
-`django-orm-lens` gives them a **static, deterministic, JSON view** of the
-schema — no Django boot, no database, no side effects. And you get a nice CLI
-for humans too.
-
----
-
-## Programmatic API
-
-```python
-from django_orm_lens import scan_workspace
-
-index = scan_workspace(".")
-for app in index.apps:
-    for model in app.models:
-        print(f"{app.name}.{model.name} — {len(model.fields)} fields")
-
-# The full parsed tree serialises to the same JSON schema the VS Code
-# extension emits, so tools can share it interchangeably.
-import json
-json.dumps(index.to_dict(), indent=2)
-```
-
----
-
-## Links
-
-* Repo: <https://github.com/FROWNINGdev/django-orm-lens>
-* Issues: <https://github.com/FROWNINGdev/django-orm-lens/issues>
-* Changelog: <https://github.com/FROWNINGdev/django-orm-lens/blob/main/CHANGELOG.md>
-* VS Code extension: <https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens>
-
-MIT licensed.
+Metadata-Version: 2.4
+Name: django-orm-lens
+Version: 1.0.4
+Summary: Static analysis + MCP server for Django models. Sidebar tree, ER diagrams, and JSON output for terminals and AI coding agents.
+Author: frowningdev
+License: MIT
+Project-URL: Homepage, https://github.com/FROWNINGdev/django-orm-lens
+Project-URL: Repository, https://github.com/FROWNINGdev/django-orm-lens
+Project-URL: Bug Tracker, https://github.com/FROWNINGdev/django-orm-lens/issues
+Project-URL: Changelog, https://github.com/FROWNINGdev/django-orm-lens/blob/main/CHANGELOG.md
+Project-URL: VS Code Marketplace, https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens
+Keywords: django,orm,models,er-diagram,mermaid,mcp,ai-agents,cursor,aider,code-analysis,static-analysis
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.1; extra == "dev"
+
+# django-orm-lens
+
+<!-- mcp-name: io.github.FROWNINGdev/django-orm-lens -->
+
+**Static analysis + MCP server for Django models.** Terminal- and AI-agent-friendly.
+
+Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/servers/io.github.FROWNINGdev%2Fdjango-orm-lens) as `io.github.FROWNINGdev/django-orm-lens`.
+
+Ships with a zero-dependency parser, a JSON/Markdown/table CLI, and an optional
+MCP (Model Context Protocol) server so any AI coding agent — Cursor, Aider,
+Continue, and any other MCP client — can navigate your Django schema without
+importing Django or spinning up your app.
+
+Companion to the [Django ORM Lens VS Code
+extension](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens).
+
+---
+
+## Install
+
+```bash
+# Core CLI (zero third-party deps)
+pip install django-orm-lens
+
+# With the MCP server (adds the `mcp` package)
+pip install "django-orm-lens[mcp]"
+```
+
+Requires Python **3.9+**. Works on Linux, macOS, and Windows.
+
+---
+
+## CLI usage
+
+```bash
+# Scan a Django project for models (JSON, Markdown, or table)
+django-orm-lens scan -f json
+django-orm-lens scan -f markdown
+django-orm-lens scan -f table
+
+# Describe one model
+django-orm-lens describe blog.Post
+django-orm-lens describe Post -f json
+
+# Compact hover card (great for pipeing into your editor)
+django-orm-lens hover blog.Post
+
+# Flat list — pipes into fzf, grep, etc.
+django-orm-lens list | fzf
+
+# Emit a Mermaid ER diagram
+django-orm-lens er > schema.mmd
+django-orm-lens er -o schema.mmd
+```
+
+Every command accepts `--path <dir>` and repeatable `--exclude <glob>`. Defaults
+skip `migrations/`, `venv/`, `.venv/`, `env/`, and `node_modules/`.
+
+---
+
+## MCP server — for AI coding agents
+
+The MCP server exposes five read-only tools that any MCP-compatible agent can
+call while it edits your Django project:
+
+| Tool | Purpose |
+| --- | --- |
+| `list_apps` | Every Django app in the workspace with model counts |
+| `list_models` | Flat `app.Model` list, optional app filter |
+| `describe_model` | Full field / relation / Meta detail for one model |
+| `find_relations` | Inbound + outbound relations for one model |
+| `er_diagram` | Mermaid `erDiagram` string for the whole workspace |
+
+### Start the server manually
+
+```bash
+django-orm-lens-mcp     # dedicated entry point
+# or
+django-orm-lens mcp     # subcommand
+```
+
+By default the server scans the current working directory. Override with
+`DJANGO_ORM_LENS_ROOT=/abs/path/to/project`.
+
+### Register it with an agent
+
+**Cursor** — add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "django-orm-lens": {
+      "command": "django-orm-lens-mcp",
+      "env": { "DJANGO_ORM_LENS_ROOT": "/abs/path/to/your/project" }
+    }
+  }
+}
+```
+
+**Aider / Continue.dev / Zed / any MCP client** — same shape, the tool is
+generic. Point `command` at the installed `django-orm-lens-mcp` binary and set
+the workspace root via env.
+
+---
+
+## Why?
+
+Django's ORM is Python, and Python is dynamic. AI agents that only see
+`models.py` as raw text miss:
+
+* which fields belong to which model;
+* the direction and cardinality of every relation;
+* what `Meta.ordering`, `unique_together`, and `constraints` actually contain;
+* which app owns which model when the project uses split `models/` packages.
+
+`django-orm-lens` gives them a **static, deterministic, JSON view** of the
+schema — no Django boot, no database, no side effects. And you get a nice CLI
+for humans too.
+
+---
+
+## Programmatic API
+
+```python
+from django_orm_lens import scan_workspace
+
+index = scan_workspace(".")
+for app in index.apps:
+    for model in app.models:
+        print(f"{app.name}.{model.name} — {len(model.fields)} fields")
+
+# The full parsed tree serialises to the same JSON schema the VS Code
+# extension emits, so tools can share it interchangeably.
+import json
+json.dumps(index.to_dict(), indent=2)
+```
+
+---
+
+## Links
+
+* Repo: <https://github.com/FROWNINGdev/django-orm-lens>
+* Issues: <https://github.com/FROWNINGdev/django-orm-lens/issues>
+* Changelog: <https://github.com/FROWNINGdev/django-orm-lens/blob/main/CHANGELOG.md>
+* VS Code extension: <https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens>
+
+MIT licensed.

{django_orm_lens-1.0.2 → django_orm_lens-1.0.4}/README.md

@@ -1,9 +1,11 @@
 # django-orm-lens
 
-<!-- mcp-name: io.github.frowningdev/django-orm-lens -->
+<!-- mcp-name: io.github.FROWNINGdev/django-orm-lens -->
 
 **Static analysis + MCP server for Django models.** Terminal- and AI-agent-friendly.
 
+Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/servers/io.github.FROWNINGdev%2Fdjango-orm-lens) as `io.github.FROWNINGdev/django-orm-lens`.
+
 Ships with a zero-dependency parser, a JSON/Markdown/table CLI, and an optional
 MCP (Model Context Protocol) server so any AI coding agent — Cursor, Aider,
 Continue, and any other MCP client — can navigate your Django schema without

{django_orm_lens-1.0.2 → django_orm_lens-1.0.4}/django_orm_lens/__init__.py

@@ -4,7 +4,7 @@ Terminal / editor-agnostic parser for Django models.py files.
 Ships a CLI and an optional MCP server for AI coding agents.
 """
 
-__version__ = "1.0.2"
+__version__ = "1.0.4"
 
 from .models import ParsedApp, ParsedField, ParsedModel, WorkspaceIndex
 from .parser import parse_models_file, scan_workspace

{django_orm_lens-1.0.2 → django_orm_lens-1.0.4}/django_orm_lens/models.py

@@ -40,6 +40,8 @@ class ParsedField:
             out["onDelete"] = self.on_delete
         if self.related_name is not None:
             out["relatedName"] = self.related_name
+        if self.through_model is not None:
+            out["throughModel"] = self.through_model
         return out
 
 

{django_orm_lens-1.0.2 → django_orm_lens-1.0.4}/django_orm_lens/parser.py

@@ -258,6 +258,8 @@ def parse_models_file(file_path: str, content: str) -> List[ParsedModel]:
                     field.related_model = _extract_related(inner)
                     field.on_delete = _extract_on_delete(inner)
                     field.related_name = _extract_related_name(inner)
+                    if ftype == "ManyToManyField":
+                        field.through_model = _extract_through_model(inner)
                 model.fields.append(field)
                 j = end_idx + 1
                 continue

{django_orm_lens-1.0.2 → django_orm_lens-1.0.4}/django_orm_lens.egg-info/PKG-INFO

@@ -1,191 +1,193 @@
-Metadata-Version: 2.4
-Name: django-orm-lens
-Version: 1.0.2
-Summary: Static analysis + MCP server for Django models. Sidebar tree, ER diagrams, and JSON output for terminals and AI coding agents.
-Author: frowningdev
-License: MIT
-Project-URL: Homepage, https://github.com/FROWNINGdev/django-orm-lens
-Project-URL: Repository, https://github.com/FROWNINGdev/django-orm-lens
-Project-URL: Bug Tracker, https://github.com/FROWNINGdev/django-orm-lens/issues
-Project-URL: Changelog, https://github.com/FROWNINGdev/django-orm-lens/blob/main/CHANGELOG.md
-Project-URL: VS Code Marketplace, https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens
-Keywords: django,orm,models,er-diagram,mermaid,mcp,ai-agents,cursor,aider,code-analysis,static-analysis
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Framework :: Django
-Classifier: Framework :: Django :: 4.0
-Classifier: Framework :: Django :: 4.1
-Classifier: Framework :: Django :: 4.2
-Classifier: Framework :: Django :: 5.0
-Classifier: Framework :: Django :: 5.1
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Documentation
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Utilities
-Classifier: Typing :: Typed
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Provides-Extra: mcp
-Requires-Dist: mcp>=1.0; extra == "mcp"
-Provides-Extra: dev
-Requires-Dist: pytest>=8; extra == "dev"
-Requires-Dist: ruff>=0.5; extra == "dev"
-Requires-Dist: mypy>=1.10; extra == "dev"
-Requires-Dist: build>=1.2; extra == "dev"
-Requires-Dist: twine>=5.1; extra == "dev"
-
-# django-orm-lens
-
-<!-- mcp-name: io.github.frowningdev/django-orm-lens -->
-
-**Static analysis + MCP server for Django models.** Terminal- and AI-agent-friendly.
-
-Ships with a zero-dependency parser, a JSON/Markdown/table CLI, and an optional
-MCP (Model Context Protocol) server so any AI coding agent — Cursor, Aider,
-Continue, and any other MCP client — can navigate your Django schema without
-importing Django or spinning up your app.
-
-Companion to the [Django ORM Lens VS Code
-extension](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens).
-
----
-
-## Install
-
-```bash
-# Core CLI (zero third-party deps)
-pip install django-orm-lens
-
-# With the MCP server (adds the `mcp` package)
-pip install "django-orm-lens[mcp]"
-```
-
-Requires Python **3.9+**. Works on Linux, macOS, and Windows.
-
----
-
-## CLI usage
-
-```bash
-# Scan a Django project for models (JSON, Markdown, or table)
-django-orm-lens scan -f json
-django-orm-lens scan -f markdown
-django-orm-lens scan -f table
-
-# Describe one model
-django-orm-lens describe blog.Post
-django-orm-lens describe Post -f json
-
-# Compact hover card (great for pipeing into your editor)
-django-orm-lens hover blog.Post
-
-# Flat list — pipes into fzf, grep, etc.
-django-orm-lens list | fzf
-
-# Emit a Mermaid ER diagram
-django-orm-lens er > schema.mmd
-django-orm-lens er -o schema.mmd
-```
-
-Every command accepts `--path <dir>` and repeatable `--exclude <glob>`. Defaults
-skip `migrations/`, `venv/`, `.venv/`, `env/`, and `node_modules/`.
-
----
-
-## MCP server — for AI coding agents
-
-The MCP server exposes five read-only tools that any MCP-compatible agent can
-call while it edits your Django project:
-
-| Tool | Purpose |
-| --- | --- |
-| `list_apps` | Every Django app in the workspace with model counts |
-| `list_models` | Flat `app.Model` list, optional app filter |
-| `describe_model` | Full field / relation / Meta detail for one model |
-| `find_relations` | Inbound + outbound relations for one model |
-| `er_diagram` | Mermaid `erDiagram` string for the whole workspace |
-
-### Start the server manually
-
-```bash
-django-orm-lens-mcp     # dedicated entry point
-# or
-django-orm-lens mcp     # subcommand
-```
-
-By default the server scans the current working directory. Override with
-`DJANGO_ORM_LENS_ROOT=/abs/path/to/project`.
-
-### Register it with an agent
-
-**Cursor** — add to `~/.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "django-orm-lens": {
-      "command": "django-orm-lens-mcp",
-      "env": { "DJANGO_ORM_LENS_ROOT": "/abs/path/to/your/project" }
-    }
-  }
-}
-```
-
-**Aider / Continue.dev / Zed / any MCP client** — same shape, the tool is
-generic. Point `command` at the installed `django-orm-lens-mcp` binary and set
-the workspace root via env.
-
----
-
-## Why?
-
-Django's ORM is Python, and Python is dynamic. AI agents that only see
-`models.py` as raw text miss:
-
-* which fields belong to which model;
-* the direction and cardinality of every relation;
-* what `Meta.ordering`, `unique_together`, and `constraints` actually contain;
-* which app owns which model when the project uses split `models/` packages.
-
-`django-orm-lens` gives them a **static, deterministic, JSON view** of the
-schema — no Django boot, no database, no side effects. And you get a nice CLI
-for humans too.
-
----
-
-## Programmatic API
-
-```python
-from django_orm_lens import scan_workspace
-
-index = scan_workspace(".")
-for app in index.apps:
-    for model in app.models:
-        print(f"{app.name}.{model.name} — {len(model.fields)} fields")
-
-# The full parsed tree serialises to the same JSON schema the VS Code
-# extension emits, so tools can share it interchangeably.
-import json
-json.dumps(index.to_dict(), indent=2)
-```
-
----
-
-## Links
-
-* Repo: <https://github.com/FROWNINGdev/django-orm-lens>
-* Issues: <https://github.com/FROWNINGdev/django-orm-lens/issues>
-* Changelog: <https://github.com/FROWNINGdev/django-orm-lens/blob/main/CHANGELOG.md>
-* VS Code extension: <https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens>
-
-MIT licensed.
+Metadata-Version: 2.4
+Name: django-orm-lens
+Version: 1.0.4
+Summary: Static analysis + MCP server for Django models. Sidebar tree, ER diagrams, and JSON output for terminals and AI coding agents.
+Author: frowningdev
+License: MIT
+Project-URL: Homepage, https://github.com/FROWNINGdev/django-orm-lens
+Project-URL: Repository, https://github.com/FROWNINGdev/django-orm-lens
+Project-URL: Bug Tracker, https://github.com/FROWNINGdev/django-orm-lens/issues
+Project-URL: Changelog, https://github.com/FROWNINGdev/django-orm-lens/blob/main/CHANGELOG.md
+Project-URL: VS Code Marketplace, https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens
+Keywords: django,orm,models,er-diagram,mermaid,mcp,ai-agents,cursor,aider,code-analysis,static-analysis
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.1; extra == "dev"
+
+# django-orm-lens
+
+<!-- mcp-name: io.github.FROWNINGdev/django-orm-lens -->
+
+**Static analysis + MCP server for Django models.** Terminal- and AI-agent-friendly.
+
+Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io/servers/io.github.FROWNINGdev%2Fdjango-orm-lens) as `io.github.FROWNINGdev/django-orm-lens`.
+
+Ships with a zero-dependency parser, a JSON/Markdown/table CLI, and an optional
+MCP (Model Context Protocol) server so any AI coding agent — Cursor, Aider,
+Continue, and any other MCP client — can navigate your Django schema without
+importing Django or spinning up your app.
+
+Companion to the [Django ORM Lens VS Code
+extension](https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens).
+
+---
+
+## Install
+
+```bash
+# Core CLI (zero third-party deps)
+pip install django-orm-lens
+
+# With the MCP server (adds the `mcp` package)
+pip install "django-orm-lens[mcp]"
+```
+
+Requires Python **3.9+**. Works on Linux, macOS, and Windows.
+
+---
+
+## CLI usage
+
+```bash
+# Scan a Django project for models (JSON, Markdown, or table)
+django-orm-lens scan -f json
+django-orm-lens scan -f markdown
+django-orm-lens scan -f table
+
+# Describe one model
+django-orm-lens describe blog.Post
+django-orm-lens describe Post -f json
+
+# Compact hover card (great for pipeing into your editor)
+django-orm-lens hover blog.Post
+
+# Flat list — pipes into fzf, grep, etc.
+django-orm-lens list | fzf
+
+# Emit a Mermaid ER diagram
+django-orm-lens er > schema.mmd
+django-orm-lens er -o schema.mmd
+```
+
+Every command accepts `--path <dir>` and repeatable `--exclude <glob>`. Defaults
+skip `migrations/`, `venv/`, `.venv/`, `env/`, and `node_modules/`.
+
+---
+
+## MCP server — for AI coding agents
+
+The MCP server exposes five read-only tools that any MCP-compatible agent can
+call while it edits your Django project:
+
+| Tool | Purpose |
+| --- | --- |
+| `list_apps` | Every Django app in the workspace with model counts |
+| `list_models` | Flat `app.Model` list, optional app filter |
+| `describe_model` | Full field / relation / Meta detail for one model |
+| `find_relations` | Inbound + outbound relations for one model |
+| `er_diagram` | Mermaid `erDiagram` string for the whole workspace |
+
+### Start the server manually
+
+```bash
+django-orm-lens-mcp     # dedicated entry point
+# or
+django-orm-lens mcp     # subcommand
+```
+
+By default the server scans the current working directory. Override with
+`DJANGO_ORM_LENS_ROOT=/abs/path/to/project`.
+
+### Register it with an agent
+
+**Cursor** — add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "django-orm-lens": {
+      "command": "django-orm-lens-mcp",
+      "env": { "DJANGO_ORM_LENS_ROOT": "/abs/path/to/your/project" }
+    }
+  }
+}
+```
+
+**Aider / Continue.dev / Zed / any MCP client** — same shape, the tool is
+generic. Point `command` at the installed `django-orm-lens-mcp` binary and set
+the workspace root via env.
+
+---
+
+## Why?
+
+Django's ORM is Python, and Python is dynamic. AI agents that only see
+`models.py` as raw text miss:
+
+* which fields belong to which model;
+* the direction and cardinality of every relation;
+* what `Meta.ordering`, `unique_together`, and `constraints` actually contain;
+* which app owns which model when the project uses split `models/` packages.
+
+`django-orm-lens` gives them a **static, deterministic, JSON view** of the
+schema — no Django boot, no database, no side effects. And you get a nice CLI
+for humans too.
+
+---
+
+## Programmatic API
+
+```python
+from django_orm_lens import scan_workspace
+
+index = scan_workspace(".")
+for app in index.apps:
+    for model in app.models:
+        print(f"{app.name}.{model.name} — {len(model.fields)} fields")
+
+# The full parsed tree serialises to the same JSON schema the VS Code
+# extension emits, so tools can share it interchangeably.
+import json
+json.dumps(index.to_dict(), indent=2)
+```
+
+---
+
+## Links
+
+* Repo: <https://github.com/FROWNINGdev/django-orm-lens>
+* Issues: <https://github.com/FROWNINGdev/django-orm-lens/issues>
+* Changelog: <https://github.com/FROWNINGdev/django-orm-lens/blob/main/CHANGELOG.md>
+* VS Code extension: <https://marketplace.visualstudio.com/items?itemName=frowningdev.django-orm-lens>
+
+MIT licensed.

{django_orm_lens-1.0.2 → django_orm_lens-1.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "django-orm-lens"
-version = "1.0.2"
+version = "1.0.4"
 description = "Static analysis + MCP server for Django models. Sidebar tree, ER diagrams, and JSON output for terminals and AI coding agents."
 readme = "README.md"
 requires-python = ">=3.9"

{django_orm_lens-1.0.2 → django_orm_lens-1.0.4}/setup.cfg

@@ -1,4 +1,4 @@
-[egg_info]
-tag_build = 
-tag_date = 0
-
+[egg_info]
+tag_build = 
+tag_date = 0
+