Menu

I built a Django command that generates API docs without Swagger or annotations

#routes#docs#manage#django#article
Reading 0:00
15s threshold

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:…

Continue reading — create a free account

Join HashtagPLUS to read full articles, follow hashtags, vote, and join the conversation.