This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Python wrapper for Azavea's Cicero API

Project Description

Python-Cicero provides a Pythonic “wrapper” to Azavea’s Cicero API for address-based legislative and non-legislative district matching, lookup of elected official contact information, and election events.

Note: Be sure to take a look at the project page on Github.

Installation / Setup

Use pip to install the library:

pip install python-cicero

If you anticipate making improvements/extensions and would like to document them, use the extras_require convention to also install the Pycco documentation generator as a dependency (see Documentation section below):

pip install python-cicero[‘docs’]

To make requests to the Cicero API, you will need a Cicero account. A free trial of the API is available by registering here. The process for purchasing additional API credits is described on the Cicero website.

Testing

There are a few ways to run the unit tests.

One option is to use the shell script in the root of the repository called test.example.sh. Copy it using cp test.example.sh test.sh. Edit test.sh to include your Cicero API username and password. Then, run the tests using ./test.sh.

Another option is to edit the test/tests.py file directly, adding your Cicero API credentials where indicated. Doing so will allow you to execute tests using nosetests (if you have the nose package installed), or using python setup.py test, or invoking the tests.py file itself.

Documentation

Documentation, generated with Pycco, is available in the “docs” folder as HTML files. The filenames correspond to the appropriate module being documented.

For examples of the wrapper in use, see the cicero_examples.py file.

Help!

All of us at Azavea would be happy to help you get the most out of your Cicero API account. For questions about this wrapper, contact cicero@azavea.com

License

python-cicero is licensed under the Apache 2.0 license. See LICENSE.txt for more details.

Contribute

See a bug? Want to improve the docs or provide more examples? Thank you! Please open a pull-request with your improvements and we’ll work to respond to it in a timely manner.

Release History

Release History

This version
History Node

0.1.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
python-cicero-0.1.0.tar.gz (304.1 kB) Copy SHA256 Checksum SHA256 Source Jan 22, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting