Skip to content

vox-container API Reference (generated)

Crate: vox-container · Version: 0.6.0 · Target: Library (lib.rs)

OCI container runtime abstraction for Vox — supports Docker and Podman

OCI container runtime abstraction for the Vox toolchain.

Provides the [ContainerRuntime] trait, Docker + Podman implementations, and automatic runtime detection (prefer rootless Podman, fall back to Docker).

Pure types live in vox-container-types (L0). This crate (L3) adds the Docker/Podman CLI backends and runtime detection.

Callers wanting the abstract SkillRuntime interface see vox-skill-runtime. Deployment artifact codegen (Dockerfile, Compose, K8s, etc.) is in vox-deploy-codegen.

DependencyKind
vox-container-typesNormal
ModuleDescription
detect—
docker—
podman—
FunctionDescription
log_exec_riskClassify the exec risk of a container image or command string and log the result. Called before any container run dispatch. Uses the exec_grammar risk classifier (from vox-container-types). The result is logged only; nothing enforces on it.
Dependency Topology, diagram 17 nodes, 6 edges: vox-container → vox-container-types; vox-audit → vox-container; vox-cli → vox-container; vox-cli-research → vox-container; vox-plugin-runtime-cont… → vox-container; vox-skills → vox-containervox-containervox-container-typesvox-auditvox-clivox-cli-researchvox-plugin-runtime-containervox-skills
Diagram source
graph {
direction: right
node vox_container: "vox-container"
node vox_container_types: "vox-container-types"
vox_container -> vox_container_types
node vox_audit: "vox-audit"
vox_audit -> vox_container
node vox_cli: "vox-cli"
vox_cli -> vox_container
node vox_cli_research: "vox-cli-research"
vox_cli_research -> vox_container
node vox_plugin_runtime_container: "vox-plugin-runtime-container"
vox_plugin_runtime_container -> vox_container
node vox_skills: "vox-skills"
vox_skills -> vox_container
}
Consumer CrateRole
vox-auditDirect workspace dependent
vox-cliDirect workspace dependent
vox-cli-researchDirect workspace dependent
vox-plugin-runtime-containerDirect workspace dependent
vox-skillsDirect workspace dependent
KindSymbolSignatureSourceDescription
fnlog_exec_riskpub fn log_exec_risk(raw_command: &str)crates/vox-container/src/lib.rs#L30-L49Classify the exec risk of a container image or command string and log the result. Called before any container run dispatch. Uses the exec_grammar risk classifier (from vox-container-types). The result is logged only; nothing enforces on it.
fndetect::detect_runtimepub fn detect_runtime(preference: RuntimePreference) -> anyhow::Result<Box<dyn ContainerRuntime>>crates/vox-container/src/detect.rs#L19-L63Detect and return the best available container runtime. With [RuntimePreference::Auto], Podman is preferred because it runs rootless without a daemon. If neither runtime is available, returns an error.
structdocker::DockerRuntimepub struct DockerRuntimecrates/vox-container/src/docker.rs#L14Docker-backed container runtime. Shells out to the docker CLI. Requires Docker Desktop or Docker Engine to be installed and the daemon to be running.
fndocker::newpub fn new() -> Selfcrates/vox-container/src/docker.rs#L18-L20Create a new Docker runtime handle.
structpodman::PodmanRuntimepub struct PodmanRuntimecrates/vox-container/src/podman.rs#L15Podman-backed container runtime. Shells out to the podman CLI. Runs rootless by default — no daemon required. Uses OCI image format for maximum compatibility with Docker registries and tooling.
fnpodman::newpub fn new() -> Selfcrates/vox-container/src/podman.rs#L19-L21Create a new Podman runtime handle.