tui-textarea/CONTRIBUTING.md

Reporting an issue

For reporting a bug, please make sure your report includes the following points.

• How to reproduce it
  • What text the textarea contained as pre-condition
  • What operations you did
  • What was the expected behavior
  • What was the actual behavior
• Environment
  • Your terminal
  • Rust version
  • tui crate version

An example of bug report: https://github.com/rhysd/tui-textarea/issues/1

Submitting a pull request

Please ensure that all tests and linter checks passed on your branch before creating a PR which modifies some source files.

To run tests:

cargo test --features=search -- --skip src/lib.rs

--skip is necessary since cargo test tries to run code blocks in README file.

To run linters:

cargo clippy --all-features --examples
cargo fmt -- --check

If you use cargo-watch, cargo watch-check alias is useful to run checks automatically on writing to a file.

Running a fuzzer

To run fuzzing tests, cargo-fuzz is necessary.

cargo +nightly fuzz run edit

Running benchmark suites

Benchmarks are available using Criterion.rs.

To separate criterion crate dependency, benchmark suites are separated as another crate in bench/.

To run benchmarks:

cd ./bench
cargo bench --benches

See README in bench/ for more details.