testing

func FakeCache ¶ added in v1.15.0

func FakeCache(t testing.TB) *FakeCacheStore

FakeCache gives the cache package helpers (cache.Get, cache.Remember, ...) an empty in-memory store for the rest of the test, so values cached by one test never reach another, then restores the previous global store.

func FakeStorage ¶ added in v1.15.0

func FakeStorage(t testing.TB) *FakeDisk

FakeStorage returns an empty in-memory disk. Storage has no global driver, so pass it wherever the code under test takes a storage.Driver.

disk := nimbustesting.FakeStorage(t)
app.Uploads = disk
client.Post("/avatar", body)
disk.AssertExists(t, "avatars/1.png")

func FakeEvents ¶ added in v1.15.0

func FakeEvents(t testing.TB, except ...string) *FakeEventBus

FakeEvents fakes events.Default for the rest of the test: events.Dispatch records events instead of running listeners, except for the event names in except, whose listeners still run (they are recorded too).

bus := nimbustesting.FakeEvents(t)
client.PostJSON("/signup", body)
bus.AssertDispatched(t, "user.created")

func FakeEventsOn ¶ added in v1.15.0

func FakeEventsOn(t testing.TB, d *events.Dispatcher, except ...string) *FakeEventBus

FakeEventsOn fakes one dispatcher, such as app.Events, the same way FakeEvents fakes events.Default.

func FakeMail ¶ added in v1.15.0

func FakeMail(t testing.TB) *FakeMailer

FakeMail makes mail.Send (and notifications' mail channel) capture messages on a fresh FakeMailer for the rest of the test, then restores mail.Default.

mails := nimbustesting.FakeMail(t)
client.PostJSON("/signup", body)
mails.AssertSent(t, func(m *mail.Message) bool { return m.Subject == "Welcome" })

func NewFakeMailer ¶

func NewFakeMailer() *FakeMailer

NewFakeMailer returns a fresh fake mailer.

func FakeNotifications ¶ added in v1.15.0

func FakeNotifications(t testing.TB) *FakeNotifier

FakeNotifications makes notification.Send (and SendMail, Broadcast) record notifications instead of mailing or broadcasting them for the rest of the test. AfterSend hooks still run for Send.

notes := nimbustesting.FakeNotifications(t)
client.PostJSON("/orders", body)
nimbustesting.AssertNotificationSent(t, notes, func(n *OrderShipped) bool { return n.OrderID == 7 })

func FakeJobs ¶ added in v1.15.0

func FakeJobs(t testing.TB) *FakeQueue

FakeJobs sends every queue.Dispatch to a fresh FakeQueue for the rest of the test and puts the previous global manager back when it ends. Jobs are serialized as a real adapter would store them, so a job that cannot be marshaled fails at Dispatch.

Job types registered with queue.Register (after FakeJobs, or on the manager it replaced) come back as values in Dispatched and run with ProcessAll. JobsOf and AssertDispatched decode any job type without registering it.

jobs := nimbustesting.FakeJobs(t)
client.PostJSON("/signup", body)
nimbustesting.AssertDispatched(t, jobs, func(j *SendWelcome) bool { return j.Email == "a@b.co" })

func NewFakeQueue ¶

func NewFakeQueue() *FakeQueue

NewFakeQueue returns a fresh fake queue. Use FakeJobs to also capture queue.Dispatch calls.

func FakeHTTP ¶ added in v1.15.0

func FakeHTTP(t testing.TB) *FakeTransport

FakeHTTP replaces http.DefaultTransport for the rest of the test, so every client without a transport of its own (http.DefaultClient, &http.Client{...}) gets answers from On stubs instead of the network. A request no stub matches fails the test and returns an error, unless AllowStray was called.

Clients that set their own Transport are not intercepted, nor are clients that copied DefaultTransport before FakeHTTP ran. For the AI providers use ai.Fake instead.

api := nimbustesting.FakeHTTP(t)
api.On("POST", "https://api.stripe.com/v1/charges").RespondJSON(200, map[string]any{"id": "ch_1"})
client.PostJSON("/checkout", body)
api.AssertSent(t, func(r nimbustesting.RecordedRequest) bool { return r.URL.Path == "/v1/charges" })

func New ¶ added in v1.4.0

func New(app *nimbus.App) *TestClient

New returns an HTTP test client bound to the given Nimbus App. It automatically warms up the application if not already warmed.

func NewAppTestClient ¶

func NewAppTestClient(setup func(app *nimbus.App)) (*nimbus.App, *TestClient)

NewAppTestClient creates a minimal Nimbus application with a fresh router and returns both the app and an HTTP TestClient bound to its router.

func NewTestClient ¶

func NewTestClient(r *router.Router) *TestClient

NewTestClient returns a client that sends requests to the given router.