ledgerconformance

Overview ¶

Package ledgerconformance provides a shared conformance test suite for the tool.ReadLedger interface (ADR 0281). Adapters (the in-memory reference memledger, a durable Redis-backed implementation, ...) call Run with a factory that constructs a fresh ledger, and the suite exercises only the tool.ReadLedger interface.

Importing "testing" in a non-_test.go file is intentional here: this is a test-helper package whose sole purpose is to be imported by adapter tests, the conventional Go pattern for shared conformance suites (cf. testing/fstest and the sibling fsconformance/memconformance packages).

The suite pins the CONTRACT — exact-token round trip, ordinary absence, and concurrent access — not the implementation: durability, storage encoding, and failure-classification detail beyond "absence vs error" are adapter-internal and deliberately NOT asserted here (a durable adapter's own tests cover its failure classification, e.g. TestPersistentReadLedgers_Scenario2_*).