testcontainers-ext 0.1.0

Utilities collection of extension traits for testcontainers-rs.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

# Testcontainers-ext

[![Crates.io](https://img.shields.io/crates/v/testcontainers-ext.svg)](https://crates.io/crates/testcontainers-ext)
[![Docs.rs](https://docs.rs/testcontainers-ext/badge.svg)](https://docs.rs/testcontainers-ext)

Testcontainers-ext is a utilities collection of extension traits for testcontainers-rs.

## Install

```bash
# or cargo add testcontainers-ext
cargo install testcontainers-ext
```

## Usage

- ImagePruneExistedLabelExt / with_prune_existed_label

```rust
use testcontainers::{core::{IntoContainerPort, WaitFor}, runners::SyncRunner, GenericImage, ImageExt};
use testcontainers_ext::ImagePruneExistedLabelExt;
use anyhow::Result;

#[tokio::test]
async fn test () -> Result<()> {
    let container = GenericImage::new("redis", "7.2.4")
        .with_exposed_port(6379.tcp())
        .with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
        .with_prune_existed_label(
            "my-project-scope",
            "redis",
            true,
            true
        ).await?
        .start()
        .await?;
    Ok(())
}
```

- ImageDefaultLogConsumerExt / with_default_log_consumer

```rust
use testcontainers::{core::{IntoContainerPort, WaitFor}, runners::SyncRunner, GenericImage, ImageExt};
use testcontainers_rs_ext::ImageDefaultLogConsumerExt;
use anyhow::Result;

#[tokio::test]
async fn test () -> Result<()> {
    let container = GenericImage::new("redis", "7.2.4")
        .with_exposed_port(6379.tcp())
        .with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
        .with_default_log_consumer()
        .start()
        .await?;
    Ok(())
}
```

### Ready-to-use images

The easiest way to use `testcontainers` is to depend on ready-to-use images (aka modules).

Modules are available as a community-maintained crate: [testcontainers-modules](https://github.com/testcontainers/testcontainers-rs-modules-community)

## License

Licensed under

- MIT license
  ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)