#docker #testcontainers


Core crate of testcontainers, a library for integration-testing against docker containers from within Rust

2 unstable releases

0.2.0 Oct 23, 2018
0.1.0 Oct 3, 2018

#6 in #testcontainers

Download history 2/week @ 2018-10-30 29/week @ 2018-11-06 8/week @ 2018-11-13 14/week @ 2018-11-20 4/week @ 2018-11-27 30/week @ 2018-12-04 46/week @ 2018-12-11 17/week @ 2018-12-18 34/week @ 2018-12-25 3/week @ 2019-01-01 4/week @ 2019-01-08 7/week @ 2019-01-15 20/week @ 2019-01-22

24 downloads per month
Used in 13 crates (10 directly)


203 lines


Build Status Crates.io Docs.rs Dependabot Status

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


TL:DR: Depend on testcontainers, this will give you everything you need.

Check the integration tests on how to use the library.


The repository is structured into the several crates.

  • core: Contains the core traits and structs necessary for the testcontainers ecosystem.
  • cli_client: Contains an implementation of the Docker trait that uses the docker-CLI to issue commands.
  • The folder images contains several crates named after the respective docker image. Each crate adds support for one particular image. This allows to selectively import the images you need.

Last but not least: testcontainers: This is a meta crate that bundles all these crates together for convenient usage.


Licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.