Skip to main content

dathren

Public health data, cleaned up and documented.

dathren fetches datasets from agencies like the CDC and returns them in one consistent shape, with the quirks marked instead of hidden: suppressed cells, provisional counts, and adjusted values all come through as explicit fields.

pip install dathren            # or: pip install 'dathren[pandas]'
import dathren

for d in dathren.datasets():
    print(d["id"], "-", d["title"])

rows = dathren.fetch("cdc-vsrr-overdose", geo="US", measure="synthetic_opioids", since=2024)
rows[-1]
# {'dataset': 'cdc-vsrr-overdose', 'measure': 'synthetic_opioids', 'geo': 'US',
#  'geo_name': 'United States', 'period': '2026-05', 'value': 33959.0,
#  'adjusted_value': 34507.0, 'flags': ['provisional', 'underreported'], ...}

df = dathren.fetch_df("brfss-mental-health", measure="mental_distress")

Read each dataset's caveats before drawing conclusions:

for c in dathren.info("cdc-places-county")["caveats"]:
    print(c["title"], "-", c["detail"])

Data is fetched live from the publisher on every call. Browse datasets, charts, and caveats at dathren.debugr.net.

Metadata

Release files for dathren 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dathren 0.1.1
File Size Uploaded Provenance
dathren-0.1.1.tar.gz 30.4 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for dathren 0.1.1
File
dathren-0.1.1-cp39-abi3-win_amd64.whl CPython 3.9 abi3 Windows x86-64 Details
dathren-0.1.1-cp39-abi3-manylinux_2_28_aarch64.whl CPython 3.9 abi3 Linux glibc 2.28+ ARM64 Details
dathren-0.1.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.9 abi3 Linux glibc 2.17+ x86-64 Details
dathren-0.1.1-cp39-abi3-macosx_11_0_arm64.whl CPython 3.9 abi3 macOS 11.0+ ARM64 Details
dathren-0.1.1-cp39-abi3-macosx_10_12_x86_64.whl CPython 3.9 abi3 macOS 10.12+ x86-64 Details

Total release size: 9.9 MB

Release files / dathren-0.1.1.tar.gz

Download URL dathren-0.1.1.tar.gz
Size 30.4 kB
Tags Source
SHA-256 checksum
How to use checksums
a42c07d5ef6409baf020019b87251c9986b5c642a4fe7f645d2d9068eb312441
BLAKE2b-256 checksum
How to use checksums
3a074dc0c93f42255bbcd805b003806bdf72f9d4e07dc627b6a3666bab12be26
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / dathren-0.1.1-cp39-abi3-win_amd64.whl

Download URL dathren-0.1.1-cp39-abi3-win_amd64.whl
Size 1.8 MB
Tags CPython 3.9 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
825bff9574dd4b6def416e00740e5f2dc4456e822c689422e04d4e3c392c0c0d
BLAKE2b-256 checksum
How to use checksums
2551dcbf7eb5a71b41d707c662d80ba57c8db6f2f27e86f347c7c7624c6de8a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / dathren-0.1.1-cp39-abi3-manylinux_2_28_aarch64.whl

Download URL dathren-0.1.1-cp39-abi3-manylinux_2_28_aarch64.whl
Size 2.1 MB
Tags CPython 3.9 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
380b6ab588bb1b88776134495e816b23312521c6c2ae1e5c86cd7a701adc20a1
BLAKE2b-256 checksum
How to use checksums
14bb84fae65dac12dd9f8532f4e0d7aa559257a33a61a2baf0802c70fcddc2be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / dathren-0.1.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL dathren-0.1.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 2.1 MB
Tags CPython 3.9 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
7879109d289f1352430eef12f148ec3410342758dcf1c2ecbdde2c99895168e3
BLAKE2b-256 checksum
How to use checksums
93acf4be6ec156a22fbb3c261ab13d4bbd792504aae2aa695ed89f9a0fe25ecb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / dathren-0.1.1-cp39-abi3-macosx_11_0_arm64.whl

Download URL dathren-0.1.1-cp39-abi3-macosx_11_0_arm64.whl
Size 1.9 MB
Tags CPython 3.9 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
aae071de5b97ba4427ed47a6b4a1e143630a22ee384343a8b1a587b24dd95ec8
BLAKE2b-256 checksum
How to use checksums
34609e528589084f95f8785b496967d71b6b7e22c3f38f68b203e6f354d85c48
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Release files / dathren-0.1.1-cp39-abi3-macosx_10_12_x86_64.whl

Download URL dathren-0.1.1-cp39-abi3-macosx_10_12_x86_64.whl
Size 1.9 MB
Tags CPython 3.9 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
6930bb4bb7196690452d20e63a98b3e7d537d752b205b77dbb2c7bd4f1b56db6
BLAKE2b-256 checksum
How to use checksums
19d8500972528ab474572c2894394e54615a93dad8c6e4b8a1f314632e1dcf40
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

Security for dathren 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for dathren-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 25, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

6 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page