kern

package module

Go to main page

Versions in this module

v1

v1.0.2

Jul 30, 2026

v1.0.1

Jul 30, 2026

Changes in this version

+ func RequestIDFromContext(ctx context.Context) string

v1.0.0

Jul 30, 2026

v0

v0.2.0

Jul 30, 2026

Changes in this version

+ func GetRequestID(ctx context.Context) string

+ func LoggerFromContext(ctx context.Context) *slog.Logger

+ func RequestIDCtxKey() any

+ func SetLogger(ctx context.Context, l *slog.Logger) context.Context

v0.1.3

Jul 16, 2026

Changes in this version

+ type TestClient struct

+ func NewTestClient(app *App) *TestClient

+ func (tc *TestClient) Delete(path string) *httptest.ResponseRecorder

+ func (tc *TestClient) Do(req *http.Request) *httptest.ResponseRecorder

+ func (tc *TestClient) Get(path string) *httptest.ResponseRecorder

+ func (tc *TestClient) Post(path string, body io.Reader) *httptest.ResponseRecorder

+ func (tc *TestClient) PostJSON(path string, payload interface{}) *httptest.ResponseRecorder

+ func (tc *TestClient) Put(path string, body io.Reader) *httptest.ResponseRecorder

+ func (tc *TestClient) Request(method, path string, body io.Reader) *httptest.ResponseRecorder

+ func (tc *TestClient) WithHeader(key, value string) *TestClient

v0.1.2

Jul 16, 2026

v0.1.1

Jul 16, 2026

Changes in this version

+ var ErrEmptyRequestBody = errors.New("request body is empty")

+ var ErrInvalidBindTarget = errors.New("bind target must be a non-nil pointer to struct")

+ func IntPathConstraint(value string) bool

+ func IsBodyTooLarge(err error) bool

+ func SlugPathConstraint(value string) bool

+ func UUIDPathConstraint(value string) bool

+ func UintPathConstraint(value string) bool

+ type App struct

+ func Default() *App

+ func New(opts ...Option) *App

+ func (app *App) AddConstraints(method, path string, constraints Constraints, handler HandlerFunc)

+ func (app *App) AddNamedConstraints(name, method, path string, constraints Constraints, handler HandlerFunc)

+ func (app *App) DELETE(path string, handler HandlerFunc)

+ func (app *App) DELETENamed(name, path string, handler HandlerFunc)

+ func (app *App) GET(path string, handler HandlerFunc)

+ func (app *App) GETNamed(name, path string, handler HandlerFunc)

+ func (app *App) Group(prefix string, middlewares ...MiddlewareFunc) *Group

+ func (app *App) HEAD(path string, handler HandlerFunc)

+ func (app *App) HEADNamed(name, path string, handler HandlerFunc)

+ func (app *App) OPTIONS(path string, handler HandlerFunc)

+ func (app *App) OPTIONSNamed(name, path string, handler HandlerFunc)

+ func (app *App) OnError(hook ErrorHook)

+ func (app *App) OnListen(hook ListenHook)

+ func (app *App) OnRoute(hook RouteHook)

+ func (app *App) OnShutdown(hook ShutdownHook)

+ func (app *App) PATCH(path string, handler HandlerFunc)

+ func (app *App) PATCHNamed(name, path string, handler HandlerFunc)

+ func (app *App) POST(path string, handler HandlerFunc)

+ func (app *App) POSTNamed(name, path string, handler HandlerFunc)

+ func (app *App) PUT(path string, handler HandlerFunc)

+ func (app *App) PUTNamed(name, path string, handler HandlerFunc)

+ func (app *App) Route(method, path string, handler HandlerFunc)

+ func (app *App) RouteByName(name string) (RouteInfo, bool)

+ func (app *App) RouteNamed(name, method, path string, handler HandlerFunc)

+ func (app *App) Routes() []RouteInfo

+ func (app *App) Run(addr string, opts ...RunOption) error

+ func (app *App) RunTLS(addr, certFile, keyFile string, opts ...RunOption) error

