testcontainers 0.27.3

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

use std::{fmt, io::BufRead, sync::Arc};

use crate::{
    core::{async_container, sync_container::sync_reader},
    TestcontainersError,
};

/// Represents the result of an executed command in a container.
pub struct SyncExecResult {
    pub(super) inner: async_container::exec::ExecResult,
    pub(super) runtime: Arc<tokio::runtime::Runtime>,
}

impl SyncExecResult {
    /// Returns the exit code of the executed command.
    /// If the command has not yet exited, this will return `None`.
    pub fn exit_code(&self) -> Result<Option<i64>, TestcontainersError> {
        self.runtime.block_on(self.inner.exit_code())
    }

    /// Returns an asynchronous reader for stdout.
    pub fn stdout<'b>(&'b mut self) -> Box<dyn BufRead + Send + 'b> {
        Box::new(sync_reader::SyncReadBridge::new(
            self.inner.stdout(),
            self.runtime.clone(),
        ))
    }

    /// Returns an asynchronous reader for stderr.
    pub fn stderr<'b>(&'b mut self) -> Box<dyn BufRead + Send + 'b> {
        Box::new(sync_reader::SyncReadBridge::new(
            self.inner.stderr(),
            self.runtime.clone(),
        ))
    }

    /// Returns stdout as a vector of bytes.
    /// Keep in mind that this will block until the command exits.
    ///
    /// If you want to read stderr in chunks, use [`SyncExecResult::stdout`] instead.
    pub fn stdout_to_vec(&mut self) -> Result<Vec<u8>, TestcontainersError> {
        self.runtime.block_on(self.inner.stdout_to_vec())
    }

    /// Returns stderr as a vector of bytes.
    /// Keep in mind that this will block until the command exits.
    ///
    /// If you want to read stderr in chunks, use [`SyncExecResult::stderr`] instead.
    pub fn stderr_to_vec(&mut self) -> Result<Vec<u8>, TestcontainersError> {
        self.runtime.block_on(self.inner.stderr_to_vec())
    }
}

impl fmt::Debug for SyncExecResult {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.debug_struct("ExecResult")
            .field("id", &self.inner.id)
            .finish()
    }
}