Skip to main content

🟢 django-shreck

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

Python 3.11+ Django 4.2+ License: MIT

Screenshots

Shell and table view Detail view

Inline editing Side-by-side compare

🎬 Watch the screencast

Features

  • Auto-imported models — All your Django models are available immediately with tab completion
  • Interactive shell — Full Python REPL with auto-imported models and history
  • 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

Metadata

Release files for django-shreck 0.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-shreck 0.1.5
File Size Uploaded
django_shreck-0.1.5.tar.gz 837.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for django-shreck 0.1.5
File Interpreter ABI Platform
django_shreck-0.1.5-py3-none-any.whl Python 3 none any Details

Total release size: 865.1 kB

Release files / django_shreck-0.1.5.tar.gz

Download URL django_shreck-0.1.5.tar.gz
Size 837.7 kB
Tags Source
SHA-256 checksum
How to use checksums
36af84c88a069da1297f820ea7af1b4895c85f2df718c5ec296ea17b04ec1b10
BLAKE2b-256 checksum
How to use checksums
ab0bbac6eddce21be7b0b9c3c13d5bfd6b139a34ea03418bf2aa4592dd87a26e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release files / django_shreck-0.1.5-py3-none-any.whl

Download URL django_shreck-0.1.5-py3-none-any.whl
Size 27.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9c576595ffccbcbb11b132e368d41e0170653893c07f24a77ef6afb5758ac4c0
BLAKE2b-256 checksum
How to use checksums
5caa0c5b892fff8fdce2425c07761131702fc3523804450cf590477af5816a89
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

0.1.5 This release

2 release files

0.1.4

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page