Crate docker_ctl

docker-ctl

Crate for conveniently starting and stopping docker containers. This crate is a wrapper around the docker command line interface.

Installation

Add docker-ctl to your project with:

cargo add docker-ctl

Example

use docker_ctl::Container;
use std::io::{Read, Write};

// Create a new container, with the `alpine` image in interractive mode.
let mut container = Container::configure("alpine")
  .set_interractive(true)
  .create();

/// Start the container
container.start().unwrap();

/// Run the `echo` command in the container
let mut stdin = container.take_stdin().unwrap();
stdin.write_all(b"echo Hello World!").unwrap();

/// Dropping `stdin` will terminate the container
drop(stdin);

/// Read the output
let mut buf = vec![];
container
  .take_stdout()
  .unwrap()
  .read_to_end(&mut buf)
  .unwrap();

/// Print `Hellow World!\n` characters.
println!("{:?}", buf);

Structs

• Configurator
  Configuration of the container
• Container
  Handle to a container

Enums

• Error
  Represent errors in docker-ctl
• Network
  Network mode, refer to the docker documentation for an explanation on the different modes.

Type Aliases

• Result