25 releases (15 breaking)
0.16.7 | May 1, 2024 |
---|---|
0.15.0 | Oct 5, 2023 |
0.14.0 | Jun 1, 2022 |
0.12.0 | Jan 28, 2021 |
0.3.1 | Oct 23, 2018 |
#12 in Testing
118,787 downloads per month
Used in 100 crates
(86 directly)
120KB
2.5K
SLoC
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::*
(useblocking
feature for synchronous API)
Example:
- Blocking API (under
blocking
feature)
use testcontainers::{core::WaitFor, runners::SyncRunner, GenericImage};
#[test]
fn test_redis() {
let container = GenericImage::new("redis", "7.2.4")
.with_exposed_port(6379)
.with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
.start();
}
- Async API
use testcontainers::{core::WaitFor, runners::AsyncRunner, GenericImage};
#[tokio::test]
async fn test_redis() {
let container = GenericImage::new("redis", "7.2.4")
.with_exposed_port(6379)
.with_wait_for(WaitFor::message_on_stdout("Ready to accept connections"))
.start()
.await;
}
Ready-to-use images
The easiest way to use testcontainers
is to depend on ready-to-use images (aka modules).
Modules are available as a community-maintained crate: testcontainers-modules
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Dependencies
~21–34MB
~636K SLoC