Releases: ErickShepherd/noaa-gml-file-reader
Releases · ErickShepherd/noaa-gml-file-reader
Release list
noaa-gml-file-reader 2.0.4
Adds distribution-validation tooling; CI and publish workflow hardening.
noaa-gml-file-reader 2.0.3
Documentation site + metadata polish — no code changes. Sphinx docs hosted on Read the Docs (shipped in-tag, fixing the tag-based "stable" build), Documentation URL in the PyPI project links, absolute README links, and the shields.io DOI badge.
Full details: CHANGELOG.md
v2.0.2
Citation metadata only — no code changes.
- Added
.zenodo.jsonand an author ORCID inCITATION.cff, so this release is archived on Zenodo with a citable DOI and correct software metadata.
v2.0.1
Docs & packaging release — no code changes.
- New "Problems this solves" section in the README mapping common queries (reading NOAA GML CO₂/CH₄ files, loading Mauna Loa flask data into pandas) to
read_data - Corrected the PyPI install note and narrowed the in-situ dialect table to the surveyed
(hourly)product - Expanded keywords; added Source and Bug Tracker project URLs
See CHANGELOG.md for details.
v2.0.0
[2.0.0] — 2026-07-08
Modernization release. Breaking — the package is renamed and unparseable
input now raises instead of returning an empty DataFrame.
Changed
- Renamed the package: import
noaa_esrl_gmd_file_reader→
noaa_gml_file_reader, distributionnoaa-gml-file-reader. NOAA renamed
ESRL's Global Monitoring Division (GMD) to the Global Monitoring Laboratory
(GML) in 2020. read_datanow auto-detects the header dialect and parses both the legacy
# number_of_header_lines:format and the current# header_lines :format,
extracting column names correctly for each.- Documented missing-value sentinels (
-999.99,-999.999,nan) are mapped to
NaNso numeric columns parse numeric. - Relicensed AGPL-3.0 → MIT.
- Modern packaging:
pyproject.toml(hatchling), package split into
_reader.py, full type hints, and updated docstrings.
Added
UnrecognizedFormatError(carries the file path and its first line), raised on
unrecognized, malformed, truncated, or empty input.- Offline pytest suite over committed fixtures and a GitHub Actions CI workflow
(ruff + pytest on Python 3.10–3.13 +python -m build+twine check).
Removed
- The silent empty-DataFrame return on parse failure (v1 behavior) — it made a
parse failure indistinguishable from an empty file, so v1 failed silently on
every current NOAA file.
Fixed
- Current (post-2020) NOAA GML files now parse instead of returning empty.
- The inconsistent GPL/AGPL wording in the v1 module docstring (removed; the
LICENSE file governs).