logging

type Filter ¶ added in v0.3.0

type Filter interface {
	Level(*http.Request) Level
}

A Filter determines the logging level, possibly based on each request.

type FilterFunc ¶ added in v0.3.0

type FilterFunc func(*http.Request) Level

FilterFunc adapts a function to be a Filter.

func FixedLevel(level Level) FilterFunc

func (f FilterFunc) Level(req *http.Request) Level

type Level ¶

type Level int

Level allows control of the predicate of detail in log messages.

const (
	// Off turns logging off.
	Off Level = iota

	// Discrete log messages contain only a summary of the request and response.
	// No query parameters are printed in order to hide potential personal information.
	Discrete

	// Summary log messages contain only a summary of the request and response,
	// including the full target URL.
	Summary

	// WithHeaders log messages contain a summary and the request/response headers
	WithHeaders

	// WithHeadersAndBodies log messages contain a summary and the request/response headers and bodies
	// Textual bodies are included in the log; for binary content, the size is shown instead.
	WithHeadersAndBodies
)

func (i Level) Ordinal() int

func (i Level) String() string

type LogContent ¶

type LogContent struct {
	Header http.Header
	Body   []byte
}

type LogItem ¶

type LogItem struct {
	Method     string
	URL        *url.URL
	StatusCode int
	Request    LogContent
	Response   LogContent
	Err        error
	Start      time.Time
	Duration   time.Duration
	Level      Level
}

LogItem records information about one HTTP round-trip.

type Logger ¶

type Logger func(item *LogItem)

Logger is a function that processes log items, usually by writing them to a log file.

func LogWriter(out io.Writer, dir string) Logger

type VariableFilter ¶ added in v0.3.0

type VariableFilter struct {
	// contains filtered or unexported fields
}

VariableFilter is a Filter that is controlled by a predicate. This predicate can be altered by any goroutine at any time.

func NewVariableFilter(initial Level) *VariableFilter

func NewVariablePredicate(initial FilterFunc) *VariableFilter

func (vf *VariableFilter) Level(req *http.Request) Level

func (vf *VariableFilter) SetLevel(newLevel FilterFunc)