chtypes 0.1.2__tar.gz → 0.2.1__tar.gz

chtypes-0.2.1/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog — `chtypes`
+
+All notable changes to the python binding. The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+The four bindings in this repository are released together and give one answer, so an entry here has a counterpart in the other three.
+
+## [0.2.1] — 2026-09-15
+
+Released in step with the Rust crate, which gains `Registry::open` and `Error::LibraryRead`; this binding's public API is unchanged.
+
+### Notes
+
+- Speaks **ABI revision 4**, unchanged since 0.1.0, so no artifact needs relinking. The golden set this release was tested against is the one core serves, generated on the ClickHouse lines 24.8, 25.3, 25.8, 25.10, 26.2, 26.3, 26.4, 26.5, 26.6, 26.7 and 26.8.
+- **The ABI-revision refusal is now run, not assumed.** This binding's suite points a registry at a generated artifact answering the wrong revision and asserts the load is refused naming both numbers, beside a matching-revision control that must load; CI fails the build if either case did not run (#36).
+
+## [0.2.0] — 2026-09-15
+
+### Changed — BREAKING
+
+- **The TypeScript filter verdicts are the wire characters.** `Verdict.True` / `False` / `Error` / `Decline` are now `'t'` / `'f'` / `'e'` / `'d'`, which Go, Python and Rust have always rendered. TypeScript alone spelled them `'true'` / `'false'` / `'error'` / `'decline'`, so two SDKs could not share a log line, a fixture or a test. The four states and the fail-closed rule are unchanged: `'e'` and `'d'` are NOT answers, and a caller enforcing visibility must hide the row or fail the request on both — collapsing either into `false` inverts fail-closed into fail-open, the measured leak class. Only the rendered characters moved. **The parity suites now ENFORCE the shared value in all four bindings**; until this release two of the four merely declared it.
+
+- **TypeScript `FetchError` now extends `ArtifactError` (and so `RegistryError`), where it previously extended `ChtypesError` directly.** A `try`/`catch` chain that tests `RegistryError` before `FetchError` now takes the `RegistryError` arm for the five fetch verdicts, which it did not before. Ordering a catch chain most-specific-first is unaffected.
+
+### Added
+
+- **Load-time checksum verification in Go and Rust**, matching what Python and TypeScript have always offered: re-hash the library against `manifest.json`'s `library_sha256` **before `dlopen`**, and refuse the load on a mismatch. Off by default in all four. Whether an artifact was re-hashed before being mapped used to depend on which binding a consumer picked, which is a security posture and not an API spelling. A manifest carrying no `library_sha256` is refused by Go, TypeScript and Rust — verification asked for and not possible is not verification — while Python's returns silently, which is what remains of issue #13's item A2.
+- **One catchable artifact error in TypeScript.** `ArtifactError` is a new exported base: all six artifact conditions now extend it, where `ArtifactMissingError` previously sat under `RegistryError` and the other five under `FetchError`, so a caller had to catch two unrelated types. Every existing `code` value and message is unchanged, and `ArtifactMissingError instanceof RegistryError` still holds.
+- **Eight constants that three bindings exported and the fourth did not**, so a caller no longer retypes a literal the other SDKs hand them: `Registry.SearchPath()` (go), `parse_signature_file` and `FETCH_COMMAND` (python), `RELEASE_KEY_ID` and `DEFAULT_LOCK_FILE` (ts), `fetch::LOCK_SCHEMA` (rust), and `CHTYPES_REGISTRY` / `CHTYPES_AUTOFETCH` as `EnvRegistry` / `EnvAutoFetch` (go) and `ENV_REGISTRY` / `ENV_AUTOFETCH` (ts). Each new name replaces the inline literal in its own binding's code path, so there is one definition rather than two.
+
+### Notes
+
+- Speaks **ABI revision 4**, unchanged since 0.1.0, so no artifact needs relinking. The golden set this release was tested against is the one core serves, generated on the ClickHouse lines 24.8, 25.3, 25.8, 25.10, 26.2, 26.3, 26.4, 26.5, 26.6, 26.7 and 26.8.
+- `Library` still has no scope-based release in Python or TypeScript, while `Registry`, `Schema`, `Filter` and `Block` do. That asymmetry is deliberate — a `with library:` or `using library` closes at the end of a block, which is the mid-lifecycle teardown measured to segfault on the next open — and it is now recorded in the parity manifest so no future audit reopens it as a gap.
+
+## [0.1.2] — 2026-09-11
+
+### Changed — BREAKING
+
+- **The transform reason for a materialized DEFAULT is now `default_materialized`** — previously the same word spelled with an `s` — and the exported constant naming it is now `Reason.DEFAULT_MATERIALIZED`. ClickHouse's own keyword is `MATERIALIZED`; its parser rejects the `s` spelling outright with a syntax error, so the reason naming that concept now matches the system it describes. Code comparing against the old string or the old constant name must be updated.
+- This is an SDK-only change and **the ABI is untouched: it remains revision 4, and no artifact needs relinking.** The reason is derived in the binding, not received from the artifact — the library emits `default_substituted`, which each binding translates. That wire value is unchanged.
+
+### Changed
+
+- **The per-language README is now an orientation page, not a manual.** It carries install, a quickstart that runs, the three outcomes and the error model, and then points at `docs/` for the rest — roughly 450 lines of reference prose moved to `docs/guides/` and `docs/reference/` rather than being repeated four times and drifting four ways.
+- **The published packages no longer cite a repository you cannot open.** 148 source comments — in every binding and in `include/chtypes.h`, all of which ship inside the crate, the sdist and the module — attributed the contract they implement to a private repository's specification. They now cite **the C ABI contract**, with `include/chtypes.h` as the public authority for it. Alongside those, 14 dead paths into that repository, the examples' instruction to build an artifact there, and two descriptions of the signing infrastructure are gone. What remains is every place where the two-repository split is itself the subject — describing it in prose is honest and stays legal; naming something a reader cannot open is not, and `scripts/lint-public.sh` is what enforces the difference. (An earlier draft of this entry enumerated three files. That count was never checked and was wrong by eighteen, which is the same mistake the entry above is about: the rule is checkable, a file list is not.)
+- `scripts/lint-public.sh` is new and blocking in CI, because the sweep this replaces reported itself complete while 148 of its targets survived in a different shape. It refuses both the private repository's name and that exact prose pointer, and its `--selftest` proves each rule fires rather than assuming it.
+
+## [0.1.1] — 2026-09-11
+
+- **The golden set is served, not tracked.** `goldens/cases.json` no longer exists in this repository. Core publishes `sdk-goldens.json` in the rolling release as a row in the signed `SHA256SUMS`; `scripts/fetch.sh` installs it at `<registry>/sdk-goldens.json` and the golden test reads it offline from there (`CHTYPES_GOLDENS` overrides). A case runs only against the exact ClickHouse version `generated.exact` names for its line and skips loudly otherwise, so the set shrinks as lines are added rather than recording an answer twice.
+- **Artifact identity gained a wrapper build.** Assets are `chtypes-<version>-<os>-<arch>-b<N>.tar.gz`, where `<N>` is the core commit's UNIX timestamp; an absent suffix means build 0 and stays valid. Line resolution ranks by `(version, build)`, so a rebuild of a line supersedes the older build.
+- Fetching now retries the publish window, so a fetch that races a release no longer fails on sums naming a file the host has not finished serving.
+- README install instructions name the published package rather than a path dependency.
+- Two errors in the published README, both found by running the snippets rather than reading them: Python's `substituted` is on `RowResult`, not `BatchResult`, and TypeScript's `using schema = …` is a syntax error on Node 22, this package's own `engines` floor (`schema.close()` is portable).
+- `docs/support.md` is new: which language versions, platforms and ClickHouse lines are supported, generated from the manifests and the release's own index.
+
+## [0.1.0] — 2026-09-10
+
+First release, published to PyPI from the tag `python/v0.1.0`.
+
+- Speaks **ABI revision 4** of the frozen `chs_*` C ABI (`include/chtypes.h`, 28 functions). The binding `dlopen`s a per-version artifact and reimplements no ClickHouse semantics; `Transformed` is the one derived result.
+- Verified against the public golden set (`goldens/cases.json`, schema 1, 31 cases), whose expectations were generated on ClickHouse 24.8, 25.3, 25.8, 25.10, 26.5, 26.6 and 26.7 — every case answered identically on all seven lines, and any case that did not was refused by the generator.
+- Pre-1.0: the artifact name `libchtypes`, the `chs_` prefix and the `enum chs_format` numbers are frozen. Function signatures freeze at this tag.

