-
-
Couldn't load subscription status.
- Fork 1.5k
Add fparams linter #4853
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add fparams linter #4853
Conversation
Hey, thank you for opening your first Pull Request !
Same concept as pairedbrackets in #3225
In order for a pull request adding a linter to be reviewed, the linter and the PR must follow some requirements.
- The CLA must be signed
Pull Request Description
- It must have a link to the linter repository.
- It must provide a short description of the linter.
Linter
- It must not be a duplicate of another linter or a rule of a linter. (the team will help to verify that)
- It must have a valid license (AGPL is not allowed) and the file must contain the required information by the license, ex: author, year, etc.
- The linter repository must have a CI and tests.
- It must use
go/analysis. - It must have a valid tag, ex:
v1.0.0,v0.1.0. - It must not contain
init(). - It must not contain
panic(). - It must not contain
log.fatal(),os.exit(), or similar. - It must not modify the AST.
- It must not have false positives/negatives. (the team will help to verify that)
- It must have tests inside golangci-lint.
- The linter must use Go <= 1.21
The Linter Tests Inside Golangci-lint
- They must have at least one std lib import.
- They must have integration tests without configuration (default).
- They must have integration tests with configuration (if the linter has a configuration).
.golangci.next.reference.yml
- The file
.golangci.next.reference.ymlmust be updated. - The file
.golangci.reference.ymlmust NOT be edited. - The linter must be added to the lists of available linters (alphabetical case-insensitive order).
enableanddisableoptions
- If the linter has a configuration, the exhaustive configuration of the linter must be added (alphabetical case-insensitive order)
- The values must be different from the default ones.
- The default values must be defined in a comment.
- The option must have a short description.
Others Requirements
- The files (tests and linter) inside golangci-lint must have the same name as the linter.
- The
.golangci.ymlof golangci-lint itself must not be edited and the linter must not be added to this file. - The linters must be sorted in the alphabetical order (case-insensitive) in the
lintersdb/builder_linter.goand.golangci.next.reference.yml. - The load mode (
WithLoadMode(...)):- if the linter uses
goanalysis.LoadModeSyntax-> noWithLoadForGoAnalysis()inlintersdb/builder_linter.go - if the linter uses
goanalysis.LoadModeTypesInfo, it requiresWithLoadForGoAnalysis()inlintersdb/builder_linter.go
- if the linter uses
- The version in
WithSince(...)must be the next minor version (v1.X.0) of golangci-lint. -
WithURL()must contain the URL of the repository.
Recommendations
- The file
jsonschema/golangci.next.jsonschema.jsonshould be updated. - The file
jsonschema/golangci.jsonschema.jsonmust NOT be edited. - The linter repository should have a readme and linting.
- The linter should be published as a binary. (useful to diagnose bug origins)
- The linter repository should have a
.gitignore(IDE files, binaries, OS files, etc. should not be committed) - A tag should never be recreated.
The golangci-lint team will edit this comment to check the boxes before and during the review.
The code review will start after the completion of those checkboxes (except for the specific items that the team will help to verify).
The reviews should be addressed as commits (no squash).
If the author of the PR is a member of the golangci-lint team, he should not edit this message.
This checklist does not imply that we will accept the linter.
CLAassistant
commented
May 20, 2025
CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.
Description
fparams is a linter tool for Go that checks the formatting of function parameters and return values. The linter ensures that function parameters and return values are either all on one line or each on a new line. This helps maintain consistent and readable code formatting in Go projects.
Link: https://github.com/artemk1337/fparams
Example
Given a function declaration like this:
fparams will suggest changing it to: