testcontainers 0.15.0

A library for integration-testing against docker containers from within Rust.
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
72

use std::net::{Ipv6Addr, TcpListener};

use testcontainers::{clients, core::WaitFor, GenericImage};

/// Test the functionality of exposing container ports over both IPv4 and IPv6.
#[tokio::test]
async fn test_ipv4_ipv6_host_ports() {
    let _ = pretty_env_logger::try_init();
    let docker = clients::Cli::default();

    let wait_for = WaitFor::message_on_stdout("server is ready");
    let image = GenericImage::new("simple_web_server", "latest").with_wait_for(wait_for.clone());

    // Run one container, and check what ephemeral ports it uses. Perform test HTTP requests to
    // both bound ports.
    let first_container = docker.run(image.clone());
    let first_ipv4_port = first_container.get_host_port_ipv4(80);
    let first_ipv6_port = first_container.get_host_port_ipv6(80);
    assert_eq!(
        "foo",
        reqwest::get(&format!("http://127.0.0.1:{first_ipv4_port}"))
            .await
            .unwrap()
            .text()
            .await
            .unwrap(),
    );
    assert_eq!(
        "foo",
        reqwest::get(&format!("http://[::1]:{first_ipv6_port}"))
            .await
            .unwrap()
            .text()
            .await
            .unwrap(),
    );

    // Bind to several subsequent ports in the ephemeral range, only on IPv6. This should cause
    // Docker's IPv4 and IPv6 port allocation to no longer be in lock step, (if they were before)
    // as the IPv6 allocator would have to skip the ports we grabbed.
    let mut sockets = Vec::new();
    for port in first_ipv6_port + 1..first_ipv6_port + 9 {
        if let Ok(socket) = TcpListener::bind((Ipv6Addr::LOCALHOST, port)) {
            sockets.push(socket);
        }
    }

    // Run a second container, and repeat test HTTP requests with it. This confirms that handling
    // of both IPv4 and IPv6 host port bindings is correct, because at this point,
    // `second_ipv4_port` and `second_ipv6_port` are very unlikely to be the same.
    let second_container = docker.run(image);
    let second_ipv4_port = second_container.get_host_port_ipv4(80);
    let second_ipv6_port = second_container.get_host_port_ipv6(80);
    assert_eq!(
        "foo",
        reqwest::get(&format!("http://127.0.0.1:{second_ipv4_port}"))
            .await
            .unwrap()
            .text()
            .await
            .unwrap(),
    );
    assert_eq!(
        "foo",
        reqwest::get(&format!("http://[::1]:{second_ipv6_port}"))
            .await
            .unwrap()
            .text()
            .await
            .unwrap(),
    );
}