EPA Python API wrapper
======================
Python wrapper for the multiple APIs available through the EPA's
website.
Documentation for the APIs can be found here:
[http://www.epa.gov/enviro/facts/ef_restful.html](http://www.epa.gov/enviro/facts/ef_restful.html)
APIs
----
### RADInfo
>>> from epa.radinfo import RADInfo
>>> r = RADInfo()
>>> # An empty method returns a dict of available columns.
... r.facility_type()
>>> # A method call without a value returns info about that column.
... r.facility_type('cit_ref_code')
>>> # Find information on a facility in a certain city.
... r.facility('city_name', 'Berkeley')
{'data': {'about': "Berkeley's Radiation Facility"}}
>>> # Find all the radiation facilities in Texas.
... r.facility('state_code', 'TX')
{'all': {'seven': 'Texas facilities'}}
>>> # Integer values are converted to strings automatically.
... r.regulation('part_id', 61)
>>> r.regulation('title_id', '40')
>>> # Search for the CIT_REF_CODE of a RAD NPL facility.
... r.regulation('cit_ref_code', '40CFR300')
>>> data = r.regulatory_program('sec_cit_ref_flag', 'N')
>>> data['Count']
100
>>> new_data = r.regulatory_program('sec_cit_ref_code', 'N', count=200)
>>> new_data['Count']
190
>>> data = r.regulatory_program('cit_ref_code', '40CFR300', start=50)
>>> data['Count']
8
>>> # Find geographic information.
... r.geo('geometric_type_code', '001')
### GICS
>>> from epa.gics import GICS
>>> g = GICS()
>>> # List construction projects that are 91% complete.
... g.construction('complete_percent', 91)
>>> # Find all the construction projects at a specific facility.
... data = g.construction('facility_number', 190226001)
>>> data['Count']
8
>>> # Search for a specific grant's milestones.
... g.milestone('grant_number', 190709130)
>>> # Find all ADMIN COMPLETE milestones.
... g.milestone('milestone_type', 'ADMIN COMPLETE')
>>> # Search for milestones on a specific DD-MON-YY date.
... g.milestone('milestone_date', '16-MAR-01')
>>> # Find descriptions for a status code.
... g.status('status_code', 'AF')
>>> # Find grants on a specific date.
... g.grant('award_accept_date', '12-MAR-01')
>>> # Find grants for a specific city.
... g.grant('projecty_city_name', 'San Francisco')
>>> # Search the GICS API's grants for a specific state.
... g.grant('project_state_code', 'TX', count=500)
>>> # Find an applicant in a specific zipcode.
... g.applicant('zip_code', 94105)
### PCS
>>> from epa.pcs import PCS
>>> p = PCS()
>>> # Search for facilities in a city.
... p.facility('location_city', 'San Francisco')
>>> # Find a facility in a particular zipcode.
... p.facility('location_zip_code', 76108)
>>> # Find a sludge facility in a specific state.
... p.sludge('handler_state', 'NY')
>>> p.pipe_schedule('discharge_num', 333)
>>> p.pipe_schedule('npdes', 'GMG290024')
>>> p.dmr_measurement('discharge_num', '001')
>>> # Find the inspections that took place on a specific date.
... p.inspection('insp_date', '16-MAR-01')
>>> p.enforcement_action('ea_code', '09')
Copyright
---------
Copyright (c) 2011 Code for America Laboratories.
See LICENSE for details.
