Added swagger support

hooks/post_gen_project.py

@@ -1,14 +1,25 @@
-import subprocess
+from subprocess import run
 
 GO_PACKAGES = [
-    "github.com/gofiber/fiber/v2"
+    "github.com/gofiber/fiber/v2",
+    "github.com/gofiber/swagger",
+]
+
+GO_INSTALL = [
+    "github.com/swaggo/swag/cmd/swag@latest"
 ]
 
 def main() -> int:
-    subprocess.run(["git", "init"])
+    run(["git", "init"])
 
     for package in GO_PACKAGES:
-        subprocess.run(["go", "get", "-u", package])
+        run(["go", "get", "-u", package])
+
+    for package in GO_INSTALL:
+        run(["go", "install", package])
+
+    run(["swag", "init", "-d", "internal/app"])
+
     return 0
 
 if __name__ == "__main__":

{{cookiecutter.project_name}}/internal/app/api/router.go

@@ -3,7 +3,7 @@ package api
 import (
 	"github.com/gofiber/fiber/v2"
 	"github.com/gofiber/fiber/v2/middleware/helmet"
-	"{{cookiecutter.module_path}}/internal/app/api/v1"
+	v1 "{{cookiecutter.module_path}}/internal/app/api/v1"
 )
 
 func ConfigureRoutes(app *fiber.App) error {

{{cookiecutter.project_name}}/internal/app/api/v1/router.go

@@ -5,14 +5,21 @@ import (
 	"github.com/gofiber/fiber/v2/middleware/requestid"
 )
 
+// @Summary		Endpoint for testing latency
+// @Description	Endpoint for testing latency
+// @Tags 		Health
+// @Success		200	{string} string
+// @Router		/api/v1/ping [get]
+func Ping(c *fiber.Ctx) error {
+	return c.SendString("pong")
+}
+
 func ConfigureRoutes(router fiber.Router) error {
 	v1 := router.Group("/v1")
 
 	v1.Use(requestid.New())
 
-	v1.Get("/ping", func(c *fiber.Ctx) error {
-		return c.SendString("pong")
-	})
+	v1.Get("/ping", Ping)
 
 	return nil
 }

{{cookiecutter.project_name}}/internal/app/main.go

@@ -5,9 +5,19 @@ import (
 	"github.com/gofiber/fiber/v2/middleware/compress"
 	"github.com/gofiber/fiber/v2/middleware/helmet"
 	"github.com/gofiber/fiber/v2/middleware/logger"
+	"github.com/gofiber/swagger"
+	_ "{{cookiecutter.module_path}}/docs"
 	"{{cookiecutter.module_path}}/internal/app/api"
 )
 
+// @title           {{cookiecutter.project_name}} API
+// @version         1.0
+// @description     Documentation for the {{cookiecutter.project_name}} API.
+
+// @securityDefinitions.apikey	ApiKeyAuth
+// @in							header
+// @name						Authorization
+// @description					Token used to authenticate against the API.
 func Run() error {
 	app := fiber.New()
 
@@ -15,6 +25,11 @@ func Run() error {
 	app.Use(compress.New())
 	app.Use(helmet.New())
 
+	// Prefork is only enabled in prod-mode.
+	if !app.Config().Prefork {
+		app.Get("/swagger/*", swagger.HandlerDefault)
+	}
+
 	api.ConfigureRoutes(app)
 
 	return app.Listen(":3000")

{{cookiecutter.project_name}}/justfile

@@ -34,4 +34,7 @@ stop: ## Stop the container
 start: ## Start the container
 	podman start {{project_name}}
 
+swagger: ## Generate swagger documentation
+	swag init -d internal/app
+
 {%- endraw %}