http

package

Go to main page

Versions in this module

v2

v2.0.6

Jan 21, 2024

v2.0.5

Jan 4, 2024

v2.0.4

Jan 4, 2024

Changes in this version

type KeyValue

+ func (kv *KeyValue) Strings() []string

v2.0.3

Jan 4, 2024

Changes in this version

type Muxer

+ Use func(filters ...Filter)

v2.0.2

Dec 24, 2023

Changes in this version

+ func DefaultMetricsNameFormatter(namespace string, r *http.Request) string

+ func DefaultSpanNameFormatter(operation string, r *http.Request) string

+ type ChiMuxOption func(*chiMuxer)

+ func MethodNotAllowedChiMuxOption(handlerFunc http.HandlerFunc) ChiMuxOption

+ func NotFoundHandlerChiMuxOption(handlerFunc http.HandlerFunc) ChiMuxOption

type Filter

+ func CustomMetricsFilter(namespace string, provider metrics.Provider, formatter MetricsNameFormatter, ...) Filter

+ func OpenTelemetryFilter(namespace string, provider OpenTelemetryProvider, tags []KeyValue, ...) Filter

+ func SetRequestHeaderFilter(key, value string) Filter

+ func SetResponseHeaderFilter(key, value string) Filter

+ func WithChi(middleware func(http.Handler) http.Handler) Filter

type KeyValue

+ func (kv *KeyValue) String() string

+ type MetricsTagGenerator func(rw WrapResponseWriter, req *http.Request) []KeyValue

+ type OpenTelemetryRequestFilter otelhttp.Filter

+ type TraceLogFieldsGen func(rw WrapResponseWriter, req *http.Request) []log.Field

type TransportConfigOption

+ func WithHandlerOptionForTransport(options ...HandlerOption) TransportConfigOption

+ func WithTraceLogging(fieldsGens ...TraceLogFieldsGen) TransportConfigOption

+ func WithTransportOption(options ...TransportOption) TransportConfigOption

v2.0.1

Dec 11, 2023

v2.0.0

Nov 30, 2023

Changes in this version

+ const HeaderAccept

+ const HeaderAccessMaxAge

+ const HeaderAllowHeaders

+ const HeaderAllowMethods

+ const HeaderAllowOrigin

+ const HeaderAuthorization

+ const HeaderContentType

+ const HeaderExposeHeader

+ const HeaderReferer

+ const HeaderRequestID

+ const HeaderUserAgent

+ const HeaderXForwardedFor

+ const HeaderXForwardedProto

+ var ErrNotHTTPRequest = errors.New("missmatch type, request should be *http.Request")

+ var ErrNotHTTPResponse = errors.New("mismatch type, response should be *http.Response")

+ func Chain(inner http.Handler, filters ...Filter) http.Handler

+ func NewHandler(fn Handler, opts ...HandlerOption) net_http.Handler

+ func NewRecovery(logger log.Logger, options ...RecoveryOption) *recovery

+ func NewResponse(req *net_http.Request, opts ...ResponseOption) *net_http.Response

+ func NoopBefore(cx context.Context, _ *http.Request) context.Context

+ func NoopMiddleware(next endpoint.Endpoint) endpoint.Endpoint

+ type AfterFunc kit_http.ServerResponseFunc

+ type BeforeFunc kit_http.RequestFunc

+ type ContextKey int

+ const ContextKeyRequestAccept

+ const ContextKeyRequestAuthorization

+ const ContextKeyRequestHost

+ const ContextKeyRequestMethod

+ const ContextKeyRequestPath

+ const ContextKeyRequestProto

+ const ContextKeyRequestReferer

+ const ContextKeyRequestRemoteAddr

+ const ContextKeyRequestURI

+ const ContextKeyRequestUserAgent

+ const ContextKeyRequestXForwardedFor

+ const ContextKeyRequestXForwardedProto

+ const ContextKeyRequestXRequestID

+ const ContextKeyResponseHeaders

+ const ContextKeyResponseSize

+ type CorsOptions cors.Options

+ type Decoder func(context.Context, *net_http.Request) (interface{}, error)

+ func NewDefaultDecoder() Decoder

+ func NopRequestDecoder() Decoder

+ type DefaultMuxOption func(*chiMuxer)

+ func MethodNotAllowedMuxOption(handlerFunc http.HandlerFunc) DefaultMuxOption

+ func NotFoundHandlerMuxOption(handlerFunc http.HandlerFunc) DefaultMuxOption

