Kinda.Testing.Lifecycle (kinda v0.12.0)

Copy Markdown View Source

Deterministic lifecycle scenarios for owned native resources.

The caller supplies release and probe callbacks, so production resources do not need test hooks. Every scenario uses a stable seed and reports the exact release order on failure.

Summary

Types

resources()

Functions

owner_graph!(declarations)
permutations(declarations, options \\ [])
verify!(declarations, options)

Verifies every requested release order using freshly-created resources.

Types

resources()

@type resources() :: %{required(atom() | binary()) => term()}

Functions

owner_graph!(declarations)

@spec owner_graph!([Kinda.Resource.Declaration.t()]) :: %{
  optional(atom() | binary()) => atom() | binary() | nil
}

permutations(declarations, options \\ [])

@spec permutations(
  [Kinda.Resource.Declaration.t()],
  keyword()
) :: [[Kinda.Resource.Declaration.t()]]

verify!(declarations, options)

@spec verify!(
  [Kinda.Resource.Declaration.t()],
  keyword()
) :: :ok

Verifies every requested release order using freshly-created resources.

:setup returns a map keyed by declaration identity. :release receives the declaration and its corresponding resource. :probe runs after every release with the resources that have not been explicitly released yet.