#docker #container #starting

docker-ctl

Crate for conveniently starting and stopping docker containers

3 unstable releases

new 0.2.1 Oct 21, 2024
0.2.0 Sep 10, 2024
0.1.0 Sep 6, 2024

#555 in Unix APIs

Download history 102/week @ 2024-09-02 153/week @ 2024-09-09 44/week @ 2024-09-16 21/week @ 2024-09-23 8/week @ 2024-09-30 1/week @ 2024-10-07

77 downloads per month

MIT license

16KB
438 lines

docs crates.io

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

Dependencies

~0.6–26MB
~376K SLoC