feat: upgrade exhaustruct to v4

- analyzer package is now distributed via vanity import as
  `dev.gaijin.team/go/exhaustruct/v4`.
- version introduced new features which, in turn, required usage
  of structure as configuration causing major version bump.

Author: xobotyi

.golangci.next.reference.yml

@@ -502,18 +502,45 @@ linters:
       default-case-required: true
 
     exhaustruct:
-      # List of regular expressions to match struct packages and their names.
-      # Regular expressions must match complete canonical struct package/name/structname.
-      # If this list is empty, all structs are tested.
+      # List of regular expressions to match type names that should be
+      # processed. Anonymous structs can be matched by '<anonymous>' alias.
+      #
+      # Each regular expression must match the full type name, including package path.
+      # For example, to match type `net/http.Cookie` regular expression should be
+      # `.*/http\.Cookie`, but not `http\.Cookie`.
+      #
       # Default: []
       include:
         - '.+\.Test'
         - 'example\.com/package\.ExampleStruct[\d]{1,2}'
-      # List of regular expressions to exclude struct packages and their names from checks.
-      # Regular expressions must match complete canonical struct package/name/structname.
+      # List of regular expressions to match type names that should be
+      # excluded from processing. Anonymous structs can be matched by '<anonymous>'
+      # alias.
+      # Has precedence over IncludeRx.
+      # Each regular expression must match the full type name, including package path.
+      # For example, to match type `net/http.Cookie` regular expression should be
+      # `.*/http\.Cookie`, but not `http\.Cookie`.
       # Default: []
       exclude:
         - '.+/cobra\.Command$'
+      # AllowEmpty allows empty structures, effectively excluding them from the check.
+      # Default: false
+      allow-empty: false
+      # List of regular expressions to match type names that should be
+      # allowed to be empty. Anonymous structs can be matched by '<anonymous>'
+      # alias.
+      # Each regular expression must match the full type name, including package path.
+      # For example, to match type `net/http.Cookie` regular expression should be
+      # `.*/http\.Cookie`, but not `http\.Cookie`.
+      # Default: []
+      allow-empty-rx:
+        - '.*/http\.Cookie'
+      # Allows empty structures in return statements.
+      # Default: false
+      allow-empty-returns: false
+      # Allows empty structures in variable declarations.
+      # Default: false
+      allow-empty-declarations: false
 
     fatcontext:
       # Check for potential fat contexts in struct pointers.

go.mod

@@ -5,6 +5,7 @@ go 1.23.0
 require (
 	4d63.com/gocheckcompilerdirectives v1.3.0
 	4d63.com/gochecknoglobals v0.2.2
+	dev.gaijin.team/go/exhaustruct/v4 v4.0.0
 	github.com/4meepo/tagalign v1.4.3
 	github.com/Abirdcfly/dupword v0.1.6
 	github.com/AlwxSin/noinlineerr v1.0.5
@@ -13,7 +14,6 @@ require (
 	github.com/Antonboom/testifylint v1.6.1
 	github.com/BurntSushi/toml v1.5.0
 	github.com/Djarvur/go-err113 v0.0.0-20210108212216-aea10b59be24
-	github.com/GaijinEntertainment/go-exhaustruct/v3 v3.3.1
 	github.com/OpenPeeDeeP/depguard/v2 v2.2.1
 	github.com/alecthomas/chroma/v2 v2.20.0
 	github.com/alecthomas/go-check-sumtype v0.3.1
@@ -145,6 +145,7 @@ require (
 
 require (
 	codeberg.org/chavacava/garif v0.2.0 // indirect
+	dev.gaijin.team/go/golib v0.6.0 // indirect
 	github.com/Masterminds/semver/v3 v3.3.1 // indirect
 	github.com/alfatraining/structtag v1.0.0 // indirect
 	github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
@@ -210,9 +211,8 @@ require (
 	github.com/valyala/bytebufferpool v1.0.0 // indirect
 	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
 	github.com/yusufpapurcu/wmi v1.2.4 // indirect
-	go.uber.org/atomic v1.7.0 // indirect
-	go.uber.org/multierr v1.6.0 // indirect
-	go.uber.org/zap v1.24.0 // indirect
+	go.uber.org/multierr v1.10.0 // indirect
+	go.uber.org/zap v1.27.0 // indirect
 	golang.org/x/exp v0.0.0-20240909161429-701f63a606c0 // indirect
 	golang.org/x/exp/typeparams v0.0.0-20250620022241-b7579e27df2b // indirect
 	golang.org/x/text v0.27.0 // indirect

go.sum

@@ -421,8 +421,12 @@ type ExhaustiveSettings struct {
 }
 
 type ExhaustructSettings struct {
-	Include []string `mapstructure:"include"`
-	Exclude []string `mapstructure:"exclude"`
+	Include                []string `mapstructure:"include"`
+	Exclude                []string `mapstructure:"exclude"`
+	AllowEmpty             bool     `mapstructure:"allow-empty"`
+	AllowEmptyRx           []string `mapstructure:"allow-empty-rx"`
+	AllowEmptyReturns      bool     `mapstructure:"allow-empty-returns"`
+	AllowEmptyDeclarations bool     `mapstructure:"allow-empty-declarations"`
 }
 
 type FatcontextSettings struct {

pkg/config/linters_settings.go

@@ -1,22 +1,25 @@
 package exhaustruct
 
 import (
-	exhaustruct "github.com/GaijinEntertainment/go-exhaustruct/v3/analyzer"
+	exhaustruct "dev.gaijin.team/go/exhaustruct/v4/analyzer"
 
 	"github.com/golangci/golangci-lint/v2/pkg/config"
 	"github.com/golangci/golangci-lint/v2/pkg/goanalysis"
 	"github.com/golangci/golangci-lint/v2/pkg/golinters/internal"
 )
 
 func New(settings *config.ExhaustructSettings) *goanalysis.Linter {
-	var include, exclude []string
-
+	cfg := exhaustruct.Config{}
 	if settings != nil {
-		include = settings.Include
-		exclude = settings.Exclude
+		cfg.IncludeRx = settings.Include
+		cfg.ExcludeRx = settings.Exclude
+		cfg.AllowEmpty = settings.AllowEmpty
+		cfg.AllowEmptyRx = settings.AllowEmptyRx
+		cfg.AllowEmptyReturns = settings.AllowEmptyReturns
+		cfg.AllowEmptyDeclarations = settings.AllowEmptyDeclarations
 	}
 
-	analyzer, err := exhaustruct.NewAnalyzer(include, exclude)
+	analyzer, err := exhaustruct.NewAnalyzer(cfg)
 	if err != nil {
 		internal.LinterLogger.Fatalf("exhaustruct configuration: %v", err)
 	}