Struct CreateCommand 

pub struct CreateCommand {
    pub executor: CommandExecutor,
    /* private fields */
}

Docker create command builder

Create a new container without starting it. This is useful for preparing containers that will be started later.

Example

use docker_wrapper::CreateCommand;

// Create a simple container
let result = CreateCommand::new("alpine:latest")
    .name("my-container")
    .run()
    .await?;

println!("Created container: {}", result.container_id());

Fields

executor: CommandExecutor

Command executor

Implementations

impl CreateCommand

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

Create a new create command

Example

use docker_wrapper::CreateCommand;

let cmd = CreateCommand::new("nginx:latest");

pub fn name(self, name: impl Into<String>) -> Self

Set the container name

Example

use docker_wrapper::CreateCommand;

let cmd = CreateCommand::new("alpine:latest")
    .name("my-container");

pub fn cmd(self, command: Vec<impl Into<String>>) -> Self

Set the command to run in the container

Example

use docker_wrapper::CreateCommand;

let cmd = CreateCommand::new("alpine:latest")
    .cmd(vec!["echo", "hello world"]);

pub fn env(self, key: impl Into<String>, value: impl Into<String>) -> Self

Add an environment variable

Example

use docker_wrapper::CreateCommand;

let cmd = CreateCommand::new("alpine:latest")
    .env("KEY", "value")
    .env("DEBUG", "true");

pub fn port(self, host_port: u16, container_port: u16) -> Self

Add a port mapping

Example

use docker_wrapper::CreateCommand;

let cmd = CreateCommand::new("nginx:latest")
    .port(8080, 80);

pub fn workdir(self, workdir: impl Into<String>) -> Self

Set working directory

pub fn user(self, user: impl Into<String>) -> Self

Set user

pub fn hostname(self, hostname: impl Into<String>) -> Self

Set hostname

pub fn attach_stdin(self) -> Self

Attach to STDIN

pub fn attach_stdout(self) -> Self

Attach to STDOUT

pub fn attach_stderr(self) -> Self

Attach to STDERR

pub fn interactive(self) -> Self

Enable interactive mode

pub fn tty(self) -> Self

Allocate a pseudo-TTY

pub fn volume(self, volume: impl Into<String>) -> Self

Add a volume mount

Example

use docker_wrapper::CreateCommand;

let cmd = CreateCommand::new("alpine:latest")
    .volume("/host/path:/container/path")
    .volume("/host/data:/data:ro");

pub fn label(self, label: impl Into<String>) -> Self

Add a label

pub fn memory(self, memory: impl Into<String>) -> Self

Set memory limit

pub fn cpus(self, cpus: impl Into<String>) -> Self

Set CPU limit

pub fn network(self, network: impl Into<String>) -> Self

Set network mode

pub async fn run(&self) -> Result<CreateResult>

Execute the create command

Errors

Returns an error if:

• The Docker daemon is not running
• The specified image doesn’t exist
• Invalid configuration options

Example

use docker_wrapper::CreateCommand;

let result = CreateCommand::new("alpine:latest")
    .name("test-container")
    .cmd(vec!["echo", "hello"])
    .run()
    .await?;

if result.success() {
    println!("Created container: {}", result.container_id());
}

Trait Implementations

impl Clone for CreateCommand

fn clone(&self) -> CreateCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CreateCommand

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

Formats the value using the given formatter.

impl DockerCommand for CreateCommand

type Output = CommandOutput

The output type this command produces

fn get_executor(&self) -> &CommandExecutor

Get the command executor for extensibility

fn get_executor_mut(&mut self) -> &mut CommandExecutor

Get mutable command executor for extensibility

fn build_command_args(&self) -> Vec<String>

Build the complete command arguments including subcommands

fn execute<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Self::Output>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute the command and return the typed output

fn execute_command<'life0, 'async_trait>( &'life0 self, command_args: Vec<String>, ) -> Pin<Box<dyn Future<Output = Result<CommandOutput>> + Send + 'async_trait>>

where Self: Sync + 'async_trait, 'life0: 'async_trait,

Helper method to execute the command with proper error handling

fn arg<S: AsRef<OsStr>>(&mut self, arg: S) -> &mut Self

Add a raw argument to the command (escape hatch)

fn args<I, S>(&mut self, args: I) -> &mut Self

where I: IntoIterator<Item = S>, S: AsRef<OsStr>,

Add multiple raw arguments to the command (escape hatch)

fn flag(&mut self, flag: &str) -> &mut Self

Add a flag option (e.g., –detach, –rm)

fn option(&mut self, key: &str, value: &str) -> &mut Self

Add a key-value option (e.g., –name value, –env key=value)