Function CallRoute

svc/api/internal/testutil/http.go:654–688

CallRoute executes a request against a registered route and returns the typed response. The request body is JSON-encoded from req, and the response is unmarshaled into Res. This is the primary way to test API endpoints. Pass nil headers to use an empty header set.

(h *Harness, route zen.Route, headers http.Header, req Req)

// into Res. This is the primary way to test API endpoints. Pass nil headers to use
// an empty header set.
func CallRoute[Req any, Res any](h *Harness, route zen.Route, headers http.Header, req Req) TestResponse[Res] {
	h.t.Helper()

	rr := httptest.NewRecorder()

	body := new(bytes.Buffer)
	err := json.NewEncoder(body).Encode(req)
	require.NoError(h.t, err)

	httpReq := httptest.NewRequest(route.Method(), route.Path(), body)
	httpReq.Header = headers
	if httpReq.Header == nil {
		httpReq.Header = http.Header{}
	}

	h.srv.Mux().ServeHTTP(rr, httpReq)
	require.NoError(h.t, err)

	rawBody := rr.Body.Bytes()

	res := TestResponse[Res]{
		Status:  rr.Code,
		Headers: rr.Header(),
		RawBody: string(rawBody),
		Body:    nil,
	}

	var responseBody Res
	err = json.Unmarshal(rawBody, &responseBody)
	require.NoError(h.t, err)

	res.Body = &responseBody

	return res
}

// UnmarshalBody decodes a JSON response body into the provided pointer. This is
// useful when working directly with httptest.ResponseRecorder rather than using