httptest

func ChiContextFromRequest ¶

func ChiContextFromRequest(r *http.Request) *chi.Context

ChiContextFromRequest returns a chi.Context associated with a given http.Request, creating a new one in case the request does not have one yet.

func CloneRequest ¶

func CloneRequest(r *http.Request) *http.Request

CloneRequest takes a given http.Request, and clones it into a new http.Request, preserving its body, if any. Use this instead of http.Request#Clone

func EmptyRequest ¶

func EmptyRequest() *http.Request

EmptyRequest returns a dummy GET request to a "foo" endpoint, without a body. Useful for testing middlewares and handlers.

func EmptyRequestHandler ¶

func EmptyRequestHandler() http.Handler

EmptyRequestHandler returns an http.Handler that simply returns 200, without a body

func ExecuteLogHandler ¶

func ExecuteLogHandler(r *http.Request, handler func(http.ResponseWriter, *http.Request, *zap.Logger)) *http.Response

ExecuteLogHandler takes a request and applies it to a handler that uses middleware.LoggerHandler

func ExecuteLogHandlerWithMiddlewares ¶

func ExecuteLogHandlerWithMiddlewares(r *http.Request, handler func(http.ResponseWriter, *http.Request, *zap.Logger), middlewares ...func(http.Handler) http.Handler) *http.Response

ExecuteLogHandlerWithMiddlewares takes a handler that uses middleware.LoggerHandler and an arbitrary number of middlewares and executes all of them.

func ExecuteMiddlewareWithRequest ¶

func ExecuteMiddlewareWithRequest(r *http.Request, baseHandler http.Handler, middlewares ...func(http.Handler) http.Handler) *http.Response

ExecuteMiddlewareWithRequest takes an HTTP request, a base handler (your controller's action handler, for instance), and a set of middlewares to process the request, returning the response generated by applying the provided request through all middlewares and the provided base handler.

func ExecuteRequest ¶

func ExecuteRequest(req *http.Request, handler func(w http.ResponseWriter, r *http.Request)) *http.Response

ExecuteRequest simply executes the handler with a given http.Request and returns its response.

func JSONFromResponse ¶

func JSONFromResponse(r *http.Response, into interface{})

JSONFromResponse attempts to unmarshal a given http.Response body into the provided interface. Panics if reading the body or unmarshalling fails.

func PassThroughRequestHandler ¶

func PassThroughRequestHandler() (func(*testing.T, *http.Response), http.Handler)

PassThroughRequestHandler returns an assertion function and an HTTP handler. After applying a request to the handler, the response can be tested by the returned assertion function, as to ensure that a response contains the body and header generated randomly by the handler.

For instance:

assertion, handler := test.PassThroughRequestHandler()
resp := test.ExecuteMiddlewareWithRequest(
	test.EmptyRequest(),
	handler,
	ARandomMiddleware{})
assertion(t, resp)

func PrepareRequest ¶

func PrepareRequest(req *http.Request, mutators ...RequestMutator) *http.Request

PrepareRequest takes an HTTP request instance and a set of mutators, applying them to it and returning a new request with all mutations applied.

func RequestInterceptorHandler ¶

func RequestInterceptorHandler() (handler http.Handler, capturedRequest *http.Request)

RequestInterceptorHandler provides a handler that returns an HTTP 200 with no body, and intercepts the request, storing a reference to it for later inspection.