Documentation
¶
Overview ¶
Package coverage parses a Go coverprofile and reports statement coverage over blocks not marked with a coverage-ignore directive. It backs the awf coverage gate (ADR-0012): a directive of the form "<slashes> coverage-ignore: <reason>" drops its block from both the covered and total counts; a directive with no non-empty reason is an error.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Report ¶
type Report struct {
Covered int // statements in non-ignored blocks executed at least once
Total int // statements in non-ignored blocks
}
Report is the result of checking a coverprofile.
func Check ¶
Check parses the coverprofile at profilePath and returns a Report over blocks not marked for ignore. srcRoot is the module root on disk; modPath is the go.mod module path, used to map profile paths to files on disk.
A profile produced by `go test ./... -coverpkg=./...` emits each instrumented block once per test binary, so the same block recurs many times with differing counts. Blocks are first merged by identity (file + span), OR-ing the counts (mode: set), exactly as `go tool cover` does — otherwise the denominator is inflated by the duplication.
func CheckProfile ¶
CheckProfile resolves the module root from the working directory (nearest ancestor with a go.mod) and checks profilePath against the module sources.
Source Files