middlewares

package module

Go to main page

Versions in this module

v0

v0.3.2

Aug 11, 2026

v0.3.1

Aug 11, 2026

v0.3.0

Aug 11, 2026

Changes in this version

+ func KeyByHeader(name string) func(*http.Request) string

+ func KeyByIP() func(*http.Request) string

+ func LoggerFrom(ctx context.Context) *slog.Logger

+ type HSTS struct

+ IncludeSubDomains bool

+ MaxAge time.Duration

+ Preload bool

type LoggerOption

+ func WithContextLogger() LoggerOption

+ type MemoryRateLimitStore struct

+ func NewMemoryRateLimitStore() *MemoryRateLimitStore

+ func (s *MemoryRateLimitStore) Take(_ context.Context, key string, limit int, window time.Duration) (RateLimitResult, error)

type Middleware

+ func RateLimit(cfg RateLimitConfig, opts ...RateLimitOption) Middleware

+ type RateLimitConfig struct

+ Key func(*http.Request) string

+ Limit int

+ Store RateLimitStore

+ Window time.Duration

+ type RateLimitOption func(*rateLimitConfig)

+ func WithFailOpen() RateLimitOption

+ func WithRateLimitStatus(code int) RateLimitOption

+ type RateLimitResult struct

+ Allowed bool

+ Remaining int

+ Reset time.Time

+ RetryAfter time.Duration

+ type RateLimitStore interface

+ Take func(ctx context.Context, key string, limit int, window time.Duration) (RateLimitResult, error)

type SecurityOption

+ func WithHSTSPolicy(p HSTS) SecurityOption

v0.2.0

Aug 11, 2026

v0.1.2

Aug 11, 2026

v0.1.1

Jul 10, 2026

v0.1.0

Jul 8, 2026

Changes in this version

+ const DefaultCompressMinBytes

+ const DefaultRequestIDHeader

+ func Handler(next http.Handler, m ...Middleware) http.Handler

+ func RealIPFrom(ctx context.Context) string

+ func RequestIDFrom(ctx context.Context) string

+ type CORSOption func(*corsConfig)

+ func WithAllowCredentials() CORSOption

+ func WithAllowedHeaders(headers ...string) CORSOption

+ func WithAllowedMethods(methods ...string) CORSOption

+ func WithAllowedOrigins(origins ...string) CORSOption

+ func WithExposedHeaders(headers ...string) CORSOption

+ func WithMaxAge(seconds int) CORSOption

+ type CompressOption func(*compressConfig)

+ func WithCompressLevel(level int) CompressOption

+ func WithCompressMinBytes(n int) CompressOption

+ func WithCompressTypes(types ...string) CompressOption

+ type LoggerOption func(*loggerConfig)

+ func WithLogLevel(level slog.Level) LoggerOption

+ func WithLogMessage(msg string) LoggerOption

+ func WithLogger(l *slog.Logger) LoggerOption

+ func WithSkip(fn func(*http.Request) bool) LoggerOption

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

+ func CORS(opts ...CORSOption) Middleware

+ func Chain(m ...Middleware) Middleware

+ func Compress(opts ...CompressOption) Middleware

+ func Logger(opts ...LoggerOption) Middleware

+ func MaxBytes(n int64) Middleware

+ func RealIP(opts ...RealIPOption) Middleware

+ func Recoverer(opts ...RecovererOption) Middleware

+ func RequestID(opts ...RequestIDOption) Middleware

+ func SecurityHeaders(opts ...SecurityOption) Middleware

+ func Throttle(limit int, opts ...ThrottleOption) Middleware

+ func Timeout(d time.Duration, opts ...TimeoutOption) Middleware

+ type RealIPOption func(*realIPConfig)

+ func TrustLoopbackProxies() RealIPOption

+ func WithTrustedProxies(cidrs ...string) RealIPOption

+ type RecovererOption func(*recovererConfig)

+ func WithRecoverHandler(fn func(http.ResponseWriter, *http.Request, any)) RecovererOption

+ func WithRecoverLogger(l *slog.Logger) RecovererOption

+ type RequestIDOption func(*requestIDConfig)

+ func WithRequestIDGenerator(fn func() string) RequestIDOption

+ func WithRequestIDHeader(name string) RequestIDOption

+ func WithTrustedRequestIDHeader() RequestIDOption

+ type SecurityOption func(*securityConfig)

+ func WithCSP(policy string) SecurityOption

+ func WithFrameOptions(v string) SecurityOption

+ func WithHSTS(seconds int) SecurityOption

+ func WithReferrerPolicy(v string) SecurityOption

+ type ThrottleOption func(*throttleConfig)

+ func WithThrottleRetryAfter(seconds int) ThrottleOption

+ func WithThrottleStatus(code int) ThrottleOption

+ type TimeoutOption func(*timeoutConfig)

+ func WithTimeoutMessage(msg string) TimeoutOption

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