continuo-validation-contract
The contract shared by the continuo validation runner and every engine adapter library. Four modules:
| Module | What it holds |
|---|---|
continuo_validation_contract.port |
The ValidationAdapter port (engine-specific empty-table DDL) and the RuntimeAdapter port, plus entry-point discovery |
continuo_validation_contract.types |
The SQL column-type grammar that DDL-emitting methods validate against |
continuo_validation_contract.sql |
ensure_single_read, the parse-backed gate check_binds runs before it lets a declared read near an engine |
continuo_validation_contract.result |
The sentinel-framed result-block wire format the runner emits and the k8s-controller parses |
Each continuo-validation-<engine> library depends on this package and
implements the port.
ensure_single_read is why this package has a runtime dependency —
sqlglot, pinned exactly — where it
previously had none. Deciding "is this one read query?" means parsing it, and
that rule is engine-independent: every adapter needs the same one, so it lives
here rather than being reimplemented per engine. Adapters call it with their
own dialect ("postgres", "trino", …) and it raises ValueError on
anything that is not exactly one query — no sqlglot exception escapes, so
callers never import sqlglot to handle a rejected read.
Job, not a service
This package runs nothing of its own — it isn't a service and it isn't the
Job either. It's the interface both sides of the validation Job agree on:
continuo-validation-runner (the Job that
calls it) and every continuo-validation-<engine> adapter package (which
implements it). The whole contract is the nine ValidationAdapter methods
(required_env, from_env, ensure_schema, drop_schema,
build_empty_from_sql, clone_empty_from_prod, build_empty_from_columns,
check_binds, close) plus the sentinel result-block format
discover_adapter resolves against at import time — and the two shared guards
implementations are required to run rather than reinvent:
types.validate_column_type before interpolating a type into DDL, and
sql.ensure_single_read before letting a declared read reach an engine.
Because the port is the contract, this package is very unlikely to need changes — new warehouse support is a new adapter package implementing the existing methods, not a change here. Touching this file means bumping a version that the co-located runner and adapters in this workspace consume immediately, and that external adapter authors pin from PyPI, so treat it as a deliberate, coordinated change.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file continuo_validation_contract-0.4.0.tar.gz.
File metadata
- Download URL: continuo_validation_contract-0.4.0.tar.gz
- Upload date:
- Size: 11.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
641885511882fe8367641b6d953a2216acff662722fd2906d2e84db06131cb18
|
|
| MD5 |
aeedd470d45f45de79b735b082724c13
|
|
| BLAKE2b-256 |
96321a17df50603df0ffa48ef7e46e1b01cb93307cb9860d01bc3c57165b8051
|
Provenance
The following attestation bundles were made for continuo_validation_contract-0.4.0.tar.gz:
Publisher:
publish-pypi.yml on carolsimone/continuo-validation
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
continuo_validation_contract-0.4.0.tar.gz -
Subject digest:
641885511882fe8367641b6d953a2216acff662722fd2906d2e84db06131cb18 - Sigstore transparency entry: 2367559327
- Sigstore integration time:
-
Permalink:
carolsimone/continuo-validation@3feecb6dee8bd53f9fcbfe2725ea2a3d1903b0fe -
Branch / Tag:
refs/tags/pypi-contract-v0.4.0 - Owner: https://github.com/carolsimone
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@3feecb6dee8bd53f9fcbfe2725ea2a3d1903b0fe -
Trigger Event:
push
-
Statement type:
File details
Details for the file continuo_validation_contract-0.4.0-py3-none-any.whl.
File metadata
- Download URL: continuo_validation_contract-0.4.0-py3-none-any.whl
- Upload date:
- Size: 8.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
917efa9db50ad4cb85d815c903bd5115e64d8606910d9a8a9d02dd3c8e8342e1
|
|
| MD5 |
164820b9c5472629a439360999fb73dd
|
|
| BLAKE2b-256 |
17bde281c4b28c0bd93f472da61d1a2fcb1a64a274b4731b29cbb7855fd126db
|
Provenance
The following attestation bundles were made for continuo_validation_contract-0.4.0-py3-none-any.whl:
Publisher:
publish-pypi.yml on carolsimone/continuo-validation
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
continuo_validation_contract-0.4.0-py3-none-any.whl -
Subject digest:
917efa9db50ad4cb85d815c903bd5115e64d8606910d9a8a9d02dd3c8e8342e1 - Sigstore transparency entry: 2367559671
- Sigstore integration time:
-
Permalink:
carolsimone/continuo-validation@3feecb6dee8bd53f9fcbfe2725ea2a3d1903b0fe -
Branch / Tag:
refs/tags/pypi-contract-v0.4.0 - Owner: https://github.com/carolsimone
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-pypi.yml@3feecb6dee8bd53f9fcbfe2725ea2a3d1903b0fe -
Trigger Event:
push
-
Statement type:
