Struct ContainerId 

pub struct ContainerId(pub String);

Container ID returned by docker run

Tuple Fields

0: String

Implementations

impl ContainerId

pub fn as_str(&self) -> &str

Get the container ID as a string

pub fn short(&self) -> &str

Get the short form of the container ID (first 12 characters)

pub async fn port_mappings(&self) -> Result<Vec<PortMappingInfo>>

Get port mappings for this container

This queries Docker for the actual mapped ports of the running container. Useful when using dynamic port allocation (e.g., -p 6379 without specifying host port).

Example

use docker_wrapper::{DockerCommand, RunCommand};

// Run Redis with dynamic port allocation
let container_id = RunCommand::new("redis:alpine")
    .name("my-redis")
    .port_dyn(6379)  // Dynamic port allocation
    .detach()
    .rm()
    .execute()
    .await?;

// Get the actual mapped port
let port_mappings = container_id.port_mappings().await?;
if let Some(mapping) = port_mappings.first() {
    println!("Redis is available at {}:{}", mapping.host_ip, mapping.host_port);
}

Errors

Returns an error if:

• The container doesn’t exist or has been removed
• The Docker daemon is not running
• There’s a communication error with Docker

pub async fn port_mapping( &self, container_port: u16, ) -> Result<Option<PortMappingInfo>>

Get a specific port mapping for this container

Example

use docker_wrapper::{DockerCommand, RunCommand};

let container_id = RunCommand::new("nginx:alpine")
    .port_dyn(80)
    .detach()
    .rm()
    .execute()
    .await?;

// Get the mapping for port 80
if let Some(mapping) = container_id.port_mapping(80).await? {
    println!("Nginx is available at {}:{}", mapping.host_ip, mapping.host_port);
}

Errors

Returns an error if:

• The container doesn’t exist or has been removed
• The Docker daemon is not running
• There’s a communication error with Docker

Trait Implementations

impl Clone for ContainerId

fn clone(&self) -> ContainerId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContainerId

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

Formats the value using the given formatter.

impl Display for ContainerId

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

Formats the value using the given formatter.

impl PartialEq for ContainerId

fn eq(&self, other: &ContainerId) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ContainerId

impl StructuralPartialEq for ContainerId