Skip to content
Package httpretty prints the HTTP requests you make with Go pretty on your terminal.
Go Shell
Branch: master
Clone or download

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
example fix: linting issue on example/httprepl. Feb 3, 2020
internal internal(header): adding package description. Feb 20, 2020
scripts scripts: adding test and code coverage scripts for CI. Feb 2, 2020
testdata test: moving testdata to goldenfile. Feb 2, 2020
.gitignore Adding .gitignore. Feb 2, 2020
.travis.yml ci: updating Go version. Feb 20, 2020
CONTRIBUTING.md Adding CONTRIBUTING.md. Feb 2, 2020
LICENSE.md Adding public domain (MIT) license. Feb 2, 2020
README.md docs: fixing httpretty.WithHide example. Feb 20, 2020
client_test.go httpretty: adding method to skip printing specific request and respon… Feb 22, 2020
go.mod Adding go.mod. Feb 2, 2020
httpretty.go httpretty: adding method to skip printing specific request and respon… Feb 22, 2020
httpretty_test.go test: fixing static analysis for colored output test. Feb 21, 2020
long_test.go test: moving testdata to goldenfile. Feb 2, 2020
norace_test.go httpretty: adding code. Feb 2, 2020
printer.go httpretty: adding method to skip printing specific request and respon… Feb 22, 2020
race_test.go httpretty: adding code. Feb 2, 2020
recorder.go httpretty: adding code. Feb 2, 2020
server_test.go httpretty: adding method to skip printing specific request and respon… Feb 22, 2020
tls.go httpretty: adding code. Feb 2, 2020

README.md

httpretty

GoDoc Build Status Coverage Status Go Report Card

Package httpretty prints the HTTP requests of your Go programs pretty on your terminal screen. It is mostly inspired in curl's --verbose mode, and also on the httputil.DumpRequest and similar functions.

asciicast

Setting up a logger

You can define a logger with something like

logger := &httpretty.Logger{
	Time:           true,
	TLS:            true,
	RequestHeader:  true,
	RequestBody:    true,
	ResponseHeader: true,
	ResponseBody:   true,
	Colors:         true, // erase line if you don't like colors
	Formatters:     []httpretty.Formatter{&httpretty.JSONFormatter{}},
}

This code will set up a logger with sane settings. By default the logger prints nothing but the request line (and the remote address, when using it on the server-side).

Using on the client-side

You can set the transport for the *net/http.Client you are using like this:

client := &http.Client{
	Transport: logger.RoundTripper(http.DefaultTransport),
}

// from now on, you can use client.Do, client.Get, etc. to create requests.

If you don't care about setting a new client, you can safely replace your existing http.DefaultClient with this:

http.DefaultClient.Transport = logger.RoundTripper(http.DefaultClient.Transport)

Then httpretty is going to print information about regular requests to your terminal when code such as this is called:

if _, err := http.Get("https://www.google.com/"); err != nil {
        fmt.Fprintf(os.Stderr, "%+v\n", err)
        os.Exit(1)
}

However, have in mind you usually want to use a custom *http.Client to control things such as timeout.

Logging on the server-side

You can use the logger quickly to log requests on your server. For example:

logger.Middleware(mux)

The handler should by a http.Handler. Usually, you want this to be your http.ServeMux HTTP entrypoint.

For working examples, please see the example directory.

Filtering

You have two ways to filter a request so it isn't printed by the logger.

httpretty.WithHide

You can filter any request by setting a request context before the request reaches httpretty.RoundTripper:

req = req.WithContext(httpretty.WithHide(ctx))

Filter function

A second option is to implement

type Filter func(req *http.Request) (skip bool, err error)

and set it as the filter for your logger. For example:

logger.SetFilter(func filteredURIs(req *http.Request) (bool, error) {
	if req.Method != http.MethodGet {
		return true, nil
	}

	if path := req.URL.Path; path == "/debug" | strings.HasPrefix(path, "/debug/") {
		return true, nil
	}

	return false
})

Formatters

You can define a formatter for any media type by implementing the Formatter interface.

We provide a JSONFormatter for convenience (it is not enabled by default).

You can’t perform that action at this time.