Python Other
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE Mar 3, 2017
manual_data/districts fix #1159 Feb 4, 2017
openstates AZ: strip district Aug 18, 2017
scripts conversion scripts aren't needed Jun 2, 2017
.gitignore Adding pycharm files to .gitignore Jul 5, 2017
.travis.yml Merge remote-tracking branch 'upstream/master' into pupa-mn Mar 14, 2017 Update Mar 12, 2017
Dockerfile try to fix failing billy venv Jul 21, 2017
README.rst allow running billy & pupa scrapers side by side w/ same docker-compose Feb 20, 2017
docker-compose.yml docker-compose fix Jun 4, 2017 import all states Jul 17, 2017
requirements.txt NH: old db is gone, drop requirement for mssql Jun 8, 2017
setup.cfg flake8 everything Jun 2, 2017 bump setup Feb 22, 2017


The Open States Project collects and makes available data about state legislative activities, including bill summaries, votes, sponsorships and state legislator information. This data is gathered directly from the states and made available in a common format for interested developers, through a JSON API and data dumps.


Getting Started

We use Docker to provide a reproducible development environment. Make sure you have Docker installed. Inside of the directory you cloned this project into:

docker-compose run openstates <abbreviated state code>  # Scrapes the state indicated by the code e.g. "ny"

This project runs on top of billy, a scraping framework for government data. Our Docker container runs the billy-update command (billy-update docs) with whatever arguments you put at the end of docker run. For example, you can limit the scrape to Tennessee's (tn) state senators using:

docker-compose run openstates tn --upper --legislators

Check out the writing scrapers guide to understand how the scrapers work & how to contribute.


To run all tests:

docker-compose run --entrypoint=nosetests openstates /srv/openstates-web/openstates

Note that Illinois (il) is the only state with tests right now.