Struct ImportCommand 

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

Docker import command builder

Import the contents from a tarball to create a filesystem image.

Example

use docker_wrapper::ImportCommand;

// Import from file
let result = ImportCommand::new("backup.tar")
    .repository("my-app:imported")
    .run()
    .await?;

if result.success() {
    println!("Image imported: {}", result.image_id().unwrap_or("unknown"));
}

Fields

executor: CommandExecutor

Command executor

Implementations

impl ImportCommand

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

Create a new import command

Example

use docker_wrapper::ImportCommand;

// Import from file
let cmd = ImportCommand::new("backup.tar");

// Import from URL
let cmd = ImportCommand::new("http://example.com/image.tar.gz");

// Import from stdin
let cmd = ImportCommand::new("-");

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

Set repository name for the imported image

Example

use docker_wrapper::ImportCommand;

let cmd = ImportCommand::new("backup.tar")
    .repository("my-app:v1.0");

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

Set commit message for the imported image

Example

use docker_wrapper::ImportCommand;

let cmd = ImportCommand::new("backup.tar")
    .message("Imported from production backup");

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

Apply Dockerfile instruction while importing

Example

use docker_wrapper::ImportCommand;

let cmd = ImportCommand::new("backup.tar")
    .change("ENV PATH=/usr/local/bin:$PATH")
    .change("EXPOSE 8080");

pub fn changes<I, S>(self, changes: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Apply multiple Dockerfile instructions while importing

Example

use docker_wrapper::ImportCommand;

let cmd = ImportCommand::new("backup.tar")
    .changes(vec![
        "ENV NODE_ENV=production",
        "EXPOSE 3000",
        "CMD [\"npm\", \"start\"]"
    ]);

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

Execute the import command

Errors

Returns an error if:

• The Docker daemon is not running
• The source file doesn’t exist or is not readable
• The tarball is corrupted or invalid
• Network issues (for URL sources)
• Insufficient disk space

Example

use docker_wrapper::ImportCommand;

let result = ImportCommand::new("app-backup.tar")
    .repository("my-app:restored")
    .message("Restored from backup")
    .run()
    .await?;

if result.success() {
    println!("Import successful!");
    if let Some(image_id) = result.image_id() {
        println!("New image ID: {}", image_id);
    }
}

Trait Implementations

impl Clone for ImportCommand

fn clone(&self) -> ImportCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImportCommand

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

Formats the value using the given formatter.

impl DockerCommand for ImportCommand

type Output = CommandOutput

The output type this command produces

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 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 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)