JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 46987
  • Score
    100M100P100Q146239F
  • License MIT

Static asset revisioning by appending content hash to filenames: unicorn.css => unicorn-098f6bcd.css

Package Exports

  • gulp-rev

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (gulp-rev) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

gulp-rev Build Status

Static asset revisioning by appending content hash to filenames unicorn.cssunicorn-098f6bcd.css

Make sure to set the files to never expire for this to have an effect.

Install

$ npm install --save-dev gulp-rev

Usage

var gulp = require('gulp');
var rev = require('gulp-rev');

gulp.task('default', function () {
    return gulp.src('src/*.css')
        .pipe(rev())
        .pipe(gulp.dest('dist'));
});

Options are intentionally missing as the default should work in most cases.

Original path

Original file paths are stored at file.revOrigPath. This could come in handy for things like rewriting references to the assets.

Asset hash

The hash of each rev'd file is stored at file.revHash. You can use this for customizing the file renaming, or for building different manifest formats.

Asset manifest

var gulp = require('gulp');
var rev = require('gulp-rev');

gulp.task('default', function () {
    // by default, gulp would pick `assets/css` as the base,
    // so we need to set it explicitly:
    return gulp.src(['assets/css/*.css', 'assets/js/*.js'], {base: 'assets'})
        .pipe(gulp.dest('build/assets'))  // copy original assets to build dir
        .pipe(rev())
        .pipe(gulp.dest('build/assets'))  // write rev'd assets to build dir
        .pipe(rev.manifest())
        .pipe(gulp.dest('build/assets')); // write manifest to build dir
});

An asset manifest, mapping the original paths to the revisioned paths, will be written to dist/rev-manifest.json:

{
    "css/unicorn.css": "css/unicorn-098f6bcd.css"
}

Integration

For more info on how to integrate gulp-rev into your app, have a look at the integration guide.

License

MIT © Sindre Sorhus