Thanks for your interest in contributing to ouch
!
- Code of Conduct
- I want to ask a question or provide feedback
- Adding a new feature
- PRs
- Dealing with UI tests
We follow the Rust Official Code of Conduct.
Create an issue or go to Ouch Discussions.
Before opening the PR, open an issue to discuss your addition, this increases the chance of your PR being accepted.
- Pass all CI checks.
- After opening the PR, add a CHANGELOG.md entry.
We use snapshots to do UI testing and guarantee a consistent output, this way, you can catch accidental changes or see what output changed in the PR diff.
- Run tests with
cargo
normally, or with a filter:
cargo test
# Only run UI tests
cargo test -- ui
- If some UI test failed, you should review it:
cargo insta review
- After addressing all, you should be able to
git add
andcommit
accordingly.