Merge pull request #1444 from gofiber/codex/2025-10-31-13-04-48

Author: ReneWerner87

.github/workflows/golangci-lint.yml

@@ -42,8 +42,23 @@ jobs:
         uses: dorny/paths-filter@v3
         with:
           filters: ${{ steps.filter-setup.outputs.filters }}
+
+      - name: Set packages
+        id: set-packages
+        run: |
+          # If this is a push to master or main, build a JSON array of all packages.
+          # Otherwise, use the filtered list of changed packages.
+          if [[ "${{ github.event_name }}" == "push" ]]; then
+            packages=$(find v3 -mindepth 1 -maxdepth 1 -type d -exec basename {} \; | sort | awk 'BEGIN{first=1; printf "["} {if(!first) printf ","; printf "\"%s\"", $0; first=0} END{printf "]"}')
+          else
+            packages='${{ steps.filter.outputs.changes }}'
+          fi
+          echo "packages<<EOF" >> $GITHUB_OUTPUT
+          echo "$packages" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+        shell: bash
     outputs:
-      packages: ${{ steps.filter.outputs.changes || '[]' }}
+      packages: ${{ steps.set-packages.outputs.packages }}
 
   lint:
     needs: changes

.github/workflows/test-swaggerui.yml

@@ -0,0 +1,34 @@
+name: "Test swaggerui"
+
+on:
+  push:
+    branches:
+      - master
+      - main
+    paths:
+      - 'v3/swaggerui/**/*.go'
+      - 'v3/swaggerui/go.mod'
+      - 'v3/swaggerui/go.sum'
+  pull_request:
+    paths:
+      - 'v3/swaggerui/**/*.go'
+      - 'v3/swaggerui/go.mod'
+      - 'v3/swaggerui/go.sum'
+
+jobs:
+  Tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        go-version:
+          - 1.25.x
+    steps:
+      - name: Fetch Repository
+        uses: actions/checkout@v5
+      - name: Install Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '${{ matrix.go-version }}'
+      - name: Run Test
+        working-directory: ./v3/swaggerui
+        run: go test -v -race ./...

.github/workflows/test-swagger.yml renamed to .github/workflows/test-swaggo.yml

@@ -1,17 +1,19 @@
-name: "Test swagger"
+name: "Test swaggo"
 
 on:
   push:
     branches:
       - master
       - main
     paths:
-      - 'v3/swagger/**/*.go'
-      - 'v3/swagger/go.mod'
+      - 'v3/swaggo/**/*.go'
+      - 'v3/swaggo/go.mod'
+      - 'v3/swaggo/go.sum'
   pull_request:
     paths:
-      - 'v3/swagger/**/*.go'
-      - 'v3/swagger/go.mod'
+      - 'v3/swaggo/**/*.go'
+      - 'v3/swaggo/go.mod'
+      - 'v3/swaggo/go.sum'
 
 jobs:
   Tests:
@@ -28,5 +30,5 @@ jobs:
         with:
           go-version: '${{ matrix.go-version }}'
       - name: Run Test
-        working-directory: ./v3/swagger
+        working-directory: ./v3/swaggo
         run: go test -v -race ./...

README.md

