add -quiet flag to update-checks-doc script

and run the script in `make lint`

Author: rhysd

.github/workflows/ci.yaml

@@ -104,8 +104,6 @@ jobs:
             echo "$diffs" >&2
             exit 1
           fi
-      - name: Check `docs/checks.md` is up-to-date
-        run: go run ./scripts/update-checks-doc -check ./docs/checks.md
       - name: Install staticcheck
         run: |
           go install honnef.co/go/tools/cmd/staticcheck@latest

Makefile

@@ -26,6 +26,7 @@ t test: .testtimestamp
 .staticchecktimestamp: $(TESTS) $(SRCS) $(TOOL)
 	staticcheck ./...
 	GOOS=js GOARCH=wasm staticcheck ./playground
+	go run ./scripts/update-checks-doc -check -quiet ./docs/checks.md
 	touch .staticchecktimestamp
 
 l lint: .staticchecktimestamp

scripts/update-checks-doc/main.go

@@ -317,13 +317,16 @@ var stderr io.Writer = os.Stderr
 
 func Main(args []string) error {
 	var check bool
+	var quiet bool
 	flags := flag.NewFlagSet(args[0], flag.ContinueOnError)
 	flags.BoolVar(&check, "check", false, "check the document is up-to-date")
+	flags.BoolVar(&quiet, "quiet", false, "disable trace logs")
 	flags.SetOutput(stderr)
 	flags.Usage = func() {
 		fmt.Fprintln(stderr, "Usage: update-checks-doc [FLAGS] FILE\n\nFlags:")
 		flags.PrintDefaults()
 	}
+
 	if err := flags.Parse(args[1:]); err != nil {
 		if err == flag.ErrHelp {
 			return nil
@@ -335,6 +338,10 @@ func Main(args []string) error {
 	}
 	path := flags.Arg(0)
 
+	if quiet {
+		log.SetOutput(io.Discard)
+	}
+
 	in, err := os.ReadFile(path)
 	if err != nil {
 		return fmt.Errorf("could not read the document file: %w", err)

scripts/update-checks-doc/main_test.go

@@ -73,6 +73,16 @@ func TestMainCheckOK(t *testing.T) {
 	}
 }
 
+func TestMainCheckQuietOK(t *testing.T) {
+	if runtime.GOOS == "windows" {
+		t.Skip("update-checks-doc doesn't support Windows")
+	}
+	path := filepath.FromSlash("testdata/ok/minimal.out")
+	if err := Main([]string{"exe", "-check", "-quiet", path}); err != nil {
+		t.Fatal(err)
+	}
+}
+
 func TestMainPrintHelp(t *testing.T) {
 	if err := Main([]string{"exe", "-help"}); err != nil {
 		t.Fatal(err)