diff --git a/README.md b/README.md index 58439a64a190..65be35052280 100644 --- a/README.md +++ b/README.md @@ -206,6 +206,10 @@ golangci-lint linters - [depguard](https://github.com/OpenPeeDeeP/depguard) - Go linter that checks if package imports are in a list of acceptable packages # Configuration +Configuration file has lower priority than command-line: if the same bool/string/int option defined in the command-line +and in the configuration file, option from command-line will be used. +Slice options (e.g. list of enabled/disabled linters) are combined from the command-line and configuration file. + ## Command-Line Options ``` golangci-lint run -h diff --git a/README.md.tmpl b/README.md.tmpl index 2a5e80a009e8..6f23f1fe9122 100644 --- a/README.md.tmpl +++ b/README.md.tmpl @@ -164,6 +164,10 @@ golangci-lint linters {{.DisabledByDefaultLinters}} # Configuration +Configuration file has lower priority than command-line: if the same bool/string/int option defined in the command-line +and in the configuration file, option from command-line will be used. +Slice options (e.g. list of enabled/disabled linters) are combined from the command-line and configuration file. + ## Command-Line Options ``` golangci-lint run -h diff --git a/pkg/commands/root.go b/pkg/commands/root.go index cbd11d6627a8..b8c87b299b5a 100644 --- a/pkg/commands/root.go +++ b/pkg/commands/root.go @@ -10,6 +10,7 @@ import ( "github.com/golangci/golangci-lint/pkg/printers" "github.com/sirupsen/logrus" "github.com/spf13/cobra" + "github.com/spf13/pflag" ) func (e *Executor) persistentPostRun(cmd *cobra.Command, args []string) { @@ -77,13 +78,17 @@ func (e *Executor) initRoot() { PersistentPreRun: e.persistentPostRun, PersistentPostRun: e.persistentPreRun, } - rootCmd.PersistentFlags().BoolVarP(&e.cfg.Run.IsVerbose, "verbose", "v", false, wh("verbose output")) - rootCmd.PersistentFlags().StringVar(&e.cfg.Run.CPUProfilePath, "cpu-profile-path", "", wh("Path to CPU profile output file")) - rootCmd.PersistentFlags().StringVar(&e.cfg.Run.MemProfilePath, "mem-profile-path", "", wh("Path to memory profile output file")) - rootCmd.PersistentFlags().IntVarP(&e.cfg.Run.Concurrency, "concurrency", "j", getDefaultConcurrency(), wh("Concurrency (default NumCPU)")) - if e.commit != "" { - rootCmd.PersistentFlags().BoolVar(&e.cfg.Run.PrintVersion, "version", false, wh("Print version")) - } + e.initRootFlagSet(rootCmd.PersistentFlags()) e.rootCmd = rootCmd } + +func (e *Executor) initRootFlagSet(fs *pflag.FlagSet) { + fs.BoolVarP(&e.cfg.Run.IsVerbose, "verbose", "v", false, wh("verbose output")) + fs.StringVar(&e.cfg.Run.CPUProfilePath, "cpu-profile-path", "", wh("Path to CPU profile output file")) + fs.StringVar(&e.cfg.Run.MemProfilePath, "mem-profile-path", "", wh("Path to memory profile output file")) + fs.IntVarP(&e.cfg.Run.Concurrency, "concurrency", "j", getDefaultConcurrency(), wh("Concurrency (default NumCPU)")) + if e.commit != "" { + fs.BoolVar(&e.cfg.Run.PrintVersion, "version", false, wh("Print version")) + } +} diff --git a/pkg/commands/run.go b/pkg/commands/run.go index 094d7ffedd9c..4d2578d8b31a 100644 --- a/pkg/commands/run.go +++ b/pkg/commands/run.go @@ -46,43 +46,33 @@ func wh(text string) string { return color.GreenString(text) } -func (e *Executor) initRun() { - var runCmd = &cobra.Command{ - Use: "run", - Short: welcomeMessage, - Run: e.executeRun, - } - e.rootCmd.AddCommand(runCmd) - - runCmd.SetOutput(printers.StdOut) // use custom output to properly color it in Windows terminals - runCmd.Flags().SortFlags = false // sort them as they are defined here - +func (e *Executor) initFlagSet(fs *pflag.FlagSet) { hideFlag := func(name string) { - if err := runCmd.Flags().MarkHidden(name); err != nil { + if err := fs.MarkHidden(name); err != nil { panic(err) } } // Output config oc := &e.cfg.Output - runCmd.Flags().StringVar(&oc.Format, "out-format", + fs.StringVar(&oc.Format, "out-format", config.OutFormatColoredLineNumber, wh(fmt.Sprintf("Format of output: %s", strings.Join(config.OutFormats, "|")))) - runCmd.Flags().BoolVar(&oc.PrintIssuedLine, "print-issued-lines", true, wh("Print lines of code with issue")) - runCmd.Flags().BoolVar(&oc.PrintLinterName, "print-linter-name", true, wh("Print linter name in issue line")) - runCmd.Flags().BoolVar(&oc.PrintWelcomeMessage, "print-welcome", false, wh("Print welcome message")) + fs.BoolVar(&oc.PrintIssuedLine, "print-issued-lines", true, wh("Print lines of code with issue")) + fs.BoolVar(&oc.PrintLinterName, "print-linter-name", true, wh("Print linter name in issue line")) + fs.BoolVar(&oc.PrintWelcomeMessage, "print-welcome", false, wh("Print welcome message")) hideFlag("print-welcome") // no longer used // Run config rc := &e.cfg.Run - runCmd.Flags().IntVar(&rc.ExitCodeIfIssuesFound, "issues-exit-code", + fs.IntVar(&rc.ExitCodeIfIssuesFound, "issues-exit-code", 1, wh("Exit code when issues were found")) - runCmd.Flags().StringSliceVar(&rc.BuildTags, "build-tags", []string{}, wh("Build tags (not all linters support them)")) - runCmd.Flags().DurationVar(&rc.Deadline, "deadline", time.Minute, wh("Deadline for total work")) - runCmd.Flags().BoolVar(&rc.AnalyzeTests, "tests", false, wh("Analyze tests (*_test.go)")) - runCmd.Flags().BoolVar(&rc.PrintResourcesUsage, "print-resources-usage", false, wh("Print avg and max memory usage of golangci-lint and total time")) - runCmd.Flags().StringVarP(&rc.Config, "config", "c", "", wh("Read config from file path `PATH`")) - runCmd.Flags().BoolVar(&rc.NoConfig, "no-config", false, wh("Don't read config")) + fs.StringSliceVar(&rc.BuildTags, "build-tags", []string{}, wh("Build tags (not all linters support them)")) + fs.DurationVar(&rc.Deadline, "deadline", time.Minute, wh("Deadline for total work")) + fs.BoolVar(&rc.AnalyzeTests, "tests", false, wh("Analyze tests (*_test.go)")) + fs.BoolVar(&rc.PrintResourcesUsage, "print-resources-usage", false, wh("Print avg and max memory usage of golangci-lint and total time")) + fs.StringVarP(&rc.Config, "config", "c", "", wh("Read config from file path `PATH`")) + fs.BoolVar(&rc.NoConfig, "no-config", false, wh("Don't read config")) // Linters settings config lsc := &e.cfg.LintersSettings @@ -91,72 +81,88 @@ func (e *Executor) initRun() { // but when number of linters started to grow it became ovious that // we can't fill 90% of flags by linters settings: common flags became hard to find. // New linters settings should be done only through config file. - runCmd.Flags().BoolVar(&lsc.Errcheck.CheckTypeAssertions, "errcheck.check-type-assertions", false, "Errcheck: check for ignored type assertion results") + fs.BoolVar(&lsc.Errcheck.CheckTypeAssertions, "errcheck.check-type-assertions", false, "Errcheck: check for ignored type assertion results") hideFlag("errcheck.check-type-assertions") - runCmd.Flags().BoolVar(&lsc.Errcheck.CheckAssignToBlank, "errcheck.check-blank", false, "Errcheck: check for errors assigned to blank identifier: _ = errFunc()") + fs.BoolVar(&lsc.Errcheck.CheckAssignToBlank, "errcheck.check-blank", false, "Errcheck: check for errors assigned to blank identifier: _ = errFunc()") hideFlag("errcheck.check-blank") - runCmd.Flags().BoolVar(&lsc.Govet.CheckShadowing, "govet.check-shadowing", false, "Govet: check for shadowed variables") + fs.BoolVar(&lsc.Govet.CheckShadowing, "govet.check-shadowing", false, "Govet: check for shadowed variables") hideFlag("govet.check-shadowing") - runCmd.Flags().Float64Var(&lsc.Golint.MinConfidence, "golint.min-confidence", 0.8, "Golint: minimum confidence of a problem to print it") + fs.Float64Var(&lsc.Golint.MinConfidence, "golint.min-confidence", 0.8, "Golint: minimum confidence of a problem to print it") hideFlag("golint.min-confidence") - runCmd.Flags().BoolVar(&lsc.Gofmt.Simplify, "gofmt.simplify", true, "Gofmt: simplify code") + fs.BoolVar(&lsc.Gofmt.Simplify, "gofmt.simplify", true, "Gofmt: simplify code") hideFlag("gofmt.simplify") - runCmd.Flags().IntVar(&lsc.Gocyclo.MinComplexity, "gocyclo.min-complexity", + fs.IntVar(&lsc.Gocyclo.MinComplexity, "gocyclo.min-complexity", 30, "Minimal complexity of function to report it") hideFlag("gocyclo.min-complexity") - runCmd.Flags().BoolVar(&lsc.Maligned.SuggestNewOrder, "maligned.suggest-new", false, "Maligned: print suggested more optimal struct fields ordering") + fs.BoolVar(&lsc.Maligned.SuggestNewOrder, "maligned.suggest-new", false, "Maligned: print suggested more optimal struct fields ordering") hideFlag("maligned.suggest-new") - runCmd.Flags().IntVar(&lsc.Dupl.Threshold, "dupl.threshold", + fs.IntVar(&lsc.Dupl.Threshold, "dupl.threshold", 150, "Dupl: Minimal threshold to detect copy-paste") hideFlag("dupl.threshold") - runCmd.Flags().IntVar(&lsc.Goconst.MinStringLen, "goconst.min-len", + fs.IntVar(&lsc.Goconst.MinStringLen, "goconst.min-len", 3, "Goconst: minimum constant string length") hideFlag("goconst.min-len") - runCmd.Flags().IntVar(&lsc.Goconst.MinOccurrencesCount, "goconst.min-occurrences", + fs.IntVar(&lsc.Goconst.MinOccurrencesCount, "goconst.min-occurrences", 3, "Goconst: minimum occurrences of constant string count to trigger issue") hideFlag("goconst.min-occurrences") // (@dixonwille) These flag is only used for testing purposes. - runCmd.Flags().StringSliceVar(&lsc.Depguard.Packages, "depguard.packages", nil, + fs.StringSliceVar(&lsc.Depguard.Packages, "depguard.packages", nil, "Depguard: packages to add to the list") hideFlag("depguard.packages") - runCmd.Flags().BoolVar(&lsc.Depguard.IncludeGoRoot, "depguard.include-go-root", false, + fs.BoolVar(&lsc.Depguard.IncludeGoRoot, "depguard.include-go-root", false, "Depguard: check list against standard lib") hideFlag("depguard.include-go-root") // Linters config lc := &e.cfg.Linters - runCmd.Flags().StringSliceVarP(&lc.Enable, "enable", "E", []string{}, wh("Enable specific linter")) - runCmd.Flags().StringSliceVarP(&lc.Disable, "disable", "D", []string{}, wh("Disable specific linter")) - runCmd.Flags().BoolVar(&lc.EnableAll, "enable-all", false, wh("Enable all linters")) - runCmd.Flags().BoolVar(&lc.DisableAll, "disable-all", false, wh("Disable all linters")) - runCmd.Flags().StringSliceVarP(&lc.Presets, "presets", "p", []string{}, + fs.StringSliceVarP(&lc.Enable, "enable", "E", []string{}, wh("Enable specific linter")) + fs.StringSliceVarP(&lc.Disable, "disable", "D", []string{}, wh("Disable specific linter")) + fs.BoolVar(&lc.EnableAll, "enable-all", false, wh("Enable all linters")) + fs.BoolVar(&lc.DisableAll, "disable-all", false, wh("Disable all linters")) + fs.StringSliceVarP(&lc.Presets, "presets", "p", []string{}, wh(fmt.Sprintf("Enable presets (%s) of linters. Run 'golangci-lint linters' to see them. This option implies option --disable-all", strings.Join(lintersdb.AllPresets(), "|")))) - runCmd.Flags().BoolVar(&lc.Fast, "fast", false, wh("Run only fast linters from enabled linters set")) + fs.BoolVar(&lc.Fast, "fast", false, wh("Run only fast linters from enabled linters set")) // Issues config ic := &e.cfg.Issues - runCmd.Flags().StringSliceVarP(&ic.ExcludePatterns, "exclude", "e", []string{}, wh("Exclude issue by regexp")) - runCmd.Flags().BoolVar(&ic.UseDefaultExcludes, "exclude-use-default", true, getDefaultExcludeHelp()) + fs.StringSliceVarP(&ic.ExcludePatterns, "exclude", "e", []string{}, wh("Exclude issue by regexp")) + fs.BoolVar(&ic.UseDefaultExcludes, "exclude-use-default", true, getDefaultExcludeHelp()) - runCmd.Flags().IntVar(&ic.MaxIssuesPerLinter, "max-issues-per-linter", 50, wh("Maximum issues count per one linter. Set to 0 to disable")) - runCmd.Flags().IntVar(&ic.MaxSameIssues, "max-same-issues", 3, wh("Maximum count of issues with the same text. Set to 0 to disable")) + fs.IntVar(&ic.MaxIssuesPerLinter, "max-issues-per-linter", 50, wh("Maximum issues count per one linter. Set to 0 to disable")) + fs.IntVar(&ic.MaxSameIssues, "max-same-issues", 3, wh("Maximum count of issues with the same text. Set to 0 to disable")) - runCmd.Flags().BoolVarP(&ic.Diff, "new", "n", false, + fs.BoolVarP(&ic.Diff, "new", "n", false, wh("Show only new issues: if there are unstaged changes or untracked files, only those changes are analyzed, else only changes in HEAD~ are analyzed.\nIt's a super-useful option for integration of golangci-lint into existing large codebase.\nIt's not practical to fix all existing issues at the moment of integration: much better don't allow issues in new code")) - runCmd.Flags().StringVar(&ic.DiffFromRevision, "new-from-rev", "", wh("Show only new issues created after git revision `REV`")) - runCmd.Flags().StringVar(&ic.DiffPatchFilePath, "new-from-patch", "", wh("Show only new issues created in git patch with file path `PATH`")) + fs.StringVar(&ic.DiffFromRevision, "new-from-rev", "", wh("Show only new issues created after git revision `REV`")) + fs.StringVar(&ic.DiffPatchFilePath, "new-from-patch", "", wh("Show only new issues created in git patch with file path `PATH`")) + +} + +func (e *Executor) initRun() { + var runCmd = &cobra.Command{ + Use: "run", + Short: welcomeMessage, + Run: e.executeRun, + } + e.rootCmd.AddCommand(runCmd) - e.parseConfig(runCmd) + runCmd.SetOutput(printers.StdOut) // use custom output to properly color it in Windows terminals + + fs := runCmd.Flags() + fs.SortFlags = false // sort them as they are defined here + e.initFlagSet(fs) + + e.parseConfig() } func (e *Executor) runAnalysis(ctx context.Context, args []string) (<-chan result.Issue, error) { @@ -274,16 +280,28 @@ func (e *Executor) executeRun(cmd *cobra.Command, args []string) { } } -func (e *Executor) parseConfig(cmd *cobra.Command) { - // XXX: hack with double parsing to access "config" option here - if err := cmd.ParseFlags(os.Args); err != nil { +func (e *Executor) parseConfig() { + // XXX: hack with double parsing for 2 purposes: + // 1. to access "config" option here. + // 2. to give config less priority than command line. + + // We use another pflag.FlagSet here to not set `changed` flag + // on cmd.Flags() options. Otherwise string slice options will be duplicated. + fs := pflag.NewFlagSet("config flag set", pflag.ContinueOnError) + + // Don't do `fs.AddFlagSet(cmd.Flags())` because it shared flags representations: + // `changed` variable inside string slice vars will be shared. + e.initFlagSet(fs) + e.initRootFlagSet(fs) + + if err := fs.Parse(os.Args); err != nil { if err == pflag.ErrHelp { return } logrus.Fatalf("Can't parse args: %s", err) } - if err := viper.BindPFlags(cmd.Flags()); err != nil { + if err := viper.BindPFlags(fs); err != nil { logrus.Fatalf("Can't bind cobra's flags to viper: %s", err) } diff --git a/pkg/lint/lintersdb/lintersdb.go b/pkg/lint/lintersdb/lintersdb.go index fbc3725314a9..d8c4389086fa 100644 --- a/pkg/lint/lintersdb/lintersdb.go +++ b/pkg/lint/lintersdb/lintersdb.go @@ -323,6 +323,7 @@ func getEnabledLintersSet(lcfg *config.Linters, enabledByDefaultLinters []linter // --presets can only add linters to default set for _, p := range lcfg.Presets { for _, lc := range GetAllLinterConfigsForPreset(p) { + lc := lc resultLintersSet[lc.Linter.Name()] = &lc } } @@ -413,20 +414,6 @@ func GetEnabledLinters(cfg *config.Config) ([]linter.Config, error) { return resultLinters, nil } -func uniqStrings(ss []string) []string { - us := map[string]bool{} - for _, s := range ss { - us[s] = true - } - - var ret []string - for k := range us { - ret = append(ret, k) - } - - return ret -} - func verbosePrintLintersStatus(cfg *config.Config, lcs []linter.Config) { var linterNames []string for _, lc := range lcs { @@ -435,6 +422,6 @@ func verbosePrintLintersStatus(cfg *config.Config, lcs []linter.Config) { logrus.Infof("Active linters: %s", linterNames) if len(cfg.Linters.Presets) != 0 { - logrus.Infof("Active presets: %s", uniqStrings(cfg.Linters.Presets)) + logrus.Infof("Active presets: %s", cfg.Linters.Presets) } }