datastate

Jul 23, 2026

Changes in this version

+ const RedactedValue

+ var DefaultLimits = Limits

+ var ErrAmbiguousHolder = errors.New("datastate: holder name is required when more than one holder is registered")

+ var ErrAssertionFailed = errors.New("datastate: assertion failed")

+ var ErrEmptyQuery = errors.New("datastate: query DTQL text is empty")

+ var ErrNilExecutor = errors.New("datastate: executor is nil")

+ var ErrNoHolders = errors.New("datastate: no database holders are registered")

+ var ErrUnknownHolder = errors.New("datastate: unknown holder")

+ type Assertion struct

+ Expect Expectation

+ Holder string

+ Name string

+ Normalization Normalization

+ Query Query

+ Redact []string

+ type AttachmentPoint string

+ const AttachmentAfterMessage

+ const AttachmentBranchCompletion

+ const AttachmentCheckpoint

+ type Evidence struct

+ AttachmentPoint AttachmentPoint

+ ExcludedFields []string

+ FailureMessage string

+ Holder string

+ Name string

+ Outcome Outcome

+ Params map[string]any

+ Preview []Row

+ Query string

+ RedactedFields []string

+ ReturnedRows int

+ TotalRows int

+ Truncated bool

+ type Executor interface

+ Execute func(ctx context.Context, handle any, query Query) ([]Row, error)

+ type Expectation func(rows []Row) error

+ func All(expectations ...Expectation) Expectation

+ func AllRows(check func(Row) error) Expectation

+ func AnyRow(check func(Row) error) Expectation

+ func Empty() Expectation

+ func ExactRowCount(n int) Expectation

+ func ExactRows(want []Row) Expectation

+ func MaxRowCount(n int) Expectation

+ func MinRowCount(n int) Expectation

+ func NonEmpty() Expectation

+ func RowContains(partial Row) Expectation

+ type Handles map[string]any

+ type Limits struct

+ MaxFields int

+ MaxRows int

+ type Normalization struct

+ ExcludedFields []string

+ SortKeys []string

+ type Outcome string

+ const OutcomeFailed

+ const OutcomePassed

+ type Query struct

+ DTQL string

+ Params map[string]any

+ type Row map[string]any

+ type Runner struct

+ func NewRunner(executor Executor, handles Handles, limits Limits) (*Runner, error)

+ func (r *Runner) Gate(ctx context.Context, point AttachmentPoint, assertions []Assertion, ...) ([]Evidence, error)

+ func (r *Runner) Run(ctx context.Context, point AttachmentPoint, assertion Assertion) (Evidence, error)

+ func (r *Runner) RunAll(ctx context.Context, point AttachmentPoint, assertions ...Assertion) ([]Evidence, error)