contenttest

type Fake ¶

type Fake struct {
	// contains filtered or unexported fields
}

Fake is contracts.Service over a map: the same rules, no database, no transaction. A consumer that wants to test what it does when a page is published takes one of these instead of a Postgres.

It ignores the transaction it is handed, and that is the honest limit of it: it cannot tell a caller that a write did not commit, because nothing here commits. Everything it can be wrong about is what RunService checks.

func NewFake() *Fake

func (f *Fake) Archive(_ context.Context, _ db.Tx[db.Tenant], id uuid.UUID) (*contracts.Content, error)

func (f *Fake) Contents() map[uuid.UUID]contracts.Content

func (f *Fake) Public(_ context.Context, _ db.Tx[db.Tenant], slug string) (*contracts.Content, error)

func (f *Fake) Publish(_ context.Context, _ db.Tx[db.Tenant], id uuid.UUID) (*contracts.Content, error)

func (f *Fake) Published() []string

func (f *Fake) Put(c *contracts.Content) uuid.UUID

func (f *Fake) Unpublish(_ context.Context, _ db.Tx[db.Tenant], id uuid.UUID) (*contracts.Content, error)

type Fixture ¶

type Fixture struct {
	Ctx     context.Context
	Tx      db.Tx[db.Tenant]
	Service contracts.Service
	// Seed stores content and returns the id it was given. It is the one thing
	// the suite cannot do through the interface, because the interface is the
	// lifecycle and creating a page is kit/rest's five routes.
	Seed func(*contracts.Content) uuid.UUID
	// Published is the events the implementation has published so far, in
	// order. Half of what the lifecycle promises is silence: publishing what is
	// already published is a second click on a button, not a second
	// publication, and a subscriber must not hear about it.
	Published func() []string
}

Fixture is one case's world: a Service, the transaction its commands take, and a store to put content in.

type Harness ¶

type Harness func(t *testing.T, run func(Fixture))

Harness builds one Fixture and calls run with it, because the real service's fixture is a transaction and a transaction is a scope somebody has to close.