serv

Jun 19, 2024

Changes in this version

type ErrorLogger

+ func NewLogger(l *log.Logger) ErrorLogger

Jun 14, 2024

Changes in this version

+ const ErrServerClose

+ const ErrServerShutdown

May 31, 2024

Changes in this version

type Logger

+ LogServerClose func(name string)

+ LogServerShutdown func(name string)

+ LogServerStart func(name, addr string)

+ LogServerStartTLS func(name, addr, certFile, keyFile string)

May 19, 2024

Changes in this version

type Logger

+ ServerStartTLS func(name, addr, certFile, keyFile string)

May 3, 2024

Changes in this version

type Option

+ func WithTLSConfig(conf *tls.Config, opts ...easytls.Option) Option

May 3, 2024

Changes in this version

+ func NoContent(w http.ResponseWriter, _ *http.Request)

+ func NoContentHandler() http.Handler

+ type ErrorLogger interface

Apr 25, 2024

Changes in this version

type ServeMux

+ func (mux *ServeMux) ServeHTTP(wri http.ResponseWriter, req *http.Request)

+ func (mux *ServeMux) WithNotFoundHandler(h http.Handler) *ServeMux

Apr 22, 2024

Changes in this version

+ const CloseError

+ const ErrAlreadyStarted

+ const ErrAppendRootCAFailure

+ const ErrHandlerIsNoRouteHandler

+ const ErrUnableToClose

+ const ErrUnableToShutdown

+ const ErrUnableToStart

+ const ShutdownError

+ func AddHandlerName(name string, next http.Handler) http.Handler

+ func AddServerName(name string, next http.Handler) http.Handler

+ func GetCertificate(cl CertificateLoader) func(*tls.ClientHelloInfo) (*tls.Certificate, error)

+ func HandlerName(ctx context.Context) string

+ func RegisterRoutes(rh RouteHandler, routes ...Route)

+ func WriteJSON(w http.ResponseWriter, v any) error

+ func WriteJSONError(w http.ResponseWriter, err error) error

type Config

+ func (cfg *Config) IsZero() bool

+ type ErrorLoggerProvider interface

+ ErrorLogger func() *log.Logger

+ type InvalidStateError struct

+ Err error

+ State State

+ func (u InvalidStateError) Error() string

+ func (u InvalidStateError) Unwrap() error

type Option

+ func WithBaseContext(ctx context.Context) Option

+ func WithDefaultLogger() Option

+ func WithDefaultTLSConfig(opts ...TLSOption) Option

+ func WithErrorLogger(l *log.Logger) Option

+ func WithHandler(h http.Handler) Option

+ func WithRoutesRegisterer(reg ...RoutesRegisterer) Option

type Port

+ func (p *Port) Set(s string) (err error)

type PortParseError

+ Cause error

+ Input string

+ type Route struct

+ Handler http.Handler

+ Method string

+ Name string

+ Pattern string

+ func (r Route) ServeHTTP(wri http.ResponseWriter, req *http.Request)

+ type RouteHandler interface

+ HandleRoute func(route Route)

+ type Router interface

+ type RoutesRegisterer interface

+ RegisterRoutes func(rh RouteHandler)

+ type RoutesRegistererFunc func(rh RouteHandler)

+ func (fn RoutesRegistererFunc) RegisterRoutes(rh RouteHandler)

+ type ServeMux struct

+ func DefaultServeMux() *ServeMux

+ func NewServeMux() *ServeMux

+ func (mux *ServeMux) HandleRoute(route Route)

type Server

+ Addr string

+ Config Config

+ Handler http.Handler

+ func (srv *Server) State() State

+ func (srv *Server) With(opts ...Option) error

+ type State uint32

+ const StateClosed

+ const StateClosing

+ const StateErrored

+ const StateStarted

+ const StateUnstarted

+ func (s State) String() string

type TLSConfig

+ CACertFile string

+ VerifyClient bool

+ func (tc TLSConfig) ApplyTo(conf *tls.Config) error

type TLSKeyPair

+ func (kp TLSKeyPair) ApplyTo(conf *tls.Config) error

type TLSOption

+ ApplyTo func(conf *tls.Config) error

type TLSPemBlocks

+ func (pb TLSPemBlocks) ApplyTo(conf *tls.Config) error

May 23, 2023

