3.8 KiB

Raw Blame History

Maintaining

Conduct

Be kind to everyone. Read and adhere to the Code of Conduct.

Testing

npm test: Lint the code and run the entire test suite with coverage.
npm run test-win: Run the tests on Windows.
npm run coverage: Generate a coverage report for the last test run (opens a browser window).
tap test/fork.js --bail: Run a specific test file and bail on the first failure (useful when hunting bugs).

Release process

Bump dependencies.
Ensure Travis CI and AppVeyor are green.
Publish a new version using np with a version number according to semver.
Write a release note following the style of previous release notes.

Pull requests

New features should come with tests and documentation.
Ensure the contributing guidelines are followed.
At least one team member must LGTM a pull request before it's merged.
Squash commits when merging. Example

Profiling

You should first install iron-node and / or devtool globally:

$ npm install --global iron-node devtool

In the root of a project using AVA, run:

$ iron-node node_modules/ava/profile.js <test-file>

Or:

$ devtool node_modules/ava/profile.js <test-file>

Once the Dev Tools window has loaded, activate Memory or CPU profiling, and then hit Cmd R to rerun the tests.

As soon as the tests finish, stop the recording and inspect the profiler results. The flamegraph can be displayed by choosing Chart from the drop down on the Profiles tab (other views include Tree (top down) and Heavy (bottom up)).

You may also want to check out the Settings page in Dev Tools and enable one or more options in the Profiling section.

Helpful resources

Benchmarking

First collect benchmark data for a branch/commit:

$ node bench/run

Once you have collected data from two/three branches/commits:

$ node bench/compare

You could for example gather benchmark data from the working tree and the last commit.

You can now launch a subset of the suite:

$ node bench/run.js concurrent/sync.js serial/sync.js -- concurrent/sync.js -- serial/sync.js

Note the -- separator. The above would be the same as benchmarking all three of the following commands.

$ ava concurrent/sync.js serial/sync.js
$ ava concurrent/sync.js
$ ava serial/sync.js

Also if you are benchmarking a suite that should fail, you must add the --should-fail flag in that group:

$ node bench/run.js concurrent/sync.js -- --should-fail other/failures.js

The above benchmarks two commands, but expects the second one to fail.

Onboarding new core members

Add the user to the readme.md and package.json.
Add the user as a collaborator to all AVA related repos and npm packages.
Share the Twitter account login info and that he user is free to tweet/retweet relevant stuff.

3.8 KiB Raw Blame History