gulp-shared-tasks v0.30.40

Automated tasks (linting, testing, building) for a Node.js development workflow using Babel, ESLint, Prettier, Jscpd, Ava, Travis, nyc and codecov.

The task runner is Gulp, but you don't need to know Gulp to use these tasks.

Workflow

Code is compiled from the src to the build directory using Babel, so you can use the latest JavaScript features.

Linting and formatting are performed with ESLint, Prettier and Jscpd. We recommend using plugins with your IDE (code editor) for both Prettier and ESLint so that linting/formatting is performed as you code.

We use Ava to run tests. Each line of code must be tested.

Usage

Any task can be run using gulp for example:

gulp build

If you're on cmd.exe (Windows) use npx gulp ... instead.

Overview

The main commands are:

• gulp check: lint/format the JavaScript files.
• gulp build: build source files and test files. Must be run before running any code or unit tests.
• gulp unit: run unit tests.
• gulp test: perform the three tasks above.

Use gulp checkw, gulp buildw and gulp unitw to run them in watch mode.

Travis CI ensures that:

• tests pass on all supported environments.
• all source files are covered by tests and follow the same coding style.

Available tasks

gulp check

Lint and check source files:

• format JavaScript files with Prettier.
• lint and autofix JavaScript files using ESLint (see the coding style).
• find duplicated code with Jscpd.

This is automatically triggered before any git push.

gulp build

Build source files and test files:

• JavaScript files are transpiled with Babel.
• Other files are copied as is.

Source files are built from the src directory to the build/src directory. Test files are built from the test directory to the build/test directory.

This must be done before running any code or unit tests.

gulp unit

Run unit tests with Ava.

To specify Ava options, please call ava directly instead. For example: ava --update-snapshots.

To target a single test file, use ava build/test/file.js not ava test/file.js.

Test coverage is performed in CI (Travis) and uploaded to codecov. It can also be performed locally using nyc ava.

gulp test

Runs gulp check then gulp build then gulp unit.

This is performed on CI (Travis) for each OS (Windows, Mac, Linux) and supported Node.js version.

gulp checkw, gulp buildw, gulp unitw, gulp warnw

Like gulp check, gulp build, gulp unit and gulp warn but in watch mode. The watch mode works even when installing/updating/uninstalling dependencies or changing the Gulp tasks themselves.

They can be performed together, e.g. gulp buildw in one terminal tab and gulp unitw in another.

Other tasks

gulp warn

Check for security vulnerabilities (using npm audit) and outdated dependencies (using npm outdated).

gulp releasePatch, gulp releaseMinor, gulp releaseMajor

Release a new patch/minor/major version on npm and GitHub using release-it.

The new version will only be published to npm after CI tests have passed.

Only the repository owner can perform these tasks.

gulp coverage

Ensures that files are fully covered by tests using nyc. This is meant to be performed on CI (Travis).

Custom tasks

Repositories with a gulp top-level directory have additional tasks. Please check those files to see which custom tasks are available.

Support

If you found a bug or would like a new feature, don't hesitate to submit an issue on GitHub.

For other questions, feel free to chat with us on Gitter.

Everyone is welcome regardless of personal background. We enforce a Code of conduct in order to promote a positive and inclusive environment.

Contributing

This project was made with ❤️. The simplest way to give back is by starring and sharing it online.

If the documentation is unclear or has a typo, please click on the page's Edit button (pencil icon) and suggest a correction.

If you would like to help us fix a bug or add a new feature, please check our guidelines. Pull requests are welcome!