Struct ExecCommand 

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

Docker exec command builder with fluent API

Fields

executor: CommandExecutor

Command executor for extensibility

Implementations

impl ExecCommand

pub fn new(container: impl Into<String>, command: Vec<String>) -> Self

Create a new exec command for the specified container and command

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["ls".to_string(), "-la".to_string()]);

pub fn detach(self) -> Self

Run in detached mode (background)

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["sleep".to_string(), "10".to_string()])
    .detach();

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

Override the key sequence for detaching a container

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["bash".to_string()])
    .detach_keys("ctrl-p,ctrl-q");

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

Add an environment variable

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["env".to_string()])
    .env("DEBUG", "1")
    .env("LOG_LEVEL", "info");

pub fn envs(self, vars: HashMap<String, String>) -> Self

Add multiple environment variables

Examples

use docker_wrapper::ExecCommand;
use std::collections::HashMap;

let mut env_vars = HashMap::new();
env_vars.insert("DEBUG".to_string(), "1".to_string());
env_vars.insert("LOG_LEVEL".to_string(), "info".to_string());

let exec_cmd = ExecCommand::new("my-container", vec!["env".to_string()])
    .envs(env_vars);

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

Add an environment file

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["env".to_string()])
    .env_file("/path/to/env.file");

pub fn interactive(self) -> Self

Keep STDIN open even if not attached

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["bash".to_string()])
    .interactive();

pub fn privileged(self) -> Self

Give extended privileges to the command

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["mount".to_string()])
    .privileged();

pub fn tty(self) -> Self

Allocate a pseudo-TTY

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["bash".to_string()])
    .tty();

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

Set username or UID (format: “<name|uid>[:<group|gid>]”)

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["whoami".to_string()])
    .user("root");

let exec_cmd2 = ExecCommand::new("my-container", vec!["id".to_string()])
    .user("1000:1000");

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

Set working directory inside the container

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["pwd".to_string()])
    .workdir("/app");

pub fn it(self) -> Self

Convenience method for interactive TTY mode

Examples

use docker_wrapper::ExecCommand;

let exec_cmd = ExecCommand::new("my-container", vec!["bash".to_string()])
    .it();

Trait Implementations

impl Clone for ExecCommand

fn clone(&self) -> ExecCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExecCommand

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

Formats the value using the given formatter.

impl DockerCommand for ExecCommand

type Output = ExecOutput

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)