testcontainers_dart 0.2.0
testcontainers_dart: ^0.2.0 copied to clipboard
Disposable Docker containers for Dart integration tests, with readiness checks, logs, exec and cleanup.
0.2.0 #
- Upgrade to
docker_engine0.2.0 with Docker Engine API support through v1.55. - Breaking: Default to
PullPolicy.ifNotPresentfor application and Ryuk images instead of always pulling. Addalwaysandneverpolicies to both configurations; inspect failures other than 404 are propagated without pulling. - Require Dart 3.13.7 and adopt primary constructors,
Future.pauseand typed unmodifiable list copies without changing container lifecycle behavior. - Remove the 1000-line readiness limit: log waits search all available history.
Add
logs(tail: null)to read all history, retaining the default snapshot tail. - Add lazy
StartedContainer.logsStream()with stdout/stderr chunks, TTY detection, historical tail selection and cancellation without closing shared connections. - Breaking: Rename the readiness interface from
WaitStrategytoWaitand move theWait.for...helpers into factory constructors on that interface. - Split readiness strategies into separate files with a shared wait export.
- Handle Ryuk socket write errors during connection retries without unhandled asynchronous exceptions.
- Add default-on, per-provider Ryuk sessions for crash cleanup, with reserved session labels, acknowledged filter registration and configurable image, daemon socket, port binding and connection timeout.
- Breaking:
DockerProvider.close()now ends the Ryuk session and triggers delayed cleanup of remaining containers. Disable Ryuk to retain connection-only close behavior. Theorg.testcontainerslabel namespace is now reserved. - Test handshake failures, concurrent startup, startup rollback, process exit and
real-Docker cleanup after
SIGKILL, including isolation between sessions.
0.1.0 #
- Use the package name
testcontainers_dartand the matching public library. - Name the container launch configuration
ContainerConfig. - Move into a Pub workspace and depend on the standalone
docker_enginepackage; keep public Testcontainers imports and Docker configuration/errors available. - Implement generic async container lifecycle, env/command/ports/bind mounts, inspect, multiplexed logs and exec output.
- Add Unix/TCP connections, API negotiation, request timeouts and explicit cleanup.
- Add TCP/log/HTTP/healthcheck/exec/composite readiness strategies.
- Cover the core with unit and local socket tests; add an opt-in Docker smoke test.