gulp-chmod
Change permissions of Vinyl files
Install
$ npm install --save-dev gulp-chmod
Usage
const gulp = require('gulp');
const chmod = require('gulp-chmod');
exports.default = () => (
gulp.src('src/app.js')
.pipe(chmod(0o755))
.pipe(gulp.dest('dist'))
);
or
const gulp = require('gulp');
const chmod = require('gulp-chmod');
exports.default = () => (
gulp.src('src/app.js')
.pipe(chmod({
owner: {
read: true,
write: true,
execute: true
},
group: {
execute: true
},
others: {
execute: true
}
}))
.pipe(gulp.dest('dist'))
);
API
chmod(fileMode, directoryMode?)
fileMode
Type: number | object
Can either be a chmod octal number or an object with the individual permissions specified.
Values depends on the current file, but these are the possible keys:
{
owner: {
read: true,
write: true,
execute: true
},
group: {
read: true,
write: true,
execute: true
},
others: {
read: true,
write: true,
execute: true
}
}
When read
, write
, and execute
are the same, you can simplify the object:
{
read: true
}
Pass undefined
to not set permissions on files. Useful if you only want to set permissions on directories.
directoryMode
Type: true | number | object
Same as fileMode
, but applies to directories.
Specify true
to use the same value as fileMode
.
Tip
Combine it with gulp-filter to only change permissions on a subset of the files.
const gulp = require('gulp');
const gFilter = require('gulp-filter');
const chmod = require('gulp-chmod');
const filter = gFilter('src/cli.js', {restore: true});
exports.default = () => (
gulp.src('src/*.js')
// Filter a subset of the files
.pipe(filter)
// Make them executable
.pipe(chmod(0o755))
// Bring back the previously filtered out files
.pipe(filter.restore)
.pipe(gulp.dest('dist'))
);
Related
- gulp-chown - Change owner of Vinyl files