Rev Task

Sharable tasks to apply a unique hash to file names. Implements the following gulp plugins:

• gulp-rev
• gulp-rev-delete-original
• gulp-rev-rewrite

Note This task will be applied just on production.

Installation

This task requires @wok-cli/core as peer dependency.

npm i @wok-cli/core @wok-cli/task-rev --save-dev

Environmental variables

This task adds the following environmental variables:

• rev: (boolean) Set to false to skip execution.

Parameters

| parameter | type | default | note | | ---------- | ------------------ | ------- | ------------------------------------------------- | | pattern | stringstring[] | | Globs source files to rewrite (1) | | dest | string | | Destination folder (1) | | manifest | string | | Manifest file path (1) | | hook:(*) | object | | Hooks configuration parameters (see below) |

1. Supports environment templates.

Hooks

| name | type | description | | --------- | ------------- | ------------------------------------------------------------------------ | | before | lazypipe | Executed before file revving | | after | lazypipe | Executed after file revving (source files have been deleted) | | rewrite | lazypipe | Executed before revved source files are updated by gulp-rev-rewrite |

Example

This example task will perform the following actions:

1. match the files with the provided glob pattern
2. create a new file with a unique rev hash appended to it's name
3. remove the original files

const $ = require('@wok-cli/core');
const rev = require('@wok-cli/task-rev');

exports.rev = $.task(rev, {
  pattern: ['public/**/*.{js,css}'],
  dest: 'public',
  manifest: 'public/manifest.json',
});