Add benchmarking scripts
- Dominant language
- JavaScript
- Stars
- 186
- Forks
- 70
- PR merge metrics
- No merged PRs in 30d
Description
For many types of changes (such as #76 and #78, recently) it would be great to have a set of benchmarking scripts for assessing performance impacts.
`spritezero` does currently have some unit-tests that function sort of like benchmarking ([see here](https://github.com/mapbox/spritezero/blob/a6eaaca6b9e416dcb5b6561b5d62bc57bf204a6e/test/generate.test.js#L46-L66)) but it is not ideal to have these mixed in with unit tests.
**Benchmarking scripts guidelines:**
- Should live in the `bench/` directory, following convention of other repos (ex https://github.com/mourner/rbush/tree/master/bench).
- Can be run locally to assess if changes to spritezero deps or code have an impact on performance or memory usage
- Should do no network, only local i/o
- Should be primarily designed to be run locally and used for collaborative testing
- Should nevertheless be run on CI (with explicit lines added to the .travis.yml to run them) to ensure they don't break (since they should not run as unit tests). But we should ignore their timing result on CI - the only purpose is to make sure they don't break under refactors.
- Should dump their output in an easy to share format that can be posted on tickets and referred back to
- Data input should be stable over time so their results can be compared across time with git bisect
- Should have configurable concurrency and should not default to using os.cpus() otherwise results will not be very comparable across machines.
(h/t @springmeyer for this list)
Contributor guide
Research direction
Start by reviewing the benchmark-like cases in test/generate.test.js, the proposed bench/ convention, and the existing .travis.yml configuration. Define stable local inputs, configurable concurrency, shareable output, and CI execution that checks for breakage without evaluating timing; done means the scripts cover performance or memory checks without network I/O.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript
- Domain
- ci-cd, performance, tooling
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100