httpserver

Feb 18, 2026

Changes in this version

+ var ErrInvalidFileHeader = errors.New("invalid file header")

+ func GetFormValue[T any](req *http.Request, key string, defaultValue T, validateFunc func(T) error) (T, error)

+ func GetQueryParam[T any](req *http.Request, key string, defaultValue T, validateFunc func(T) error) (T, error)

+ func SaveBodyToFile(resp http.ResponseWriter, req *http.Request, magicBytes []byte) (dir, filePath string, err error)

Feb 11, 2026

Changes in this version

+ const DefaultHost

+ const DefaultIdleTimeout

+ const DefaultPort

+ const DefaultReadHeaderTimeout

+ const DefaultReadTimeout

+ const DefaultWriteTimeout

+ const StartupCheckTimeout

+ var ErrInvalidBasePath = errors.New("httpserver: base path must be an absolute path without trailing slash")

+ var ErrInvalidContext = errors.New("httpserver: context must not be nil or cancelled")

+ var ErrInvalidHost = errors.New("httpserver: host must be a valid network address")

+ var ErrInvalidPort = errors.New("httpserver: port must be between 1 and 65535")

+ var ErrInvalidReadHeaderTimeout = errors.New("httpserver: read header timeout must be positive")

+ var ErrInvalidReadTimeout = errors.New("httpserver: read timeout must be positive")

+ var ErrMissingCertFile = errors.New("httpserver: cert file must be specified if key file is specified")

+ var ErrMissingKeyFile = errors.New("httpserver: key file must be specified if cert file is specified")

+ var ErrUnreadableCertFile = errors.New("httpserver: cert file must be readable")

+ var ErrUnreadableKeyFile = errors.New("httpserver: key file must be readable")

+ type Config struct

+ BasePath string

+ CertFile string

+ EnableH2C bool

+ Host string

+ IdleTimeout time.Duration

+ KeyFile string

+ Port int

+ ReadHeaderTimeout time.Duration

+ ReadTimeout time.Duration

+ WriteTimeout time.Duration

+ func (r *Config) SetDefaults()

+ func (r *Config) Validate() error

+ type HTTPServer struct

+ Log log.Logger

+ Server *http.Server

+ func New(cfg *Config, opts ...Option) *HTTPServer

+ func (s *HTTPServer) Start(ctx context.Context) error

+ func (s *HTTPServer) Stop(ctx context.Context) error

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

+ type Option func(*HTTPServer)

+ func WithHandler(handler http.Handler) Option

+ func WithLogger(logger log.Logger) Option

+ type Router struct

+ func NewRouter() *Router

+ func (r *Router) Group(configure func(r *Router))

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

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

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

+ func (r *Router) Use(middlewares ...Middleware)