objtest

Documentation

Overview

Package objtest is the conformance suite for the cacheobj contract. It IS the contract: any Cache[*Val] built by the supplied factory must pass Run, the same way cachetest.Run anchors the byte-cache family.

A factory (not a finished cache) is taken so the suite can construct caches with its own deterministic clock and assorted options.

Index

• func Run(t *testing.T, bounded bool, f Factory)
• type Factory
• type Val

Functions

func Run

func Run(t *testing.T, bounded bool, f Factory)

Run executes the full conformance suite against caches built by f. Bounded indicates whether f produces a capacity-bounded cache (some checks — LRU eviction — only apply when bounded).

Types

type Factory

type Factory func(opts ...cacheobj.Option) cacheobj.Cache[*Val]

Factory builds a Cache[*Val] from the given options. Implementations pass cacheobj.New[*Val]. The suite appends its own WithClock so it controls time.

type Val

type Val struct{ N int }

Val is the reference value type the suite caches. It is a pointer target so the suite can assert reference identity (the defining behavior: Get returns the same object that was Set).