continuo-python-runtime 0.9.0__py3-none-any.whl → 0.10.0__py3-none-any.whl

continuo_python_runtime/contract/loader.py

@@ -44,8 +44,13 @@ _ALLOWED_KEYS = {
     "secret_ref",
     "mode_type",
     "primary_key",
+    "timeout_minutes",
 }
 
+# Bounds of a node's declared task timeout, in minutes (one minute to one week).
+MIN_TIMEOUT_MINUTES = 1
+MAX_TIMEOUT_MINUTES = 10_080
+
 _REQUIRED_STRING_FIELDS = ("schema", "table", "owner", "schedule")
 
 _ALLOWED_OUTPUT_COLUMN_KEYS = {"name", "type", "nullable"}
@@ -295,6 +300,16 @@ def parse_node(
             raise ContractError(f"{label}: 'secret_ref' is not allowed for kind {kind}")
         secret_ref = validate_secret_ref(raw["secret_ref"], label)
 
+    timeout_minutes = raw.get("timeout_minutes")
+    if "timeout_minutes" in raw and (
+        type(timeout_minutes) is not int
+        or not MIN_TIMEOUT_MINUTES <= timeout_minutes <= MAX_TIMEOUT_MINUTES
+    ):
+        raise ContractError(
+            f"{label}: 'timeout_minutes' must be an integer between "
+            f"{MIN_TIMEOUT_MINUTES} and {MAX_TIMEOUT_MINUTES}, got {timeout_minutes!r}"
+        )
+
     mode_type = raw.get("mode_type", DEFAULT_MODE_TYPE)
     if not isinstance(mode_type, str) or mode_type not in MODE_TYPES:
         raise ContractError(
@@ -302,7 +317,7 @@ def parse_node(
         )
     if mode_type not in rules.mode_types:
         raise ContractError(
-            f"{label}: 'mode_type' {mode_type} is not allowed for kind {kind} "
+            f"{label}: 'mode_type' {mode_type!r} is not allowed for kind {kind!r} "
             f"(allowed: {sorted(rules.mode_types)})"
         )
 
@@ -375,6 +390,7 @@ def parse_node(
         secret_ref=secret_ref,
         mode_type=mode_type,
         primary_key=primary_key,
+        timeout_minutes=timeout_minutes,
     )
 
 

continuo_python_runtime/contract/merge.py

@@ -170,6 +170,10 @@ def build_wire_contract(
 
         primary_bytes, member_bytes = _HASH_INPUTS[node.kind](node, repo_root)
         entry.update(hash_parts(entry, primary_bytes, member_bytes))
+        # The one wire key outside config_hash: it is written after the hashes
+        # are computed, so changing it alone never changes content_hash.
+        if node.timeout_minutes is not None:
+            entry["timeout_minutes"] = node.timeout_minutes
 
         wire_nodes.append(entry)
 

continuo_python_runtime/contract/model.py

@@ -45,6 +45,7 @@ class Node:
     secret_ref: str = ""
     mode_type: str = DEFAULT_MODE_TYPE
     primary_key: tuple[str, ...] = ()
+    timeout_minutes: int | None = None
 
     @property
     def relation(self) -> str:

continuo_python_runtime/hashing.py

@@ -21,6 +21,10 @@ from json import dumps
 
 HASH_PART_FIELDS = ("source_hash", "shared_code_hash", "config_hash")
 CONTENT_HASH_FIELD = "content_hash"
+# A wire key that is not part of the config_hash basis: it tunes how the node
+# runs (the task timeout) and says nothing about what the node computes, so
+# changing it alone is not a code change.
+NON_HASHED_FIELDS = ("timeout_minutes",)
 
 
 def canonical_entry(entry: dict) -> dict:
@@ -28,13 +32,14 @@ def canonical_entry(entry: dict) -> dict:
 
     Drops ``content_hash`` and all three of ``HASH_PART_FIELDS`` from the
     basis, and whitespace-normalizes every ``str`` value in ``reads`` via
-    ``" ".join(sql.split())``. Everything else is preserved verbatim,
-    including ``config``.
+    ``" ".join(sql.split())``. ``timeout_minutes`` is the one other wire key
+    left out of the basis (``NON_HASHED_FIELDS``). Everything else is
+    preserved verbatim, including ``config``.
     """
     canonical = deepcopy(entry)
 
     canonical.pop(CONTENT_HASH_FIELD, None)
-    for field in HASH_PART_FIELDS:
+    for field in (*HASH_PART_FIELDS, *NON_HASHED_FIELDS):
         canonical.pop(field, None)
 
     reads = canonical.get("reads")

{continuo_python_runtime-0.9.0.dist-info → continuo_python_runtime-0.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: continuo-python-runtime
-Version: 0.9.0
+Version: 0.10.0
 Summary: Runtime harness, contract tooling, and CI lint for Continuo python nodes.
 Author: Simone Carolini
 Maintainer: Simone Carolini
@@ -12,7 +12,7 @@ Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.14
 Requires-Dist: boto3==1.43.85
-Requires-Dist: continuo-engine-contract==0.8.0
+Requires-Dist: continuo-engine-contract==0.8.1
 Requires-Dist: pyarrow==25.0.1
 Requires-Dist: pyyaml==6.0.3
 Requires-Dist: sqlglot==30.17.0
@@ -196,6 +196,15 @@ produced, never how it is checked or written.
   script reads with `os.environ[...]`. The contract never holds a secret value
   or env var name; the Secret itself is created in the cluster by the operator.
 
+### Task timeout
+
+Any node may set `timeout_minutes:` — an integer from 1 to 10,080 (one week) —
+to declare how long its task may run before continuo gives up on it. A value
+outside that range, or one that is not an integer, fails
+`continuo-runtime validate`/`merge`/`lint`. It is the one key that is not part
+of `config_hash`, so changing only the timeout never changes the node's
+`content_hash`.
+
 ## Write modes
 
 `mode_type:` chooses how the harness writes a node's table on each run:
@@ -347,11 +356,11 @@ A domain repo picks its warehouse engine by which base image it builds
 `FROM`:
 
 ```dockerfile
-FROM ghcr.io/carolsimone/continuo-python-runtime-postgres:v0.9.0
+FROM ghcr.io/carolsimone/continuo-python-runtime-postgres:v0.10.0
 # or
-FROM ghcr.io/carolsimone/continuo-python-runtime-trino:v0.9.0
+FROM ghcr.io/carolsimone/continuo-python-runtime-trino:v0.10.0
 # or
-FROM ghcr.io/carolsimone/continuo-python-runtime-duckdb:v0.9.0
+FROM ghcr.io/carolsimone/continuo-python-runtime-duckdb:v0.10.0
 ```
 
 The engine is part of the image **name**; the tag is the bare version, so

{continuo_python_runtime-0.9.0.dist-info → continuo_python_runtime-0.10.0.dist-info}/RECORD

@@ -7,15 +7,15 @@ continuo_python_runtime/csv_loader.py,sha256=a5Hwu-YIzIiko8X1_vqShsnzjs2-OsKEUSC
 continuo_python_runtime/csv_source.py,sha256=7g8Tu6ieiJLvWH4Ep4nwYlOdGkjeePr12K5UHuO8TNc,4136
 continuo_python_runtime/errors.py,sha256=nfZzfBhQ2ajm7USAWKKaGY2uUlh8eNjNPNYYuaOJgZE,1032
 continuo_python_runtime/harness.py,sha256=vm2wL7cOHT2uvrIgDZkNXAV7aT-6x7dQoCKirr41oJ0,16798
-continuo_python_runtime/hashing.py,sha256=70iXQb0CmjGqniTPofXY6WapydQ7aK2XOk5dzpEf-zk,3354
+continuo_python_runtime/hashing.py,sha256=7lIkWOM50xt9syFNPNSTLG3T5qxqGnA6doHXPAub0Bg,3711
 continuo_python_runtime/lint.py,sha256=M59UtCHHVQnJKNolIkvkRk_AgGAFvxD9zkKAMMK-7GI,12984
 continuo_python_runtime/shape.py,sha256=C-5ClSxPYgoO9pUiGqw7pCnmlBbsEl-sIm7Twbf-H4o,3693
 continuo_python_runtime/types.py,sha256=_ssxNE2Lq5782n9_Ihs-u_6ybCCy8XaL6iYbE35tBug,5057
 continuo_python_runtime/contract/__init__.py,sha256=S79x6j_P0CmaSuCGzeWoK1U0507KvD2MZXwQl9DFWMM,37
 continuo_python_runtime/contract/kinds.py,sha256=nirtluv9GU0sZzGF8_-qRIdbeCRtBul_ppNnr6CIEC0,5320
-continuo_python_runtime/contract/loader.py,sha256=uDlOYN6V7KhYhHk2aK34MHxSo3Z8riZw3FZ31Xf1Aqk,18386
-continuo_python_runtime/contract/merge.py,sha256=vN1hA0WSHbUnDyyobW1Z2YYZvU4a0eqwDLS8d_xNGQo,8124
-continuo_python_runtime/contract/model.py,sha256=Dq95CuAcSopumNqP9SlnrxXKhDVeYA55JwBKorhYde4,1435
+continuo_python_runtime/contract/loader.py,sha256=UqmN1RdtlebV3F-kwFcH5DDVbdxcKgnhGR7Sm6HCcMY,18999
+continuo_python_runtime/contract/merge.py,sha256=DCyX9j2TIVgqPmKyFzU-dvy-VX526FZdfcS7-XWxO9c,8381
+continuo_python_runtime/contract/model.py,sha256=uQs0hKkdu55XP6dcbxRFGrMsUe7lSV3QJk1UvOd_3Zo,1474
 continuo_python_runtime/contract/paths.py,sha256=SRn70pJkDAIpXw0IcMU2iNKPKvct8w_SZP2ec-lV91M,1458
 continuo_python_runtime/contract/secret_ref.py,sha256=96jh2G81clpabiEWGIsxbd9r5GKEGLb4Sa1-WJ9G59Q,1131
 continuo_python_runtime/csv_readers/__init__.py,sha256=9TKvjC37C77uRaJQZuO0--zVj2OvuNwpJE6nWx7j2S8,806
@@ -24,9 +24,9 @@ continuo_python_runtime/csv_readers/s3.py,sha256=zmvHs3TxlN2alPKrdaHzPyREmkve2nB
 continuo_python_runtime/validation/__init__.py,sha256=hz5oGXsoaUoygR0_pBby9PS6cEfrre518EE0HGB58eE,79
 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.9.0.dist-info/METADATA,sha256=wUHVQEfqOyqKM7xdRqUXXsJE4AI1aDZQ3x9q3_9zon4,23389
-continuo_python_runtime-0.9.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-continuo_python_runtime-0.9.0.dist-info/entry_points.txt,sha256=ZvIwSm9f9B9ZmZMf6CyF5Zt4QONn8rqaIk-u-B1CF2Y,70
-continuo_python_runtime-0.9.0.dist-info/licenses/LICENSE,sha256=hfXfFCk-8gnps4YvHA6bjCNaSYqOrq2gAdqkXYycAQc,11345
-continuo_python_runtime-0.9.0.dist-info/licenses/NOTICE,sha256=ykgYyQkAMx3uas90FZHzt0aTca9IgJQCLpZ4d74Pl3U,465
-continuo_python_runtime-0.9.0.dist-info/RECORD,,
+continuo_python_runtime-0.10.0.dist-info/METADATA,sha256=3ji0upgqKfQevT-K1R15WiKqSt1XTkHfpbSaqQa33E8,23796
+continuo_python_runtime-0.10.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+continuo_python_runtime-0.10.0.dist-info/entry_points.txt,sha256=ZvIwSm9f9B9ZmZMf6CyF5Zt4QONn8rqaIk-u-B1CF2Y,70
+continuo_python_runtime-0.10.0.dist-info/licenses/LICENSE,sha256=hfXfFCk-8gnps4YvHA6bjCNaSYqOrq2gAdqkXYycAQc,11345
+continuo_python_runtime-0.10.0.dist-info/licenses/NOTICE,sha256=ykgYyQkAMx3uas90FZHzt0aTca9IgJQCLpZ4d74Pl3U,465
+continuo_python_runtime-0.10.0.dist-info/RECORD,,