Changes in this version

+ const ErrInvalidFormat

+ const ErrMissingPort

+ const ErrServerStarted

+ const ErrUnstartedClose

+ const ErrUnstartedShutdown

+ func BaseContext(ctx context.Context) func(_ net.Listener) context.Context

+ func DefaultTLSConfig() *tls.Config

+ func JoinHostPort(host string, port Port) string

+ func ServerName(ctx context.Context) string

+ type CertificateLoader interface

+ LoadCertificate func() (*tls.Certificate, error)

+ type Config struct

+ BaseContext func(net.Listener) context.Context

+ ConnContext func(context.Context, net.Conn) context.Context

+ IdleTimeout time.Duration

+ MaxHeaderBytes uint

+ ReadHeaderTimeout time.Duration

+ ReadTimeout time.Duration

+ ShutdownTimeout time.Duration

+ WriteTimeout time.Duration

+ func DefaultConfig() *Config

+ func DefaultConfigWithContext(ctx context.Context) *Config

+ func (cfg *Config) ApplyTo(s *http.Server)

+ func (cfg *Config) Default()

+ func (cfg *Config) WithIdleTimeout(v time.Duration) *Config

+ func (cfg *Config) WithMaxHeaderBytes(v uint) *Config

+ func (cfg *Config) WithReadHeaderTimeout(v time.Duration) *Config

+ func (cfg *Config) WithReadTimeout(v time.Duration) *Config

+ func (cfg *Config) WithShutdownTimeout(v time.Duration) *Config

+ func (cfg *Config) WithWriteTimeout(v time.Duration) *Config

+ type DefaultLogger struct

+ Logger *log.Logger

+ func (l *DefaultLogger) ServerClose(name string)

+ func (l *DefaultLogger) ServerShutdown(name string)

+ func (l *DefaultLogger) ServerStart(name, addr string)

+ type Logger interface

+ ServerClose func(name string)

+ ServerShutdown func(name string)

+ ServerStart func(name, addr string)

+ func NopLogger() Logger

+ type Option interface

+ func WithLogger(l Logger) Option

+ func WithMiddleware(mw ...middleware.Middleware) Option

+ func WithName(name string) Option

+ func WithOptions(opts ...Option) Option

+ func WithTLS(conf *tls.Config, opts ...TLSOption) Option

+ type Port uint16

+ func ParsePort(s string) (Port, error)

+ func SplitHostPort(hostport string) (string, Port, error)

+ func (p *Port) UnmarshalText(text []byte) (err error)

+ func (p Port) Addr() string

+ func (p Port) MarshalText() ([]byte, error)

+ func (p Port) String() string

+ type PortParseError struct

+ Err error

+ Text string

+ func (p *PortParseError) Error() string

+ func (p *PortParseError) Unwrap() error

+ type Server struct

+ ShutdownTimeout time.Duration

+ func New(mux http.Handler, opts ...Option) (*Server, error)

+ func NewDefault(mux http.Handler, opts ...Option) (*Server, error)

+ func (srv *Server) Close() error

+ func (srv *Server) ListenAndServe() error

+ func (srv *Server) ListenAndServeTLS(certFile, keyFile string) error

+ func (srv *Server) Name() string

+ func (srv *Server) RegisterOnShutdown(fn func())

+ func (srv *Server) Run(ctx context.Context) error

+ func (srv *Server) Serve(l net.Listener) error

+ func (srv *Server) ServeTLS(l net.Listener, certFile, keyFile string) error

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

+ type TLSConfig struct

+ CaCertFile string

+ CertFile string

+ InsecureSkipVerify bool

+ KeyFile string

+ func (tc TLSConfig) Apply(conf *tls.Config) error

+ func (tc TLSConfig) IsZero() bool

+ type TLSKeyPair struct

+ CertFile string

+ KeyFile string

+ func (kp TLSKeyPair) Apply(conf *tls.Config) error

+ func (kp TLSKeyPair) LoadCertificate() (*tls.Certificate, error)

+ type TLSOption interface

+ Apply func(conf *tls.Config) error

+ type TLSPemBlocks struct

+ Cert []byte

+ Key []byte

+ func (pb TLSPemBlocks) Apply(conf *tls.Config) error

+ func (pb TLSPemBlocks) LoadCertificate() (*tls.Certificate, error)