Skip to content

Add django-orm-lens under Debugging Tools > Others#3260

Closed
FROWNINGdev wants to merge 1 commit into
vinta:masterfrom
FROWNINGdev:add-django-orm-lens
Closed

Add django-orm-lens under Debugging Tools > Others#3260
FROWNINGdev wants to merge 1 commit into
vinta:masterfrom
FROWNINGdev:add-django-orm-lens

Conversation

@FROWNINGdev

Copy link
Copy Markdown

Adds django-orm-lens to Debugging Tools > Others — the Django debugging neighbourhood alongside django-debug-toolbar and django-migration-linter-style tools.

What it does

Static-analysis dev tool for Django ORM models. Zero database, zero Django boot, zero credentials — parses models.py / signals.py / migrations/ via AST.

Three surfaces on one Python parser:

  • CLI (pip install django-orm-lens) — 6 subcommands: list, apps, describe, relations, nplusone, migration-risk
  • MCP server (pip install django-orm-lens[mcp]) — 9 read-only tools for AI coding agents (Cursor, Aider, Claude Desktop, Zed): list_apps, list_models, describe_model, find_relations, cascade_preview, er_diagram, describe_migration_dependency, suggest_indexes, signal_graph
  • VS Code / VSCodium / Cursor extension — sidebar tree + Mermaid ER diagram + hover cards + CodeLens

Quality checklist per CONTRIBUTING.md

  • Python-first — 78.5% Python (313.5 KB), 17.8% TypeScript (VS Code webview only). Repo language breakdown: https://github.com/FROWNINGdev/django-orm-lens
  • Active — 8 patch releases shipped today (v0.7.0 → v0.7.8), CI green
  • Stable — v0.7.8, 5.0★ Marketplace rating, 185 Python + 4 TypeScript regression tests, all green
  • Documented — README in EN/RU/ES/ZH, quickstart under 60 seconds, examples, gallery, roadmap
  • Unique — the only Django-model static-analysis tool with all three surfaces (editor + CLI + MCP) sharing one parser. No existing awesome-python entry overlaps
  • ⚠️ Established — repository is 9 days old (2026-07-12). This misses the 1-month base bar and the 3-month Hidden Gem bar. Fully understand if you want to hold and revisit; opening this PR mostly to put it on your radar and let you decide.

Signals that partially compensate for age

The entry (Debugging Tools > Others, alphabetically after django-debug-toolbar)

- [django-orm-lens](https://github.com/FROWNINGdev/django-orm-lens) - Live sidebar and Mermaid ER diagram for your Django models plus a CLI and MCP server for AI agents. Static AST analysis — no DB, no Django boot.

Happy to close and revisit at 1-month / 3-month mark if you'd prefer the age bar respected. Please close without hesitation if that's the call — no hard feelings. Thanks for the amazing catalog!

@JinyangWang27

Copy link
Copy Markdown
Collaborator

@FROWNINGdev Thanks for your submission. However, this project does not meet our acceptance criteria:

Repository age: The repository was created 2 weeks ago. We require a minimum of 3 months (or 6 months for Hidden Gem submissions) to ensure project stability.

GitHub stars: 23 stars (minimum 100 required, or strong justification for Hidden Gem).

Please see our CONTRIBUTING.md for full requirements. You're welcome to resubmit once the project has matured and gained community traction.

@FROWNINGdev

Copy link
Copy Markdown
Author

Thanks @JinyangWang27 for taking the time to review — totally fair call and I appreciate the transparent criteria. Will circle back around late September 2026 when we're past the 3-month mark and (hopefully) north of 100 ⭐. Growth curve looks reasonable so far (23 ⭐ in 10 days, Open VSX verified, MCP Registry-listed) but agreed the age gate is exactly the right filter. Thanks for the great catalog.

@k7b95zcf9b-code

k7b95zcf9b-code commented Jul 22, 2026 via email

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants