Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

httpkit

package

Go to main page

Versions in this module

v0

v0.4.2

Feb 24, 2026

v0.4.1

Jan 19, 2026

v0.4.0

Sep 15, 2025

Changes in this version

+ func ErrorHTTP(w http.ResponseWriter, r *http.Request, err error, options ...ResponseOption)

+ func HTML(w http.ResponseWriter, r *http.Request, v []byte, options ...ResponseOption)

+ func JSON(w http.ResponseWriter, r *http.Request, v any, options ...ResponseOption)

+ func NewClient(options ...ClientOption) *http.Client

+ func ProfilerMiddleware() http.Handler

+ func SetHTMLTemplater(templater HTMLTemplateProvider)

+ func SetHTTPErrorResponder(responder HTTPErrorResponder)

+ func Status(w http.ResponseWriter, _ *http.Request, statusCode int, ...)

+ func TEXT(w http.ResponseWriter, r *http.Request, v []byte, options ...ResponseOption)

+ func TemplateHTML(w http.ResponseWriter, r *http.Request, name string, v any, ...)

+ type ClientOption func(config *Config)

+ func WithCustomDialer(dialer CustomDialer) ClientOption

+ func WithDialTimeout(timeout time.Duration) ClientOption

+ func WithKeepAliveDisabled(disabled bool) ClientOption

+ func WithKeepAliveTimeout(timeout time.Duration) ClientOption

+ func WithMaxIdleConns(maxn int) ClientOption

+ func WithMaxIdleConnsPerHost(maxn int) ClientOption

+ func WithReadBufferSize(size int) ClientOption

+ func WithResponseHeaderTimeout(timeout time.Duration) ClientOption

+ func WithRetries(options ...retry.Option) ClientOption

+ func WithTLSHandshakeTimeout(timeout time.Duration) ClientOption

+ func WithWriteBufferSize(size int) ClientOption

+ type Config struct

+ type CustomDialer interface

+ DialContext func(ctx context.Context, network, address string) (net.Conn, error)

+ type HTMLTemplateProvider interface

+ Template func(ctx context.Context, name string) (*template.Template, error)

+ type HTTPErrorResponder func(w http.ResponseWriter, err error, options ...ResponseOption)

+ type HealthConfig struct

+ type ListenerConfig struct

+ type ListenerHTTP struct

+ func NewListenerHTTP(addr string, options ...ListenerOption[ListenerConfig]) (*ListenerHTTP, error)

+ func (l *ListenerHTTP) Mount(route string, handler http.Handler, middlewares ...Middleware)

+ func (l *ListenerHTTP) MountGroup(route string, fn func(r chi.Router))

+ func (l *ListenerHTTP) Serve(ctx context.Context) error

+ type ListenerOption func(o *T)

+ func HTTPServerIdleTimeout(t time.Duration) ListenerOption[TimeoutsConfig]

+ func HTTPServerReadHeaderTimeout(t time.Duration) ListenerOption[TimeoutsConfig]

+ func HTTPServerReadTimeout(t time.Duration) ListenerOption[TimeoutsConfig]

+ func HTTPServerWriteTimeout(t time.Duration) ListenerOption[TimeoutsConfig]

+ func HealthCheckAccessLog(enable bool) ListenerOption[HealthConfig]

+ func HealthCheckMetricsForEndpoint(enable bool) ListenerOption[HealthConfig]

+ func HealthCheckReportHTML() ListenerOption[HealthConfig]

+ func HealthCheckReportJSON() ListenerOption[HealthConfig]

+ func HealthCheckRoute(route string) ListenerOption[HealthConfig]

+ func HealthChecker(checker hc.HealthChecker) ListenerOption[HealthConfig]

+ func MetricsAccessLog(enable bool) ListenerOption[MetricsConfig]

+ func MetricsMetricsForEndpoint(enable bool) ListenerOption[MetricsConfig]

+ func MetricsRoute(route string) ListenerOption[MetricsConfig]

+ func NewListenerOption[T ListenerOptionConstraint](options ...ListenerOption[T]) []ListenerOption[T]

+ func WithGlobalMiddlewares(middlewares ...Middleware) ListenerOption[ListenerConfig]

+ func WithHTTPServerTimeouts(options ...ListenerOption[TimeoutsConfig]) ListenerOption[ListenerConfig]

+ func WithHealthCheck(options ...ListenerOption[HealthConfig]) ListenerOption[ListenerConfig]

+ func WithLogger(logger *slog.Logger) ListenerOption[ListenerConfig]

+ func WithMetrics(options ...ListenerOption[MetricsConfig]) ListenerOption[ListenerConfig]

+ func WithProfiler(cfg PPROFConfig) ListenerOption[ListenerConfig]

+ func WithTLS(cert, key string) ListenerOption[ListenerConfig]

+ type ListenerOptionConstraint interface

+ type MetricsConfig struct

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

+ func CORSMiddleware(o cors.Options) Middleware

+ func LoggingMiddleware(logger *slog.Logger) Middleware

+ func MetricsMiddleware() Middleware

+ func RecoveryMiddleware() Middleware

+ func RedirectSlashesMiddleware() Middleware

+ type PPROFConfig struct

+ type ResponseOption func(o *ResponseOptions)

+ func WithErrorReport() ResponseOption

+ func WithHeader(key, value string) ResponseOption

+ func WithStatus(code int) ResponseOption

+ type ResponseOptions struct

+ func NewResponseOptions(w http.ResponseWriter, options ...ResponseOption) *ResponseOptions

+ type TimeoutsConfig struct