34 releases (10 breaking)

0.14.0-beta.1 Jun 19, 2023
0.11.4 Nov 12, 2024
0.11.3 Oct 17, 2024
0.9.0 Jul 30, 2024
0.1.0-beta.1 Jun 28, 2023

#22 in Testing

Download history 17898/week @ 2024-08-13 13605/week @ 2024-08-20 17898/week @ 2024-08-27 19689/week @ 2024-09-03 16037/week @ 2024-09-10 14037/week @ 2024-09-17 17203/week @ 2024-09-24 17347/week @ 2024-10-01 13757/week @ 2024-10-08 17729/week @ 2024-10-15 18031/week @ 2024-10-22 17559/week @ 2024-10-29 16783/week @ 2024-11-05 17619/week @ 2024-11-12 18837/week @ 2024-11-19 16450/week @ 2024-11-26

74,445 downloads per month
Used in 46 crates (43 directly)

MIT license

270KB
5K SLoC

testcontainers-modules

Continuous Integration Crates.io Docs.rs

Community maintained modules for testcontainers

Provides modules to use for testing components in accordance with testcontainers-rs. Every module is treated as a feature inside this crate.

Usage

  1. Depend on testcontainers-modules with necessary features (e.g postgres, minio and etc)
    • Enable blocking feature if you want to use modules within synchronous tests (feature-gate for SyncRunner)
  2. Then start using the modules inside your tests with either AsyncRunner or SyncRunner

Simple example of using postgres module with SyncRunner (blocking and postgres features enabled):

use testcontainers_modules::{postgres, testcontainers::runners::SyncRunner};

#[test]
fn test_with_postgres() {
    let container = postgres::Postgres::default().start().unwrap();
    let host_ip = container.get_host().unwrap();
    let host_port = container.get_host_port_ipv4(5432).unwrap();
}

Note: you don't need to explicitly depend on testcontainers as it's re-exported dependency of testcontainers-modules with aligned version between these crates. For example:

use testcontainers_modules::testcontainers::ImageExt;

You can also see examples for more details.

How to override module defaults (version, tag, ENV-variables)

Just use RunnableImage:

use testcontainers_modules::{
    redis::Redis,
    testcontainers::{ContainerRequest, ImageExt}
};


/// Create a Redis module with `6.2-alpine` tag and custom password
fn create_redis() -> ContainerRequest<Redis> {
    Redis::default()
        .with_tag("6.2-alpine")
        .with_env_var("REDIS_PASSWORD", "my_secret_password")
}

License

Dependencies

~23–40MB
~749K SLoC