Contributions are welcome. This project accepts pull requests on GitHub.
You can find help and discussion at the project's GitHub Issues page. Please use the issue tracker to report any bugs found with this project.
When submitting a bug report, please include enough information to reproduce the bug. A good bug report includes the following sections:
-
Description: Provide a short and clear description of the bug.
-
Steps to Reproduce: Provide steps to reproduce the behavior you are experiencing. Please try to keep this as short as possible. If able, create a reproducible test or script outside any framework you are using. This will help us to quickly debug the issue.
-
Expected Behavior: Provide a short and clear description of what you expect to happen.
-
Screenshots or Other Output: If applicable, add screenshots or program output to help explain your problem.
-
Environment Details: Provide details about the system where you're using this package, such as Go version and operating system.
-
Additional Context: Provide any additional context that may help us debug the problem.
This project welcomes pull requests to fix bugs!
If you see a bug report that you'd like to fix, please feel free to do so. Following the directions and guidelines described in the "Adding New Features" section below, you may create bugfix branches and send pull requests.
If you have an idea for a new feature, it's a good idea to check out the issues or active pull requests first to see if anyone is already working on the feature. If not, feel free to submit an issue first, asking whether the feature is beneficial to the project. This will save you from doing a lot of development work only to have your feature rejected. We don't enjoy rejecting your hard work, but some features don't fit with the goals of the project.
When you do begin working on your feature, here are some guidelines to consider:
- Your pull request description should clearly detail the changes you have made. We will use this description to update the CHANGELOG. If there is no description, or it does not adequately describe your feature, we may ask you to update the description.
- All pull requests must pass the full CI suite. Hint: run
make cito check locally. - Please write tests for any new features you add, using only the standard library
testingpackage. - Please ensure that tests pass before submitting your pull request. This project automatically runs tests for
pull requests, but running them locally will save you time. Hint: run
make test. - Use topic/feature branches. Please do not ask to pull from your main branch. - For more information, see "Understanding the GitHub flow."
- Submit one feature per pull request. If you have multiple features you wish to submit, please break them into separate pull requests.
To develop this project, you will need Go 1.25 or greater,
golangci-lint v2, and make.
After cloning this repository locally, the full suite of code quality tools can be run in one command:
make ciThis project uses go vet and golangci-lint (configured in .golangci.yml) for static
analysis, with gofumpt and goimports as the enforced formatters:
# Static analysis
make vet
make lint
# Auto-format the codebase
make fmtThe following must pass before we will accept a pull request. If this does not pass, it will result in a complete build failure:
make testTests run with the race detector and shuffled execution order. An HTML coverage report can be generated with
make cover (written to build/coverage.html).