v10.2.2

🧹 Maintenance

• Update minor deps @cristianrgreco (#664)

v10.2.1

Changes

🐛 Bug Fixes

• Fix Npipe strategy discovery for Windows @cristianrgreco (#639)

v10.2.0

Changes

🚀 Features

• Add UA header to Docker runtime @cristianrgreco (#637)
• Remove unnecessary ping of container runtime @cristianrgreco (#635)

📖 Documentation

• Update DOCKER_AUTH_CONFIG example in docs @testica (#636)
• Add global testcontainers header to docs @leocross (#633)
• Rename Elastic Search to Elasticsearch in docs @mdelapenya (#634)

🧹 Maintenance

• Update minor deps @cristianrgreco (#638)
• Restructure test workflow @cristianrgreco (#632)

v10.1.0

Changes

🚀 Features

• Add support for targeting a build stage when building a Docker image @ClaytonNorthey92 (#628)

🧹 Maintenance

• Rename src to packages to follow workspaces convention @cristianrgreco (#631)
• Copy README and LICENSE from root to each package on pack @cristianrgreco (#630)
• Improve test coverage of container runtime strategies @cristianrgreco (#627)

v10.0.2

Changes

🐛 Bug Fixes

• Do not call container starting and started lifecycle hooks if container is reused @cristianrgreco (#625)

🧹 Maintenance

• Exclude test-helper from package @cristianrgreco (#626)
• Replace variable value with constant @arty-name (#624)

v10.0.1

Changes

• Update publish workflow.

v10.0.0

🚨 Breaking Changes

Modules have moved to their own packages

Why?

To reduce bloat! Not everyone who installs Testcontainers needs classes and dependencies for Postgres. It's also now much easier to create and contribute new modules. The modules live in the testcontainers organisation on NPM so it's clear which are officially supported.

Previously:

import { GenericContainer, PostgreSqlContainer, MySqlContainer } from "testcontainers";

Now:

import { GenericContainer } from "testcontainers";
import { PostgreSqlContainer } from "@testcontainers/postgresql";
import { MySqlContainer } from "@testcontainers/mysql";

Added a helper for pull policies

Why?

It's a hassle having an import per type of pull policy. Let's simplify the public API.

1. DefaultPullPolicy and AlwaysPullPolicy replaced by PullPolicy.

Previously:

import { GenericContainer, DefaultPullPolicy, AlwaysPullPolicy } from "testcontainers";

const container1 = await GenericContainer
  .fromDockerfile("/path/to/build-context")
  .withPullPolicy(new AlwaysPullPolicy())
  .build();

const container2 = await GenericContainer
  .fromDockerfile("/path/to/build-context")
  .withPullPolicy(new DefaultPullPolicy())
  .build();

After:

import { GenericContainer, PullPolicy } from "testcontainers";

const container1 = await GenericContainer
  .fromDockerfile("/path/to/build-context")
  .withPullPolicy(PullPolicy.alwaysPull())
  .build();

const container2 = await GenericContainer
  .fromDockerfile("/path/to/build-context")
  .withPullPolicy(PullPolicy.defaultPolicy())
  .build();

2. PullPolicy renamed to ImagePullPolicy

Previously:

import { GenericContainer, PullPolicy } from "testcontainers";

class CustomPullPolicy implements PullPolicy {
  public shouldPull(): boolean {
    return true;
  }
}

After:

import { GenericContainer, ImagePullPolicy } from "testcontainers";

class CustomPullPolicy implements ImagePullPolicy {
  public shouldPull(): boolean {
    return true;
  }
}

Removed deprecated container lifecycle callbacks

Why?

Cleaning up the codebase makes it less confusing!

preStart -> beforeContainerCreated
beforeContainerStarted -> beforeContainerCreated
postStart -> containerStarted

Changes

🚀 Features

• Separate testcontainers and modules into workspaces and publish as distinct packages into the testcontainers NPM organisation @cristianrgreco (#621)

v9.12.0

Changes

🚀 Features

• Automatic fallback to docker-compose v2 @cristianrgreco (#620)
• Support copying directories to a started container @cristianrgreco (#614)

🧹 Maintenance

• Await Selenium WebDriver creation in tests @cristianrgreco (#612)

v9.11.0

Changes

🚀 Features

• Support excluding a build image from cleanup by Ryuk @cristianrgreco (#608)
• Create a single Reaper session per parallel test run @cristianrgreco (#597)
• Support copying directories to a container @cristianrgreco (#606)
• Specify mode when copying files/content to a container @cristianrgreco (#604)

🐛 Bug Fixes

• Fix race condition where messages are lost between log consumers @cristianrgreco (#611)

🧹 Maintenance

• Selenium additionally wait for listening ports @cristianrgreco (#609)
• Retry Selenium test suite @cristianrgreco (#607)

v9.10.1

Changes

🧹 Maintenance

• Update dependency minor versions @cristianrgreco (#603)
• Selenium tests work with ARM + Retry for flaky CI @cristianrgreco (#599)