@@ -37,7 +37,8 @@ Repository for third party middlewares and service implementations, with depende
 * [otel (opentelemetry)](./v3/otel/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+otel%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-otel.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="otel workflow status" /> </a>
 * [paseto](./v3/paseto/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+paseto%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-paseto.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="paseto workflow status" /> </a>
 * [socket.io](./v3/socketio/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+socketio%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-socketio.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="socket.io workflow status" /> </a>
-* [swagger](./v3/swagger/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+swagger%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-swagger.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="swagger workflow status" /> </a>
+* [swaggo](./v3/swaggo/README.md) _(formerly `swagger`)_ <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+swaggo%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-swaggo.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="swaggo workflow status" /> </a>
+* [swaggerui](./v3/swaggerui/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+swaggerui%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-swaggerui.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="swaggerui workflow status" /> </a>
 * [websocket](./v3/websocket/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+websocket%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-websocket.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="websocket workflow status" /> </a>
 
 ## 🥡 Service Implementations

go.work

@@ -15,7 +15,8 @@ use (
 ./v3/paseto
 ./v3/sentry
 ./v3/socketio
-./v3/swagger
+    ./v3/swaggo
+./v3/swaggerui
 ./v3/testcontainers
 ./v3/websocket
 ./v3/zap

v3/README.md

@@ -35,7 +35,8 @@ Repository for third party middlewares and service implementations, with depende
 * [otel (opentelemetry)](./otel/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+otel%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-otel.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="otel workflow status" /> </a>
 * [paseto](./paseto/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+paseto%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-paseto.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="paseto workflow status" /> </a>
 * [socket.io](./socketio/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+socketio%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-socketio.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="socket.io workflow status" /> </a>
-* [swagger](./swagger/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+swagger%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-swagger.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="swagger workflow status" /> </a>
+* [swaggo](./swaggo/README.md) _(formerly `swagger`)_ <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+swaggo%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-swaggo.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="swaggo workflow status" /> </a>
+* [swaggerui](./swaggerui/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+swaggerui%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-swaggerui.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="swaggerui workflow status" /> </a>
 * [websocket](./websocket/README.md) <a href="https://github.com/gofiber/contrib/actions?query=workflow%3A%22Test+websocket%22"> <img src="https://img.shields.io/github/actions/workflow/status/gofiber/contrib/test-websocket.yml?branch=main&label=%F0%9F%A7%AA%20&style=flat&color=75C46B" alt="websocket workflow status" /> </a>
 
 ## 🥡 Service Implementations

v3/swagger/README.md renamed to v3/swaggerui/README.md

@@ -1,15 +1,15 @@
 ---
-id: swagger
-title: Swagger
+id: swaggerui
+title: Swagger UI Middleware
 ---
 
-# Swagger
+# Swagger UI Middleware
 
-![Release](https://img.shields.io/github/v/tag/gofiber/contrib?filter=swagger*)
+![Release](https://img.shields.io/github/v/tag/gofiber/contrib?filter=swaggerui*)
 [![Discord](https://img.shields.io/discord/704680098577514527?style=flat&label=%F0%9F%92%AC%20discord&color=00ACD7)](https://gofiber.io/discord)
-![Test](https://github.com/gofiber/contrib/workflows/Test%20swagger/badge.svg)
+![Test](https://github.com/gofiber/contrib/workflows/Test%20swaggerui/badge.svg)
 
-Swagger middleware for [Fiber](https://github.com/gofiber/fiber). The middleware handles Swagger UI.
+Swagger UI middleware for [Fiber](https://github.com/gofiber/fiber). This handler serves pre-generated Swagger/OpenAPI specs via the swagger-ui package.
 
 
 **Compatible with Fiber v3.**
@@ -27,64 +27,64 @@ We only support the latest two versions of Go. Visit [https://go.dev/doc/devel/r
 
 ### Signatures
 ```go
-func New(config ...swagger.Config) fiber.Handler
+func New(config ...swaggerui.Config) fiber.Handler
 ```
 
 ### Installation
 Swagger is tested on the latests [Go versions](https://golang.org/dl/) with support for modules. So make sure to initialize one first if you didn't do that yet:
 ```bash
 go mod init github.com/<user>/<repo>
 ```
-And then install the swagger middleware:
+And then install the Swagger UI middleware:
 ```bash
-go get github.com/gofiber/contrib/v3/swagger
+go get github.com/gofiber/contrib/v3/swaggerui
 ```
 
 ### Examples
 Import the middleware package
 ```go
 import (
   "github.com/gofiber/fiber/v3"
-  "github.com/gofiber/contrib/v3/swagger"
+  "github.com/gofiber/contrib/v3/swaggerui"
 )
 ```
 
 Using the default config:
 ```go
-app.Use(swagger.New())
+app.Use(swaggerui.New())
 ```
 
 Using a custom config:
 ```go
-cfg := swagger.Config{
+cfg := swaggerui.Config{
     BasePath: "/",
     FilePath: "./docs/swagger.json",
     Path:     "swagger",
     Title:    "Swagger API Docs",
 }
 
-app.Use(swagger.New(cfg))
+app.Use(swaggerui.New(cfg))
 ```
 
 Use program data for Swagger content:
 ```go
-cfg := swagger.Config{
+cfg := swaggerui.Config{
     BasePath:    "/",
     FilePath:    "./docs/swagger.json",
     FileContent: mySwaggerByteSlice,
     Path:        "swagger",
     Title:       "Swagger API Docs",
 }
 
-app.Use(swagger.New(cfg))
+app.Use(swaggerui.New(cfg))
 ```
 
 Using multiple instances of Swagger:
 ```go
 // Create Swagger middleware for v1
 //
 // Swagger will be available at: /api/v1/docs
-app.Use(swagger.New(swagger.Config{
+app.Use(swaggerui.New(swaggerui.Config{
     BasePath: "/api/v1/",
     FilePath: "./docs/v1/swagger.json",
     Path:     "docs",
@@ -93,7 +93,7 @@ app.Use(swagger.New(swagger.Config{
 // Create Swagger middleware for v2
 //
 // Swagger will be available at: /api/v2/docs
-app.Use(swagger.New(swagger.Config{
+app.Use(swaggerui.New(swaggerui.Config{
     BasePath: "/api/v2/",
     FilePath: "./docs/v2/swagger.json",
     Path:     "docs",

v3/swagger/go.mod renamed to v3/swaggerui/go.mod

@@ -1,4 +1,4 @@
-module github.com/gofiber/contrib/v3/swagger
+module github.com/gofiber/contrib/v3/swaggerui
 
 go 1.25.0
 

v3/swagger/go.sum renamed to v3/swaggerui/go.sum

@@ -1,4 +1,4 @@
-package swagger
+package swaggerui
 
 import (
 	"encoding/json"