Welcome to the documentation for django-popolo!

This fork of django-popolo is the same as the upstream code except that the models use integer IDs rather than slugs, and the models have no slug field. This is to enable projects using this package to pick their own (perhaps different) slug behaviour.

django-popolo is a django-based implementation of the Popolo's open government data specifications.

It is developed as a django application to be deployed directly within django projects.

It will allow web developers using it to manage and store data according to Popolo's specifications.

The standard sql-oriented django ORM will be used.

Project is under way and any help is welcome.

To install django-popolo as a third party app within a Django project, you need to add it to the Django project's requirements.txt. You can do this from GitHub in the usual way, or using the mysociety-django-popolo package on PyPI.

You also need to add popolo and ajax_select to your django INSTALLED_APPS.

Set up the tests with:

pip install -r tests_requirements.txt python setup.py install

You can run the tests with:

python setup.py test

or:

python runtests.py