petstore

petstore — forge kit reference service

Runnable example of a REST service built with github.com/fromforgesoftware/forge/go/kit. Demonstrates:

• rest.WithOpenAPI(...) — auto-generated OpenAPI 3.1 spec for every registered route
• rest.HandlerWithOpenAPI(...) — per-route annotation (summary, description, tags, errors)
• openapi.SpecSecurityScheme + openapi.DefaultSecurity — bearer auth applied to all routes by default
• openapi.NoSecurity() — explicit per-route override (used by the mock login)
• Swagger UI — served at /docs, with a working Authorize button

Run

go run .

Then:

# Inspect the spec
curl http://localhost:8080/openapi.json | jq

# Open the interactive UI
open http://localhost:8080/docs

Try it from Swagger UI

1. Open http://localhost:8080/docs.
2. Hit POST /login-mock, send any username, copy the returned token.
3. Click Authorize at the top, paste the token, Authorize, Close.
4. Use any of the /v1/pets endpoints with "Try it out".

Endpoints

Layout

A single main.go for readability — domain, repo, HTTP handlers, and entry point in one file. A real service would split these into packages (internal/domain, internal/repository, internal/transport/http); this example deliberately doesn't, so the kit's surface is visible end-to-end at a glance.