Metadata-Version: 2.4
Name: dirigent-block-execute
Version: 0.17.3
Summary: The execute block family for dirigent: shell, docker, compose, buildx, and a checkout.
License-Expression: LicenseRef-Proprietary
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: dirigent-block-http==0.17.3
Requires-Dist: dirigent-common==0.17.3
Requires-Dist: dirigent-plugin==0.17.3
Requires-Dist: httpx2>=2.12.0
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# dirigent-block-execute

The execute block family: everything that runs something on the worker. `shell.run` a command,
`docker.run` a container, `docker.compose.up` and `docker.compose.down` a stack, `docker.build`
an image, and `git.checkout` a working tree.

These are the blocks that declare themselves unsafe, because what they run is the step's own
code rather than a call to a service. The family registers the `docker` and `git` connection
kinds, and carries the shared internals the six have in common: process containment, output
capture, the environment allowlist, and the on-disk credential material a tool has to be
handed. `dg reap` uses the same internals to clear what a run left behind.
