Skip to main content

Enhances Django runserver with Werkzeug.

Project description

Django Werkzeug
===============

[![Current version on PyPI](http://img.shields.io/pypi/v/django-werkzeug.svg)][pypi]

Enhances Django `runserver` with [Werkzeug][].

This project uses [Django Extensions][] under the hood. It "wraps" it, along
with Werkzeug, so you don't have to add an explicit `werkzeug` dependency
to your `requirements.txt` or remember a new command.


Why
---

Werkzeug and its builtin error page has proven to be indispensable in a number
of Django projects. While Django Extensions is also a great tool, the full
extent of it is not always needed in specific projects.

Also, when committing to Werkzeug, it's convenient to run the `runserver`
instead of learning a new command. This brings newcomers to your team up to
speed without further instruction and doesn't require existing members to
change their muscle memory during their day-to-day.

If you want to use Werkzeug on certain projects, but don't want to keep track
of which ones, this package is for you.


Requirements
------------

Django Werkzeug requires Django 1.8 or later.


Installation
------------

```bash
$ pip install django-werkzeug
```

Then enable it by adding it to `INSTALLED_APPS` in your `settings.py` file:

```python
INSTALLED_APPS = [
'django_werkzeug',
...
]
```


Usage
-----

```bash
$ python manage.py runserver
```

Or to run Django's classic builtin server, run:

```bash
$ python manage.py runserver_classic
```


Contributing
------------

1. Check the open issues or open a new issue to start a discussion around
your feature idea or the bug you found
2. Fork the repository and make your changes
3. Create a new pull request


[pypi]: http://pypi.python.org/pypi/django-werkzeug/
[werkzeug]: https://github.com/pallets/werkzeug
[django extensions]: https://github.com/django-extensions/django-extensions

Project details


Release history Release notifications

This version
History Node

1.0.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django-werkzeug-1.0.0.zip (5.3 kB) Copy SHA256 hash SHA256 Source None Dec 7, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page