+ type Encoder func(context.Context, net_http.ResponseWriter, interface{}) error

+ func NewDefaultEncoder() Encoder

+ func NewDefaultJSONEncoder() Encoder

+ type ErrorEncoder func(context.Context, error, net_http.ResponseWriter)

+ type ErrorHandler interface

+ type Filter func(http.Handler) http.Handler

+ func AllowContentTypeFilter(contentTypes ...string) Filter

+ func CleanPathFilter() Filter

+ func CorsFilterWithCustomOptions(options CorsOptions) Filter

+ func CorsFilterWithDefaults() Filter

+ func CustomMetricsForDefaultMuxFilter(namespace string, provider metrics.Provider, formatter MetricsNameFormatter, ...) Filter

+ func CustomRequestIDFilter(formatter RequestIDFormatter, customHeaders ...string) Filter

+ func DeleteHeadersFilter(headers ...string) Filter

+ func GzipCompressionFilter(level int, types ...string) Filter

+ func NoopFilter() Filter

+ func OpenTelemetryFilterForDefaultMux(namespace string, tags []KeyValue, meterProvider metric.MeterProvider, ...) Filter

+ func PanicRecoveryFilter(logger log.Logger, options ...RecoveryOption) Filter

+ func RedirectSlashFilter() Filter

+ func SetHeaderFilter(key, value string) Filter

+ func SetRequestHeader(key, value string) Filter

+ func TraceLoggingFilter(logger log.Logger) Filter

+ type Handler endpoint.Endpoint

+ type HandlerFunc func(ctx context.Context, req *net_http.Request) (*net_http.Response, error)

+ type HandlerOption func(*handler)

+ func HandlerWithAfterFunc(fn AfterFunc) HandlerOption

+ func HandlerWithBeforeFunc(fn BeforeFunc) HandlerOption

+ func HandlerWithDecoder(fn Decoder) HandlerOption

+ func HandlerWithEncoder(fn Encoder) HandlerOption

+ func HandlerWithEndpointMiddleware(fn endpoint.Middleware) HandlerOption

+ func HandlerWithErrorEncoder(fn ErrorEncoder) HandlerOption

+ func HandlerWithErrorhandler(fn ErrorHandler) HandlerOption

+ func HandlerWithFilter(f Filter) HandlerOption

+ func HandlerWithMiddleware(fn Middleware) HandlerOption

+ func NewDeleteHeaderHandlerOption(headers ...string) HandlerOption

+ func NewErrorEncoderHandlerOptions(fn ErrorEncoder) HandlerOption

+ func NewFiltersHandlerOption(filters ...Filter) HandlerOption

+ func NewGoKitDecoderHandlerOption(fn kit_http.DecodeRequestFunc) HandlerOption

+ func NewGoKitEncoderHandlerOption(fn kit_http.EncodeResponseFunc) HandlerOption

+ func NewGoKitErrorEncoderHandlerOption(fn kit_http.ErrorEncoder) HandlerOption

+ func NewRequestIDHandlerOption(formatter RequestIDFormatter, customHeaders ...string) HandlerOption

+ func NewSetRequestHeader(key, val string) HandlerOption

+ func NewSetResponseHeader(key, val string) HandlerOption

+ type KeyValue struct

+ Key string

+ Value string

+ type MetricsNameFormatter func(namespace string, r *http.Request) string

+ type Middleware endpoint.Middleware

+ type Muxer interface

+ Handler func(method, url string, fn http.Handler)

+ URLParser func() URLParser

+ func NewDefaultMux(opts ...DefaultMuxOption) Muxer

+ func NewGorillaMux() Muxer

+ type OpenTelemetryProvider interface

+ type PanicCallback func(*PanicInformation)

+ type PanicFormatter interface

+ Format func(http.ResponseWriter, *http.Request, *PanicInformation)

+ type PanicFormatterType uint

+ const HTMLPanicFormatter

+ const TextPanicFormatter

+ type PanicInformation struct

+ RecoveredPanic interface{}

+ Request *http.Request

+ Stack []byte

+ func (p *PanicInformation) RequestInfo() string

+ func (p *PanicInformation) StackString() string

+ type RecoveryOption func(*recovery)

+ func WithCustomFormatter(formatter PanicFormatter) RecoveryOption

+ func WithFormatterType(formatterType PanicFormatterType) RecoveryOption

+ func WithHTMLFormatter() RecoveryOption

+ func WithStack(stackSize int, stackOtherGoroutines bool) RecoveryOption

