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

@@ -532,18 +532,45 @@ linters-settings:
     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.2
 	github.com/Abirdcfly/dupword v0.1.3
 	github.com/Antonboom/errname v1.0.0
@@ -13,7 +14,6 @@ require (
 	github.com/BurntSushi/toml v1.4.1-0.20240526193622-a339e1f7089c
 	github.com/Crocmagnon/fatcontext v0.7.1
 	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/go-check-sumtype v0.3.1
 	github.com/alexkohler/nakedret/v2 v2.0.5
@@ -125,16 +125,17 @@ require (
 	go-simpler.org/musttag v0.13.0
 	go-simpler.org/sloglint v0.9.0
 	go.uber.org/automaxprocs v1.6.0
-	golang.org/x/mod v0.24.0
-	golang.org/x/sys v0.31.0
-	golang.org/x/tools v0.31.0
+	golang.org/x/mod v0.27.0
+	golang.org/x/sys v0.34.0
+	golang.org/x/tools v0.35.0
 	gopkg.in/yaml.v3 v3.0.1
 	honnef.co/go/tools v0.6.1
 	mvdan.cc/gofumpt v0.7.0
 	mvdan.cc/unparam v0.0.0-20240528143540-8a5130ca722f
 )
 
 require (
+	dev.gaijin.team/go/golib v0.6.0 // indirect
 	github.com/Masterminds/semver/v3 v3.3.0 // indirect
 	github.com/beorn7/perks v1.0.1 // indirect
 	github.com/ccojocar/zxcvbn-go v1.0.2 // indirect
@@ -191,13 +192,14 @@ require (
 	github.com/tklauser/numcpus v0.6.1 // indirect
 	github.com/valyala/bytebufferpool v1.0.0 // 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-20250210185358-939b2ce775ac // indirect
-	golang.org/x/sync v0.12.0 // indirect
+	golang.org/x/sync v0.16.0 // indirect
 	golang.org/x/text v0.22.0 // indirect
+	golang.org/x/tools/go/expect v0.1.1-deprecated // indirect
+	golang.org/x/tools/go/packages/packagestest v0.1.1-deprecated // indirect
 	google.golang.org/protobuf v1.36.5 // indirect
 	gopkg.in/ini.v1 v1.67.0 // indirect
 	gopkg.in/yaml.v2 v2.4.0 // indirect

go.sum

@@ -432,8 +432,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,7 +1,7 @@
 package exhaustruct
 
 import (
-	"github.com/GaijinEntertainment/go-exhaustruct/v3/analyzer"
+	"dev.gaijin.team/go/exhaustruct/v4/analyzer"
 	"golang.org/x/tools/go/analysis"
 
 	"github.com/golangci/golangci-lint/pkg/config"
@@ -10,13 +10,17 @@ import (
 )
 
 func New(settings *config.ExhaustructSettings) *goanalysis.Linter {
-	var include, exclude []string
+	cfg := analyzer.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
 	}
 
-	a, err := analyzer.NewAnalyzer(include, exclude)
+	a, err := analyzer.NewAnalyzer(cfg)
 	if err != nil {
 		internal.LinterLogger.Fatalf("exhaustruct configuration: %v", err)
 	}