accesslog

type AccessLogIO interface {
	io.ReadWriteCloser
	io.ReadWriteSeeker
	io.ReaderAt
	sync.Locker
	Name() string // file name or path
	Truncate(size int64) error
}

type AccessLogger struct {
	Formatter
	// contains filtered or unexported fields
}

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

type CIDR struct{ types.CIDR }

type CombinedFormatter struct{ CommonFormatter }

type CommonFormatter struct {
	GetTimeNow func() time.Time // for testing purposes only
	// contains filtered or unexported fields
}

type Config struct {
	BufferSize int        `json:"buffer_size"`
	Format     Format     `json:"format" validate:"oneof=common combined json"`
	Path       string     `json:"path" validate:"required"`
	Filters    Filters    `json:"filters"`
	Fields     Fields     `json:"fields"`
	Retention  *Retention `json:"retention"`
}

type FieldConfig struct {
	Default FieldMode            `json:"default" validate:"oneof=keep drop redact"`
	Config  map[string]FieldMode `json:"config" validate:"dive,oneof=keep drop redact"`
}

type FieldMode string

type Fields struct {
	Headers FieldConfig `json:"headers"`
	Query   FieldConfig `json:"query"`
	Cookies FieldConfig `json:"cookies"`
}

type File struct {
	*os.File
	sync.Mutex
	// contains filtered or unexported fields
}

type Filterable interface {
	comparable
	Fulfill(req *http.Request, res *http.Response) bool
}

type Filters struct {
	StatusCodes LogFilter[*StatusCodeRange] `json:"status_codes"`
	Method      LogFilter[HTTPMethod]       `json:"method"`
	Host        LogFilter[Host]             `json:"host"`
	Headers     LogFilter[*HTTPHeader]      `json:"headers"` // header exists or header == value
	CIDR        LogFilter[*CIDR]            `json:"cidr"`
}

type Format string

type Formatter interface {
	// Format writes a log line to line without a trailing newline
	Format(line *bytes.Buffer, req *http.Request, res *http.Response)
	SetGetTimeNow(getTimeNow func() time.Time)
}

type HTTPHeader struct {
	Key, Value string
}

type HTTPMethod string

type Host string

type JSONFormatter struct{ CommonFormatter }

type JSONLogEntry struct {
	Time        string              `json:"time"`
	IP          string              `json:"ip"`
	Method      string              `json:"method"`
	Scheme      string              `json:"scheme"`
	Host        string              `json:"host"`
	URI         string              `json:"uri"`
	Protocol    string              `json:"protocol"`
	Status      int                 `json:"status"`
	Error       string              `json:"error,omitempty"`
	ContentType string              `json:"type"`
	Size        int64               `json:"size"`
	Referer     string              `json:"referer"`
	UserAgent   string              `json:"useragent"`
	Query       map[string][]string `json:"query,omitempty"`
	Headers     map[string][]string `json:"headers,omitempty"`
	Cookies     map[string]string   `json:"cookies,omitempty"`
}

type LogFilter[T Filterable] struct {
	Negative bool
	Values   []T
}

type MockFile struct {
	sync.Mutex
	// contains filtered or unexported fields
}

type Retention struct {
	Days uint64 `json:"days"`
	Last uint64 `json:"last"`
}

type StatusCodeRange struct {
	Start int
	End   int
}