Skip to main content

Run plug-able Django apps without a settings module

Project description

Django-mini is an MIT-licensed command-line utility for running Django management commands without a settings module. It is intended to help developers run and test stand-alone Django apps.

Installation

Install using pip from PyPI:

pip install django-mini

Alternatively, download the source, unpack it and install it like a typical Python distribution:

python setup.py install

The installation consists of a single pure-Python module called djangomini and an executable script django-mini.py. Django-mini assumes a recent version of Django is already installed.

Basic Usage

Django-mini has a few flags for configuring Django settings, and then any other arguments are passed to Django’s management utility so it can do its stuff.

  • --database <database> - to specify the default database.
  • --app <appname> - adds your app package to Django’s INSTALLED_APPS.
  • --admin - adds Django’s built-in admin and its requirements.
  • --debug-toolbar - adds Rob Hudson’s django-debug-toolbar and its requirements.
  • -p or --persisting - use an sqlite database named djangomini.sqlite.

If you don’t use the persisting option or specify a database, django-mini will use an in-memory sqlite database (implying it will get destroyed after the command finishes).

To run Django with your app and the built-in admin, use a named database:

django-mini.py --database /tmp/django.sqlite --admin --app myapp syncdb
django-mini.py --database /tmp/django.sqlite --admin --app myapp runserver

Or use the persisting option:

django-mini.py -p --admin syncdb
django-mini.py -p --admin runserver

That will start Django’s development server with the admin. The admin application will be available at http://localhost:8000/admin/ and all other requests will be directed to your app, i.e. your app’s myapp.urls is configured to serve all other requests.

The full documentation has more examples of use, including how to use other databases, how to change any setting, and how to mount an app at a particular URL.

Project details


Download files

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

Files for django-mini, version 0.5.1
Filename, size File type Python version Upload date Hashes
Filename, size django-mini-0.5.1.tar.gz (16.5 kB) File type Source Python version None Upload date Hashes View hashes

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