Add swaggo/swag formatter (#5749)

Co-authored-by: Fernandez Ludovic <[email protected]>

Author: cooperbenson-qz

.github/dependabot.yml

@@ -10,6 +10,7 @@ updates:
       # Ignore forked linters because of their versioning issues.
       - dependency-name: "github.com/golangci/dupl"
       - dependency-name: "github.com/golangci/gofmt"
+      - dependency-name: "github.com/golangci/swaggoswag"
       - dependency-name: "github.com/golangci/unconvert"
   - package-ecosystem: github-actions
     directory: "/"

.golangci.next.reference.yml

@@ -3975,6 +3975,7 @@ formatters:
     - gofumpt
     - goimports
     - golines
+    - swaggo
 
   # Formatters settings.
   settings:

go.mod

@@ -51,6 +51,7 @@ require (
 	github.com/golangci/misspell v0.6.0
 	github.com/golangci/plugin-module-register v0.1.1
 	github.com/golangci/revgrep v0.8.0
+	github.com/golangci/swaggoswag v0.0.0-20250504205917-77f2aca3143e
 	github.com/golangci/unconvert v0.0.0-20250410112200-a129a6e6413e
 	github.com/gordonklaus/ineffassign v0.1.0
 	github.com/gostaticanalysis/forcetypeassert v0.2.0

go.sum

@@ -837,7 +837,8 @@
         "gofmt",
         "gofumpt",
         "goimports",
-        "golines"
+        "golines",
+        "swaggo"
       ]
     },
     "settings": {

jsonschema/golangci.next.jsonschema.json

@@ -49,5 +49,5 @@ func (l *Linters) validateNoFormatters() error {
 }
 
 func getAllFormatterNames() []string {
-	return []string{"gci", "gofmt", "gofumpt", "goimports", "golines"}
+	return []string{"gci", "gofmt", "gofumpt", "goimports", "golines", "swaggo"}
 }

pkg/config/linters.go

@@ -12,6 +12,7 @@ import (
 	"github.com/golangci/golangci-lint/v2/pkg/goformatters/gofumpt"
 	"github.com/golangci/golangci-lint/v2/pkg/goformatters/goimports"
 	"github.com/golangci/golangci-lint/v2/pkg/goformatters/golines"
+	"github.com/golangci/golangci-lint/v2/pkg/goformatters/swaggo"
 	"github.com/golangci/golangci-lint/v2/pkg/logutils"
 )
 
@@ -41,6 +42,10 @@ func NewMetaFormatter(log logutils.Log, cfg *config.Formatters, runCfg *config.R
 		m.formatters = append(m.formatters, goimports.New(&cfg.Settings.GoImports))
 	}
 
+	if slices.Contains(cfg.Enable, swaggo.Name) {
+		m.formatters = append(m.formatters, swaggo.New())
+	}
+
 	// gci is a last because the only goal of gci is to handle imports.
 	if slices.Contains(cfg.Enable, gci.Name) {
 		formatter, err := gci.New(&cfg.Settings.Gci)
@@ -86,5 +91,5 @@ func (m *MetaFormatter) Format(filename string, src []byte) []byte {
 }
 
 func IsFormatter(name string) bool {
-	return slices.Contains([]string{gofmt.Name, gofumpt.Name, goimports.Name, gci.Name, golines.Name}, name)
+	return slices.Contains([]string{gofmt.Name, gofumpt.Name, goimports.Name, gci.Name, golines.Name, swaggo.Name}, name)
 }

pkg/goformatters/meta_formatter.go

@@ -0,0 +1,23 @@
+package swaggo
+
+import "github.com/golangci/swaggoswag"
+
+const Name = "swaggo"
+
+type Formatter struct {
+	formatter *swaggoswag.Formatter
+}
+
+func New() *Formatter {
+	return &Formatter{
+		formatter: swaggoswag.NewFormatter(),
+	}
+}
+
+func (*Formatter) Name() string {
+	return Name
+}
+
+func (f *Formatter) Format(path string, src []byte) ([]byte, error) {
+	return f.formatter.Format(path, src)
+}

pkg/goformatters/swaggo/swaggo.go

@@ -0,0 +1,23 @@
+package swaggo
+
+import (
+	"golang.org/x/tools/go/analysis"
+
+	"github.com/golangci/golangci-lint/v2/pkg/goanalysis"
+	"github.com/golangci/golangci-lint/v2/pkg/goformatters"
+	"github.com/golangci/golangci-lint/v2/pkg/goformatters/swaggo"
+	"github.com/golangci/golangci-lint/v2/pkg/golinters/internal"
+)
+
+const linterName = "swaggo"
+
+func New() *goanalysis.Linter {
+	a := goformatters.NewAnalyzer(
+		internal.LinterLogger.Child(linterName),
+		"Check if swaggo comments are formatted",
+		swaggo.New(),
+	)
+
+	return goanalysis.NewLinter(a.Name, a.Doc, []*analysis.Analyzer{a}, nil).
+		WithLoadMode(goanalysis.LoadModeSyntax)
+}

pkg/golinters/swaggo/swaggo.go

@@ -0,0 +1,19 @@
+package swaggo
+
+import (
+	"testing"
+
+	"github.com/golangci/golangci-lint/v2/test/testshared/integration"
+)
+
+func TestFromTestdata(t *testing.T) {
+	integration.RunTestdata(t)
+}
+
+func TestFix(t *testing.T) {
+	integration.RunFix(t)
+}
+
+func TestFixPathPrefix(t *testing.T) {
+	integration.RunFixPathPrefix(t)
+}