testcontainers_gleam - v2.0.0

testcontainers_gleam/wait_strategy

Wait strategies to determine when a container is ready.

A wait strategy is passed to container.with_waiting_strategy to tell testcontainers how to detect that a container has finished starting.

Example

import testcontainers_gleam/container
import testcontainers_gleam/wait_strategy

container.new("postgres:16-alpine")
|> container.with_exposed_port(5432)
|> container.with_waiting_strategy(
  wait_strategy.port("0.0.0.0", 5432, 5000, 500),
)

Types

WaitStrategy

</>

Opaque type wrapping an Elixir wait strategy struct.

Construct with port, log, or command.

pub type WaitStrategy

Values

command

</> 
pub fn command(
  cmd: List(String),
  timeout: Int,
  retry_delay: Int,
) -> WaitStrategy

Wait until command exits with status 0 inside the container.

Retries every retry_delay ms, giving up after timeout ms.

log

</> 
pub fn log(
  pattern: String,
  timeout: Int,
  retry_delay: Int,
) -> WaitStrategy

Wait until a container log line matches pattern.

The pattern is compiled to an Elixir Regex before being passed to the underlying LogWaitStrategy. Retries every retry_delay ms, giving up after timeout ms.

port

</> 
pub fn port(
  ip: String,
  port: Int,
  timeout: Int,
  retry_delay: Int,
) -> WaitStrategy

Wait until the given port on ip accepts TCP connections.

Retries every retry_delay ms, giving up after timeout ms.

✨ Search Document