scorecard/probes/issueActivityByProjectMember/impl.go
Spencer Schrock 0b9dfb656f
⚠️ Replace v4 module references with v5 (#4027)
Signed-off-by: Spencer Schrock <sschrock@google.com>
2024-04-12 14:51:50 -07:00

107 lines
3.1 KiB
Go

// Copyright 2023 OpenSSF Scorecard 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.
//nolint:stylecheck
package issueActivityByProjectMember
import (
"embed"
"fmt"
"strconv"
"time"
"github.com/ossf/scorecard/v5/checker"
"github.com/ossf/scorecard/v5/clients"
"github.com/ossf/scorecard/v5/finding"
"github.com/ossf/scorecard/v5/internal/probes"
"github.com/ossf/scorecard/v5/probes/internal/utils/uerror"
)
func init() {
probes.MustRegister(Probe, Run, []probes.CheckName{probes.Maintained})
}
//go:embed *.yml
var fs embed.FS
const (
Probe = "issueActivityByProjectMember"
NumIssuesKey = "numberOfIssuesUpdatedWithinThreshold"
LookbackDayKey = "lookBackDays"
lookBackDays = 90
)
func Run(raw *checker.RawResults) ([]finding.Finding, string, error) {
if raw == nil {
return nil, "", fmt.Errorf("%w: raw", uerror.ErrNil)
}
r := raw.MaintainedResults
numberOfIssuesUpdatedWithinThreshold := 0
// Look for activity in past `lookBackDays`.
threshold := time.Now().AddDate(0 /*years*/, 0 /*months*/, -1*lookBackDays /*days*/)
var findings []finding.Finding
for i := range r.Issues {
if hasActivityByCollaboratorOrHigher(&r.Issues[i], threshold) {
numberOfIssuesUpdatedWithinThreshold++
}
}
var text string
var outcome finding.Outcome
if numberOfIssuesUpdatedWithinThreshold > 0 {
text = "Found a issue within the threshold."
outcome = finding.OutcomeTrue
} else {
text = "Did not find issues within the threshold."
outcome = finding.OutcomeFalse
}
f, err := finding.NewWith(fs, Probe, text, nil, outcome)
if err != nil {
return nil, Probe, fmt.Errorf("create finding: %w", err)
}
f = f.WithValues(map[string]string{
NumIssuesKey: strconv.Itoa(numberOfIssuesUpdatedWithinThreshold),
LookbackDayKey: strconv.Itoa(lookBackDays),
})
findings = append(findings, *f)
return findings, Probe, nil
}
// hasActivityByCollaboratorOrHigher returns true if the issue was created or commented on by an
// owner/collaborator/member since the threshold.
func hasActivityByCollaboratorOrHigher(issue *clients.Issue, threshold time.Time) bool {
if issue == nil {
return false
}
if issue.AuthorAssociation.Gte(clients.RepoAssociationCollaborator) &&
issue.CreatedAt != nil && issue.CreatedAt.After(threshold) {
// The creator of the issue is a collaborator or higher.
return true
}
for _, comment := range issue.Comments {
if comment.AuthorAssociation.Gte(clients.RepoAssociationCollaborator) &&
comment.CreatedAt != nil &&
comment.CreatedAt.After(threshold) {
// The author of the comment is a collaborator or higher.
return true
}
}
return false
}