Struct LoginCommand 

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

Command for authenticating with Docker registries

The LoginCommand provides a builder pattern for constructing Docker login commands with various authentication options including username/password, token-based auth, and different registry endpoints.

Examples

use docker_wrapper::LoginCommand;

// Login to Docker Hub
let login = LoginCommand::new("myusername", "mypassword");

// Login to private registry
let login = LoginCommand::new("user", "pass")
    .registry("my-registry.com");

// Login with stdin password (more secure)
let login = LoginCommand::new("user", "")
    .password_stdin();

Fields

executor: CommandExecutor

Command executor for running the command

Implementations

impl LoginCommand

pub fn new(username: impl Into<String>, password: impl Into<String>) -> Self

Creates a new login command with username and password

Arguments

• username - The username for authentication
• password - The password for authentication (can be empty if using stdin)

Examples

use docker_wrapper::LoginCommand;

let login = LoginCommand::new("myuser", "mypass");

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

Sets the registry server for authentication

If not specified, defaults to Docker Hub (index.docker.io)

Arguments

• registry - The registry server URL

Examples

use docker_wrapper::LoginCommand;

let login = LoginCommand::new("user", "pass")
    .registry("gcr.io");

pub fn password_stdin(self) -> Self

Enables reading password from stdin for security

When enabled, the password field is ignored and Docker will prompt for password input via stdin.

Examples

use docker_wrapper::LoginCommand;

let login = LoginCommand::new("user", "")
    .password_stdin();

pub fn executor(self, executor: CommandExecutor) -> Self

Sets a custom command executor

Arguments

• executor - Custom command executor

pub fn get_username(&self) -> &str

Gets the username

pub fn get_registry(&self) -> Option<&str>

Gets the registry (if set)

pub fn is_password_stdin(&self) -> bool

Returns true if password will be read from stdin

pub fn get_executor(&self) -> &CommandExecutor

Get a reference to the command executor

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

Get a mutable reference to the command executor

Trait Implementations

impl Clone for LoginCommand

fn clone(&self) -> LoginCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LoginCommand

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

Formats the value using the given formatter.

impl Default for LoginCommand

fn default() -> Self

Returns the “default value” for a type.

impl Display for LoginCommand

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

Formats the value using the given formatter.

impl DockerCommand for LoginCommand

type Output = LoginOutput

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)