Feature/base harvester

[slawler]

v0.1.0 Release

Base Harvester class and implementations added.

Overview

This PR brings cosecha to v0.1.0 with support for gridded and time-series data harvesting, including NetCDF output, Apache Iceberg catalogs, and USGS data retrieval.

Key Features

Data Input Support

• NWIS Reaper: Hydrological observations from USGS NWIS API
• NWP Reaper: Numerical weather prediction data (HRRR, GFS, etc.) via herbie-data
• MRMS Reaper: Multi-Radar/Multi-Sensor System (MRMS) analysis data.
• Extensible base classes for custom reapers

Data Output Support

• sow_to_netcdf: Write gridded data to NetCDF format using h5netcdf (pure Python, no system dependencies)
• sow_to_iceberg: Write time-series data to Apache Iceberg tables with local file-based catalogs and ACID support
• sow_to_zarr: Gridded data in Zarr format with chunking and compression
• sow_to_parquet: Time-series data in Parquet format
• sow_to_icechunk: Gridded data in IceChunk format

Dependencies

• Using h5py>=3.0 to netcdf feature (required HDF5 backend for h5netcdf)
• Using herbie-data>=2026.3.0 for NWP data access (fixed package naming issue)
• Using sqlalchemy>=2.0.47,<3 for Iceberg local catalog support

Testing

• Added 61 tests
• All pre-commit checks passing

Notes

This is the first major release. No migration needed for new users.

Closes

• Fixes #N/A (initial release)

[cheginit]

Here's a brief summary of changes that I made:

Design & API consistency

• Standardized time parameters: public APIs accept str only, parsed via pd.to_datetime() at __init__, pd.Timestamp internally.
• Added _ensure_data() to ReaperBase with @overload return types, eliminating duplicated guard clauses across 5 sow_to_* methods.
• Unified exception hierarchy: no raw ValueError escapes reaper code — all mapped to ReaperError, DateRangeError, or APIError.
• Shared to_180() utility replaces herbie accessor and MRMS private method; handles 1D and 2D grids.
• Used load_catalog as context manager in sow_to_iceberg to prevent SQLite connection leaks.
• Aligned __init__.py exports; deleted dead data_models.py module.

Logging

• Replaced Rich-based logging with plain logging.StreamHandler; dropped rich dependency.

Type checking

• 0 pyright strict-mode errors (down from 7). _ensure_data() and to_180() use @overload for type narrowing without assert or cast.

Testing

• Coverage: 47% → 96% (128 tests: 125 non-network + 3 network).
• New test files for utils, logging, and base reaper classes. Extended all three reaper test files.
• Added @pytest.mark.network integration tests for NWIS, NWP (HRRR), and MRMS (S3).
• Fixed stale coverage data caused by --cov-append; cleaned up warning filters.

CI

• Full matrix (3 OS × 2 Python) runs non-network tests; network tests run once on ubuntu-latest / py314.

Documentation

• Added a new example for Hurricane Beryl, TX.
• Fixed missing/incorrect docstring parameters and types. Removed 22 trivial comments; verified all markdown and docs are up to date.