continuo-validation-contract

The contract shared by the continuo validation runner and every engine adapter library. Five 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.config ensure_known_keys, the fail-closed gate build_empty_from_columns runs before it lets a node's physical-layout config block reach DDL
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 three shared guards implementations are required to run rather than reinvent: types.validate_column_type before interpolating a type into DDL, sql.ensure_single_read before letting a declared read reach an engine, and config.ensure_known_keys before building any DDL from a node's physical-layout config block, to reject keys this engine doesn't recognize.

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.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for carolsimone from gravatar.com carolsimone

Credits

Author: Simone Carolini

Requires

Python >=3.14

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

continuo_validation_contract-0.6.0.tar.gz (13.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

continuo_validation_contract-0.6.0-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

Details for the file continuo_validation_contract-0.6.0.tar.gz.

File metadata

File hashes

Hashes for continuo_validation_contract-0.6.0.tar.gz
Algorithm Hash digest
SHA256 e515c5098e8f533d6505515fd9d72c6a4c16d8189402a7de1a1b1dd10fc34e00
MD5 9837121c5c7e225efcede11bf16d764f
BLAKE2b-256 3877a90ab11116c350c9e1d3a795edaefcfffac62f80862acfaa8cba10096d04

See more details on using hashes here.

Provenance

The following attestation bundles were made for continuo_validation_contract-0.6.0.tar.gz:

Publisher: publish-pypi.yml on carolsimone/continuo-validation

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file continuo_validation_contract-0.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for continuo_validation_contract-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a65bbcc484f1af5796daf5f014e2192945381a9c581e9b5d0ddf4092e800873f
MD5 79c716f5488a9cf709d5374b35fcf90e
BLAKE2b-256 d5771652064ab3f64493285dda924d7c474187eaa776479f422c205e4680ff6b

See more details on using hashes here.

Provenance

The following attestation bundles were made for continuo_validation_contract-0.6.0-py3-none-any.whl:

Publisher: publish-pypi.yml on carolsimone/continuo-validation

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page