@futagoza/gulp-bump

0.6.0 • Public • Published

This package is included with @futagoza/gulp

Will bump the version field of any file passed to it from Gulp.

example

const gulp = require( "gulp" );
const bump = require( "@futagoza/gulp-bump" );
const pump = require( "pump" );

// Bump the "version" field of every `package.json` in the packages directory
gulp.task( "bump", () => pump(

    gulp.src( "packages/**/package.json" ),
    bump( /* [ argv = process.argv, options = {} ] */ ),
    gulp.dest( "packages/" )

) );

cli usage

This module was created to always read the CLI arguments passed to the current Gulp task. It takes the arguments from the command line interface, processes them before finally passing them to gulp-regex. You can also programmatically pass default options.

Optionally you can pass the argv yourself as the first argument (an array), or as options.argv

options

As well as the options from gulp-regex, you can use the following:

api option cli option description
argv Used if no argv argument was provided; otherwise defaults to process.argv
ignore1 --ignore Inverts the job of only, bumping every file but those that match the pattern
major --major Sets the option type for gulp-regex to "major"2
minor --minor Sets the option type for gulp-regex to "minor"2
new-version --new-version value
-V value
Gulp prints it's own version with --version, so this happened...
only1 --only pattern Only bump files with the property name that match pattern (a RegExp string)
patch --patch Sets the option type for gulp-regex to "patch"2
quiet --quit Flag to silence the summary.
summary3 A callback that by default prints the summary to the console.
tag --tag, --keepmetadata Flag that enables the keepmetadata option for gulp-regex.
  1. This has only implemented for and tested on JSON files
  2. Only used if there's no type or version options
  3. Has a call signature of (filename: string, results: {}) => void

license

History license

This module was originally a wrapper around gulp-bump until v0.4; at which point because I needed a way to change the summary, I copy-pasted the code and it's dependencies, as well as updating the code for Node 6+ and adding what I needed; so now it's a direct wrapper around gulp-regex instead.

@futagoza/gulp-bump is Copyright (c) 2018+ Futago-za Ryuu
gulp-bump and gulp-regex are Copyright (c) 2015+ Steve Lacy

Package Sidebar

Install

npm i @futagoza/gulp-bump

Weekly Downloads

1

Version

0.6.0

License

MIT

Unpacked Size

9.86 kB

Total Files

5

Last publish

Collaborators

  • ryuu