Popularity
2.0
Growing
Activity
0.0
Stable
18
1
4

Programming language: Go

client-timing alternatives and similar packages

Based on the "Actual middlewares" category

Do you think we are missing an alternative of client-timing or a related project?

Add another 'Actual middlewares' Package

README

client-timing

Build Status codecov GoDoc Go Report Card

An HTTP client for go-server-timing middleware.

Features:

  • An HTTP Client or RoundTripper, fully compatible with Go's standard library.
  • Automatically time HTTP requests sent from an HTTP handler.
  • Collects all timing headers from upstream servers.
  • Customize timing headers according to the request, response and error of the HTTP round trip.

Install

go get -u github.com/posener/client-timing

Usage

  1. Add a *clienttiming.Timer to your server handler, or create it in the handler function itself.
  2. Wrap the http.Handler with servertiming.Middleware.
  3. In the handler function, having timer of type *clienttiming.Timer and req is the *http.Request:

    a. Create an *http.Client using timer.Client(req.Context())

    b. Or create an http.RoundTripper using timer.Transport(req.Context())

  4. Use option a or b directly or inject it to a library that accepts them, in your outgoing HTTP request from the handler.

  5. That is it! the timing header will appear in the response from the handler.

Example

Suppose we have an HTTP handler:

type handler struct {
    timer *clienttiming.Timer
}

Our usage of that handler will be:

func main() {
    h := &handler{
        timer: clienttiming.New(clienttiming.WithName("my-server")),
    }
    log.Fatal(http.ListenAndServe(":8080", servertiming.Middleware(h)))
}

Example for Client function:

func (h *handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    // Create an http client using the request context
    c := h.timer.Client(r.Context())

    // Perform HTTP requests, as many as you like
    resp, err := c.Get("https://golang.org/")

    ...
}

Example for Transport function:

func (h *handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    // Instrument an http client with a timing transport
    c := &http.Client{
        Transport: h.timer.Transport(r.Context()),
    }

    // Perform HTTP requests, as many as you like
    resp, err := c.Get("https://golang.org/")

    ...
}

Run the [example](./example/main.go)

go run ./example/main.go