testfile

README

docs

Documentation

Overview

Package testfile provides a go/analysis analyzer enforcing the gomatic Go testing standard that unit-test files are 1:1 with their source files: <name>_test.go tests <name>.go. A _test.go file without a matching source file is allowed only when it is not a unit test — it carries a build constraint (an explicit //go:build or legacy // +build line, or a filename-implied _GOOS/_GOARCH suffix) or declares no Test functions (examples, benchmarks, fuzz targets).

Each pass judges only the _test.go files it delivers, so a file is reported exactly once — by the pass that contains it — anchored at its own package clause. Files the go tool ignores (a leading _ or dot, including a file named exactly _test.go) are never judged. Unreadable or unparseable test files are deliberately exempt: the analyzer fails open rather than report a file it could not inspect, and that contract is pinned by tests.

Index

• Variables

Variables

var Analyzer = &analysis.Analyzer{
	Name: "testfile",
	Doc:  "reports _test.go unit-test files without a matching source file",
	Run:  run,
}

Analyzer reports unit-test files that are not 1:1 with a source file.

var Registration = goyze.Registration{
	Name:       "testfile",
	Categories: []goyze.Category{"testing"},
	URL:        "https://docs.gomatic.dev/yze/testfile",
	Analyzer:   Analyzer,
}

Registration declares this analyzer to the yze framework.