Skip to content
A library for integration-testing against docker containers from within Rust.
Branch: master
Clone or download
bonomat Merge pull request #91 from testcontainers/dependabot/cargo/rusoto_co…

Update rusoto_core requirement from 0.38 to 0.39
Latest commit 45e3a77 May 21, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.githooks Add newline and shebang line Jan 16, 2019
cli_client Upgrade parity container May 5, 2019
core Bump tc_core version to 0.3.0, testcontainers to 0.5.1 Feb 27, 2019
images Upgrade parity container May 5, 2019
testcontainers Update dependencies in lockstep May 21, 2019
.gitignore Adding support for the Amazon DynamoDB local container Dec 13, 2018
.mergify.yml Add .mergify.yml Feb 21, 2019
.travis.yml Fix parity version in travis file May 5, 2019 Restructure crate for better usability Oct 2, 2018
LICENSE-Apache-2.0 Remove appendix from license file Aug 24, 2018
LICENSE-MIT Initial commit for putting testcontainers open-source Aug 21, 2018 Add additional newline to README Jan 17, 2019 Fix typo + ask for `test --all` Feb 28, 2019 Apply suggestions from code review Jan 17, 2019
rust-toolchain Add toolchain file Aug 24, 2018


Build Status Dependabot Status

Testcontainers-rs is the official Rust language fork of


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.


To not make it too inconvenient, the meta crate testcontainers cannot strictly follow semver. Thus you are encouraged to at least depend on the minor version of the library, i.e. X.Y. If you are interested in this crate versioning approach, checkout the release guide.


Licensed under either of

at your option.


While developing, please make sure that your code is formatted using cargo-fmt. You can easily do that by using the pre-defined git hooks:

git config core.hookspath .githooks


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.

You can’t perform that action at this time.