Botica.Runner.Executor (Botica v2.0.0)

Executes health checks in parallel with timeout support.

This module provides the core execution engine for Botica checks, running them in parallel while respecting timeout constraints.

Summary

execute(config)

Executes all checks in parallel and returns structured results.

Executes checks sequentially (for debugging or ordered execution).

@spec execute(Botica.Types.config()) ::
  {:ok, [Botica.Types.result()]} | {:error, String.t()}

Executes all checks in parallel and returns structured results.

:timeout - Global timeout in milliseconds for each check (default: 30_000)
:stop_on_first_error - Stop executing remaining checks after first error
:continue_on_error - Continue executing checks even if some fail (default: true)

Individual checks can specify their own timeout in their definition:

%{
  id: :slow_check,
  timeout: 5000,  # This check gets 5 seconds instead of global 30s
  check: fn -> ... end
}

When a check times out, it returns an error result with a descriptive message. The timeout is applied per-check, not for the entire run.

@spec execute(Botica.Types.config(), Botica.Types.executor_options()) ::
  {:ok, [Botica.Types.result()]} | {:error, String.t()}

@spec execute_sequential(Botica.Types.config()) ::
  {:ok, [Botica.Types.result()]} | {:error, String.t()}

Executes checks sequentially (for debugging or ordered execution).