Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 796 Commits
.cargo		.cargo
.config		.config
.github		.github
docs		docs
testcontainers		testcontainers
testimages		testimages
.gitignore		.gitignore
.rustfmt.toml		.rustfmt.toml
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
Cargo.toml		Cargo.toml
DESIGN_PRINCIPLES.md		DESIGN_PRINCIPLES.md
LICENSE-Apache-2.0		LICENSE-Apache-2.0
LICENSE-MIT		LICENSE-MIT
Pipfile		Pipfile
Pipfile.lock		Pipfile.lock
README.md		README.md
mkdocs.yml		mkdocs.yml
release-plz.toml		release-plz.toml
requirements.txt		requirements.txt
runtime.txt		runtime.txt

Repository files navigation

Testcontainers-rs

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

Usage

`testcontainers` is the core crate

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

Depend ontestcontainers
Implementtestcontainers::core::Image for necessary docker-images
Run it with any available runnertestcontainers::runners::* (useblocking feature for synchronous API)

Example:

Blocking API (underblocking feature)

use testcontainers::{core::{IntoContainerPort,WaitFor}, runners::SyncRunner,GenericImage,ImageExt};#[test]fntest_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

use testcontainers::{core::{IntoContainerPort,WaitFor}, runners::AsyncRunner,GenericImage,ImageExt};#[tokio::test]asyncfntest_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");}