Simplicidade
que flui.
Uma toolkit Go moderna e minimalista para Chi, feita para construir coisas incríveis.
Uma toolkit Go moderna e minimalista para Chi, feita para construir coisas incríveis.
Decodificar, validar, escolher o status, definir o Content-Type. Todo handler Chi repete isso. O Kori leva esse trabalho para helpers: handlers retornam erro, structs fazem bind e validação em uma chamada.
func createUser(w http.ResponseWriter, r *http.Request) {
var body CreateUserBody
if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusBadRequest)
json.NewEncoder(w).Encode(map[string]string{"message": "invalid JSON"})
return
}
if err := validate.Struct(body); err != nil {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusUnprocessableEntity)
json.NewEncoder(w).Encode(map[string]string{"message": err.Error()})
return
}
user, err := db.Create(body.Name, body.Email)
if err != nil {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusConflict)
json.NewEncoder(w).Encode(map[string]string{"message": "email already in use"})
return
}
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusCreated)
json.NewEncoder(w).Encode(user)
}func createUser(w http.ResponseWriter, r *http.Request) error {
var body CreateUserBody
if err := kori.BindJSON(r, &body); err != nil {
return err // 400 or 422, with structured details
}
user, err := db.Create(body.Name, body.Email)
if err != nil {
return kori.Conflict("email already in use")
}
return kori.JSON(w, http.StatusCreated, user)
}JSON inválido retorna 400. Uma tag validate que falha retorna 422 com detalhes por campo. Qualquer outro erro vira um 500 que nunca expõe detalhes internos.
O Kori não é um framework. Ele registra rotas no seu chi.Router, aceita seus middlewares como estão e mantém http.ResponseWriter e *http.Request em toda assinatura. Adote um handler de cada vez.
r := chi.NewRouter()
r.Use(middleware.Logger)
// a plain Chi handler, untouched
r.Get("/health", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("ok"))
})
// Kori handlers on the same router
users := kori.Group(r, "/users", auth.Bearer(verify))
kori.GET(users, "/", listUsers)
kori.POST(users, "/", createUser)
kori.DELETE(users, "/{id}", deleteUser, kori.Use(requireAdmin))O pacote inteiro cabe em uma tela. Referência completa da API
GET · POST · PUT · PATCH · DELETERegistre handlers que retornam error em qualquer chi.Router.BindJSON · BindQuery · BindPath · BindHeader · BindForm · BindMultipartDecodifique em uma struct e valide com go-playground/validator em uma chamada.JSON · Text · NoContent · Redirect · RawJSONEscreva a resposta e retorne o erro na mesma linha.NotFound · BadRequest · Conflict · Unauthorized · NewErrorErros HTTP tipados com um único error handler substituível.Group · UseSub-routers com prefixo e middleware por rota.NewSSEWriter · SendJSON · PingServer-Sent Events para progresso e tokens de LLM.O módulo opcional kori/openapi lê as mesmas tags json, path, query e validate que você usa no binding. Suas structs viram a spec. Nenhuma anotação para manter sincronizada. Ler o guia de OpenAPI
type CreateUserBody struct {
Name string `json:"name" validate:"required,min=2"`
Email string `json:"email" validate:"required,email"`
}
kori.POST(r, "/users", createUser, spec.Route(openapi.RouteConfig{
Summary: "Create a user",
Body: &CreateUserBody{},
Responses: map[int]any{201: &User{}},
}))CreateUserBody:
type: object
required: [name, email]
properties:
name:
type: string
minLength: 2
email:
type: string
format: emailO Kori requer Go 1.26+ e Chi v5. Adicione a um router existente e converta os handlers no seu ritmo.