oh boy

aslilac · aslilac · commit e8c1b319490e · 2025-04-15T21:45:40.000Z
diff --git a/testutil/ctx.go b/testutil/ctx.go
@@ -15,6 +15,8 @@ func Context(t *testing.T, dur time.Duration) context.Context {
 // TryRecvCtx will attempt to receive a value from the chan and return it. If
 // the context expires before a value can be received, it will fail the test. If
 // the channel is closed, the zero value of the channel type will be returned.
+//
+// Safety: Must only be called from the Go routine that created `t`.
 func TryRecvCtx[A any](ctx context.Context, t testing.TB, c <-chan A) A {
 	t.Helper()
 	select {
@@ -30,6 +32,8 @@ func TryRecvCtx[A any](ctx context.Context, t testing.TB, c <-chan A) A {
 // RequireRecvCtx will receive a value from the chan and return it. If the
 // context expires or the channel is closed before a value can be received,
 // it will fail the test.
+//
+// Safety: Must only be called from the Go routine that created `t`.
 func RequireRecvCtx[A any](ctx context.Context, t testing.TB, c <-chan A) A {
 	t.Helper()
 	select {
@@ -47,6 +51,8 @@ func RequireRecvCtx[A any](ctx context.Context, t testing.TB, c <-chan A) A {
 
 // RequireSendCtx will send the given value over the chan and then return. If
 // the context expires before the send succeeds, it will fail the test.
+//
+// Safety: Must only be called from the Go routine that created `t`.
 func RequireSendCtx[A any](ctx context.Context, t testing.TB, c chan<- A, a A) {
 	t.Helper()
 	select {
