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
Crate Overview
Section titled “Crate Overview”vox-container
Section titled “vox-container”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.
Workspace Dependencies
Section titled “Workspace Dependencies”| Dependency | Kind |
|---|---|
vox-container-types | Normal |
Public API Surface
Section titled “Public API Surface”Modules
Section titled “Modules”| Module | Description |
|---|---|
detect | — |
docker | — |
podman | — |
Functions
Section titled “Functions”| Function | Description |
|---|---|
log_exec_risk | Classify 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
Section titled “Dependency Topology”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}Reverse Dependents (Used By)
Section titled “Reverse Dependents (Used By)”| Consumer Crate | Role |
|---|---|
vox-audit | Direct workspace dependent |
vox-cli | Direct workspace dependent |
vox-cli-research | Direct workspace dependent |
vox-plugin-runtime-container | Direct workspace dependent |
vox-skills | Direct workspace dependent |
Deep Public Symbols (Source-Anchored)
Section titled “Deep Public Symbols (Source-Anchored)”| Kind | Symbol | Signature | Source | Description |
|---|---|---|---|---|
fn | log_exec_risk | pub fn log_exec_risk(raw_command: &str) | crates/vox-container/src/lib.rs#L30-L49 | Classify 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. |
fn | detect::detect_runtime | pub fn detect_runtime(preference: RuntimePreference) -> anyhow::Result<Box<dyn ContainerRuntime>> | crates/vox-container/src/detect.rs#L19-L63 | Detect 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. |
struct | docker::DockerRuntime | pub struct DockerRuntime | crates/vox-container/src/docker.rs#L14 | Docker-backed container runtime. Shells out to the docker CLI. Requires Docker Desktop or Docker Engine to be installed and the daemon to be running. |
fn | docker::new | pub fn new() -> Self | crates/vox-container/src/docker.rs#L18-L20 | Create a new Docker runtime handle. |
struct | podman::PodmanRuntime | pub struct PodmanRuntime | crates/vox-container/src/podman.rs#L15 | Podman-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. |
fn | podman::new | pub fn new() -> Self | crates/vox-container/src/podman.rs#L19-L21 | Create a new Podman runtime handle. |