chtypes 0.3.0__tar.gz → 0.3.2__tar.gz

{chtypes-0.3.0 → chtypes-0.3.2}/CHANGELOG.md

@@ -4,6 +4,33 @@ All notable changes to the python binding. The format is [Keep a Changelog](http
 
 The four bindings in this repository are released together and give one answer, so an entry here has a counterpart in the other three.
 
+## [Unreleased]
+
+## [0.3.2] — 2026-09-28
+
+Speaks ABI revision 5, unchanged from 0.3.1: every artifact 0.3.1 loads, this release loads.
+
+### Added
+
+- **`ReleaseEntry.abi_revision`** (`int | None`): the row's `abi_revision`, `None` when the row declares none or declares something that is not an integer.
+
+### Changed
+
+- **Installs move to a per-revision directory, so the first fetch after upgrading downloads again.** The per-user cache `default_registry_dir()` is now `${XDG_CACHE_HOME:-~/.cache}/chtypes/artifacts/abi<R>/<os>-<arch>`, `<R>` this binding's own `ABI_REVISION`, where it was `…/chtypes/artifacts/<os>-<arch>`. Two SDK versions that speak different ABI revisions on one machine no longer overwrite each other's artifacts. Nothing is migrated: the old directory is simply no longer read, and can be deleted once nothing older uses it. `CHTYPES_REGISTRY` and an explicit directory are taken exactly as before.
+- **Fetch now selects only artifacts built at this binding's own ABI revision** (`docs/guides/fetch.md` §2). The release's rows are narrowed to those whose `abi_revision` is `ABI_REVISION` before the newest-version, highest-build rule applies; a row that declares no revision never matches. Nothing at that revision for the line and platform is `ArtifactUnpublishedError` (`CHTYPES_ARTIFACT_UNPUBLISHED`, exit 4), naming the revision(s) the release does serve — never a fallback to another revision's build, which the loader would refuse anyway. Across a revision cutover the grace this gives an older binding is temporary: an older-revision build stays fetchable only until that line's next publish evicts it under retention, which keeps two builds per version.
+- **`fetch_lines(..., all_lines=True)` and `python -m chtypes fetch --all` no longer skip a line silently.** A line the release has for the platform only at another ABI revision, or only in rows that record none (built before revisions were recorded), is not installed, and one loud warning line (through `progress` when one is given, else on stderr) names the line, the platform, what the release does serve and this binding's revision; every other line still installs, and the exit status stays 0 when they all do.
+- **`list` shows only the release's rows at this binding's ABI revision** — what a fetch could install — and, when that hides any of the platform's rows, adds one line naming them: `<N> row(s) at ABI revision(s) <S> not shown; this SDK speaks <R>`, or, for rows that record none, `<M> row(s) that record no ABI revision (built before revisions were recorded) not shown; this SDK speaks <R>`. Nothing is added when nothing was hidden.
+- **On darwin-arm64, fetching line 24.8 now fails at fetch time** with `CHTYPES_ARTIFACT_UNPUBLISHED` (exit 4) instead of installing an artifact the loader then refuses: the release's only 24.8 rows for that platform record no ABI revision, because they were built before revisions were recorded, and the message says exactly that rather than that the release serves none.
+- `Release.offered()` now returns only rows at this binding's ABI revision, and `Release.select()` considers only those.
+
+## [0.3.1] — 2026-09-26
+
+Speaks ABI revision 5, unchanged from 0.3.0: every artifact 0.3.0 loads, this release loads.
+
+### Changed
+
+- **The publish-window retry (`docs/guides/fetch.md` §3a) now also covers a release-level file whose hash disagrees with its `SHA256SUMS` row** — `sdk-goldens.json`, checked after the requested artifact has already installed, since it is best-effort and never blocks that install — and the retry budget widened from 3 attempts ~10s apart to 5 attempts with delays doubling from 4s (4/8/16/32s, ~60s of sleep, ~70s of wall time with network latency). The artifacts host's edge cache can hold a stale pairing of `SHA256SUMS`, its signature, `index.json` or `sdk-goldens.json` for up to its measured 60-second `Cache-Control: max-age`, wider than the original ~10s budget covered. Every retry now re-reads the WHOLE consistent set fresh — never one freshly re-fetched object checked against another attempt's stale one. A release-level file mismatch that never heals still leaves the golden tests skipping loudly, exactly as before, and never fails the fetch that asked for the artifact (issue #223).
+
 ## [0.3.0] — 2026-09-22
 
 ### Added

{chtypes-0.3.0 → chtypes-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: chtypes
-Version: 0.3.0
+Version: 0.3.2
 Summary: Python binding for the chtypes artifacts: ClickHouse's own type system, per version, behind the frozen chs_* C ABI
 Project-URL: Homepage, https://github.com/wave-rf/chtypes
 Project-URL: Repository, https://github.com/wave-rf/chtypes
@@ -31,7 +31,7 @@ uv add chtypes            # or: pip install chtypes
 python -m chtypes fetch 25.8
 ```
 
-The fetch lands in `~/.cache/chtypes/artifacts/<os>-<arch>/25.8/` — the per-user cache every chtypes binding reads by default — after checking an ed25519 signature over the release and the sha256 of every byte. `$CHTYPES_REGISTRY` overrides it. The ed25519 verifier is pure stdlib too.
+The fetch lands in `~/.cache/chtypes/artifacts/abi<R>/<os>-<arch>/25.8/` — the per-user cache every chtypes binding reads by default, `<R>` the ABI revision this SDK speaks (fetch installs only artifacts built at it) — after checking an ed25519 signature over the release and the sha256 of every byte. `$CHTYPES_REGISTRY` overrides it. The ed25519 verifier is pure stdlib too.
 
 ## Quickstart
 

{chtypes-0.3.0 → chtypes-0.3.2}/README.md

@@ -13,7 +13,7 @@ uv add chtypes            # or: pip install chtypes
 python -m chtypes fetch 25.8
 ```
 
-The fetch lands in `~/.cache/chtypes/artifacts/<os>-<arch>/25.8/` — the per-user cache every chtypes binding reads by default — after checking an ed25519 signature over the release and the sha256 of every byte. `$CHTYPES_REGISTRY` overrides it. The ed25519 verifier is pure stdlib too.
+The fetch lands in `~/.cache/chtypes/artifacts/abi<R>/<os>-<arch>/25.8/` — the per-user cache every chtypes binding reads by default, `<R>` the ABI revision this SDK speaks (fetch installs only artifacts built at it) — after checking an ed25519 signature over the release and the sha256 of every byte. `$CHTYPES_REGISTRY` overrides it. The ed25519 verifier is pure stdlib too.
 
 ## Quickstart
 

{chtypes-0.3.0 → chtypes-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "chtypes"
-version = "0.3.0"
+version = "0.3.2"
 description = "Python binding for the chtypes artifacts: ClickHouse's own type system, per version, behind the frozen chs_* C ABI"
 readme = "README.md"
 license = "Apache-2.0"

{chtypes-0.3.0 → chtypes-0.3.2}/src/chtypes/__main__.py

@@ -196,7 +196,14 @@ def _cmd_verify(args: argparse.Namespace) -> int:
 
 
 def _cmd_list(args: argparse.Namespace) -> int:
-    from .fetch import Fetcher, fetch_destination, host_platform, installed_lines
+    from .fetch import (
+        Fetcher,
+        _fetch_abi_revision,
+        _not_shown,
+        fetch_destination,
+        host_platform,
+        installed_lines,
+    )
 
     platform = args.platform or host_platform()
     registry = fetch_destination(args.dest, platform=platform)
@@ -221,6 +228,11 @@ def _cmd_list(args: argparse.Namespace) -> int:
             f"  {entry.minor:<8} {entry.clickhouse_version:<18} b{entry.build_number:<3} "
             f"{entry.file}  [{state}]\n"
         )
+    # Only this SDK's own ABI revision is offered (docs/guides/fetch.md §2), and
+    # one line names what that hid.
+    note = _not_shown([e for e in release.entries if e.platform == platform], _fetch_abi_revision())
+    if note is not None:
+        sys.stdout.write(f"  {note}\n")
     sys.stdout.flush()
     return EXIT_OK
 

{chtypes-0.3.0 → chtypes-0.3.2}/src/chtypes/_manifest.py

@@ -15,6 +15,7 @@ import platform as _platform
 from dataclasses import dataclass, fields
 from pathlib import Path
 
+from ._native import ABI_REVISION
 from .errors import RegistryError
 
 __all__ = [
@@ -38,11 +39,15 @@ def host_platform() -> str:
 
 def cache_registry_dir(platform: str | None = None) -> str:
     """The per-user artifact cache for a platform — ``${XDG_CACHE_HOME:-~/.cache}/
-    chtypes/artifacts/<os>-<arch>``, this host's by default. Where fetch installs,
-    where a core-repository build lands, and slot 3 of the registry search path
-    (docs/guides/fetch.md §1). A path, not a promise: it need not exist yet."""
+    chtypes/artifacts/abi<R>/<os>-<arch>``, R this binding's `ABI_REVISION`, this
+    host's platform by default. Where fetch installs, and slot 3 of the registry
+    search path (docs/guides/fetch.md §1); keyed by revision so two SDK versions
+    at different revisions never share it. A path, not a promise: it need not
+    exist yet."""
     base = os.environ.get("XDG_CACHE_HOME") or os.path.join(os.path.expanduser("~"), ".cache")
-    return os.path.join(base, "chtypes", "artifacts", platform or host_platform())
+    return os.path.join(
+        base, "chtypes", "artifacts", f"abi{ABI_REVISION}", platform or host_platform()
+    )
 
 
 @dataclass(frozen=True, slots=True)