Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

Provides a lightweight development runserver on Werkzeug with debugging

Project Description

# django-rundbg

Provides a lightweight development runserver on Werkzeug with a web-based debugger.

## Features
- Friendly for API debugging, like Django Rest Framework.
- Werkzeug [web-based debugger](

### :warning: Be very careful to keep this away from any production environment

## Installation and Configuration
From PyPI with pip

pip install django-rundbg

In your [development settings]( file add the following:
from yourproject.settings_general import INSTALLED_APPS

INSTALLED_APPS = INSTALLED_APPS + ['django_rundbg',]

DEBUG = True

## Quickstart
After installation and configuration, just run:
python rundbg --use-link

To try out, just place an `assert False` statement whenever you want to inspect your code and variables and this will show either at your
current browser window or in the dev console.

![Chrome Dev Console example](

## Invoking
After installation and configuration, just run:
python rundbg

Since it extends on Django's `runserver` you can pass on the same parameters than to `rundbg`:
python rundbg --no-reload

Additionally, it supports one additional parameter useful for debugging XHR requests:
python rundbg --use-link

This will show an very simple error 500 page, with a _link_ to the Werkzeug Traceback and web-based interactive debugger that you can open anywhere.

Additionally, it supports the following parameters from `runserver_plus`:
- `--reloader-interval 2` After how many seconds auto-reload should scan for updates in poller-mode.
- `--keep-meta-shutdown` Keep `request.META['werkzeug.server.shutdown']` function which is automatically removed because Django
debug pages tries to call the function and unintentionally shuts down the Werkzeug server.

Werkzeug security PIN is disabled.

## Credits

This project is strongly based upon the work of others:
- The [Django Extensions]( `runserver_plus` is a
more comprehensive command than this one.
- The [Werkzeug]( server.
- [Another take]( on the same challenge.

## Authors
- Juan Saavedra

With :heart: from Octobot

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(10.6 kB) Copy SHA256 Hash SHA256
Source Mar 30, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting