node package manager



Tag git repository with current package version (gulp plugin).

It will read the version attribute (by default, override with key option) from the JSON stream (probably your package.json or bower.json), prefixes it with "v" (override with prefix option) and tags the repository (effectively issues the git tag <tagname> command) with such created tagname (e.g. v1.2.3).

Simple example gulpfile

var gulp = require('gulp'),
    tag_version = require('gulp-tag-version');
// Assuming there's "version: 1.2.3" in package.json, 
// tag the last commit as "v1.2.3" 
gulp.task('tag', function() {
  return gulp.src(['./package.json']).pipe(tag_version());

Advanced example gulpfile (with bumping and commiting)

// dependencies 
var gulp = require('gulp'),
    git = require('gulp-git'),
    bump = require('gulp-bump'),
    filter = require('gulp-filter'),
    tag_version = require('gulp-tag-version');
 * Bumping version number and tagging the repository with it.
 * Please read
 * You can use the commands
 *     gulp patch     # makes v0.1.0 → v0.1.1
 *     gulp feature   # makes v0.1.1 → v0.2.0
 *     gulp release   # makes v0.2.1 → v1.0.0
 * To bump the version numbers accordingly after you did a patch,
 * introduced a feature or made a backwards-incompatible release.
function inc(importance) {
    // get all the files to bump version in 
    return gulp.src(['./package.json', './bower.json'])
        // bump the version number in those files 
        .pipe(bump({type: importance}))
        // save it back to filesystem 
        // commit the changed version number 
        .pipe(git.commit('bumps package version'))
        // read only one file to get the version number 
        // **tag it in the repository** 
gulp.task('patch', function() { return inc('patch'); })
gulp.task('feature', function() { return inc('minor'); })
gulp.task('release', function() { return inc('major'); })

Other features/remarks

  • If you need any special tagging options to be passed down to git.tag, just add it to the tag_version options. For example:
gulp.task('bump_submodule', function(){
    return gulp.src('./bower.json',  { cwd: './dist' })
        .pipe(bump({type: 'patch'}))
        .pipe(gulp.dest('./',{ cwd: './dist' }))
        .pipe(git.commit('bumps package version',{cwd: './dist'}))
        .pipe(tag_version({cwd: './dist'}));
  • If you don't want the version number to be read from the input stream, use the version parameter:
return gulp.src ...
  .pipe(tag_version({version: '1.2.3'}));

Thanks 🍺

  • to guys and gals from Fractal for Gulp itself, obviously
  • to Steve Lacy ( for creating gulp-bump and gulp-git used here
  • The main file structure is based on gulp-bump a bit as well (this is my first plugin :))
  • To @pacemkr for the first pull request I ever got (supporting empty prefix)
  • To @lapanoid for passing opts down to git.tag
  • To @brianmhunt for suggesting the version parameter