mockutil

package

v2.22.0 Latest Latest Go to latest Published: Jul 11, 2025 License: MIT Imports: 6 Imported by: 0

Details

This section is empty.

This section is empty.

func Handler(t *testing.T, requests []Request) http.HandlerFunc

Handler is using a Server to mock http requests provided by the user.

type Request struct {
	Method string
	Path   string
	Want   func(t *testing.T, r *http.Request)

	Status  int
	JSON    any
	JSONRaw string
}

Request describes a http request that a httptest.Server should receive, and the corresponding response to return.

Additional checks on the request (e.g. request body) may be added using the [Request.Want] function.

The response body is populated from either a JSON struct, or a JSON string.

type Server struct {
	*httptest.Server
	// contains filtered or unexported fields
}

Server embeds a httptest.Server that answers HTTP calls with a list of expected Request.

Request matching is based on the request count, and the user provided request will be iterated over.

A Server must be created using the NewServer function.

func NewServer(t *testing.T, requests []Request) *Server

NewServer returns a new mock server that closes itself at the end of the test.

func (m *Server) Expect(requests []Request)

Expect adds requests to the list of requests expected by the Server.