httpx

Dec 30, 2025

Changes in this version

type Router

+ func (r *Router) With(middleware ...func(http.Handler) http.Handler) *Router

Dec 19, 2025

Changes in this version

+ type ErrorFunc func(w http.ResponseWriter, r *http.Request, err error, opts ...ErrorOption)

+ type ErrorOption func(*errorConfig)

+ func WithHandler(fn ErrorFunc) ErrorOption

+ func WithHook(fn func(context.Context, error)) ErrorOption

+ func WithNoEnvelope() ErrorOption

+ func WithStatus(code int) ErrorOption

type Option

+ func WithErrorFunc(handler ErrorFunc) Option

Dec 19, 2025

Changes in this version

+ type ClientAuthBinder struct

+ func (b *ClientAuthBinder) Bind(r *http.Request, v any) error

+ func (b *ClientAuthBinder) Match(r *http.Request) bool

+ func (b *ClientAuthBinder) Name() string

+ func (b *ClientAuthBinder) Type() BinderType

Dec 19, 2025

Changes in this version

+ func GetAuthError(ctx context.Context) error

+ type AuthErrorKey struct

Dec 19, 2025

Changes in this version

+ var ErrNoCredentials = errors.New("no credentials found")

+ func DelCookie(w http.ResponseWriter, name string, opts ...CookieOption)

+ func GetCookie(r *http.Request, name string) (string, error)

+ func SetCookie(w http.ResponseWriter, name string, value string, opts ...CookieOption)

+ type AuthStrategy func(w http.ResponseWriter, r *http.Request) (any, error)

+ func AuthChain(strategies ...AuthStrategy) AuthStrategy

+ func FromCookie(name string, validator func(context.Context, string) (any, error)) AuthStrategy

+ func FromHeader(scheme string, validator func(context.Context, string) (any, error)) AuthStrategy

+ func FromQuery(param string, validator func(context.Context, string) (any, error)) AuthStrategy

+ func WithAuthChallenge(strategy AuthStrategy, headerKey, headerVal string) AuthStrategy

+ type CookieOption func(*http.Cookie)

+ func WithCookieDomain(domain string) CookieOption

+ func WithCookiePath(path string) CookieOption

+ func WithCookieTTL(duration time.Duration) CookieOption

+ func WithExposed() CookieOption

+ func WithInsecure() CookieOption

+ func WithSameSiteNone() CookieOption

+ func WithSameSiteStrict() CookieOption

type Middleware

+ func Auth(strategy AuthStrategy) Middleware

+ func AuthRequired(challengeWith http.HandlerFunc) Middleware

Dec 19, 2025

Changes in this version

+ func NewResponder[Req any, Res Responder](fn HandlerFunc[Req, Res], opts ...Option) http.HandlerFunc

+ type NoContent struct

+ Status int

+ func (nc NoContent) WriteResponse(w http.ResponseWriter, r *http.Request)

+ type RawBytes struct

+ ContentType string

+ Data []byte

+ Status int

+ func (rb RawBytes) WriteResponse(w http.ResponseWriter, r *http.Request)

+ type Redirect struct

+ Code int

+ URL string

+ func (rd Redirect) WriteResponse(w http.ResponseWriter, r *http.Request)

+ type Responder interface

+ WriteResponse func(w http.ResponseWriter, r *http.Request)

Dec 10, 2025

Changes in this version

+ func ClientIP(ctx context.Context) string

+ func NewClientIPMiddleware(trustedProxiesCIDR []string) func(http.Handler) http.Handler

+ type Router struct

+ func NewRouter() *Router

+ func (r *Router) Group(pattern string, middleware ...func(http.Handler) http.Handler) *Router

+ func (r *Router) Handle(pattern string, handler http.Handler)

+ func (r *Router) HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))

+ func (r *Router) ServeHTTP(w http.ResponseWriter, req *http.Request)

Nov 28, 2025

Changes in this version

+ var SafeMode = false

type HttpError

+ func (e *HttpError) PublicMessage() string

+ type PublicError interface

+ PublicMessage func() string

+ type SecurityConfig struct

+ CSP string

+ HSTSIncludeSubdomains bool

+ HSTSMaxAgeSeconds int

Nov 24, 2025

Changes in this version

+ func NewStreamHandler[Req any, Res Streamable](fn HandlerFunc[Req, Res], opts ...Option) http.HandlerFunc

Nov 21, 2025

Changes in this version

+ func RegisterOnShutdown(ctx context.Context, fn func())

type JsonBinder

+ DisallowUnknownFields bool

type Middleware

+ func SecurityHeaders() Middleware

+ type PathBinder struct

+ func (b *PathBinder) Bind(r *http.Request, v any) error

+ func (b *PathBinder) Match(r *http.Request) bool

+ func (b *PathBinder) Name() string

+ func (b *PathBinder) Type() BinderType

+ type ShutdownManager struct

+ func NewShutdownManager() *ShutdownManager

+ func (m *ShutdownManager) Middleware(next http.Handler) http.Handler

+ func (m *ShutdownManager) Shutdown(ctx context.Context) error

