isabella232 / conditional-1

Conditional HTTP responses with Go

Conditional

Conditional HTTP helpers for Go stdlib's net/http package.

Supported headers:

• If-Match
• If-None-Match
• If-Modified-Since
• If-Unmodified-Since

Example:

import(
	"fmt"
	"net/http"
	"net/http/httptest"

	"github.com/bsm/conditional"
)

func main() {
	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		// set ETag and/or Last-Modified headers
		w.Header().Set("ETag", `"strong"`)
		w.Header().Set("Last-Modified", "Fri, 05 Jan 2018 11:25:15 GMT")

		// perform conditional check
		if conditional.Check(w, r) {
			return
		}
		w.WriteHeader(http.StatusNoContent)
	}))
	defer srv.Close()

	client := new(http.Client)

	// make a plain GET request
	req, err := http.NewRequest("GET", srv.URL, nil)
	if err != nil {
		panic(err)
	}
	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	fmt.Println(res.Status)	// => 204 No Content

	// now, try it with a matchingg "If-Modified-Since"
	req, err = http.NewRequest("GET", srv.URL, nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("If-Modified-Since", "Fri, 05 Jan 2018 11:25:15 GMT")
	res, err = client.Do(req)
	if err != nil {
		panic(err)
	}
	fmt.Println(res.Status)	// => 304 Not Modified

}