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.


Install using pip from PyPI:

pip install django-mini

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

python install

The installation consists of a single pure-Python module called djangomini and an executable script 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: --database /tmp/django.sqlite --admin --app myapp syncdb --database /tmp/django.sqlite --admin --app myapp runserver

Or use the persisting option: -p --admin syncdb -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.

Source Distribution

django-mini-0.5.1.tar.gz (16.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page