package testcontainers

testcontainers-ocaml

Lightweight, throwaway instances of databases, message brokers, or any service that runs in a Docker container. Enables reliable integration testing with real services instead of mocks.

Installation

opam install testcontainers

Quick Example

open Lwt.Syntax
open Testcontainers_postgres

let () = Lwt_main.run (
  Postgres_container.with_postgres (fun _container conn_str ->
    Printf.printf "PostgreSQL: %s\n" conn_str;
    Lwt.return_unit
  )
)

Running Examples

# Clone the repository
git clone https://github.com/benodiwal/testcontainers_ocaml.git
cd testcontainers_ocaml

# Install dependencies
opam install . --deps-only

# Run examples
dune exec examples/basic_example.exe
dune exec examples/postgres_example.exe
dune exec examples/redis_example.exe
dune exec examples/mysql_example.exe
dune exec examples/mongo_example.exe
dune exec examples/kafka_example.exe
dune exec examples/elasticsearch_example.exe
dune exec examples/localstack_example.exe
dune exec examples/memcached_example.exe
dune exec examples/mockserver_example.exe

Available Modules

Documentation

Full documentation: https://benodiwal.github.io/testcontainers-ocaml

• Getting Started
• Core Concepts
• API Reference

Requirements

• OCaml >= 5.0
• Docker

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

Apache-2.0