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

httpserver

package

Go to main page

Versions in this module

v0

v0.5.5

Dec 23, 2025

v0.5.4

Nov 17, 2025

Changes in this version

+ func NewEchoHandler(failsafe bool) http.Handler

v0.5.3

Nov 2, 2025

Changes in this version

+ var DefaultReadyFunc = ComposeReadyFuncs(ReportListening)

+ var ErrNotListening = errors.New("server is not listening")

+ var HandlerRegistry = &provider.Registry

+ func ContextValue(s *Server) cli.Action

+ func ExpandRequest(r *http.Request, ww wrapResponseWriter) expr.Expander

+ func FlagsAndArgs() cli.Action

+ func Handle(path string, h http.Handler) cli.Action

+ func ListHandlers() cli.Action

+ func NewHeaderMiddleware(name, value string) func(http.Handler) http.Handler

+ func NewPingHandler() http.Handler

+ func NewRequestLogger(format string, out io.Writer, next http.Handler) http.Handler

+ func OpenInBrowser(c context.Context)

+ func ReportListening(c context.Context)

+ func RunServer(actionopt ...cli.Action) cli.Action

+ func SetAccessLog(v ...string) cli.Action

+ func SetAddr(s ...string) cli.Action

+ func SetFileServerHandler(v ...httpclient.VirtualPath) cli.Action

+ func SetHandler(v ...httpclient.VirtualPath) cli.Action

+ func SetHostname(s ...string) cli.Action

+ func SetIdleTimeout(d ...time.Duration) cli.Action

+ func SetMaxHeaderBytes(v ...int) cli.Action

+ func SetNoAccessLog(v ...bool) cli.Action

+ func SetNoDirectoryListings() cli.Action

+ func SetOpenInBrowser() cli.Action

+ func SetPort(s ...int) cli.Action

+ func SetReadHeaderTimeout(d ...time.Duration) cli.Action

+ func SetReadTimeout(d ...time.Duration) cli.Action

+ func SetServer(v ...string) cli.Action

+ func SetShutdownTimeout(d ...time.Duration) cli.Action

+ func SetStaticDirectory(f ...*cli.File) cli.Action

+ func SetTLSCertFile(v ...*cli.File) cli.Action

+ func SetTLSKeyFile(v ...*cli.File) cli.Action

+ func SetWriteTimeout(d ...time.Duration) cli.Action

+ func SourceAnnotation() (string, string)

+ type HandlerSpec func(context.Context, httpclient.VirtualPath) (http.Handler, error)

+ func FileServerHandlerSpec() HandlerSpec

+ func RegistryHandlerSpec(name string) HandlerSpec

+ type MiddlewareFunc func(next http.Handler) http.Handler

+ type Option func(*Server)

+ func AddReadyFunc(ready ReadyFunc) Option

+ func AddShutdownFunc(shutdown ReadyFunc) Option

+ func WithAddr(addr string) Option

+ func WithHandler(handler http.Handler) Option

+ func WithHandlerFactory(f func(*Server) (http.Handler, error)) Option

+ func WithHostname(v string) Option

+ func WithMiddleware(m MiddlewareFunc) Option

+ func WithPort(v int) Option

+ func WithReadyFunc(ready ReadyFunc) Option

+ func WithShutdownFunc(shutdown ReadyFunc) Option

+ func WithShutdownTimeout(d time.Duration) Option

+ func (o Option) Execute(c context.Context) error

+ type ReadyFunc func(context.Context)

+ func ComposeReadyFuncs(v ...ReadyFunc) ReadyFunc

+ type Server struct

+ ShutdownTimeout time.Duration

+ TLSCertFile string

+ TLSKeyFile string

+ func DefaultServer() *Server

+ func FromContext(ctx context.Context) *Server

+ func New(options ...Option) *Server

+ func (s *Server) AddMiddleware(m MiddlewareFunc)

+ func (s *Server) Execute(c context.Context) error

+ func (s *Server) Handle(path string, h http.Handler) error

+ func (s *Server) HideDirectoryListing() bool

+ func (s *Server) ListenAndServe() error

+ func (s *Server) OpenInBrowser(path ...string) error

+ func (s *Server) ReportListening() error

+ func (s *Server) SetAccessLog(v string) error

+ func (s *Server) SetAddr(addr string) error

+ func (s *Server) SetHostname(name string) error

+ func (s *Server) SetIdleTimeout(v time.Duration) error

+ func (s *Server) SetMaxHeaderBytes(v int) error

+ func (s *Server) SetNoAccessLog(v bool) error

+ func (s *Server) SetNoDirectoryListings(v bool) error

+ func (s *Server) SetPort(port int) error

+ func (s *Server) SetReadHeaderTimeout(v time.Duration) error

+ func (s *Server) SetReadTimeout(v time.Duration) error

+ func (s *Server) SetServer(name string) error

+ func (s *Server) SetShutdownTimeout(d time.Duration) error

+ func (s *Server) SetStaticDirectory(path string) error

+ func (s *Server) SetTLSCertFile(v string) error

+ func (s *Server) SetTLSKeyFile(v string) error

+ func (s *Server) SetWriteTimeout(v time.Duration) error

v0.5.2

Apr 5, 2025

v0.5.1

Mar 2, 2025

v0.5.0

Jun 8, 2023

v0.4.0

May 17, 2023

v0.3.2

Mar 15, 2023

v0.3.1

Mar 14, 2023

v0.3.0

Mar 13, 2023

v0.2.0

Sep 5, 2022

v0.1.0

Jul 9, 2022