Skip to main content

Easily bundle example data with your django apps.

Project description

Easily bundle example data with your django apps.


$ pip install django_addexampledata


Add 'django_addexampledata' to INSTALLED_APPS.


django_addexampledata provides two Django management commands:

Finds all apps with an, and runs appname.exampledata.add_exampledata() on these apps. See the howto below for more info.

Create an example user. See --help for the User attributes that can be set. Example:

python createexampleuser grandma --is-superuser

creates a superuser named grandma with password set to test.

addexampledata howto

Add to the root of your Django app (in the same directory as Add an add_exampledata function to this module. Your may look something like this:

from models import Page

def add_exampledata():
    aboutus = Page.objects.create(title="About us",
                                  body="Hello cruel world")
    contactinfo = Page.objects.create(title="Contact info",
                                      body="Coming soon.",

As long as your Django app is in INSTALLED_APPS, <appname>.exampledata.add_exampledata is run each time you run:

python addexampledata

addexampledata on specific apps

You can specify the apps that you want to add example data for as arguments for the command. Example:

python addexampledata myapp myotherapp

addexampledata adds the same data each time it runs!

You can solve this in two ways:

  1. (reccommended) Add a make target or something similar (we use a Fabric action) to reset your example database and re-run addexampledata. Use this action whenever you change/add models or exampledata.
  2. Check for existing items in add_exampledata() before inserting new data.

Project details

Release history Release notifications

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.

Filename, size & hash SHA256 hash help File type Python version Upload date
django_addexampledata-1.0.tar.gz (3.0 kB) Copy SHA256 hash SHA256 Source None Apr 10, 2012

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