The exhaustive static analysis checks that switch statements in Go source code are exhaustive. The analysis can check expression switches, if the switch expression type is an enumerated type, and type switches.
The complete analysis is implemented in multiple passes; see the packages under the 'passes' directory of the module. Package enumerated finds declarations of enumerated types and enumerated constants. Package exhaustive scans the syntax tree of Go packages for switch statements and checks that the switch statements are exhaustive.
The analysis is documented in Go package comments. See the Go files named doc.go under the 'passes' directory. The documentation can be read using the 'go doc' command. For example:
go doc github.com/nishanths/exhaustive/passes/exhaustive
The documentation is also available on pkg.go.dev.
https://pkg.go.dev/github.com/nishanths/exhaustive/passes/enumerated
https://pkg.go.dev/github.com/nishanths/exhaustive/passes/exhaustive
The exhaustive command runs the static analysis on the specified packages of Go source code. The command can be installed using 'go install'.
go install github.com/nishanths/exhaustive/cmd/exhaustive@latest
The synopsis of the command is:
exhaustive [-B] [-casenil] [-d] [-defrequire] [-e] [-g] [-i] [-p]
[-check string] [-constignore regexp] [-typeignore regexp]
[-typeonly regexp] [packages]
exhaustive -h | -help
The packages in the module can also be imported and used from external analysis driver programs. See https://golang.org/x/tools/go/analysis for details. The analysis driver program may want to make available to users the flag sets defined by both the enumerated analyzer and the exhaustive analyzer.
Given the expression switch
package a
type vcs int
const (
bazaar vcs = iota
fossil
git
mercurial
subversion
darcs
)
func f(v vcs) {
switch v {
case bazaar:
case fossil:
case git:
case mercurial:
case subversion:
}
}
the analysis reports the following diagnostic
$ exhaustive
a.go:15:2: missing cases in expression switch: darcs
$
Though it is not so in the above example, in general the enumerated type declarations and the switch statement can be in different packages.
Given the type switch
package b
import "go/types"
func f(t types.Type) bool {
switch t.(type) {
case *types.Array,
*types.Chan,
*types.Interface,
*types.Map,
*types.Pointer,
*types.Signature,
*types.Slice,
*types.Struct,
*types.Tuple,
*types.Union:
return false
case *types.Alias, *types.Named:
return true
default:
panic("internal error: unhandled type")
}
}
the diagnostic (as of go1.27) is
$ exhaustive -check=typeswitch
b.go:6:2: missing cases in type switch: *types.Basic, *types.TypeParam
$