+ func WithTextFormatter() RecoveryOption

+ func WithoutStack() RecoveryOption

+ type RequestIDFormatter func(uuid string) string

+ type ResponseOption func(*net_http.Response)

+ func ResponseWithBytes(bt []byte) ResponseOption

+ func ResponseWithCode(code int) ResponseOption

+ func ResponseWithReader(reader io.Reader) ResponseOption

+ type SpanNameFormatter func(operation string, r *http.Request) string

+ type Transport struct

+ func NewHTTPTransport(name string, options ...TransportConfigOption) (*Transport, error)

+ func NewTransport(host, port string, options ...TransportOption) (*Transport, error)

+ func (tr *Transport) Close() error

+ func (tr *Transport) DELETE(url string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) Delete(url string, fn HandlerFunc, options ...HandlerOption)

+ func (tr *Transport) GET(uri string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) Get(url string, fn HandlerFunc, options ...HandlerOption)

+ func (tr *Transport) HANDLE(met, url string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) HEAD(url string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) Handle(method, url string, fn HandlerFunc, options ...HandlerOption)

+ func (tr *Transport) Head(url string, fn HandlerFunc, options ...HandlerOption)

+ func (tr *Transport) Mux() Muxer

+ func (tr *Transport) OPTION(url string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) Open() error

+ func (tr *Transport) Options(url string, fn HandlerFunc, options ...HandlerOption)

+ func (tr *Transport) PATCH(url string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) POST(url string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) PUT(url string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) Patch(url string, fn HandlerFunc, options ...HandlerOption)

+ func (tr *Transport) Post(url string, fn HandlerFunc, options ...HandlerOption)

+ func (tr *Transport) Put(url string, fn HandlerFunc, options ...HandlerOption)

+ func (tr *Transport) TRACE(url string, fn Handler, options ...HandlerOption)

+ func (tr *Transport) Trace(url string, fn HandlerFunc, options ...HandlerOption)

+ type TransportConfigOption func(*config) error

+ func WithCustomHeadersForRequestID(formatter RequestIDFormatter, headers ...string) TransportConfigOption

+ func WithCustomHostPort(host, port string) TransportConfigOption

+ func WithCustomLogger(logger log.Logger) TransportConfigOption

+ func WithCustomMetrics(provider metrics.Provider, formatter MetricsNameFormatter, tags ...KeyValue) TransportConfigOption

+ func WithCustomPanicFormatter(formatter PanicFormatter) TransportConfigOption

+ func WithCustomTimeouts(idle, read, write time.Duration) TransportConfigOption

+ func WithDefaultPanicFormatter(panicFormatterType PanicFormatterType) TransportConfigOption

+ func WithDefaultTransportOptions(options ...TransportOption) TransportConfigOption

+ func WithFilters(filters ...Filter) TransportConfigOption

+ func WithHeartbeats(heartbeats ...string) TransportConfigOption

+ func WithLogger(level string) TransportConfigOption

+ func WithNoLogging() TransportConfigOption

+ func WithNoMetrics() TransportConfigOption

+ func WithNoTraceLogging() TransportConfigOption

+ func WithOpenTelemetryMetrics(provider OpenTelemetryProvider, tags []KeyValue, filters ...otelhttp.Filter) TransportConfigOption

+ func WithVersion(version string) TransportConfigOption

+ type TransportOption func(*Transport)

+ func WithErrorEncoder(fn ErrorEncoder) TransportOption

+ func WithFullDefaults() TransportOption

+ func WithHandlerOption(options ...HandlerOption) TransportOption

+ func WithMuxer(mux Muxer) TransportOption

+ func WithTimeout(idle, write, read time.Duration) TransportOption

+ func WithTransportErrorEncoder(fn ErrorEncoder) TransportOption

+ type URLParams map[string]string

+ func (up URLParams) ByName(key string) (value string)

+ func (up URLParams) Param(key string) (value string, found bool)

+ type URLParamsParser interface

+ ByName func(string) string

+ func Parameters(r *http.Request) URLParamsParser

+ type URLParser interface

+ Parse func(r *http.Request) URLParams

+ type WrapResponseWriter interface

+ BytesWritten func() int

+ Status func() int

+ Tee func(io.Writer)

+ Unwrap func() http.ResponseWriter

+ func NewWrapResponseWriter(w http.ResponseWriter, protoMajor int) WrapResponseWriter

v2.0.0-rc3

Oct 16, 2023

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL