AshHooks.Custody.Conformance (AshHooks v3.3.0)

Copy Markdown View Source

An ExUnit case template for implementations of AshHooks.Custody.

Use this module in a test module with custodian: YourCustodian. Add an ExUnit setup callback that provides a fresh real custody store before each test and registers its cleanup with on_exit. Callbacks use their normal public arities; configure any store connection in that setup. The template defaults to synchronous execution and forwards ExUnit case options such as :async and :register.

To tag the generated tests, use ExUnit.Case and set @moduletag before using this template, which registers the tests when it expands.

Tests cover kind bounds and assertions, idempotence, global tenant binding, permanent tombstones, concurrent store/destroy ordering, signing and verification, and literal fingerprint vectors. MAC corruption and truncation are checked by result, never by unreliable timing measurements. Passing these tests does not establish a backend's timing properties.

ExUnit references expand only in the consumer's test module. This module compiles without ExUnit, so ExUnit is not a runtime dependency of ash_hooks.