nit

nit is an opinionated Code Organization linter for Go.

It defines a collection of rules to determine how each Go file should be organized internally.

Rules

1. [X] imports is the first section
   • [X] Requires parenthesized declaration,
   • [X] One maximum, and
   • [X] Separated in 3 blocks: standard, external and same package (local).
2. [X] type is the second section
   • [X] Requires parenthesized declaration,
   • [X] Section must be sorted: exported first, then unexported; and
   • [X] Supports //- comment for separating groups
3. [X] const is the third section
   • [X] Requires parenthesized declaration,
   • [X] Multiple allowed, and
   • [X] Section must be sorted: exported first, then unexported.
4. [X] var is the fourth section
   • [X] Requires parenthesized declaration, and
   • [X] Section must be sorted: exported first, then unexported.
5. [X] func is the fifth section
   • [X] Must be sorted, exported first, then unexported, and
   • [X] Supports //- comment for separating groups.
6. [X] func method, is the sixth section
   • [X] Must be sorted by type, exported first, then unexported; and
   • [X] Supports //- comment for separating groups.

Fancy State Machine explaining the rules above:

Installing

• Using go (>= 1.13): go get github.com/MarioCarrion/nit/cmd/nit@v0.6.0, for installing v0.6.0 for example; see the releases for other versions.
• Using it as a dependency with the tools.go paradigm:

// +build tools

package tools

import (
    _ "github.com/MarioCarrion/nit/cmd/nit"
)

Using

After installing you can use:

nit -pkg <base local package> $(go list ./...)

Please use nit -h for other available arguments.

Development requirements

Go >= 1.14.0