+ func (app *App) ServeHTTP(w http.ResponseWriter, r *http.Request)

+ func (app *App) Static(prefix, dir string)

+ func (app *App) Use(middlewares ...MiddlewareFunc)

+ type BasicAuthConfig struct

+ Password string

+ Realm string

+ Username string

+ ValidateCredentials func(username, password string, r *http.Request) bool

+ type BearerAuthConfig struct

+ Realm string

+ Token string

+ ValidateToken func(token string, r *http.Request) bool

+ type CORSConfig struct

+ AllowCredentials bool

+ AllowHeaders []string

+ AllowMethods []string

+ AllowOrigins []string

+ ExposeHeaders []string

+ MaxAge int

+ PreflightContinue bool

+ type Constraints struct

+ Path PathConstraints

+ Validate MiddlewareFunc

+ type Context struct

+ Request *http.Request

+ Response http.ResponseWriter

+ func (c *Context) Accepted(data interface{}) error

+ func (c *Context) Bind(data interface{}) error

+ func (c *Context) BindForm(data interface{}) error

+ func (c *Context) BindHeader(data interface{}) error

+ func (c *Context) BindQuery(data interface{}) error

+ func (c *Context) Body() ([]byte, error)

+ func (c *Context) CheckPreconditions(etag string, modTime time.Time) bool

+ func (c *Context) ClientIP() string

+ func (c *Context) Context() context.Context

+ func (c *Context) Cookie(name string) (*http.Cookie, error)

+ func (c *Context) Created(data interface{}) error

+ func (c *Context) Data(status int, contentType string, data []byte) error

+ func (c *Context) DecodeJSON(data interface{}) error

+ func (c *Context) DecodeXML(data interface{}) error

+ func (c *Context) DefaultQuery(name, defaultValue string) string

+ func (c *Context) DownloadFile(filepath string, downloadName string) error

+ func (c *Context) ETag(tag string) string

+ func (c *Context) Error(status int, message string) error

+ func (c *Context) File(name string) (*multipart.FileHeader, error)

+ func (c *Context) Form(name string) string

+ func (c *Context) GetHeader(key string) string

+ func (c *Context) HTML(status int, html string) error

+ func (c *Context) HeaderBool(key string, defaultValue bool) (bool, error)

+ func (c *Context) HeaderInt(key string, defaultValue int) (int, error)

+ func (c *Context) IsNotModified(etag string, modTime time.Time) bool

+ func (c *Context) JSON(status int, data interface{}) error

+ func (c *Context) JSONError(status int, message string, details ...interface{}) error

+ func (c *Context) LastModified(modTime time.Time)

+ func (c *Context) Logger() *slog.Logger

+ func (c *Context) Method() string

+ func (c *Context) NoContent(status int)

+ func (c *Context) OK(data interface{}) error

+ func (c *Context) Param(name string) string

+ func (c *Context) Path() string

+ func (c *Context) Query(name string) string

+ func (c *Context) QueryBool(name string, defaultValue bool) (bool, error)

+ func (c *Context) QueryInt(name string, defaultValue int) (int, error)

+ func (c *Context) QueryPair(name1, name2 string) (string, string)

+ func (c *Context) QueryPairDefault(name1, default1, name2, default2 string) (string, string)

+ func (c *Context) QueryPairDefaultRaw(name1, default1, name2, default2 string) (string, string)

+ func (c *Context) QueryPairRaw(name1, name2 string) (string, string)

+ func (c *Context) Redirect(status int, url string)

+ func (c *Context) SaveFile(file *multipart.FileHeader, path string) error

+ func (c *Context) ServeStatic(dir string) error

+ func (c *Context) SetCookie(cookie *http.Cookie)

+ func (c *Context) SetHeader(key, value string)

+ func (c *Context) SetLogger(logger *slog.Logger)

+ func (c *Context) Status(status int)

+ func (c *Context) StreamFile(filepath string) error

+ func (c *Context) Text(status int, format string, values ...interface{}) error

+ func (c *Context) TextPair(status int, left, sep, right string) error

