feat: add gomodreplace linter.

Author: ldez

.golangci.example.yml

@@ -449,6 +449,12 @@ linters-settings:
     servingv1: knative.dev/serving/pkg/apis/serving/v1
     # using `autoscalingv1alpha1` alias for `knative.dev/serving/pkg/apis/autoscaling/v1alpha1` package
     autoscalingv1alpha1: knative.dev/serving/pkg/apis/autoscaling/v1alpha1
+  gomodreplace:
+    # Allow local `replace` directives. Default is false.
+    local: false
+    # List of allowed `replace` directives. Default is empty.
+    allow-list:
+      - launchpad.net/gocheck
 
   # The custom section can be used to define linter plugins to be loaded at runtime. See README doc
   #  for more info.

go.mod

@@ -41,6 +41,7 @@ require (
 	github.com/kulti/thelper v0.4.0
 	github.com/kunwardeep/paralleltest v1.0.2
 	github.com/kyoh86/exportloopref v0.1.8
+	github.com/ldez/gomodreplace v0.1.0
 	github.com/maratori/testpackage v1.0.1
 	github.com/matoous/godox v0.0.0-20210227103229-6504466cf951 // v1.0
 	github.com/mattn/go-colorable v0.1.8

go.sum

@@ -276,6 +276,7 @@ type LintersSettings struct {
 	Predeclared      PredeclaredSettings
 	Cyclop           Cyclop
 	ImportAs         ImportAsSettings
+	GoModReplace     GoModReplaceSettings
 
 	Custom map[string]CustomLinterSettings
 }
@@ -464,6 +465,11 @@ type Cyclop struct {
 
 type ImportAsSettings map[string]string
 
+type GoModReplaceSettings struct {
+	AllowList []string `mapstructure:"allow-list"`
+	Local     bool     `mapstructure:"local"`
+}
+
 var defaultLintersSettings = LintersSettings{
 	Lll: LllSettings{
 		LineLength: 120,

pkg/config/config.go

@@ -0,0 +1,64 @@
+package golinters
+
+import (
+	"sync"
+
+	"github.com/golangci/golangci-lint/pkg/config"
+	"github.com/ldez/gomodreplace"
+	"golang.org/x/tools/go/analysis"
+
+	"github.com/golangci/golangci-lint/pkg/golinters/goanalysis"
+	"github.com/golangci/golangci-lint/pkg/lint/linter"
+	"github.com/golangci/golangci-lint/pkg/result"
+)
+
+const goModReplaceName = "gomodreplace"
+
+// NewGoModReplace returns a new gomodreplace linter.
+func NewGoModReplace(settings *config.GoModReplaceSettings) *goanalysis.Linter {
+	var issues []goanalysis.Issue
+	var mu sync.Mutex
+
+	var opts gomodreplace.Options
+	if settings != nil {
+		opts.AllowLocal = settings.Local
+		opts.AllowList = settings.AllowList
+	}
+
+	analyzer := &analysis.Analyzer{
+		Name: goanalysis.TheOnlyAnalyzerName,
+		Doc:  goanalysis.TheOnlyanalyzerDoc,
+	}
+
+	return goanalysis.NewLinter(
+		goModReplaceName,
+		"Manage the use of replace directives in go.mod.",
+		[]*analysis.Analyzer{analyzer},
+		nil,
+	).WithContextSetter(func(lintCtx *linter.Context) {
+		analyzer.Run = func(pass *analysis.Pass) (interface{}, error) {
+			results, err := gomodreplace.Analyze(opts)
+			if err != nil {
+				lintCtx.Log.Warnf("running %s failed: %s: "+
+					"if you are not using go modules it is suggested to disable this linter", goModReplaceName, err)
+				return nil, nil
+			}
+
+			mu.Lock()
+
+			for _, p := range results {
+				issues = append(issues, goanalysis.NewIssue(&result.Issue{
+					FromLinter: goModReplaceName,
+					Pos:        p.Start,
+					Text:       p.Reason,
+				}, pass))
+			}
+
+			mu.Unlock()
+
+			return nil, nil
+		}
+	}).WithIssuesReporter(func(*linter.Context) []goanalysis.Issue {
+		return issues
+	}).WithLoadMode(goanalysis.LoadModeSyntax)
+}

pkg/golinters/gomodreplace.go

@@ -100,6 +100,7 @@ func (m Manager) GetAllSupportedLinterConfigs() []*linter.Config {
 	var reviveCfg *config.ReviveSettings
 	var cyclopCfg *config.Cyclop
 	var importAsCfg *config.ImportAsSettings
+	var goModReplaceCfg *config.GoModReplaceSettings
 	if m.cfg != nil {
 		govetCfg = &m.cfg.LintersSettings.Govet
 		testpackageCfg = &m.cfg.LintersSettings.Testpackage
@@ -112,6 +113,7 @@ func (m Manager) GetAllSupportedLinterConfigs() []*linter.Config {
 		reviveCfg = &m.cfg.LintersSettings.Revive
 		cyclopCfg = &m.cfg.LintersSettings.Cyclop
 		importAsCfg = &m.cfg.LintersSettings.ImportAs
+		goModReplaceCfg = &m.cfg.LintersSettings.GoModReplace
 	}
 	const megacheckName = "megacheck"
 	lcs := []*linter.Config{
@@ -394,6 +396,10 @@ func (m Manager) GetAllSupportedLinterConfigs() []*linter.Config {
 			WithPresets(linter.PresetStyle).
 			WithLoadForGoAnalysis().
 			WithURL("https://github.com/gostaticanalysis/forcetypeassert"),
+		linter.NewConfig(golinters.NewGoModReplace(goModReplaceCfg)).
+			WithPresets(linter.PresetStyle).
+			WithLoadForGoAnalysis().
+			WithURL("https://github.com/ldez/gomodreplace"),
 
 		// nolintlint must be last because it looks at the results of all the previous linters for unused nolint directives
 		linter.NewConfig(golinters.NewNoLintLint()).

pkg/lint/lintersdb/manager.go

@@ -53,6 +53,10 @@ func (p *AutogeneratedExclude) shouldPassIssue(i *result.Issue) (bool, error) {
 		return true, nil
 	}
 
+	if filepath.Base(i.FilePath()) == "go.mod" {
+		return true, nil
+	}
+
 	if isSpecialAutogeneratedFile(i.FilePath()) {
 		return false, nil
 	}