rev-del

Delete old, unused fingerprinted files from a revision manifest generated by a module such as gulp-rev.

Install

$ npm install --save-dev rev-del

Usage

1revDel({
2	oldManifest: 'rev-manifest.json',
3	newManifest: { /* a manifest */ },
4	suppress: true
5}, function (err, filesDeleted) {
6	// ...
7});

The manifests can be either objects or paths to files. oldManifest defaults to "rev-manifest.json" (which is the default output for gulp-rev), and newManifest has no default; it's assumed that you've got it in memory, so it's more efficient to pass it in as an object.

suppress, when set to false, will throw an error when rev-manifest.json doesn't exist. You don't normally want to change: usually, the first time you run your revisioning script, the manifest doesn't exist yet.

With Gulp

rev-del works great with Gulp and gulp-rev. You need to specify either dest in the options, or base in the manifest options—unless you're writing everything to the root directory.

1var gulp = require('gulp');
2var rev = require('gulp-rev');
3var revDel = require('rev-del');
4
5gulp.task('default', function () {
6    return gulp.src('src/*.css')
7        .pipe(rev())
8        .pipe(gulp.dest('dist'))
9        .pipe(rev.manifest())
10        .pipe(revDel({ dest: 'dist' }))           // <--
11        .pipe(gulp.dest('dist');
12});

You can pass it the name of the old manifest if you're not using the default:

1var gulp = require('gulp');
2var rev = require('gulp-rev');
3var revDel = require('rev-del');
4
5gulp.task('default', function () {
6    return gulp.src('src/*.css')
7        .pipe(rev())
8        .pipe(gulp.dest('dist'))
9        .pipe(rev.manifest('my-manifest.json'))
10        .pipe(revDel('some-other-manifest.json'))        // <--
11        .pipe(gulp.dest('dist');
12});

Call it before you call gulp.dest.

Note that you only need to change the name of manifest if it is different to the path given to rev.manifest(): if you just change the name of the manifest, rev-del will handle it fine:

1// This works
2var gulp = require('gulp');
3var rev = require('gulp-rev');
4var revDel = require('rev-del');
5
6gulp.task('default', function () {
7    return gulp.src('src/*.css')
8        .pipe(rev())
9        .pipe(gulp.dest('dist'))
10        .pipe(rev.manifest('my-manifest.json'))
11        .pipe(revDel({ dest: 'dist' }))                          // <--
12        .pipe(gulp.dest('dist');
13});

You can also specify the base as one of the options. Again, you don't need to do this if you've given it to rev.manifest()!

License

Released under the MIT license.