Zakaria
39 lines
2.0 KiB
Markdown
39 lines
2.0 KiB
Markdown
# Testcontainers
|
|
|
|
Floci has first-class Testcontainers modules for every major SDK language. Each module starts a real Floci container before your tests run and tears it down after — no running daemon, no shared state, no port conflicts.
|
|
|
|
## Available modules
|
|
|
|
For Testcontainers 1.x, use the versions as indicated in the table below.
|
|
|
|
| Language | Package | Version | Registry | Source |
|
|
|---|---|---|---|---|
|
|
| Java | `io.floci:testcontainers-floci` | `1.14.0` | [Maven Central](https://mvnrepository.com/artifact/io.floci/testcontainers-floci) | [GitHub](https://github.com/floci-io/testcontainers-floci) |
|
|
| Node.js | `@floci/testcontainers` | `0.1.0` | [npm](https://www.npmjs.com/package/@floci/testcontainers) | [GitHub](https://github.com/floci-io/testcontainers-floci-node) |
|
|
| Python | `testcontainers-floci` | `0.1.1` | [PyPI](https://pypi.org/project/testcontainers-floci/) | [GitHub](https://github.com/floci-io/testcontainers-floci-python) |
|
|
| .NET | `Testcontainers.Floci` | see releases | [GitHub Packages](https://github.com/orgs/floci-io/packages?repo_name=testcontainers-floci-dotnet) | [GitHub](https://github.com/floci-io/testcontainers-floci-dotnet) |
|
|
| Go | — | 🚧 In progress | — | [GitHub](https://github.com/floci-io/testcontainers-floci-go) |
|
|
|
|
For Testcontainers 2.x / Spring Boot 4.x, use version `2.15.0`.
|
|
|
|
## How it works
|
|
|
|
Every module exposes a `FlociContainer` class that wraps the official `floci/floci:latest` Docker image. When the container starts it waits for port 4566 to be ready, then exposes:
|
|
|
|
| Method | Returns |
|
|
|---|---|
|
|
| `getEndpoint()` | `http://localhost:<mapped-port>` |
|
|
| `getRegion()` | `us-east-1` (default) |
|
|
| `getAccessKey()` | `test` |
|
|
| `getSecretKey()` | `test` |
|
|
|
|
You pass these values directly into any AWS SDK client — no manual configuration, no environment variables.
|
|
|
|
## Language guides
|
|
|
|
- [Java](java.md) — JUnit 5, Spring Boot `@ServiceConnection`
|
|
- [Node.js / TypeScript](nodejs.md) — Jest, Vitest
|
|
- [Python](python.md) — pytest
|
|
- [.NET](dotnet.md): xUnit
|
|
- [Go](go.md) — in progress
|