mjumbewu/django-councilmatic

:heartpulse: Django app providing core functions for *.councilmatic.org

django-councilmatic ===========

The django-councilmatic app provides the core functionality for the Councilmatic family, a set of web apps for keeping tabs on local city council. It is built upon the open civic data standard and ultimately makes Councilmatic easier to re-deploy in new cities.

django-councilmatic includes:

• data models for bills, people, organizations, events, and more
• a task to load data from the open civic data api
• views and templates for bill/person/organization/event pages, search, and more

The Councilmatic family includes:

• Philly Councilmatic (the original and first Councilmatic, by Mjumbe Poe, an important predecessor to DataMade's django-councilmatic)
• Chicago Councilmatic
• New York City Councilmatic
• Los Angeles Metro Board

Councilmatic in your city ----If you're interested in bringing Councilmatic to your city, contact us! We'd love to help.

Want to build your own Councilmatic? Check out our Starter Template. It contains everything you need to create your own Councilmatic from scratch.

Running tests ----Did you make changes to django-councilmatic? Before you make a pull request, run some tests. We test for style with flake8:

`bash flake8 ./councilmatic_core/*.py`

We test for functionality with a custom-made TestCase. Be sure to specify the owner of your psql databse in the export command:

`bash export db_user='yourusername' && python runtests.py`

Team

• Forest Gregg, DataMade - Open Civic Data (OCD) and Legistar scraping
• Cathy Deng, DataMade - data models and loading
• Derek Eder, DataMade - front end
• Eric van Zanten, DataMade - search and dev ops

Patches and Contributions -------------We continue to improve django-councilmatic, and we welcome your ideas! You can make suggestions in the form of github issues (bug reports, feature requests, general questions), or you can submit a code contribution via a pull request.

How to contribute code:

• Fork the project.
• Make your feature addition or bug fix.
• Bonus points for running tests to check python style (pip install flake8 and then flake8 .).
• Send us a pull request with a description of your work! Don't worry if it isn't perfect - think of a PR as a start of a conversation, rather than a finished product.

Copyright

Copyright (c) 2015 Participatory Politics Foundation and DataMade. Released under the MIT License.