{chtypes-0.1.2 → chtypes-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: chtypes
-Version: 0.1.2
+Version: 0.2.1
 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

{chtypes-0.1.2 → chtypes-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "chtypes"
-version = "0.1.2"
+version = "0.2.1"
 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"
@@ -54,7 +54,7 @@ src = ["src", "tests"]
 # the classes that have actually cost time here — unused imports and names (F),
 # style errors that hide real ones (E), import order drift across 20 files (I),
 # syntax this project's floor already allows (UP), and the mutable-default /
-# loop-variable-capture family (B). `just lint` and ci/steps/static-checks.sh
-# both run this, so a finding is a gate failure, not advice.
+# loop-variable-capture family (B). `just lint` and the core repository's
+# static checks both run this, so a finding is a gate failure, not advice.
 [tool.ruff.lint]
 select = ["E", "F", "I", "UP", "B"]

{chtypes-0.1.2 → chtypes-0.2.1}/src/chtypes/__init__.py

@@ -64,6 +64,7 @@ from .errors import (
     CODE_ARTIFACT_UNTRUSTED,
     CODE_SOURCE_UNREACHABLE,
     CODE_UNSUPPORTED,
+    FETCH_COMMAND,
     ArtifactCorruptError,
     ArtifactError,
     ArtifactMissingError,
@@ -142,6 +143,7 @@ __all__ = [
     "DOC_VALUES",
     "ENV_AUTOFETCH",
     "ENV_REGISTRY",
+    "FETCH_COMMAND",
     "default_registry_dir",
     "EXPORT_NONE",
     "RELEASE_KEY_ID",

{chtypes-0.1.2 → chtypes-0.2.1}/src/chtypes/__main__.py

@@ -76,7 +76,9 @@ def build_parser() -> argparse.ArgumentParser:
     fetch = sub.add_parser(
         "fetch",
         help="install one or more ClickHouse lines, verified",
-        description="Install ClickHouse lines through the verification chain (docs/guides/fetch.md §3).",
+        description=(
+            "Install ClickHouse lines through the verification chain (docs/guides/fetch.md §3)."
+        ),
     )
     fetch.add_argument(
         "lines",

{chtypes-0.1.2 → chtypes-0.2.1}/src/chtypes/_manifest.py

@@ -111,7 +111,10 @@ def verify_library(version_dir: str | os.PathLike[str]) -> None:
     with path.open("rb") as handle:
         for chunk in iter(lambda: handle.read(1 << 20), b""):
             digest.update(chunk)
-    if digest.hexdigest() != manifest.library_sha256:
+    # Case-insensitive: a hex digest is the same digest in either case, and Go
+    # and Rust already lower-case before comparing. Comparing raw here made an
+    # uppercase manifest digest pass in two bindings and fail in two.
+    if digest.hexdigest() != manifest.library_sha256.lower():
         raise RegistryError(
             f"chtypes: {path} sha256 {digest.hexdigest()} != manifest {manifest.library_sha256}"
         )

{chtypes-0.1.2 → chtypes-0.2.1}/src/chtypes/_native.py

@@ -179,7 +179,8 @@ class _RWLock:
 
     **Readers** are every call that reaches `chs_row`, `chs_rows`,
     `chs_schema_compile`, `chs_schema_engine`, `chs_schema_ttl`,
-    `chs_validate_type` and the column accessors. The C ABI contract §Thread-safety declares those safe together **on distinct handles**, so
+    `chs_validate_type` and the column accessors. The C ABI contract
+    §Thread-safety declares those safe together **on distinct handles**, so
     per-handle serialization is `Schema`'s own lock and not this one.
 
     **The writer** is the pair that mutates per-library PROCESS state —

{chtypes-0.1.2 → chtypes-0.2.1}/src/chtypes/errors.py

@@ -14,6 +14,7 @@ __all__ = [
     "CODE_ARTIFACT_UNTRUSTED",
     "CODE_SOURCE_UNREACHABLE",
     "CODE_UNSUPPORTED",
+    "FETCH_COMMAND",
     "ArtifactCorruptError",
     "ArtifactError",
     "ArtifactMissingError",
@@ -70,6 +71,11 @@ CODE_ARTIFACT_PINNED: Final = "CHTYPES_ARTIFACT_PINNED"
 CODE_ARTIFACT_UNPUBLISHED: Final = "CHTYPES_ARTIFACT_UNPUBLISHED"
 CODE_SOURCE_UNREACHABLE: Final = "CHTYPES_SOURCE_UNREACHABLE"
 
+# This SDK's own fetch command, as the docs/guides/fetch.md §7 "Install it" message
+# spells it. The VALUE is deliberately per-language — it is the command a
+# caller of THIS SDK runs — go/ts/rust each carry their own equivalent.
+FETCH_COMMAND: Final = "python -m chtypes fetch"
+
 
 class ArtifactError(RegistryError):
     """An artifact is missing, could not be obtained, or failed verification.
@@ -123,7 +129,7 @@ class ArtifactMissingError(ArtifactError):
         super().__init__(
             f"chtypes: no artifact for ClickHouse {line} ({platform}). "
             f"Looked in: {', '.join(self.looked_in)}.\n"
-            f"Install it:  python -m chtypes fetch {line}\n"
+            f"Install it:  {FETCH_COMMAND} {line}\n"
             f"or set CHTYPES_AUTOFETCH=1 to fetch on first use."
         )
 

{chtypes-0.1.2 → chtypes-0.2.1}/src/chtypes/fetch.py

@@ -79,6 +79,7 @@ __all__ = [
     "fetch_lines",
     "fetch_destination",
     "installed_lines",
+    "parse_signature_file",
     "read_lock",
     "registry_search_path",
     "trusted_keys",
@@ -258,7 +259,7 @@ def key_id(raw_public_key: bytes) -> str:
     return hashlib.sha256(raw_public_key).hexdigest()[:16]
 
 
-def _parse_signature(sig: bytes) -> tuple[str, bytes]:
+def parse_signature_file(sig: bytes) -> tuple[str, bytes]:
     """``SHA256SUMS.sig`` -> (the comment line, the 64 signature bytes)."""
     comment = ""
     body: list[str] = []
@@ -285,7 +286,7 @@ def verify_sums_signature(sums: bytes, sig: bytes, keys: Sequence[bytes], source
     """Step 0 of the chain: the signature over the EXACT bytes of ``SHA256SUMS``
     with one of the trusted keys. Returns the id of the key that verified;
     raises `ArtifactUntrustedError` otherwise."""
-    comment, signature = _parse_signature(sig)
+    comment, signature = parse_signature_file(sig)
     for raw in keys:
         if _ed25519_verify(raw, sums, signature):
             return key_id(raw)

{chtypes-0.1.2 → chtypes-0.2.1}/src/chtypes/registry.py

@@ -370,8 +370,9 @@ class Schema:
         `BatchResult.rows` as `Outcome.SKIPPED`, carrying the server's own
         caught error verbatim (2026-08-27).
 
-        **The revision-3 export channel** (the C ABI contract §Rows;
-        docs/proposals/rows-export.md) — still ONE `chs_rows` call, never a
+        **The revision-3 export channel** (the C ABI contract §Rows, for
+        which `include/chtypes.h` is the public authority) — still ONE
+        `chs_rows` call, never a
         second, never re-parsing:
 
         `export` is None (no bytes — today's path, byte-identical documents)

{chtypes-0.1.2 → chtypes-0.2.1}/tests/conftest.py

@@ -2,7 +2,7 @@
 not run at all — it skips, loudly, by name. The fetch, CLI and pure-Python
 tests need none and always run; that is what this repository's CI proves on
 hosted runners, and the artifact-backed proof is the core repository's
-`certify` workflow against this same tree.
+server-truth suites against this same tree.
 
 The registry comes from the search path (docs/guides/fetch.md §1): `$CHTYPES_REGISTRY`,
 else the per-user artifact cache for this host (`chtypes.default_registry_dir()`:

chtypes-0.2.1/tests/test_abi_revision.py

@@ -0,0 +1,139 @@
+"""The ABI-revision handshake, run against a wrong-revision fixture (#36).
+
+`docs/reference/artifact.md` step 5 is normative: an artifact whose
+`chs_abi_revision()` answers a value that is neither 0 nor the revision this
+binding was written against MUST be refused, **naming both numbers**
+(`chtypes/_native.py`, `NativeLibrary.__init__`: "refusing to call through
+mismatched declarations"). This suite is the first thing in this repository
+that actually RUNS that rule instead of assuming it.
+
+The fixture is a pair of stub shared libraries generated from `include/chtypes.h`
+itself, by the served ABI-revision fixture generator (`abi-revision/gen.py`):
+one registry whose artifact answers `abi_revision + 1` (`wrong-revision/`), one
+answering `abi_revision`
+exactly (`at-revision/`), both on ClickHouse minor line "0.0". **Both halves
+matter** — without the `at-revision` control, a binding whose own
+`ABI_REVISION` had drifted would refuse everything and pass the refusal case
+for entirely the wrong reason.
+
+Every expected number comes from `fixture.json` — never from
+`chtypes.ABI_REVISION` — because a case that read the constant under test
+could not catch that constant being wrong.
+
+`isolated_search_path` (`tests/conftest.py`) is used to keep the per-user
+artifact cache and any ambient `$CHTYPES_REGISTRY`/system roots out of the
+search path: `Registry(root)` puts `root` first regardless, but this removes
+any chance that the fixture's odd "0.0" minor line is ever resolved from
+somewhere other than the fixture itself.
+
+Reopening a library after `close()` in the same process is measured to
+segfault (`docs/reference/bindings.md` §Teardown), so nothing here closes a
+loaded library: the refusal case never gets far enough to open one, the
+control case leaves its `Library` for process teardown (`chs_shutdown` runs
+via `atexit`), and neither path is ever loaded a second time.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import re
+from pathlib import Path
+from typing import Final
+
+import pytest
+
+import chtypes
+
+#: Where the fixture root lives. Built by the served abi-revision generator
+#: (`abi-revision/gen.py build`, core repo); this suite never builds one itself.
+ENV_ABI_FIXTURES: Final = "CHTYPES_ABI_FIXTURES"
+
+#: The one ClickHouse minor line every fixture artifact answers to.
+FIXTURE_MINOR: Final = "0.0"
+
+
+@pytest.fixture(scope="session")
+def abi_fixture() -> dict:
+    """Parse and validate `fixture.json`. Missing `$CHTYPES_ABI_FIXTURES` is a
+    SKIP (no fallback build); a fixture that exists but is malformed is a
+    FAILURE naming the path — a bad fixture must never read as "nothing to
+    test here"."""
+    env = os.environ.get(ENV_ABI_FIXTURES)
+    if not env:
+        pytest.skip(
+            f"no ABI revision fixture: ${ENV_ABI_FIXTURES} is unset (build one with "
+            "abi-revision/gen.py build --out DIR --header include/chtypes.h)"
+        )
+    root = Path(env)
+    fixture_path = root / "fixture.json"
+    try:
+        raw = fixture_path.read_text()
+    except OSError as exc:
+        pytest.fail(f"{fixture_path}: cannot read the ABI revision fixture: {exc}")
+    try:
+        doc = json.loads(raw)
+    except json.JSONDecodeError as exc:
+        pytest.fail(f"{fixture_path}: not valid JSON: {exc}")
+    abi_revision = doc.get("abi_revision")
+    valid = isinstance(abi_revision, int) and not isinstance(abi_revision, bool)
+    if not valid or abi_revision <= 0:
+        pytest.fail(
+            f"{fixture_path}: abi_revision must be a positive integer, got {abi_revision!r}"
+        )
+    mismatch_revision = doc.get("mismatch_revision")
+    if mismatch_revision != abi_revision + 1:
+        pytest.fail(
+            f"{fixture_path}: mismatch_revision is {mismatch_revision!r}, expected "
+            f"abi_revision ({abi_revision}) + 1"
+        )
+    doc["root"] = str(root)
+    return doc
+
+
+def _names_number(message: str, n: int) -> bool:
+    """ "The message says N", not "the message contains the digits of N": a
+    refusal naming revision 4 must not be satisfied by the 4 in a path like
+    `.../24.8/`, and one naming 5 must not be satisfied by 15."""
+    return re.search(rf"(^|[^0-9]){n}([^0-9]|$)", message) is not None
+
+
+def _without_fixture_path(message: str, root: Path) -> str:
+    """Strip every occurrence of the fixture root from a message before
+    `_names_number` checks it. The refusal message embeds the artifact's
+    PATH, and a path segment can itself hold a standalone digit (a scratchpad
+    session id such as `4d9fd784-...`), which would let the path alone
+    satisfy "the message names 4" for reasons that have nothing to do with
+    the refusal text itself. Both the given root and its resolved form are
+    stripped (macOS's `/tmp` vs `/private/tmp` differ), longest first so one
+    is never a partial match of the other.
+    """
+    candidates = sorted({str(root), os.path.realpath(root)}, key=len, reverse=True)
+    for candidate in candidates:
+        message = message.replace(candidate, "<fixture>")
+    return message
+
+
+def test_wrong_revision_is_refused(
+    abi_fixture: dict,
+    isolated_search_path: Path,
+) -> None:
+    root = Path(abi_fixture["root"], "wrong-revision")
+    registry = chtypes.Registry(root)
+    with pytest.raises(chtypes.RegistryError) as excinfo:
+        registry.for_version(FIXTURE_MINOR)
+    message = str(excinfo.value)
+    stripped = _without_fixture_path(message, root)
+    for n in (abi_fixture["mismatch_revision"], abi_fixture["abi_revision"]):
+        assert _names_number(stripped, n), f"the refusal does not name {n}: {message!r}"
+
+
+def test_matching_revision_loads(
+    abi_fixture: dict,
+    isolated_search_path: Path,
+) -> None:
+    root = Path(abi_fixture["root"], "at-revision")
+    registry = chtypes.Registry(root)
+    library = registry.for_version(FIXTURE_MINOR)
+    assert library.abi_revision == abi_fixture["abi_revision"]
+    assert library.version == abi_fixture["clickhouse_version"]

{chtypes-0.1.2 → chtypes-0.2.1}/tests/test_cli.py

@@ -23,7 +23,10 @@ PLATFORM = "linux-arm64"
 
 needs_fixtures = pytest.mark.skipif(
     not EXPECTED_FILE.is_file(),
-    reason=f"no fetch fixtures at {FIXTURES} (generated in the core repository, docs/guides/fetch.md §9)",
+    reason=(
+        f"no fetch fixtures at {FIXTURES} "
+        "(generated in the core repository, docs/guides/fetch.md §9)"
+    ),
 )
 
 

{chtypes-0.1.2 → chtypes-0.2.1}/tests/test_fetch.py

@@ -504,7 +504,7 @@ def test_trusted_keys_policy(monkeypatch: pytest.MonkeyPatch) -> None:
 
 def test_signature_file_shape() -> None:
     sig = (FIXTURES / "signed" / "SHA256SUMS.sig").read_bytes()
-    comment, raw = fetch_module._parse_signature(sig)
+    comment, raw = fetch_module.parse_signature_file(sig)
     assert comment == f"chtypes artifacts, ed25519 key {_expected()['key_id']}"
     assert len(raw) == 64
     sums = (FIXTURES / "signed" / "SHA256SUMS").read_bytes()
@@ -517,9 +517,9 @@ def test_signature_file_shape() -> None:
             sums + b"\n", sig, fetch_module.trusted_keys(_test_keys()), "x"
         )
     with pytest.raises(chtypes.ArtifactUntrustedError, match="base64"):
-        fetch_module._parse_signature(b"untrusted comment: x\n!!!\n")
+        fetch_module.parse_signature_file(b"untrusted comment: x\n!!!\n")
     with pytest.raises(chtypes.ArtifactUntrustedError, match="64"):
-        fetch_module._parse_signature(b"untrusted comment: x\nAAAA\n")
+        fetch_module.parse_signature_file(b"untrusted comment: x\nAAAA\n")
 
 
 # ------------------------------------------------------------- tar safety

{chtypes-0.1.2 → chtypes-0.2.1}/tests/test_parity.py

@@ -127,7 +127,9 @@ def test_every_capability_is_fully_declared() -> None:
             problems.append(f"{cid}: duplicate id")
         seen.add(cid)
         if not cap.get("what", "").strip():
-            problems.append(f"{cid}: no `what` — a capability with no description is a name, not a contract")
+            problems.append(
+                f"{cid}: no `what` — a capability with no description is a name, not a contract"
+            )
         if cap.get("group") not in MANIFEST_DOC["groups"]:
             problems.append(f"{cid}: unknown group {cap.get('group')!r}")
 
@@ -135,7 +137,9 @@ def test_every_capability_is_fully_declared() -> None:
         for lang in MANIFEST_DOC["languages"]:
             col = column(cap, lang)
             if not col:
-                problems.append(f"{cid}: no {lang} column at all — declare a spelling or an absence")
+                problems.append(
+                    f"{cid}: no {lang} column at all — declare a spelling or an absence"
+                )
                 continue
             if "absent" in col:
                 absent += 1
@@ -148,7 +152,9 @@ def test_every_capability_is_fully_declared() -> None:
                 problems.append(f"{cid}: {lang} column has neither `symbol` nor `absent`")
         if absent == len(MANIFEST_DOC["languages"]):
             problems.append(f"{cid}: absent in every binding — that is a note, not a contract")
-    assert not problems, "the parity manifest is not internally consistent:\n  " + "\n  ".join(problems)
+    assert not problems, "the parity manifest is not internally consistent:\n  " + "\n  ".join(
+        problems
+    )
 
 
 def test_the_go_copy_of_the_manifest_is_byte_identical() -> None:
@@ -162,7 +168,8 @@ def test_the_go_copy_of_the_manifest_is_byte_identical() -> None:
     if GO_COPY.read_bytes() != MANIFEST.read_bytes():
         pytest.fail(
             f"{GO_COPY} has drifted from {MANIFEST}. The manifest is one file; this is its "
-            f"embedded copy. Re-sync it:\n\n    cp tests/parity/manifest.json go/chtypes/testdata/parity.json\n"
+            f"embedded copy. Re-sync it:\n\n    "
+            f"cp tests/parity/manifest.json go/chtypes/testdata/parity.json\n"
         )
 
 
@@ -285,7 +292,8 @@ def test_the_cli_offers_every_contract_subcommand() -> None:
     """`chtypes fetch|verify|list|where` is a surface too, and it drifted once."""
     source = (SRC / "__main__.py").read_text(encoding="utf-8")
     missing = [
-        f"{cap['id']}: the python CLI has no `{cap['value']}` subcommand, which {also_in(cap)} offer"
+        f"{cap['id']}: the python CLI has no `{cap['value']}` subcommand, "
+        f"which {also_in(cap)} offer"
         for cap in CAPABILITIES
         if cap["kind"] == "cli" and spelling(cap, LANG) and f'"{cap["value"]}"' not in source
     ]
@@ -334,8 +342,8 @@ def test_no_public_name_escapes_the_contract() -> None:
     assert not undeclared, (
         f"python exports {len(undeclared)} public name(s) the parity contract has never heard "
         f"of:\n  " + "\n  ".join(undeclared) + "\n\nEither give each one a capability in "
-        f"tests/parity/manifest.json (if the other bindings should have it too) or list it under "
-        f'`unlisted.python` with a reason (if it is deliberately ours alone).'
+        "tests/parity/manifest.json (if the other bindings should have it too) or list it under "
+        "`unlisted.python` with a reason (if it is deliberately ours alone)."
     )
 
 
@@ -397,8 +405,9 @@ def test_the_manifest_and_the_spec_table_agree() -> None:
     # assertion is about which COLUMNS exist, not about their alignment.
     squashed = re.sub(r"[ \t]+", " ", full)
     assert "| Concept | Go | Python | TypeScript | Rust |" in squashed, (
-        "docs/reference/bindings.md's object-model table has lost a language column. Every language is a peer "
-        "SDK over the same C ABI and the document says so in its own second paragraph; a table with "
+        "docs/reference/bindings.md's object-model table has lost a language "
+        "column. Every language is a peer SDK over the same C ABI and the "
+        "document says so in its own second paragraph; a table with "
         "three of the four columns is how Rust came to be described only in a Notes cell."
     )
 
@@ -420,10 +429,11 @@ def test_the_manifest_and_the_spec_table_agree() -> None:
                 undocumented.append(f"{cap['id']}: {lang} `{spelled}` — {cap['what']}")
     assert checked > 0, "no object-model spelling was compared against docs/reference/bindings.md"
     assert not undocumented, (
-        f"the parity manifest requires {len(undocumented)} spelling(s) that docs/reference/bindings.md never "
+        f"the parity manifest requires {len(undocumented)} spelling(s) that "
+        f"docs/reference/bindings.md never "
         f"names:\n  " + "\n  ".join(undocumented) + "\n\nEither document them there, or — if the "
-        f"capability should not be required at all — remove it from the manifest. The two are one "
-        f"contract stated twice."
+        "capability should not be required at all — remove it from the manifest. The two are one "
+        "contract stated twice."
     )
 
 

{chtypes-0.1.2 → chtypes-0.2.1}/tests/test_registry.py

@@ -178,6 +178,29 @@ def test_manifest_ignores_unknown_fields(tmp_path: Path) -> None:
     assert manifest.library == "libchtypes.so"
 
 
+def test_verify_library_accepts_an_uppercase_digest(tmp_path: Path) -> None:
+    """A hex digest is the same digest in either case.
+
+    Go lower-cases (`strings.ToLower`) and Rust lower-cases
+    (`.to_ascii_lowercase()`) before comparing; Python and TypeScript once
+    compared raw, so an uppercase `library_sha256` was accepted by two
+    bindings and refused by two. docs/reference/artifact.md asserts all four
+    behave alike, so this pins it.
+    """
+    payload = b"not really a library"
+    (tmp_path / "fake.so").write_bytes(payload)
+    (tmp_path / "manifest.json").write_text(
+        json.dumps(
+            {
+                "library": "fake.so",
+                "library_bytes": len(payload),
+                "library_sha256": hashlib.sha256(payload).hexdigest().upper(),
+            }
+        )
+    )
+    chtypes.verify_library(tmp_path)  # must NOT raise
+
+
 def test_verify_library_checks_the_bytes(tmp_path: Path) -> None:
     payload = b"not really a library"
     (tmp_path / "fake.so").write_bytes(payload)

chtypes-0.2.1/uv.lock

@@ -0,0 +1,108 @@
+version = 1
+revision = 3
+requires-python = ">=3.11"
+
+[[package]]
+name = "chtypes"
+version = "0.2.1"
+source = { editable = "." }
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "ruff" },
+]
+
+[package.metadata]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=8.0" },
+    { name = "ruff", specifier = ">=0.14" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.21.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.1.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.16.7"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/82/bb/5a449b9162e49b139d72f61672bd3ac1d790221f796d3304e2241fff4c58/ruff-0.16.7.tar.gz", hash = "sha256:5f71d004ac1263b22fa39462ac5ae618a4b77d58981af2cc79bf79a29c12b1a6", size = 4924184, upload-time = "2026-09-10T18:04:06.336Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e3/b2/c80aeeb7f9e469c0d63a85d2f1ab6e1ebfbe10ea7a8d2438b7e09e3ff09e/ruff-0.16.7-py3-none-linux_armv6l.whl", hash = "sha256:727307773e7c7f9181d3ed3a2484186e56c1fa1874255911c74585eb2c7c19f9", size = 10048917, upload-time = "2026-09-10T18:03:30.28Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/96/20bb7bcae008004df52afcb7ac83432d4a467f2c17b672fe46d26be231c5/ruff-0.16.7-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:9d61c258deabf58f34c67bd4bb4d939c7f2e6b5f0e59c1cdd1cf771b11cde929", size = 10242929, upload-time = "2026-09-10T18:03:32.706Z" },
+    { url = "https://files.pythonhosted.org/packages/90/b2/f184b0d5abec02db69cfd7e49b688ae0237554528ca777136c613bf36bee/ruff-0.16.7-py3-none-macosx_11_0_arm64.whl", hash = "sha256:7ab81118df8945e0193d0240712aa4496573595b75185c3636ed825592a0f728", size = 9847245, upload-time = "2026-09-10T18:03:34.509Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/2d/db1633a641866ed801e34cc6b60ef236c5e16f9b2124ab1d49cc24a5fe4f/ruff-0.16.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4c196c968874fc8019da8e7163de7a1a370f111e2309b4b7dfea0fce950198d0", size = 9961780, upload-time = "2026-09-10T18:03:36.618Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/98/edea21e1a3e38dbbc3bf6bb068b863b3b06184cf8533a4c7dbbe208a89d5/ruff-0.16.7-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac8c3bd0a7e10ad31e6ce51e7a99f3cb772e69aecdd6b9ea7e99b362f62a62c0", size = 9866337, upload-time = "2026-09-10T18:03:38.805Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/11/a15e60d4c87b214646f116ca9d204475bf993ee1047459bc9a360fd4d6d1/ruff-0.16.7-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:398d3988edde000b5c75dc1b3f584708da9bc990de069c18909142580fec1af9", size = 10562512, upload-time = "2026-09-10T18:03:40.71Z" },
+    { url = "https://files.pythonhosted.org/packages/29/42/eaff4c9b6d0c7cdf56df313a17e89ae854f5bbc0b0c8f9cce19be0ab7a8f/ruff-0.16.7-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ce05b62b770a8217c4646a9c4139fca00efe8fe5d71f87df2b243ff20d4584d1", size = 11302938, upload-time = "2026-09-10T18:03:42.607Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/43/c75aa59a4ec181fe2ec06cab30e198c1c6d107229a9f008ae3a7c16cabd8/ruff-0.16.7-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:af1b576fddb9d9ef2ececfb5fadcd6a624b25070ed85e3cfcfe449fc3ff6a7b9", size = 10840857, upload-time = "2026-09-10T18:03:44.604Z" },
+    { url = "https://files.pythonhosted.org/packages/21/33/81f3da371942ea031105ba679d8d6e28ec1660ccd690a45f42d381161356/ruff-0.16.7-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9ce7f8f22df67c93ed96c717f9128eadb797144ac2bad475cf536f31d6100c55", size = 10370001, upload-time = "2026-09-10T18:03:46.706Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/0b/6345fb4dbf6dd0ed1cfe5d18391dc9c3f59cc81622a7b0a65b84b3e730ba/ruff-0.16.7-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:06d0e93d04f392996435ebd600c153f65b47d73fbec2415aa99c5ee5756b3a5f", size = 10548735, upload-time = "2026-09-10T18:03:48.658Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/4d/c5576adf511f92a328e5569dda190ecdd430da51f1a649f3a4a2fd73e21e/ruff-0.16.7-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:142151a5e7b93c1b11111337142f89dd2fbfee92161225c99a97222f22e32656", size = 10108496, upload-time = "2026-09-10T18:03:50.563Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/8c/667d83c16199a17a56adc6b0bd4c3beb5b767a2babcd16a56f76f9be7fd6/ruff-0.16.7-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:e6651f97a342d8b35d54d8991544ca22169b86dc54111cb604666940c431b750", size = 9860136, upload-time = "2026-09-10T18:03:52.621Z" },
+    { url = "https://files.pythonhosted.org/packages/99/75/78d401106731999a1dd20cc5a6961e37e1eb9397a3b589f73f3a5ce146a3/ruff-0.16.7-py3-none-musllinux_1_2_i686.whl", hash = "sha256:ef140c6eb935fa9a84c9c607dfb2cb1b85843c192e79265b0c54f35f557ea8e5", size = 10286290, upload-time = "2026-09-10T18:03:55.207Z" },
+    { url = "https://files.pythonhosted.org/packages/68/49/56f9c3a8b755df93a0ad318b2147bf4ef5dae9a7e5ec61c460109c67957f/ruff-0.16.7-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:53e39506a730fadeee0d998ed5946f30671f0db240c6c7c73bdabbe33604bb6f", size = 10745048, upload-time = "2026-09-10T18:03:57.299Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/ea/7f9b938a63ece4bec677ad7f9f7fa02df3383db1949ed93a382441c09a87/ruff-0.16.7-py3-none-win32.whl", hash = "sha256:2ea3470fcebcbc5df2fb0c6f3b90333fa9084c534e0111c038fa4a6ab9f1c4b7", size = 10059082, upload-time = "2026-09-10T18:03:59.632Z" },
+    { url = "https://files.pythonhosted.org/packages/39/11/480a6973a927aa653e1cead6a6416008640e03a99d05b34c0434b8c6c366/ruff-0.16.7-py3-none-win_amd64.whl", hash = "sha256:7ac26aca826e9e21d0f1cb25b54ac660760a9fdd094d3e4df9848232be98cfc6", size = 10593368, upload-time = "2026-09-10T18:04:01.999Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/4b/51327018d056f0dad2c2238f26d1fb0f53707a9d91b75dea6d1b3039f136/ruff-0.16.7-py3-none-win_arm64.whl", hash = "sha256:aab7f39e2c9df6c596216070f98eef1207b94f8516cca20c808826974971855b", size = 10412401, upload-time = "2026-09-10T18:04:04.098Z" },
+]

chtypes-0.1.2/CHANGELOG.md

@@ -1,35 +0,0 @@
-# Changelog — `chtypes`
-
-All notable changes to the python binding. The format is [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-The four bindings in this repository are released together and give one answer, so an entry here has a counterpart in the other three.
-
-## [0.1.2] — 2026-09-11
-
-### Changed — BREAKING
-
-- **The transform reason for a materialized DEFAULT is now `default_materialized`** — previously the same word spelled with an `s` — and the exported constant naming it is now `Reason.DEFAULT_MATERIALIZED`. ClickHouse's own keyword is `MATERIALIZED`; its parser rejects the `s` spelling outright with a syntax error, so the reason naming that concept now matches the system it describes. Code comparing against the old string or the old constant name must be updated.
-- This is an SDK-only change and **the ABI is untouched: it remains revision 4, and no artifact needs relinking.** The reason is derived in the binding, not received from the artifact — the library emits `default_substituted`, which each binding translates. That wire value is unchanged.
-
-### Changed
-
-- **The per-language README is now an orientation page, not a manual.** It carries install, a quickstart that runs, the three outcomes and the error model, and then points at `docs/` for the rest — roughly 450 lines of reference prose moved to `docs/guides/` and `docs/reference/` rather than being repeated four times and drifting four ways.
-- **The published packages no longer cite a repository you cannot open.** 148 source comments — in every binding and in `include/chtypes.h`, all of which ship inside the crate, the sdist and the module — attributed the contract they implement to a private repository's specification. They now cite **the C ABI contract**, with `include/chtypes.h` as the public authority for it. Alongside those, 14 dead paths into that repository, the examples' instruction to build an artifact there, and two descriptions of the signing infrastructure are gone. What remains naming it is the handful of places where the two-repository split is the actual subject — the README, `SECURITY.md`, and `docs/reference/README.md`, which says plainly that the full normative specification is not public.
-- `scripts/lint-public.sh` is new and blocking in CI, because the sweep this replaces reported itself complete while 148 of its targets survived in a different shape. It refuses both the private repository's name and that exact prose pointer, and its `--selftest` proves each rule fires rather than assuming it.
-
-## [0.1.1] — 2026-09-11
-
-- **The golden set is served, not tracked.** `goldens/cases.json` no longer exists in this repository. Core publishes `sdk-goldens.json` in the rolling release as a row in the signed `SHA256SUMS`; `scripts/fetch.sh` installs it at `<registry>/sdk-goldens.json` and the golden test reads it offline from there (`CHTYPES_GOLDENS` overrides). A case runs only against the exact ClickHouse version `generated.exact` names for its line and skips loudly otherwise, so the set shrinks as lines are added rather than recording an answer twice.
-- **Artifact identity gained a wrapper build.** Assets are `chtypes-<version>-<os>-<arch>-b<N>.tar.gz`, where `<N>` is the core commit's UNIX timestamp; an absent suffix means build 0 and stays valid. Line resolution ranks by `(version, build)`, so a rebuild of a line supersedes the older build.
-- Fetching now retries the publish window, so a fetch that races a release no longer fails on sums naming a file the host has not finished serving.
-- README install instructions name the published package rather than a path dependency.
-- Two errors in the published README, both found by running the snippets rather than reading them: Python's `substituted` is on `RowResult`, not `BatchResult`, and TypeScript's `using schema = …` is a syntax error on Node 22, this package's own `engines` floor (`schema.close()` is portable).
-- `docs/support.md` is new: which language versions, platforms and ClickHouse lines are supported, generated from the manifests and the release's own index.
-
-## [0.1.0] — 2026-09-10
-
-First release, published to PyPI from the tag `python/v0.1.0`.
-
-- Speaks **ABI revision 4** of the frozen `chs_*` C ABI (`include/chtypes.h`, 28 functions). The binding `dlopen`s a per-version artifact and reimplements no ClickHouse semantics; `Transformed` is the one derived result.
-- Verified against the public golden set (`goldens/cases.json`, schema 1, 31 cases), whose expectations were generated on ClickHouse 24.8, 25.3, 25.8, 25.10, 26.5, 26.6 and 26.7 — every case answered identically on all seven lines, and any case that did not was refused by the generator.
-- Pre-1.0: the artifact name `libchtypes`, the `chs_` prefix and the `enum chs_format` numbers are frozen. Function signatures freeze at this tag.

chtypes-0.1.2/uv.lock

@@ -1,108 +0,0 @@
-version = 1
-revision = 3
-requires-python = ">=3.11"
-
-[[package]]
-name = "chtypes"
-version = "0.1.2"
-source = { editable = "." }
-
-[package.dev-dependencies]
-dev = [
-    { name = "pytest" },
-    { name = "ruff" },
-]
-
-[package.metadata]
-
-[package.metadata.requires-dev]
-dev = [
-    { name = "pytest", specifier = ">=8.0" },
-    { name = "ruff", specifier = ">=0.14" },
-]
-
-[[package]]
-name = "colorama"
-version = "0.4.6"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
-]
-
-[[package]]
-name = "iniconfig"
-version = "2.3.0"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
-]
-
-[[package]]
-name = "packaging"
-version = "26.3"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" },
-]
-
-[[package]]
-name = "pluggy"
-version = "1.6.0"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
-]
-
-[[package]]
-name = "pygments"
-version = "2.21.0"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" },
-]
-
-[[package]]
-name = "pytest"
-version = "9.1.1"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "colorama", marker = "sys_platform == 'win32'" },
-    { name = "iniconfig" },
-    { name = "packaging" },
-    { name = "pluggy" },
-    { name = "pygments" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" },
-]
-
-[[package]]
-name = "ruff"
-version = "0.16.6"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/a4/7c/6adb35d70e7c027e308274557901c7e00fb3407750faf3620c184ae058cb/ruff-0.16.6.tar.gz", hash = "sha256:dcf8a73d2ff77e99dde91244b4da16feba7f14e6beeb4015dee7c5a909e99050", size = 4921251, upload-time = "2026-09-03T16:57:29.037Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/a4/28/9cc1b79639e284ec103f43c88c644db4eb58cbd0ea1ca11f1193435369ac/ruff-0.16.6-py3-none-linux_armv6l.whl", hash = "sha256:61c368c26bf8e973e5ab14a2772de587bc068ea3f9a277f673380749b4898fb8", size = 10015638, upload-time = "2026-09-03T16:56:40.986Z" },
-    { url = "https://files.pythonhosted.org/packages/71/11/627d342ef727ea7794edf74fe23d60a074b02c3acc2e9436684e782286ca/ruff-0.16.6-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:ecf4f068e2e123e43a26e9db4e19524cc56563912404e83bbfca375757e45a32", size = 10220762, upload-time = "2026-09-03T16:56:44.681Z" },
-    { url = "https://files.pythonhosted.org/packages/43/d9/b75668ce41e4c8d073d18d6d08672ba6906ce45d5c06ea4fdb2e84ce3853/ruff-0.16.6-py3-none-macosx_11_0_arm64.whl", hash = "sha256:99b62ea33baf130f50368798d841f0d95527b6d817bf31817b65dd058f1d314c", size = 9835082, upload-time = "2026-09-03T16:56:47.142Z" },
-    { url = "https://files.pythonhosted.org/packages/99/97/123ab10b05cde889c107c20f5a9774955104b5552796a2a8584b089ae8eb/ruff-0.16.6-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7fbf89013f2bb3f6835a6038ff658dc8a1b38c98dc8e724b964168ad4e881876", size = 9949304, upload-time = "2026-09-03T16:56:49.813Z" },
-    { url = "https://files.pythonhosted.org/packages/3e/58/a4a2c59dd2e5b85929c912d9cac3056eb9ee8c7e75e9b9fe3e109174966b/ruff-0.16.6-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:56a67065e22efa6bc4d498299d3bb06c0c90aace8fac2068b5a12f9dc4d8d51d", size = 9840612, upload-time = "2026-09-03T16:56:52.368Z" },
-    { url = "https://files.pythonhosted.org/packages/61/6a/ff8c8626a786c4f49d48ced4a752dadbca65f5263005f9c2416578194694/ruff-0.16.6-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e25cc89174874b176a157e4428d66761c2c0c006654419bf384f967f361ff1b1", size = 10543465, upload-time = "2026-09-03T16:56:55.089Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/bb/c47535923365f337b82e28192e4e9eef2176511007cfd99a62fc22df5dad/ruff-0.16.6-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0700580ed5303723cb3c11c2f1d2a8913ce77b7ea86646dddb887f5417a9ba70", size = 11267576, upload-time = "2026-09-03T16:56:57.791Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/50/e5119a5212b5cd63b51e1f4b25e7bd636a6668fc069a3160b108ad7e3c16/ruff-0.16.6-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:15f1d0b6e165a6e56567befb6629f8209271311d990bae0f37e6d065035ef5f3", size = 10781993, upload-time = "2026-09-03T16:57:00.666Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/98/083d8b4ef3c51a0d19db84367791cbe9f44e4b53343d19dfa83556e1cd9a/ruff-0.16.6-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d72c591a96986ee4268860e2b7235082129ca5e4cb9cbba653a4b57c11893757", size = 10317748, upload-time = "2026-09-03T16:57:03.428Z" },
-    { url = "https://files.pythonhosted.org/packages/9a/29/68f7ff2c5ad95f19f00627ac2de95644e25fe47371ea60b2db1fd952315e/ruff-0.16.6-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:65a006baa18f33324325814c864daef03541d51564b98c517610ea756ab7003e", size = 10540096, upload-time = "2026-09-03T16:57:06.182Z" },
-    { url = "https://files.pythonhosted.org/packages/c4/f9/79a8f6de85968641d68a7863aeec577551924ef066a990a48ff93167beab/ruff-0.16.6-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:cd02a7bf1a21a8735228a3e8c95a9dc5cf86bd2a52194f4aaae2a5755b4de0f4", size = 10100494, upload-time = "2026-09-03T16:57:09.194Z" },
-    { url = "https://files.pythonhosted.org/packages/d9/e8/b81a22d9b90c00b892ccf2fa2ac36fa95de4c13ab85aea3e73795cfe4651/ruff-0.16.6-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:31b36f1e5ad85e0737f09d2be4e512e2e283583c14015da3b9dc07359ac0fc88", size = 9843663, upload-time = "2026-09-03T16:57:12.168Z" },
-    { url = "https://files.pythonhosted.org/packages/39/aa/54f516ec5e5a11c4afdceb1c454ebb054ffb96e4f4a1705580b4346abd35/ruff-0.16.6-py3-none-musllinux_1_2_i686.whl", hash = "sha256:61029b4ab4aa723fd3064fab96b1d814492596bf0c792679fffcbde1e1679953", size = 10282461, upload-time = "2026-09-03T16:57:15.077Z" },
-    { url = "https://files.pythonhosted.org/packages/52/0b/38d0aa8aa32372b96dc44f97b22e576c4147808271aab7b2cb1e353d4445/ruff-0.16.6-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:9ac8998457832c2061709d900856b7ad271dace0cb41f346588d540162bfa718", size = 10728808, upload-time = "2026-09-03T16:57:17.797Z" },
-    { url = "https://files.pythonhosted.org/packages/5e/e5/9e274e24eeb027640ffc7442f21239f16d17f47acec15ae34f32e03a5c79/ruff-0.16.6-py3-none-win32.whl", hash = "sha256:0b87d9d16fcb63e8018423ca1d50b7260f15cb2da33e30db4baad4183a948c25", size = 10049212, upload-time = "2026-09-03T16:57:20.55Z" },
-    { url = "https://files.pythonhosted.org/packages/22/31/72472449414223ed1a2da236b992adbb1a2ae59e34794574810f60ce068e/ruff-0.16.6-py3-none-win_amd64.whl", hash = "sha256:10d21c51c3495d8eaea7b703a16592117ea6eb1d649e36335aa965ff1173eb39", size = 10556402, upload-time = "2026-09-03T16:57:23.501Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/07/d781f8f8e1ac24bef9f3269cf62ffb1407ca24c3a8f12e5e22874f90528c/ruff-0.16.6-py3-none-win_arm64.whl", hash = "sha256:7a976c79b958f94e50a022a19f0f8c87387448020935ec14fc74331bd0a7f2c5", size = 10412850, upload-time = "2026-09-03T16:57:26.416Z" },
-]