+ func (c *Context) XML(status int, data interface{}) error

+ type Error struct

+ Code int

+ Message string

+ func NewError(code int, message string) *Error

+ func (e *Error) Error() string

+ type ErrorHook func(error)

+ type FieldValidationError struct

+ Field string

+ Param string

+ Tag string

+ Value interface{}

+ type Group struct

+ func (g *Group) AddConstraints(method, path string, constraints Constraints, handler HandlerFunc)

+ func (g *Group) AddNamedConstraints(name, method, path string, constraints Constraints, handler HandlerFunc)

+ func (g *Group) DELETE(path string, handler HandlerFunc)

+ func (g *Group) DELETENamed(name, path string, handler HandlerFunc)

+ func (g *Group) GET(path string, handler HandlerFunc)

+ func (g *Group) GETNamed(name, path string, handler HandlerFunc)

+ func (g *Group) Group(prefix string, middlewares ...MiddlewareFunc) *Group

+ func (g *Group) HEAD(path string, handler HandlerFunc)

+ func (g *Group) HEADNamed(name, path string, handler HandlerFunc)

+ func (g *Group) OPTIONS(path string, handler HandlerFunc)

+ func (g *Group) OPTIONSNamed(name, path string, handler HandlerFunc)

+ func (g *Group) PATCH(path string, handler HandlerFunc)

+ func (g *Group) PATCHNamed(name, path string, handler HandlerFunc)

+ func (g *Group) POST(path string, handler HandlerFunc)

+ func (g *Group) POSTNamed(name, path string, handler HandlerFunc)

+ func (g *Group) PUT(path string, handler HandlerFunc)

+ func (g *Group) PUTNamed(name, path string, handler HandlerFunc)

+ func (g *Group) Use(middlewares ...MiddlewareFunc)

+ type HandlerFunc func(c *Context)

+ type JSONErrorPayload struct

+ Details interface{}

+ Error string

+ type ListenHook func(ListenInfo)

+ type ListenInfo struct

+ Addr string

+ TLS bool

+ type LoggerConfig struct

+ Fields map[string]interface{}

+ Format string

+ Logger *log.Logger

+ Output io.Writer

+ SLogger *slog.Logger

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

+ func BasicAuth(username, password string) MiddlewareFunc

+ func BasicAuthWithConfig(config BasicAuthConfig) MiddlewareFunc

+ func BearerAuth(token string) MiddlewareFunc

+ func BearerAuthWithConfig(config BearerAuthConfig) MiddlewareFunc

+ func CORS(allowOrigins []string) MiddlewareFunc

+ func CORSWithConfig(config CORSConfig) MiddlewareFunc

+ func Logger(configs ...LoggerConfig) MiddlewareFunc

+ func Recovery() MiddlewareFunc

+ type Option func(*App)

+ func WithBodyLimit(limit int64) Option

+ func WithDebug() Option

+ func WithLogger() Option

+ func WithRecovery() Option

+ func WithSlogLogger(logger *slog.Logger) Option

+ func WithStrictProxyHeaders(enabled bool) Option

+ func WithStrictRequestParsing(enabled bool) Option

+ func WithTrustedProxies(entries ...string) Option

+ type PathConstraint func(value string) bool

+ type PathConstraints map[string]PathConstraint

+ type RouteHook func(RouteInfo)

+ type RouteInfo struct

+ Method string

+ Name string

+ Path string

+ type RunOption func(*serverConfig)

+ func WithGracefulShutdown(timeout time.Duration) RunOption

+ func WithIdleTimeout(duration time.Duration) RunOption

+ func WithKeepAlivesEnabled(enabled bool) RunOption

+ func WithMaxHeaderBytes(max int) RunOption

+ func WithReadHeaderTimeout(duration time.Duration) RunOption

+ func WithReadTimeout(duration time.Duration) RunOption

+ func WithWriteTimeout(duration time.Duration) RunOption

+ type ShutdownHook func(error)

+ type ValidationErrors []FieldValidationError

+ func (e ValidationErrors) Error() string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL