eolas-data 1.3.21__tar.gz → 1.4.0__tar.gz

{eolas_data-1.3.21 → eolas_data-1.4.0}/.github/workflows/publish.yml

@@ -49,6 +49,23 @@ jobs:
           pip install "$WHL"
           pip install pytest responses geopandas shapely pandas pyarrow typer rich keyring
 
+      - name: Version self-report parity (REL-1)
+        env:
+          TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          expected="${TAG#v}"
+          # __version__ is read from installed distribution metadata, so this
+          # asserts the wheel the user pip-installs self-reports the tag — the
+          # exact drift (shipped 1.3.21 said 1.3.20) that this gate structurally
+          # closes. Run from /tmp so the source tree's __init__ can't shadow.
+          reported=$(cd /tmp && python -c "import eolas_data; print(eolas_data.__version__)")
+          echo "Tag: $expected | __version__: $reported"
+          if [ "$reported" != "$expected" ]; then
+            echo "::error::Installed eolas_data.__version__ ($reported) != tag ($expected)"
+            exit 1
+          fi
+
       - name: Client contract matrix
         run: python scripts/check_client_contract.py
 

eolas_data-1.4.0/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to `eolas-data` are recorded here. This project follows
+[Semantic Versioning](https://semver.org/).
+
+## 1.4.0
+
+### Added
+
+- **`Client.preview(name)`** — up to 10 sample rows via the unauthenticated
+  `/preview` endpoint. No API key required, no rate-limit cost, geometry hidden.
+  `eolas datasets preview` now uses it instead of burning an authenticated,
+  rate-limited `/data` call (DRIFT-5).
+- **`dimensions=` filter on `get()`** and `eolas get --dimensions` — a
+  case-insensitive substring filter on dimension columns, applied server-side on
+  the live `/data` path (the filter was live in prod but exposed by no client;
+  DRIFT-4).
+
+## 1.3.22
+
+Network-hardening + correctness release, addressing findings from the
+2026-07-05 client-library audit.
+
+### Fixed
+
+- **Request timeouts everywhere (EH-1).** Every HTTP call now carries a default
+  `(10, 300)` second (connect, read) timeout via a session subclass. A
+  black-holed connection raises instead of hanging the caller forever. Override
+  with `Client(timeout=...)`.
+- **Clean errors on transport failures (EH-2).** Connection refused / DNS /
+  timeout / reset now surface as `EolasError("Network error talking to
+  api.eolas.fyi: ...")` instead of a raw urllib3 traceback. The CLI's existing
+  error handler renders them cleanly.
+- **Atomic downloads (EH-5).** `download()` / `download_bulk()` write to a temp
+  file and atomically rename on success, and verify bytes received against
+  `Content-Length`. An interrupted or truncated download now leaves **no file**
+  at the final path instead of a silent partial.
+- **`get()` no longer degrades a bulk failure to a misleading 413 (EH-3).** The
+  auto-route swallow is narrowed to the routing decision; a real failure in the
+  bulk path now propagates instead of falling through to "use bulk download".
+- **Arrow negotiation no longer masks real errors (EH-7).** An auth/404/429
+  during the Arrow attempt now propagates immediately, without the bogus "Arrow
+  IPC unavailable" nag and without re-sending the failed request as JSON. Only a
+  non-Arrow 200 or a genuine pyarrow/IPC decode error downgrades the session.
+- **Watermark floor parsed correctly (DRIFT-2).** The HTTP 410 re-baseline
+  response nests its fields under `detail`; `WatermarkExpired.min_available_seq`
+  was always 0. Now read from the correct level with a top-level fallback.
+- **No more pandas-3 warning on every `get()` (PY-3).** Metadata accessors are
+  set via `object.__setattr__`, bypassing the pandas 3 `UserWarning`.
+- **Orphaned partial downloads are swept (PY-5).** `*.eolas-tmp-*` files >24h
+  old are cleaned on download start; a full `cache_clear()` removes them all.
+- **`download()` docstring corrected (PY-1).** It no longer claims to work for
+  "all datasets" — it is the live path and 413s on whole-dataset pulls of
+  large/geo tables; use `get()` or `download_bulk()` there.
+- **`eolas datasets list` no longer renders a blank ghost column (CLI-1).** On
+  narrow (<100 col) terminals the title column is dropped with a hint instead of
+  being squeezed to zero width.
+- **Bulk-download docs corrected (DRIFT-3).** `download_bulk()` / the CLI
+  `--freshness` help no longer claim Free plans get monthly bulk — bulk is
+  Pro/Enterprise and Free keys receive HTTP 402.
+
+### Changed
+
+- **Single-sourced version (REL-1).** `__version__` is read from installed
+  distribution metadata, so it can never drift from `pyproject.toml` again
+  (shipped 1.3.21 previously self-reported 1.3.20). The publish workflow asserts
+  the installed `__version__` equals the release tag.
+- **`merge_changes` is now a public export (DRIFT-6)** — added to `__all__`.

{eolas_data-1.3.21 → eolas_data-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eolas-data
-Version: 1.3.21
+Version: 1.4.0
 Summary: Python client for the eolas.fyi statistical data API (NZ + OECD; Australia on roadmap)
 Project-URL: Homepage, https://eolas.fyi
 Project-URL: Documentation, https://docs.eolas.fyi/
@@ -32,6 +32,7 @@ Requires-Dist: rich>=13; extra == 'cli'
 Requires-Dist: typer>=0.12; extra == 'cli'
 Provides-Extra: dev
 Requires-Dist: geopandas>=0.14; extra == 'dev'
+Requires-Dist: mcp>=1.0; extra == 'dev'
 Requires-Dist: pandas; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: responses; extra == 'dev'
@@ -41,6 +42,8 @@ Requires-Dist: typer>=0.12; extra == 'dev'
 Provides-Extra: geo
 Requires-Dist: geopandas>=0.14; extra == 'geo'
 Requires-Dist: shapely>=2.0; extra == 'geo'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0; extra == 'mcp'
 Provides-Extra: polars
 Requires-Dist: polars>=0.20; extra == 'polars'
 Provides-Extra: secure

{eolas_data-1.3.21 → eolas_data-1.4.0}/eolas_data/__init__.py

@@ -1,4 +1,8 @@
 """eolas-data — Python client for the eolas.fyi statistical data API."""
+
+from importlib.metadata import PackageNotFoundError, version as _pkg_version
+
+from .cdc import merge_changes
 from .client import Client, SyncResult
 from .dataset import Dataset
 from .exceptions import (
@@ -15,12 +19,20 @@ from .exceptions import (
     WatermarkExpired,
 )
 
-__version__ = "1.3.20"
+# Single source of truth: read the installed distribution's version so
+# __version__, `eolas version`, and the User-Agent can never drift from
+# pyproject again (REL-1). Falls back to the pyproject value only for an
+# editable tree that was never `pip install`-ed.
+try:
+    __version__ = _pkg_version("eolas-data")
+except PackageNotFoundError:  # pragma: no cover - uninstalled source checkout
+    __version__ = "1.4.0"
 
 __all__ = [
     "Client",
     "Dataset",
     "SyncResult",
+    "merge_changes",
     "EolasError",
     "AuthenticationError",
     "RateLimitError",