Nov 20, 2025

Changes in this version

+ const CodeRequestEntityTooLarge

+ const DefaultMultipartMemory

+ var ErrRequestEntityTooLarge = &HttpError

+ type FormBinder struct

+ MaxMemory int64

+ func (b *FormBinder) Bind(r *http.Request, v any) error

+ func (b *FormBinder) Match(r *http.Request) bool

+ func (b *FormBinder) Name() string

+ func (b *FormBinder) Type() BinderType

+ type JsonBinder struct

+ func (b *JsonBinder) Bind(r *http.Request, v any) error

+ func (b *JsonBinder) Match(r *http.Request) bool

+ func (b *JsonBinder) Name() string

+ func (b *JsonBinder) Type() BinderType

type Option

+ func WithMaxBodySize(maxBytes int64) Option

+ func WithMultipartLimit(limit int64) Option

+ type QueryBinder struct

+ func (b *QueryBinder) Bind(r *http.Request, v any) error

+ func (b *QueryBinder) Match(r *http.Request) bool

+ func (b *QueryBinder) Name() string

+ func (b *QueryBinder) Type() BinderType

Nov 19, 2025

Changes in this version

+ const CodeBadRequest

+ const CodeConflict

+ const CodeForbidden

+ const CodeInternalError

+ const CodeNotFound

+ const CodeOK

+ const CodeTooManyRequests

+ const CodeUnauthorized

+ const CodeValidation

+ var Binders = []Binder

+ var ErrForbidden = &HttpError

+ var ErrNotFound = &HttpError

+ var ErrTooManyRequests = &HttpError

+ var ErrUnauthorized = &HttpError

+ var SchemaDecoder = schema.NewDecoder()

+ type Binder interface

+ Bind func(r *http.Request, v any) error

+ Match func(r *http.Request) bool

+ Name func() string

+ Type func() BinderType

+ type BinderType int

+ const BinderBody

+ const BinderMeta

+ type BizCoder interface

+ BizStatus func() string

type HttpError

+ BizCode string

+ HttpCode int

+ func NewError(httpCode int, bizCode string, msg string) *HttpError

+ func (e *HttpError) BizStatus() string

+ type LogFunc func(r *http.Request, metrics httpsnoop.Metrics)

type Option

+ func AddBinders(b ...Binder) Option

+ func WithBinders(b ...Binder) Option

+ func WithErrorHook(hook func(ctx context.Context, err error)) Option

+ func WithValidator(v *validator.Validate) Option

Nov 19, 2025

Changes in this version

+ const IdentityKey

+ var Decoder = schema.NewDecoder()

+ var ErrBadRequest = &HttpError

+ var ErrInternal = &HttpError

+ var ErrValidation = &HttpError

+ var ErrorHook func(ctx context.Context, err error) = nil

+ var GetTraceID func(ctx context.Context) string = nil

+ var Validator = validator.New()

+ func Bind(r *http.Request, v any) error

+ func Chain(h http.Handler, mws ...Middleware) http.Handler

+ func Error(w http.ResponseWriter, r *http.Request, err error)

+ func GetIdentity(ctx context.Context) any

+ func NewHandler[Req any, Res any](fn HandlerFunc[Req, Res], opts ...Option) http.HandlerFunc

+ func Validate(ctx context.Context, v any) error

+ type AuthValidator func(ctx context.Context, token string) (any, error)

+ type BasicValidator func(ctx context.Context, user, pass string) (any, error)

+ type CORSOptions struct

+ AllowCredentials bool

+ AllowedHeaders []string

+ AllowedMethods []string

+ AllowedOrigins []string

+ ExposedHeaders []string

+ MaxAge int

+ type ErrorCoder interface

+ HTTPStatus func() int

+ type FileResponse struct

+ Content io.Reader

+ Name string

+ Size int64

+ Type string

+ func (f *FileResponse) Headers() map[string]string

+ func (f *FileResponse) WriteTo(w io.Writer) (int64, error)

+ type HandlerFunc func(ctx context.Context, req *Req) (Res, error)

+ type HttpError struct

+ Code int

+ Msg string

+ func (e *HttpError) Error() string

+ func (e *HttpError) HTTPStatus() int

+ type Limiter interface

+ Allow func(r *http.Request) bool

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

+ func AuthBasic(validator BasicValidator) Middleware

+ func AuthBearer(validator AuthValidator) Middleware

+ func CORS(opts CORSOptions) Middleware

+ func DefaultCORS() Middleware

+ func Logger(logFunc func(duration time.Duration, status int, path string)) Middleware

+ func RateLimit(limiter Limiter) Middleware

+ func Recovery(panicHook func(ctx context.Context, err interface{})) Middleware

+ type Option func(*config)

+ func NoEnvelope() Option

+ type Response struct

+ Code int

+ Data T

+ Message string

+ TraceID string

+ type SelfValidatable interface

+ Validate func(ctx context.Context) error

+ type Streamable interface

+ Headers func() map[string]string

+ WriteTo func(w io.Writer) (int64, error)