Skip to content

go-chi/chi/v5 — v5.5.0 snapshot

Pinned: v5.5.0 Source: tagged source

Router

import "github.com/go-chi/chi/v5"

r := chi.NewRouter()

// Middleware (applied in order)
r.Use(middleware.RequestID)
r.Use(middleware.RealIP)
r.Use(middleware.Recoverer)
r.Use(httpxmiddleware.Logger(logger, clk))

// Routes
r.Get("/", handler)
r.Post("/users", createUser)
r.Put("/users/{id}", updateUser)
r.Delete("/users/{id}", deleteUser)

// URL params
func handler(w http.ResponseWriter, r *http.Request) {
    id := chi.URLParam(r, "id")
}

Sub-routers and groups

r.Route("/api/v1", func(r chi.Router) {
    r.Use(authMiddleware)
    r.Get("/users", listUsers)
    r.Post("/users", createUser)
    r.Route("/users/{id}", func(r chi.Router) {
        r.Get("/", getUser)
        r.Put("/", updateUser)
    })
})

// Mount sub-router
r.Mount("/admin", adminRouter())

Middleware

// Built-in middleware
middleware.RequestID
middleware.RealIP
middleware.Recoverer
middleware.Compress(5)
middleware.StripSlashes
middleware.Timeout(30 * time.Second)
middleware.BasicAuth("realm", map[string]string{"user": "pass"})

Changes since v5.4.0

  • middleware.Deprecation added (RFC 9745); middleware.Sunset now follows RFC 8594 only.
  • middleware.Throttle rounds Retry-After up to whole seconds.
  • middleware.ContentCharset parses quoted media parameters.
  • middleware.SupressNotFound no longer mutates the request's route context.

golusoris usage

  • httpx/router/ — chi.Router provided via fx; ogen server mounted on it.
  • httpx/middleware/ — bounded recovery and slog-backed access logging. Prefer it over chi's standard-library middleware.Logger in Golusoris applications.