Groups
kori.Group creates a sub-router with a shared URL prefix and optional middleware.
Creating groups
Section titled “Creating groups”func Group(r chi.Router, prefix string, middlewares ...Middleware) *kori.RouterPass a chi.Router and a prefix. The returned *kori.Router embeds chi.Router, so it is a valid router for further registrations and nesting.
api := kori.Group(r, "/api")
kori.GET(api, "/users", listUsers) // GET /api/userskori.POST(api, "/users", createUser) // POST /api/usersShared prefixes
Section titled “Shared prefixes”Routes registered on a group inherit its prefix automatically:
r := chi.NewRouter()
api := kori.Group(r, "/api")users := kori.Group(api, "/users")products := kori.Group(api, "/products")
kori.GET(users, "/", listUsers) // GET /api/userskori.GET(users, "/{id}", getUser) // GET /api/users/{id}kori.POST(users, "/", createUser) // POST /api/users
kori.GET(products, "/", listProducts) // GET /api/productskori.GET(products, "/{id}", getProduct) // GET /api/products/{id}Shared middleware
Section titled “Shared middleware”Middleware passed to Group applies to every route in that group, and is inherited by any nested group:
api := kori.Group(r, "/api", authMiddleware, logMiddleware)
kori.GET(api, "/users", listUsers) // authMiddleware + logMiddleware applykori.POST(api, "/users", createUser) // authMiddleware + logMiddleware applyOrganizing APIs
Section titled “Organizing APIs”Groups compose naturally with nesting. A common pattern is a public API alongside a protected admin section:
r := chi.NewRouter()r.Use(middleware.Logger)r.Use(middleware.Recoverer)
// Public routeskori.GET(r, "/health", healthCheck)
// Authenticated APIapi := kori.Group(r, "/api", authMiddleware)
kori.GET(api, "/todos", listTodos)kori.POST(api, "/todos", createTodo)kori.GET(api, "/todos/{id}", getTodo)kori.PUT(api, "/todos/{id}", updateTodo)kori.DELETE(api, "/todos/{id}", deleteTodo)
// Admin sub-group with additional middlewareadmin := kori.Group(api, "/admin", adminOnlyMiddleware)
kori.GET(admin, "/stats", statsHandler)kori.DELETE(admin, "/users/{id}", deleteUser)This produces:
GET /api/todos → authMiddlewarePOST /api/todos → authMiddlewareGET /api/todos/{id} → authMiddlewarePUT /api/todos/{id} → authMiddlewareDELETE /api/todos/{id} → authMiddlewareGET /api/admin/stats → authMiddleware + adminOnlyMiddlewareDELETE /api/admin/users/{id} → authMiddleware + adminOnlyMiddlewarePer-route middleware
Section titled “Per-route middleware”Middleware can also be attached to individual routes using kori.Use. See Middleware for details.