1# Contributing
2
3This is a cross-team project, aiming to build solid foundations for Rust UI libraries of all sorts.
4New contributions are extremely welcome!
5
6The basic process is simple:
7
81. Pick an [issue](https://github.com/DioxusLabs/sprawl/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22), or [file a new one](https://github.com/DioxusLabs/sprawl/issues/new).
92. Comment in the issue that you plan to tackle it, and the team will assign the task to you.
103. Submit a PR.
114. Respond to feedback from reviewers and make sure CI passes.
12
13The PR review process is completely open: help us by commenting on, testing and approving PRs.
14
15If you'd like to help on a consistent basis or are interested in project management, create a Discussions post, and we'll be happy to hand out triage rights.
16
17## Testing
18
19Flexbox layouts are tested by validating that layouts written in this crate perform the same as in Chrome.
20This is done by rendering an equivalent layout in HTML and then generating a Rust test case which asserts that the resulting layout is the same when run through our layout engine.
21
22You can run these tests without setting up a webdriver environment but if you are looking to add any test case you will need to install [chromedriver](http://chromedriver.chromium.org).
23If you are developing on macOS this is easy to do through brew.
24
25```bash
26brew tap homebrew/cask
27brew cask install chromedriver
28```
29
30Once you have chromedriver installed and available in `PATH` you can re-generate all tests by running `cargo run --package gentest`.
31
32To add a new test case add another HTML file to `/test_fixtures` following the current tests as a template for new tests.
33
34## Benchmarking
35
36Benchmarks build on the same infrastructure as testing, and actually benchmarks are automatically generated from test fixtures just like tests.
37Run `cargo bench` to run benchmarks locally.
CONTRIBUTING.md
Contributing
This is a cross-team project, aiming to build solid foundations for Rust UI libraries of all sorts.
New contributions are extremely welcome!
The basic process is simple:
- Pick an issue, or file a new one.
- Comment in the issue that you plan to tackle it, and the team will assign the task to you.
- Submit a PR.
- Respond to feedback from reviewers and make sure CI passes.
The PR review process is completely open: help us by commenting on, testing and approving PRs.
If you'd like to help on a consistent basis or are interested in project management, create a Discussions post, and we'll be happy to hand out triage rights.
Testing
Flexbox layouts are tested by validating that layouts written in this crate perform the same as in Chrome.
This is done by rendering an equivalent layout in HTML and then generating a Rust test case which asserts that the resulting layout is the same when run through our layout engine.
You can run these tests without setting up a webdriver environment but if you are looking to add any test case you will need to install chromedriver.
If you are developing on macOS this is easy to do through brew.
brew tap homebrew/cask
brew cask install chromedriver
Once you have chromedriver installed and available in PATH you can re-generate all tests by running cargo run --package gentest.
To add a new test case add another HTML file to /test_fixtures following the current tests as a template for new tests.
Benchmarking
Benchmarks build on the same infrastructure as testing, and actually benchmarks are automatically generated from test fixtures just like tests.
Run cargo bench to run benchmarks locally.