continuo-python-runtime 0.4.1__py3-none-any.whl → 0.5.0__py3-none-any.whl

continuo_python_runtime/validation/runner.py

@@ -18,6 +18,11 @@ Dispatches on ``VALIDATION_OP`` env var (default ``build_from_sql``):
   that dropped a column the script reads fails the release gate, then the output
   table is materialized empty from the declared typed columns and the declared
   physical layout.
+- ``check_binds``: for a dbt test's compiled SQL (``CANDIDATE_SQL_URI``, fetched
+  the same way as ``build_from_sql``). EXPLAINs it against the candidate schema
+  via the engine adapter and creates nothing — a test whose compiled SQL names
+  a column a candidate change dropped or renamed fails the release at its
+  source, before any table is built.
 
 The engine adapter is discovered from the single installed
 ``continuo_engine.adapters`` entry point — each runner image installs exactly one.
@@ -108,7 +113,7 @@ def load_candidate_spec() -> dict:
     return spec
 
 
-_NODE_OPS = ("build_from_sql", "clone_from_prod", "build_from_columns")
+_NODE_OPS = ("build_from_sql", "clone_from_prod", "build_from_columns", "check_binds")
 _SCHEMA_OPS = ("ensure_schema", "drop_schema")
 
 
@@ -116,10 +121,13 @@ def main() -> None:
     """Run one validation op end to end; exits non-zero on failure.
 
     Node ops (``build_from_sql``/``clone_from_prod``/``build_from_columns``)
-    materialize one empty node table and require ``TABLE_NAME``. Schema ops
-    (``ensure_schema``/``drop_schema``) act on the whole candidate schema —
-    the executor schedules them as one-shot engine-image Jobs to own the
-    candidate-schema lifecycle without connecting to the warehouse itself —
+    materialize one empty node table and require ``TABLE_NAME``. ``check_binds``
+    is also a node op and requires ``TABLE_NAME`` (for identity only, in the
+    result block's ``unique_id``) but creates nothing: it bind-checks a dbt
+    test's compiled SQL against the candidate schema with the engine's EXPLAIN.
+    Schema ops (``ensure_schema``/``drop_schema``) act on the whole candidate
+    schema — the executor schedules them as one-shot engine-image Jobs to own
+    the candidate-schema lifecycle without connecting to the warehouse itself —
     and take no table.
     """
     logging.basicConfig(
@@ -139,7 +147,7 @@ def main() -> None:
     if op in _NODE_OPS:
         table = _require("TABLE_NAME")
         unique_id = _node_id() or f"model.{table}"
-        if op == "build_from_sql":
+        if op in ("build_from_sql", "check_binds"):
             try:
                 raw_sql = load_candidate_sql()
             except Exception as exc:
@@ -150,7 +158,7 @@ def main() -> None:
             if not raw_sql:
                 logger.error(
                     "CANDIDATE_SQL_URI is unset or the object is empty for a "
-                    "build_from_sql node; cannot validate"
+                    "%s node; cannot validate", op
                 )
                 print(result.result_block("error", "CANDIDATE_SQL_URI is unset or empty",
                                           unique_id=unique_id), flush=True)
@@ -238,6 +246,12 @@ def main() -> None:
             if op == "build_from_sql":
                 assert candidate_sql is not None, "candidate_sql must be set for build_from_sql"
                 adapter.build_empty_from_sql(schema, table, candidate_sql)
+            elif op == "check_binds":
+                # A dbt test: EXPLAIN its compiled SQL against the candidate
+                # schema. A dropped or renamed column fails here; no table is
+                # created and no row is read.
+                assert candidate_sql is not None, "candidate_sql must be set for check_binds"
+                adapter.check_binds(candidate_sql)
             elif op == "build_from_columns":
                 assert spec is not None, "spec must be set for build_from_columns"
                 if csv_source:

{continuo_python_runtime-0.4.1.dist-info → continuo_python_runtime-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: continuo-python-runtime
-Version: 0.4.1
+Version: 0.5.0
 Summary: Runtime harness, contract tooling, and CI lint for Continuo python nodes.
 Author: Simone Carolini
 Maintainer: Simone Carolini
@@ -11,7 +11,7 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.14
-Requires-Dist: boto3==1.43.74
+Requires-Dist: boto3==1.43.85
 Requires-Dist: continuo-engine-contract==0.7.3
 Requires-Dist: pyarrow==25.0.1
 Requires-Dist: pyyaml==6.0.3
@@ -275,9 +275,9 @@ A domain repo picks its warehouse engine by which base image it builds
 `FROM`:
 
 ```dockerfile
-FROM ghcr.io/carolsimone/continuo-python-runtime-postgres:v0.4.1
+FROM ghcr.io/carolsimone/continuo-python-runtime-postgres:v0.5.0
 # or
-FROM ghcr.io/carolsimone/continuo-python-runtime-trino:v0.4.1
+FROM ghcr.io/carolsimone/continuo-python-runtime-trino:v0.5.0
 ```
 
 The engine is part of the image **name**; the tag is the bare version, so

{continuo_python_runtime-0.4.1.dist-info → continuo_python_runtime-0.5.0.dist-info}/RECORD

@@ -19,11 +19,11 @@ continuo_python_runtime/csv_readers/__init__.py,sha256=9TKvjC37C77uRaJQZuO0--zVj
 continuo_python_runtime/csv_readers/https.py,sha256=tMJ9k5F0b9SAydpon0ZlOznfjvjhF2BBLltyVmvRneE,4998
 continuo_python_runtime/csv_readers/s3.py,sha256=zmvHs3TxlN2alPKrdaHzPyREmkve2nBiAsHRXXe1mE0,2246
 continuo_python_runtime/validation/__init__.py,sha256=hz5oGXsoaUoygR0_pBby9PS6cEfrre518EE0HGB58eE,79
-continuo_python_runtime/validation/runner.py,sha256=AwYbiFrQubxSm1vfxJJpnp7xfekviUW2anw4LRQQ4Rc,13062
+continuo_python_runtime/validation/runner.py,sha256=7pbksf7MXfTNcdklCOkOXg9qfRiJtyI_dbgbL3a9LWk,14072
 continuo_python_runtime/validation/s3.py,sha256=q8nRrT9R7L1-M4dSlDnkL7CUJMPmq86MHY_UKYFlEf8,1785
-continuo_python_runtime-0.4.1.dist-info/METADATA,sha256=EjG8OIYrN1O51KOsUxIA0Ln6zpsWdaLJheUcCaRkqD8,18811
-continuo_python_runtime-0.4.1.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
-continuo_python_runtime-0.4.1.dist-info/entry_points.txt,sha256=ZvIwSm9f9B9ZmZMf6CyF5Zt4QONn8rqaIk-u-B1CF2Y,70
-continuo_python_runtime-0.4.1.dist-info/licenses/LICENSE,sha256=hfXfFCk-8gnps4YvHA6bjCNaSYqOrq2gAdqkXYycAQc,11345
-continuo_python_runtime-0.4.1.dist-info/licenses/NOTICE,sha256=ykgYyQkAMx3uas90FZHzt0aTca9IgJQCLpZ4d74Pl3U,465
-continuo_python_runtime-0.4.1.dist-info/RECORD,,
+continuo_python_runtime-0.5.0.dist-info/METADATA,sha256=vQisnCASgreJNhw4ryPWuyQvo4dmw6mWEMJH3zZxHx4,18811
+continuo_python_runtime-0.5.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+continuo_python_runtime-0.5.0.dist-info/entry_points.txt,sha256=ZvIwSm9f9B9ZmZMf6CyF5Zt4QONn8rqaIk-u-B1CF2Y,70
+continuo_python_runtime-0.5.0.dist-info/licenses/LICENSE,sha256=hfXfFCk-8gnps4YvHA6bjCNaSYqOrq2gAdqkXYycAQc,11345
+continuo_python_runtime-0.5.0.dist-info/licenses/NOTICE,sha256=ykgYyQkAMx3uas90FZHzt0aTca9IgJQCLpZ4d74Pl3U,465
+continuo_python_runtime-0.5.0.dist-info/RECORD,,