Developer CLIv1.0.6

⚙️djangoplay-cli turns environment setup into one predictable command.

Development environments should have an interface.

Every Django project quietly accumulates the same setup work — Redis, Celery, TLS certificates, environment encryption, static collection — until starting the app stops being `python manage.py runserver` and becomes a sequence only one developer remembers correctly. djangoplay-cli turns that sequence into a small set of intentional commands and orchestrates the rest through process boundaries, without ever importing the host application's Django internals.

Orchestrated Commands

YAML

Single Config Contract

Django Internals Imported

Command to Start Dev

PyPI Package Source Documentation

djangoplay-cli

Live

dplay ssl — local HTTPS dev server

$dplay ssl

pip install · no build step · drop into any Python project

What's New

Why It Exists

Starting a Django app that depends on Redis, Celery, TLS, and environment encryption turns into a memorized sequence of commands instead of a single `runserver`.
Every manual setup step is a chance for two developers' environments to quietly diverge — one forgets Celery, another has stale Redis state.
Local HTTPS, certificate SANs, and multi-subdomain routing tend to become their own mini-project instead of part of the normal startup flow.

A tool that orchestrates. An application it never imports.

DjangoPlay CLI — orchestrates

Repository & virtualenv detection
Process orchestration (Django, Celery, Redis)
TLS/certificate management
Log streaming & diagnostics

DjangoPlay Application — runs

Django, Celery, Redis, PostgreSQL
Application-specific logic
Invoked only via manage.py / subprocess calls, never imported directly

One predictable command, zero coupling to app internals

What djangoplay-cli Does

One Command to Start: `dplay http` chains repo detection, venv checks, env encryption, a Redis flush, static collection, and a Celery worker + beat restart before it ever launches the Django dev server.
HTTPS Without the Side Project: `dplay ssl` validates or regenerates a local TLS certificate — with SANs derived from your configured host and subdomains — then serves over HTTPS via runserver_plus automatically.
Celery Treated as Part of the Environment: `dplay worker` runs the Celery worker in the foreground, and the main startup flow restarts worker + beat and waits for readiness before handing off to Django.
Logs as a First-Class Interface: `dplay logs [app]` discovers per-app log files from the project’s log directory and streams them with level filtering, tail length, and follow/no-follow control.
Diagnose Before You Debug: `dplay system doctor` checks Python version, Redis, PostgreSQL, and Celery availability in one pass, instead of chasing environment issues one at a time.
A Deliberate Reset, Not a Guess: `dplay system reset` stops development Celery/beat processes and flushes Redis — explicitly scoped to local development, never a production management mechanism.

Django DevelopmentCLIEnvironment Management

Install & Quickstart

Install

pip install djangoplay-cli

Start the HTTP dev environment

dplay http

Start the HTTPS dev environment

dplay ssl

Regenerate certificates after adding a subdomain

dplay certs
dplay ssl

Stream one app’s logs, errors only

dplay logs mailer --level ERROR

Check environment health before debugging

dplay system doctor

Security & Trust Boundaries

Machine-local secrets live in ~/.dplay/.secrets, loaded into the process environment at runtime — never committed to the CLI or application repository.
The CLI never imports the host application’s Django internals; it only talks to it through process boundaries (manage.py, Celery, OpenSSL subprocesses).
`dplay system reset` is scoped to development only — it stops local Celery processes and flushes the local Redis instance, not a production management mechanism.
TLS certificates are self-signed for local development and trusted into the macOS Keychain automatically; production TLS is out of scope.

One command to start.

One interface to manage the environment.

One predictable development workflow · Less environment management, more engineering.

Install djangoplay-cli View Source