How to install collective.cicero
- Download and install ActivePython
- Open Command Prompt
pypm install collective.cicero
collective.cicero provides access to Azavea's Cicero API for performing geography-based lookups of political data. It is designed for integration with Plone, but can be used in other contexts as well.
Access to the API is provided via the call_cicero method:
call_cicero(service_name, method_name, *args, **kw)
service_name is one of the Cicero web services. Currently the only supported option is 'ElectedOfficialQueryService'.
method_name is one of the SOAP methods supported by the chosen service.
*args and **kw are the additional parameters required by the chosen method. See the Cicero API documentation for details.
The Cicero credentials (username and password) are looked up via a plone.registry-style IRegistry utility. In Plone, activating the plone.app.registry package followed by collective.cicero will set up a suitable registry with the relevant settings available.
A test mode is supported. In test mode, canned responses will be loaded from disk instead of actually querying Cicero.
Enable test mode by setting the CICERO_TEST environment variable. If this variable is present in the operating system environment, test mode will be used.
For test mode to work, the tests folder must contain a copy of the WSDL for the service being tested, as well as a response file for the method being tested. Responses can be obtained by running in normal mode with suds configured to log at the debug level. A sample response for the GetOfficialsByAddress method of the ElectedOfficialQueryService is included.
- Add a control panel for the Cicero settings, and make it validate the credentials when they are saved. [davisagli]
- Set the socket timeout to something more reasonable. [davisagli]
- Initial release