gulp-rename

WebJar for gulp-rename

License	MIT
GroupId	org.webjars.npm
ArtifactId	gulp-rename
Last Version	1.4.0
Release Date	Aug 21, 2018
Type	jar
Description	gulp-rename WebJar for gulp-rename
Project URL	http://webjars.org
Source Code Management	https://github.com/hparra/gulp-rename

Download gulp-rename

Filename	Size
gulp-rename-1.4.0.pom
gulp-rename-1.4.0.jar	10 KB
gulp-rename-1.4.0-sources.jar	22 bytes
gulp-rename-1.4.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/gulp-rename/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>gulp-rename</artifactId>
    <version>1.4.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/gulp-rename/
implementation 'org.webjars.npm:gulp-rename:1.4.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/gulp-rename/
implementation ("org.webjars.npm:gulp-rename:1.4.0")

Apache Buildr

'org.webjars.npm:gulp-rename:jar:1.4.0'

Apache Ivy

<dependency org="org.webjars.npm" name="gulp-rename" rev="1.4.0">
  <artifact name="gulp-rename" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='gulp-rename', version='1.4.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "gulp-rename" % "1.4.0"

Leiningen

[org.webjars.npm/gulp-rename "1.4.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

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 to a fixed value
gulp.src("./src/main/text/hello.txt")
  .pipe(rename("main/text/ciao/goodbye.md"))
  .pipe(gulp.dest("./dist")); // ./dist/main/text/ciao/goodbye.md

// rename via mutating function
gulp.src("./src/**/hello.txt")
  .pipe(rename(function (path) {
    // Updates the object in-place
    path.dirname += "/ciao";
    path.basename += "-goodbye";
    path.extname = ".md";
  }))
  .pipe(gulp.dest("./dist")); // ./dist/main/text/ciao/hello-goodbye.md

// rename via a map function
gulp.src("./src/**/hello.txt")
  .pipe(rename(function (path) {
    // Returns a completely new object, make sure you return all keys needed!
    return {
      dirname: path.dirname + "/ciao",
      basename: path.basename + "-goodbye",
      extname: ".md"
    };
  }))
  .pipe(gulp.dest("./dist")); // ./dist/main/text/ciao/hello-goodbye.md

// rename via a fixed object
gulp.src("./src/main/text/hello.txt", { base: process.cwd() })
  .pipe(rename({
    dirname: "main/text/ciao",
    basename: "aloha",
    prefix: "bonjour-",
    suffix: "-hola",
    extname: ".md"
  }))
  .pipe(gulp.dest("./dist")); // ./dist/main/text/ciao/bonjour-aloha-hola.md

See test/rename.spec.js for more examples and test/path-parsing.spec.js for hairy details.

Notes

• dirname is the relative path from the base directory set by gulp.src to the filename.
  • gulp.src() uses glob-stream which sets the base to the parent of the first directory glob (*, **, [], or extglob). dirname is the remaining directories or ./ if none. glob-stream versions >= 3.1.0 (used by gulp >= 3.2.2) accept a base option, which can be used to explicitly set the base.
  • gulp.dest() renames the directories between process.cwd() and dirname (i.e. the base relative to CWD). Use dirname to rename the directories matched by the glob or descendents of the base of option.
• basename is the filename without the extension like path.basename(filename, path.extname(filename)).
• extname is the file extension including the . like path.extname(filename).
• when using a function, a second file argument is provided with the whole context and original file value.
• when using a function, if no Object is returned then the passed parameter object (along with any modifications) is re-used.

License

MIT License

Versions

Version
1.4.0 Aug 21, 2018
1.2.2 May 29, 2016
1.2.0 Aug 29, 2015