1.0.1 • Published 8 years ago

gulp-inject-version v1.0.1

Weekly downloads
531
License
Proprietary
Repository
github
Last release
8 years ago

gulp-inject-version

Gulp plugin for reading a version number out of a JSON file and injecting it into text based files.

By default, this plugin will read the version property from your project's package.json. It will then search the content of all files in the stream for the text %%GULP_INJECT_VERSION%% and replace that text with vX.Y.Z (where X.Y.Z is the version number it read from package.json).

installation

npm

npm install gulp-inject-version

usage

var injectVersion = require('gulp-inject-version');

gulp.task('build', function () {
    return gulp.src('src/index.html')
        .pipe(injectVersion())
        // whatever else you want to do to index.html...
        .pipe(gulp.dest('dist'));
});

In this usage example, if src/index.html contained the html

<div class="footer">My Project %%GULP_INJECT_VERSION%%</div>

and the version property in your project's package.json was set to '1.0.3', then after running you'd find that dist/index.html now contains the replacement text:

<div class="footer">My Project v1.0.3</div>

options

An options object can be passed into the plugin like so:

var injectVersion = require('gulp-inject-version');

gulp.task('build', function () {
    return gulp.src('src/index.html')
        .pipe(injectVersion({
            package_file: 'bower.json',
            // your other option overrides here
        }))
        // whatever else you want to do to index.html...
        .pipe(gulp.dest('dist'));
});

Option properties that you can override are:

Option propertytypedescriptiondefault value
package_filestringThe JSON containing file from which we should read the version'package.json'
version_propertystringThe name of the property that holds the version text within the JSON file'version'
prependstringA string to prepend to the outputted version text'v'
appendstringA string to append to the outputted version text''
replacestringThe placeholder text to be replaced with the version text in the source files'%%GULP_INJECT_VERSION%%'