httpserver

Sep 4, 2026

Changes in this version

+ type Expander = expander.Interface

Aug 31, 2026

Changes in this version

+ type Action = cli.Action

type Option

+ func WithDefaultServerFactory() Option

+ func WithServer(srv *http.Server) Option

+ func WithServerFactory(fn func(context.Context) (*http.Server, error)) Option

type Server

+ func (s *Server) Addr() string

+ func (s *Server) NewServer(ctx context.Context) (*http.Server, error)

+ func (s *Server) Shutdown(ctx context.Context) error

Aug 4, 2026

Changes in this version

+ func NewRecoveryMiddleware(next http.Handler) http.Handler

type Server

+ func NewDefault() *Server

Jul 6, 2026

Changes in this version

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

Jun 24, 2026

Changes in this version

+ var DefaultShutdownFunc = ComposeReadyFuncs(ReportShutdown())

type ReadyFunc

+ func ReportShutdown() ReadyFunc

May 2, 2026

Changes in this version

+ func NewReloadHandler(s *Server) http.Handler

+ type Options struct

+ AccessLog *string

+ Addr *string

+ HideDirectoryListings *bool

+ Hostname *string

+ IdleTimeout *time.Duration

+ MaxHeaderBytes *int

+ Port *int

+ ReadHeaderTimeout *time.Duration

+ ReadTimeout *time.Duration

+ ServerHeader *string

+ ShutdownTimeout *time.Duration

+ StaticDirectory *string

+ TLSCertFile *string

+ TLSKeyFile *string

+ WriteTimeout *time.Duration

+ func (o *Options) Execute(ctx context.Context) error

Apr 22, 2026

Changes in this version

+ func SetHideDirectoryListings() cli.Action

type Option

+ func WithAction(a cli.Action) Option

+ func WithDefaultAction() Option

+ func WithHideDirectoryListings(v bool) Option

type Server

+ func (s *Server) Pipeline() cli.Action

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

Mar 23, 2026

Changes in this version

+ func HandleSpec(vpath httpclient.VirtualPath, spec HandlerSpec) cli.Action

type ReadyFunc

+ func ReloadServer() ReadyFunc

+ type ReloadableHandler interface

+ Invalidate func()

+ func NewReloadableHandler(fn func(context.Context) (http.Handler, error)) ReloadableHandler

type Server

+ func (s *Server) ReloadAll()

Mar 15, 2026

Changes in this version

+ func HandleFunc(path string, h http.HandlerFunc) cli.Action

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

type Option

+ func WithAccessLog(s string) Option

+ func WithIdleTimeout(d time.Duration) Option

+ func WithMaxHeaderBytes(n int) Option

+ func WithNoAccessLog() Option

+ func WithNoDirectoryListings() Option

+ func WithReadHeaderTimeout(d time.Duration) Option

+ func WithReadTimeout(d time.Duration) Option

+ func WithServerHeader(s string) Option

+ func WithStaticDirectory(path string) Option

+ func WithTLSCertFile(filename string) Option

+ func WithTLSKeyFile(filename string) Option

+ func WithWriteTimeout(d time.Duration) Option

type ReadyFunc

+ func (r ReadyFunc) Execute(c context.Context) error

type Server

+ func (s *Server) AddReadyFunc(ready ReadyFunc) error

+ func (s *Server) AddShutdownFunc(shutdown ReadyFunc) error

+ func (s *Server) Apply(opts ...Option)

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

+ func (s *Server) WithHandler(handler http.Handler) error

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

+ func (s *Server) WithReadyFunc(ready ReadyFunc) error

+ func (s *Server) WithShutdownFunc(shutdown ReadyFunc) error

Nov 17, 2025

Changes in this version

+ func NewEchoHandler(failsafe bool) http.Handler

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