Struct TestcontainerBackend 

pub struct TestcontainerBackend { /* private fields */ }

Testcontainers backend for containerized execution

Implementations

impl TestcontainerBackend

pub fn new(image: impl Into<String>) -> Result<Self>

Create a new testcontainers backend

pub fn with_policy(self, policy: Policy) -> Self

Create with custom policy

pub fn with_timeout(self, timeout: Duration) -> Self

Create with custom execution timeout

pub fn with_startup_timeout(self, timeout: Duration) -> Self

Create with custom startup timeout

pub fn is_running(&self) -> bool

Check if the backend is running

pub fn with_env(self, key: &str, val: &str) -> Self

Add environment variable to container

pub fn with_cmd(self, cmd: Vec<String>) -> Self

Set default command for container

pub fn with_volume( self, host_path: &str, container_path: &str, read_only: bool, ) -> Result<Self>

Add volume mount

Arguments

• host_path - Path on the host system
• container_path - Path inside the container
• read_only - Whether mount is read-only

Errors

Returns error if volume validation fails

pub fn with_volume_ro( self, host_path: &str, container_path: &str, ) -> Result<Self>

Add read-only volume mount

Convenience method for adding read-only mounts

pub fn with_volume_validator(self, validator: VolumeValidator) -> Self

Set volume validator with custom whitelist

pub fn volumes(&self) -> &[VolumeMount]

Get volume mounts

pub fn with_memory_limit(self, limit_mb: u64) -> Self

Set memory limit in MB

pub fn with_cpu_limit(self, cpus: f64) -> Self

Set CPU limit (number of CPUs)

pub fn with_determinism(self, engine: Arc<DeterminismEngine>) -> Self

Set determinism engine for reproducible execution

Arguments

• engine - DeterminismEngine with configured seed, clock freezing, etc.

pub fn is_available() -> bool

Check if testcontainers is available

pub fn validate_otel_instrumentation(&self) -> Result<bool>

Validate OpenTelemetry instrumentation (if enabled)

This method validates that OTel spans are created correctly during container operations. Following core team standards:

• No .unwrap() or .expect()
• Sync method (dyn compatible)
• Returns Result<T, CleanroomError>

pub fn otel_validation_enabled(&self) -> bool

Get OpenTelemetry validation status

Trait Implementations

impl Backend for TestcontainerBackend

fn run_cmd(&self, cmd: Cmd) -> Result<RunResult>

Run a command in the backend

fn name(&self) -> &str

Get the name of the backend

fn is_available(&self) -> bool

Check if the backend is available

fn supports_hermetic(&self) -> bool

Check if the backend supports hermetic execution

fn supports_deterministic(&self) -> bool

Check if the backend supports deterministic execution

impl Clone for TestcontainerBackend

fn clone(&self) -> TestcontainerBackend

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TestcontainerBackend

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.