gulp-rename

What is gulp-rename?

The gulp-rename package is a plugin for Gulp that allows you to rename files easily. It provides a simple way to change the name, extension, or path of files in your Gulp build process.

What are gulp-rename's main functionalities?

Rename a file

This feature allows you to rename a file. In this example, 'src/file.txt' is renamed to 'renamed-file.txt' and saved in the 'dist' directory.

const gulp = require('gulp');
const rename = require('gulp-rename');

gulp.task('rename', function() {
  return gulp.src('src/file.txt')
    .pipe(rename('renamed-file.txt'))
    .pipe(gulp.dest('dist'));
});

Change file extension

This feature allows you to change the file extension. In this example, 'src/file.txt' is renamed to 'file.md' and saved in the 'dist' directory.

const gulp = require('gulp');
const rename = require('gulp-rename');

gulp.task('change-extension', function() {
  return gulp.src('src/file.txt')
    .pipe(rename({ extname: '.md' }))
    .pipe(gulp.dest('dist'));
});

Rename with a function

This feature allows you to use a function to rename files. In this example, 'src/file.txt' is renamed to 'file-renamed.md' and saved in the 'dist' directory.

const gulp = require('gulp');
const rename = require('gulp-rename');

gulp.task('rename-function', function() {
  return gulp.src('src/file.txt')
    .pipe(rename(function (path) {
      path.basename += '-renamed';
      path.extname = '.md';
    }))
    .pipe(gulp.dest('dist'));
});

Other packages similar to gulp-rename

gulp-rev

gulp-rev is a plugin for Gulp that allows you to append content hash to filenames, which is useful for cache busting. Unlike gulp-rename, which focuses on renaming files, gulp-rev is specifically designed for versioning files by appending a hash.

README

gulp-rename

gulp-rename is a gulp plugin to rename files easily.

Usage

gulp-rename provides simple file renaming methods.

var rename = require("gulp-rename");

// rename via string
gulp.src("./src/hello.txt")
	.pipe(rename("goodbye.txt"))
	.pipe(gulp.dest("./dist"));

// rename via function
gulp.src("./src/hello.txt")
	.pipe(rename(function (dir, base, ext) {
		return base + "-goodbye" + ext;
	}))
	.pipe(gulp.dest("./dist")); // ./dist/hello-goodbye.txt

// rename via hash
gulp.src("./src/hello.txt")
	.pipe(rename({
		prefix: "bonjour-",
		suffix: "-hola",
		ext: ".md"
	}))
	.pipe(gulp.dest("./dist")); // ./dist/bonjour-hello-hola.md

Notes

ext follows the node convention in that it includes the period.

License

MIT License