docker-ctl 0.2.5

Crate for conveniently starting and stopping docker containers.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

<div align="center">

[![docs](https://docs.rs/docker-ctl/badge.svg)](https://docs.rs/docker-ctl)
[![crates.io](https://img.shields.io/crates/v/docker-ctl.svg)](https://crates.io/crates/docker-ctl)
</div>

docker-ctl
==========

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

This crate is considered to be complete, and is in low maintenance mode. You are welcome to contribute support for more docker command via pull requests.

Installation
------------

Add `docker-ctl` to your project with:

```bash
cargo add docker-ctl
```

Example
-------

```rust
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_interactive(true)
  .set_capture_stdio(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);
```