Django Extensions Shell

Django Extensions Shell is the shell_plus command extracted from the excellent Django Extensions project into its own project. In most projects I've been only using the shell_plus command and to me it feels much better to introduce a dependency on this specific code in projects then to depend on the whole Django Extensions project.

Django Extensions Shell will loosely follow releases done by the Django Extensions Project itself. The version number of Django Extensions Shell will always match the release of Django Extensions.

Requirements

Django Extensions Shell requires Django 1.8 or later.

Getting It

You can get Django Extensions by using pip or easy_install:

$ pip install django-extensions-shell
or
$ easy_install django-extensions-shell

If you want to install it from source, grab the git repository from GitHub and run setup.py:

$ git clone git://github.com/shanx/django-extensions-shell.git
$ cd django-extensions-shell
$ python setup.py install

Installing It

To enable django_extensions in your project you need to add it to INSTALLED_APPS in your projects settings.py file:

INSTALLED_APPS = (
    ...
    'django_extensions_shell',
    ...
)

Using It

Run the enhanced django shell:

$ python manage.py shell_plus

Documentation

You can view documentation online at:

• https://django-extensions-shell.readthedocs.io

Or you can look at the docs/ directory in the repository.