summaryrefslogtreecommitdiffhomepage
path: root/tools/github/nogo/nogo.go
blob: b70dfe63b8722a97609e254031462247deb07b34 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
// Copyright 2019 The gVisor Authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

// Package nogo provides nogo-related utilities.
package nogo

import (
	"context"
	"fmt"
	"os"
	"path/filepath"
	"strings"
	"time"

	"github.com/google/go-github/github"
	"gvisor.dev/gvisor/tools/nogo/util"
)

// FindingsPoster is a simple wrapper around the GitHub api.
type FindingsPoster struct {
	owner     string
	repo      string
	commit    string
	dryRun    bool
	startTime time.Time

	findings map[util.Finding]struct{}
	client   *github.Client
}

// NewFindingsPoster returns a object that can post findings.
func NewFindingsPoster(client *github.Client, owner, repo, commit string, dryRun bool) *FindingsPoster {
	return &FindingsPoster{
		owner:     owner,
		repo:      repo,
		commit:    commit,
		dryRun:    dryRun,
		startTime: time.Now(),
		findings:  make(map[util.Finding]struct{}),
		client:    client,
	}
}

// Walk walks the given path tree for findings files.
func (p *FindingsPoster) Walk(path string) error {
	return filepath.Walk(path, func(filename string, info os.FileInfo, err error) error {
		if err != nil {
			return err
		}
		// Skip any directories or files not ending in .findings.
		if !strings.HasSuffix(filename, ".findings") || info.IsDir() {
			return nil
		}
		findings, err := util.ExtractFindingsFromFile(filename)
		if err != nil {
			return err
		}
		// Add all findings to the list. We use a map to ensure
		// that each finding is unique.
		for _, finding := range findings {
			p.findings[finding] = struct{}{}
		}
		return nil
	})
}

// Post posts all results to the GitHub API as a check run.
func (p *FindingsPoster) Post() error {
	// Just show results?
	if p.dryRun {
		for finding, _ := range p.findings {
			// Pretty print, so that this is useful for debugging.
			fmt.Printf("%s: (%s+%d) %s\n", finding.Category, finding.Path, finding.Line, finding.Message)
		}
		return nil
	}

	// Construct the message.
	title := "nogo"
	count := len(p.findings)
	status := "completed"
	conclusion := "success"
	if count > 0 {
		conclusion = "failure" // Contains errors.
	}
	summary := fmt.Sprintf("%d findings.", count)
	opts := github.CreateCheckRunOptions{
		Name:        title,
		HeadSHA:     p.commit,
		Status:      &status,
		Conclusion:  &conclusion,
		StartedAt:   &github.Timestamp{p.startTime},
		CompletedAt: &github.Timestamp{time.Now()},
		Output: &github.CheckRunOutput{
			Title:            &title,
			Summary:          &summary,
			AnnotationsCount: &count,
		},
	}
	annotationLevel := "failure" // Always.
	for finding, _ := range p.findings {
		opts.Output.Annotations = append(opts.Output.Annotations, &github.CheckRunAnnotation{
			Path:            &finding.Path,
			StartLine:       &finding.Line,
			EndLine:         &finding.Line,
			Message:         &finding.Message,
			Title:           &finding.Category,
			AnnotationLevel: &annotationLevel,
		})
	}

	// Post to GitHub.
	_, _, err := p.client.Checks.CreateCheckRun(context.Background(), p.owner, p.repo, opts)
	return err
}