Skip to content

Check exhaustiveness of switch statements of enum-like constants in Go source code.

License

Notifications You must be signed in to change notification settings

butzopower/exhaustive

 
 

Repository files navigation

exhaustive Godoc

Check exhaustiveness of enum switch statements in Go source code.

go install github.com/nishanths/exhaustive/cmd/exhaustive@latest

For docs on the flags, the definition of enum, and the definition of exhaustiveness, see godocs.io.

For the changelog, see CHANGELOG in the wiki.

The package provides an Analyzer that follows the guidelines in the go/analysis package; this should make it possible to integrate exhaustive with your own analysis driver program.

Example

Given the enum

package token

type Token int

const (
	Add Token = iota
	Subtract
	Multiply
	Quotient
	Remainder
)

and the switch statement

package calc

import "token"

func f(t token.Token) {
	switch t {
	case token.Add:
	case token.Subtract:
	case token.Multiply:
	default:
	}
}

running exhaustive will print

calc.go:6:2: missing cases in switch of type token.Token: Quotient, Remainder

Contributing

Issues and pull requests are welcome. Before making a substantial change, please discuss it in an issue.

About

Check exhaustiveness of switch statements of enum-like constants in Go source code.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 99.2%
  • Makefile 0.8%