django-shreck 0.1.4

A rich TUI replacement for Django's shell_plus — browse models, querysets, and management commands from your terminal.

🟢 django-shreck

A rich TUI replacement for Django's shell_plus — browse models and querysets from your terminal.

Screenshots

🎬 Watch the screencast

Features

• Auto-imported models — All your Django models are available immediately with tab completion
• Interactive shell — Full Python REPL powered by ptpython
• Scrollable table view — QuerySets are rendered as rich, scrollable tables
• Detail browser — Single objects displayed as navigable key-value detail views
• Inline editing — Edit and save single model instances directly from the TUI
• Side-by-side compare — Two objects rendered in a diff-style comparison view
• Admin integration — Single keypress opens the Django admin for any object or queryset

Installation

pip install django-shreck

Add to your INSTALLED_APPS:

INSTALLED_APPS = [
    # ...
    "django_shreck",
]

Usage

python manage.py shreck

Keybindings

Key	Action
q	Quit
a	Open admin for current object/queryset
Enter	Execute shell input
↑/↓	Browse fields / scroll table
Tab	Auto-complete

Development

git clone https://github.com/belda/django-shreck.git
cd django-shreck
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
make test

License

MIT