testcontainers-rs

> DevOps

开源

一个库,用于在 Rust 中对 Docker 容器进行集成测试。

1.1K stars0 点赞1 次浏览

访问官网 GitHub

工具介绍

一个库,用于在 Rust 中对 Docker 容器进行集成测试。

Testcontainers-rs

Testcontainers-rs is the official Rust language fork of http://testcontainers.org.

Usage

`testcontainers` is the core crate

The crate provides an API for working with containers in a test environment.

Depend on testcontainers
Implement testcontainers::core::Image for necessary docker-images
Run it with any available runner testcontainers::runners::* (use blocking feature for synchronous API)

Example:

Blocking API (under blocking feature)

rust

use testcontainers::{core::{IntoContainerPort, WaitFor}, runners::SyncRunner, GenericImage, ImageExt};

#[test]
fn test_redis() {
    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_network("bridge")
        .with_env_var("DEBUG", "1")
        .start()
        .expect("Failed to start Redis");
}

Async API

rust

use testcontainers::{core::{IntoContainerPort, WaitFor}, runners::AsyncRunner, GenericImage, ImageExt};

#[tokio::test]
async fn test_redis() {
    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_network("bridge")
        .with_env_var("DEBUG", "1")
        .start()
        .await
        .expect("Failed to start Redis");
}