I’ve been working with Django REST Framework for a while, and one thing that always annoyed me was how hard it is to get a clear view of all routes.
You either:
dig through multiple urls.py files
or set up Swagger / OpenAPI and maintain schemas
Both felt like overkill for quick visibility or internal docs.
So I built a small tool:
👉 python manage.py routes
It prints all routes in a clean table (methods, views, serializers, etc.)
Then I added this:
👉 python manage.py routes --format markdown
It generates a full API reference ( api_docs.md ) directly from your code:
serializers
permissions
auth classes
filters
path params
docstrings
No decorators, no YAML, no schema config.
It’s basically like rails routes , but for Django — with docs generation.
I’m not trying to replace Swagger — this is more for:
quick debugging
onboarding
internal docs
understanding large codebases
Would love some feedback on how we can improve this project.
Repo: https://github.com/shibinshibii/drf-routes
PyPI:…