package handlers
// @title Memoh API
// @version 1.0.0
import (
"log/slog"
"net/http"
"os"
"sync"
"github.com/labstack/echo/v4"
)
//go:generate go run github.com/swaggo/swag/cmd/swag@latest init -g swagger.go -o ../../spec --parseDependency --parseInternal
var (
swaggerSpec []byte
swaggerOnce sync.Once
swaggerErr error
)
type SwaggerHandler struct {
logger *slog.Logger
}
func NewSwaggerHandler(log *slog.Logger) *SwaggerHandler {
return &SwaggerHandler{logger: log.With(slog.String("handler", "swagger"))}
}
func (h *SwaggerHandler) Register(e *echo.Echo) {
e.GET("api/swagger.json", h.Spec)
e.GET("api/docs", h.UI)
e.GET("api/docs/", h.UI)
}
func (h *SwaggerHandler) Spec(c echo.Context) error {
swaggerOnce.Do(func() {
swaggerSpec, swaggerErr = os.ReadFile("spec/swagger.json")
})
if swaggerErr != nil {
return echo.NewHTTPError(http.StatusInternalServerError, swaggerErr.Error())
}
return c.Blob(http.StatusOK, "application/json", swaggerSpec)
}
func (h *SwaggerHandler) UI(c echo.Context) error {
return c.HTML(http.StatusOK, swaggerUIHTML)
}
const swaggerUIHTML = `
memoh-go Swagger UI
`