django-admin-generator 3.0.0

Django Admin Generator is a management command to automatically generate a Django `admin.py` file for given apps/models.

Django Admin Generator

The Django Admin Generator is a project which can automatically generate (scaffold) a Django Admin for you. By doing this it will introspect your models and automatically generate an Admin with properties like:

• list_display for all local fields
• list_filter for foreign keys with few items
• raw_id_fields for foreign keys with a lot of items
• search_fields for name and slug fields
• prepopulated_fields for slug fields
• date_hierarchy for created_at, updated_at or joined_at fields

Links

• Documentation: https://django-admin-generator.readthedocs.io/en/latest/
• Source: https://github.com/WoLpH/django-admin-generator
• Bug reports: https://github.com/WoLpH/django-admin-generator/issues
• Package homepage: https://pypi.org/project/django-admin-generator/
• My blog: https://w.wol.ph/

Install

1. Install the package:

   pip install django-admin-generator
   

2. Add django_admin_generator to your INSTALLED_APPS.

Usage

To generate an admin for a given app:

./manage.py admin_generator APP_NAME >> APP_NAME/admin.py

To generate an admin for a given app with all models starting with user:

./manage.py admin_generator APP_NAME '^user' >> APP_NAME/admin.py

To write the generated admin directly to each app's admin.py:

./manage.py admin_generator APP_NAME --write

Use all as the app name to generate admins for every local (i.e. not in site-packages) app:

./manage.py admin_generator all

Live demo

A self-documenting blog demo whose admin.py is fully auto-generated:

uv run --extra demo python test_project/manage.py demo   # or: tox -e demo

Then open http://127.0.0.1:8000/admin/ and log in with admin / admin. The admin index explains what was generated and why. See test_project/README.md for a guided tour.

Development

This project uses uv and tox:

uv sync --extra dev          # create the environment
uv run pytest                # run the tests
uv run ruff check .          # lint
uv run tox                   # full matrix (tests, lint, types, docs)