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:
Newer release available (0.6.0)

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.5.0.tar.gz (12.9 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.5.0-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for continuo_validation_contract-0.5.0.tar.gz
Algorithm Hash digest
SHA256 d9d77ed42c367aa2c516ed23c80c4369332879ab2133047ed47357a1e0690819
MD5 fe960651ed99e2d8dfd1eaf4b60a91b5
BLAKE2b-256 46ea052893d856aab06e8152f2c42bbc43fb5ac45756bdd428a96d9a866231bc

See more details on using hashes here.

Provenance

The following attestation bundles were made for continuo_validation_contract-0.5.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.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for continuo_validation_contract-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 00adc827a50cff28a964764ab81446aa0a59b01bd4d3a15493a5869d7748c849
MD5 a9abcef3d91d3293f62acd86bf41a404
BLAKE2b-256 7852b5b987b71445431cf5678f235b3f9d1f1e2dadb7d4408aed294257ea5330

See more details on using hashes here.

Provenance

The following attestation bundles were made for continuo_validation_contract-0.5.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