Skip to content

integrations

integrations

Single-source adapters for the sibling wheels terok depends on.

Every terok_executor / terok_sandbox / terok_clearance / terok_shield import in the codebase routes through this package. When a sibling release renames, splits, or relocates a symbol, only the corresponding adapter needs to change — the rest of terok keeps reading the same terok.lib.integrations.X name.

The boundary is enforced by .importlinter's *-boundary contracts: outside this package, importing a sibling wheel directly is a contract violation.

Testing note: patching terok.lib.integrations.<wheel>.<symbol> only intercepts consumers that import the symbol inside a function. A consumer that binds it at module scope (from …integrations.executor import build_base_images at the top of a file) captures the original at its own import time — patch <that module>.<symbol> instead.