PHMSA Enforcement Case Metadata

Private, read-only Actor. Downloads the official PHMSA TSV snapshot once and emits typed case metadata. No Apify Console edits or publication.

Run

pip install -r requirements.txt then python main.py. Apify SDK reads INPUT and writes default dataset plus RUN_REPORT. Run offline tests with python -m unittest discover -s tests -v from this folder. Docker uses Apify Python 3.12.

Scope and correctness

Exact source: https://primis.phmsa.dot.gov/enforcement-documents/PHMSA%20Pipeline%20Enforcement%20Raw%20Data.txt . No arbitrary URLs, document downloads, personal contact fields, browser, proxies, retries or redirects. Standard urllib environment transport. Robots checked first; minimum 2 seconds or greater robots crawl delay, 25-second request timeout, 90-second request-launch/post-response budget (socket timeout is not a total deadline; a slow active response can overrun before the post-read check), 2 requests, 10 MB export, 250 KB robots, 20,000 parsed rows and 10,000 emitted cases maximum. Windows-1252 and proper quoted TSV parsing. Missing values remain null; raw date/amount strings retained. Case ID is stable; contentHash excludes observation time. Filter arrays use exact source values, operator uses name substring or exact ID, openedSince uses ISO date. Order follows official export; no sort or complete-history guarantee.

Notices, allegations, proposed penalties and final orders remain distinct. Records are not findings of liability or legal advice. Check the official current source before decisions. dataAsOfText is preserved verbatim because source time zone is unspecified.

Rights and demand

Attribution: U.S. DOT, PHMSA. Official Data.gov catalog https://catalog-old.data.gov/dataset/pipeline-enforcement-transparency-portal lists https://www.usa.gov/government-works . Only government-produced metadata, no operator submissions. Kondwit https://kondwit.com/ explicitly integrates PHMSA enforcement for pipeline professionals; https://noxara.ai/resources/regulatory-intelligence discusses PHMSA inspection/enforcement trends. These demonstrate professional consumption, not revenue or willingness-to-pay proof. Store searches on 2026-10-06 for PHMSA, phmsa.dot.gov and pipeline enforcement found no dedicated typed case-export Actor. Generic regulatory intelligence and web crawlers are alternatives; absence is a bounded search finding, not proof.

Evidence

Portable fixtures captured from official source 2026-10-06 are included in tests/fixtures, without absolute-path dependencies. Tests cover real 5,089-case export, quoted TSV, nulls, dates, amount parsing, limits, filters, robots and URL safety. verification contains actual local SDK live-run evidence; this is not an Apify-hosted production test.