Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nakabonne/nestif
Detect deeply nested if statements in Go source code
https://github.com/nakabonne/nestif
complexity go golang golang-tools linter static-analysis
Last synced: about 9 hours ago
JSON representation
Detect deeply nested if statements in Go source code
- Host: GitHub
- URL: https://github.com/nakabonne/nestif
- Owner: nakabonne
- License: bsd-2-clause
- Created: 2020-01-11T12:01:23.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-10-31T11:41:00.000Z (almost 3 years ago)
- Last Synced: 2024-06-18T18:34:15.412Z (4 months ago)
- Topics: complexity, go, golang, golang-tools, linter, static-analysis
- Language: Go
- Homepage:
- Size: 51.8 KB
- Stars: 40
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# nestif
[](http://godoc.org/github.com/nakabonne/nestif)
Reports complex nested if statements in Go code, by calculating its complexities based on the rules defined by the [Cognitive Complexity white paper by G. Ann Campbell](https://www.sonarsource.com/docs/CognitiveComplexity.pdf).
It helps you find if statements that make your code hard to read, and clarifies which parts to refactor.
## Installation
### By go get
```
go get github.com/nakabonne/nestif/cmd/nestif
```
### By golangci-lint
`nestif` is already integrated with [golangci-lint](https://github.com/golangci/golangci-lint). Please refer to the instructions there and enable it.
## Usage
### Quick Start
```bash
nestif
```
The `...` glob operator is supported, and the above is an equivalent of:
```bash
nestif ./...
```
One or more files and directories can be specified in a single command:
```bash
nestif dir/foo.go dir2 dir3/...
```
Packages can be specified as well:
```bash
nestif github.com/foo/bar example.com/bar/baz
```
### Options
```
usage: nestif [ ...] ...
-e, --exclude-dirs strings regexps of directories to be excluded for checking; comma-separated list
--json emit json format
--min int minimum complexity to show (default 1)
--top int show only the top N most complex if statements (default 10)
-v, --verbose verbose output
```
### Example
Let's say you write:
```go
package main
func _() {
if foo {
if bar {
}
}
if baz == "baz" {
if qux {
if quux {
}
}
}
}
```
And give it to nestif:
```console
$ nestif foo.go
foo.go:9:2: `if baz == "baz"` is nested (complexity: 3)
foo.go:4:2: `if foo` is nested (complexity: 1)
```
Note that the results are sorted in descending order of complexity. In addition, it shows only the top 10 most complex if statements by default, and you can specify how many to show with `-top` flag.
### Rules
It calculates the complexities of if statements according to the nesting rules of Cognitive Complexity.
Since the more deeply-nested your code gets, the harder it can be to reason about, it assesses a nesting increment for it:
```go
if condition1 {
if condition2 { // +1
if condition3 { // +2
if condition4 { // +3
}
}
}
}
```
`else` and `else if` increase complexity by one wherever they are because the mental cost has already been paid when reading the if:
```go
if condition1 {
if condition2 { // +1
if condition3 { // +2
} else if condition4 { // +1
} else { // +1
if condition5 { // +3
}
}
}
}
```
## Inspired by
- [uudashr/gocognit](https://github.com/uudashr/gocognit)
- [fzipp/gocyclo](https://github.com/fzipp/gocyclo)
## Further reading
Please see the [Cognitive Complexity: A new way of measuring understandability](https://www.sonarsource.com/docs/CognitiveComplexity.pdf) white paper by G. Ann Campbell for more detail on Cognitive Complexity.