Metadata-Version: 2.4
Name: us-water-quality-data
Version: 2026.8.19
Summary: Versioned U.S. water-system evidence by ZIP, with explicit null semantics and model-versioned Home Safety Score fields
Author-email: Artem Akulov <artem@liraltd.com>
License-Expression: CC-BY-4.0
Project-URL: Homepage, https://zipcheckup.com
Project-URL: Repository, https://github.com/artakulov/us-water-quality-data
Project-URL: Issues, https://github.com/artakulov/us-water-quality-data/issues
Project-URL: Dataset, https://zipcheckup.com/data/
Project-URL: API, https://api.zipcheckup.com/v1/
Keywords: water-quality,epa,sdwis,zip-code,lead,copper,radon,violations,drinking-water,environmental-data,public-health,home-safety,usa,open-data
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# us-water-quality-data for Python

Versioned U.S. water-system evidence by ZIP for Python. Its bundled JSON is generated from the same open export as the JavaScript package and preserves measured zero, measured false, and unavailable evidence as different states.

```python
import us_water_quality_data as water

record = water.lookup("10001")
print(record)
print(water.meta["total_zips"])
```

The package provides `lookup`, `get_state`, `get_worst`, `get_best`, `states`, `count`, `zips`, and `search_city`. Read coverage counts, source vintage, and field definitions from `water.meta`; they vary by version.

The copper field is `copper_action_level_exceedance`, not a concentration. It is `True` only when an accepted CU90 exceedance record exists and `None` when unknown. Nullable violation, CCR, enforcement, lead, radon, score, and grade fields must not be converted to reassuring zeros or false values.

Home Safety Score fields follow the model version recorded by the source export and remain unavailable when required domain coverage is incomplete. The data is system-level and geographically joined evidence, not tap-level sampling, a property inspection, or a guarantee of safety.

License: CC BY 4.0. Full source and methodology details: [zipcheckup.com](https://zipcheckup.com).
