format

Overview ¶

Package format exposes gofumpt's formatting in an API similar to go/format. In general, the APIs are only guaranteed to work well when the input source is in canonical gofmt format.

The goVersion parameter taken by some of the functions should correspond to the Go language version a piece of code is written in. The version is used to decide whether to apply formatting rules which require new language features. When inside a Go module, goVersion should be the result of:

go list -m -f {{.GoVersion}}

goVersion is treated as a semantic version, which might start with a "v" prefix. Like Go versions, it might also be incomplete; "1.14" is equivalent to "1.14.0". An empty goVersion is equivalent to "v99", to use all available language features.