{"_id":"gulp-tag-version","_rev":"1927707","name":"gulp-tag-version","description":"Tag git repository with current package version","dist-tags":{"latest":"1.3.1"},"maintainers":[{"name":"ikari","email":"npm@ikari.pl"}],"time":{"modified":"2021-12-09T13:54:49.000Z","created":"2014-04-03T06:19:55.474Z","1.3.1":"2017-12-25T20:18:57.157Z","1.3.0":"2015-07-16T08:32:27.035Z","1.2.1":"2014-11-27T14:38:27.989Z","1.1.0":"2014-09-10T07:10:54.504Z","1.0.2":"2014-04-09T11:01:46.091Z","1.0.1":"2014-04-09T10:55:39.714Z","0.1.0":"2014-04-03T06:19:55.474Z"},"users":{"troywarr":true,"jojohess":true,"jacopkane":true,"simplesessions":true,"rubiadias":true,"defking":true,"tdmalone":true,"itsmeara":true,"doptrois":true},"author":{"name":"Cezar \"ikari\" Pokorski","email":"git@ikari.pl"},"repository":{"type":"git","url":"git+ssh://git@github.com/ikari-pl/gulp-tag-version.git"},"versions":{"1.3.1":{"name":"gulp-tag-version","version":"1.3.1","description":"Tag git repository with current package version","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["gulpplugin","git","package.json"],"repository":{"type":"git","url":"git+ssh://git@github.com/ikari-pl/gulp-tag-version.git"},"author":{"name":"Cezar \"ikari\" Pokorski","email":"git@ikari.pl"},"license":"BSD-2-Clause","dependencies":{"ansi-colors":"~1.0.1","fancy-log":"~1.3.2","gulp-git":"^2.4.2","map-stream":"~0.1.0"},"devDependencies":{"gulp":"~3.6.0","gulp-bump":"~0.1.7","gulp-filter":"~0.4.0","gulp-prompt":"~0.1.1"},"gitHead":"ecad05e9136bee8752adeaed12d6f2fcd6bb7258","bugs":{"url":"https://github.com/ikari-pl/gulp-tag-version/issues"},"homepage":"https://github.com/ikari-pl/gulp-tag-version#readme","_id":"gulp-tag-version@1.3.1","_npmVersion":"5.6.0","_nodeVersion":"9.0.0","_npmUser":{"name":"ikari","email":"npm@ikari.pl"},"dist":{"shasum":"afdcd238582fffcd9068b3c93277ad48870fbf36","size":6773,"noattachment":false,"key":"/gulp-tag-version/-/gulp-tag-version-1.3.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-tag-version/download/gulp-tag-version-1.3.1.tgz"},"maintainers":[{"name":"ikari","email":"npm@ikari.pl"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/gulp-tag-version-1.3.1.tgz_1514233136992_0.3509702947922051"},"directories":{},"publish_time":1514233137157,"_hasShrinkwrap":false,"_cnpm_publish_time":1514233137157},"1.3.0":{"name":"gulp-tag-version","version":"1.3.0","description":"Tag git repository with current package version","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["gulpplugin","git","package.json"],"repository":{"type":"git","url":"git+ssh://git@github.com/ikari-pl/gulp-tag-version.git"},"author":{"name":"Cezar \"ikari\" Pokorski","email":"git@ikari.pl"},"license":"BSD-2-Clause","dependencies":{"map-stream":"~0.1.0","gulp-util":"~2.2.14","gulp-git":"~0.3.6"},"devDependencies":{"gulp-bump":"~0.1.7","gulp-filter":"~0.4.0","gulp-prompt":"~0.1.1","gulp":"~3.6.0","gulp-git":"~0.3.6"},"gitHead":"64642e0c3a8eef57236b17ce82d08bfb885c693e","bugs":{"url":"https://github.com/ikari-pl/gulp-tag-version/issues"},"homepage":"https://github.com/ikari-pl/gulp-tag-version#readme","_id":"gulp-tag-version@1.3.0","_shasum":"8448c87eed1866db8e6cb598bc419be2df7c47db","_from":".","_npmVersion":"2.11.2","_nodeVersion":"0.12.5","_npmUser":{"name":"ikari","email":"npm@ikari.pl"},"dist":{"shasum":"8448c87eed1866db8e6cb598bc419be2df7c47db","size":2925,"noattachment":false,"key":"/gulp-tag-version/-/gulp-tag-version-1.3.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-tag-version/download/gulp-tag-version-1.3.0.tgz"},"maintainers":[{"name":"ikari","email":"npm@ikari.pl"}],"directories":{},"publish_time":1437035547035,"_cnpm_publish_time":1437035547035,"_hasShrinkwrap":false},"1.2.1":{"name":"gulp-tag-version","version":"1.2.1","description":"Tag git repository with current package version","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["gulpplugin","git","package.json"],"repository":{"type":"git","url":"http://github.com/ikari-pl/gulp-tag-version.git"},"author":{"name":"Cezar \"ikari\" Pokorski","email":"git@ikari.pl"},"license":"BSD-2-Clause","dependencies":{"map-stream":"~0.1.0","gulp-util":"~2.2.14","gulp-git":"~0.3.6"},"devDependencies":{"gulp-bump":"~0.1.7","gulp-filter":"~0.4.0","gulp-prompt":"~0.1.1","gulp":"~3.6.0","gulp-git":"~0.3.6"},"bugs":{"url":"https://github.com/ikari-pl/gulp-tag-version/issues"},"_id":"gulp-tag-version@1.2.1","dist":{"shasum":"a93b2d94b3d2823b83739298e8895f06ae245ac1","size":2870,"noattachment":false,"key":"/gulp-tag-version/-/gulp-tag-version-1.2.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-tag-version/download/gulp-tag-version-1.2.1.tgz"},"_from":".","_npmVersion":"1.3.10","_npmUser":{"name":"ikari","email":"npm@ikari.pl"},"maintainers":[{"name":"ikari","email":"npm@ikari.pl"}],"directories":{},"publish_time":1417099107989,"_cnpm_publish_time":1417099107989,"_hasShrinkwrap":false},"1.1.0":{"name":"gulp-tag-version","version":"1.1.0","description":"Tag git repository with current package version","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["gulpplugin","git","package.json"],"repository":{"type":"git","url":"http://github.com/ikari-pl/gulp-tag-version.git"},"author":{"name":"Cezar \"ikari\" Pokorski","email":"git@ikari.pl"},"license":"BSD-2-Clause","dependencies":{"map-stream":"~0.1.0","gulp-util":"~2.2.14","gulp-git":"~0.3.6"},"devDependencies":{"gulp-bump":"~0.1.7","gulp-filter":"~0.4.0","gulp-prompt":"~0.1.1","gulp":"~3.6.0","gulp-git":"~0.3.6"},"bugs":{"url":"https://github.com/ikari-pl/gulp-tag-version/issues"},"homepage":"https://github.com/ikari-pl/gulp-tag-version","_id":"gulp-tag-version@1.1.0","dist":{"shasum":"e5cb81094b831060b4d33a857dd71d79a824c736","size":2470,"noattachment":false,"key":"/gulp-tag-version/-/gulp-tag-version-1.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-tag-version/download/gulp-tag-version-1.1.0.tgz"},"_from":".","_npmVersion":"1.3.14","_npmUser":{"name":"ikari","email":"npm@ikari.pl"},"maintainers":[{"name":"ikari","email":"npm@ikari.pl"}],"directories":{},"publish_time":1410333054504,"_cnpm_publish_time":1410333054504,"_hasShrinkwrap":false},"1.0.2":{"name":"gulp-tag-version","version":"1.0.2","description":"Tag git repository with current package version","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["gulpplugin","git","package.json"],"repository":{"type":"git","url":"http://github.com/ikari-pl/gulp-tag-version.git"},"author":{"name":"Cezar \"ikari\" Pokorski","email":"git@ikari.pl"},"license":"BSD-2-Clause","dependencies":{"map-stream":"~0.1.0","gulp-util":"~2.2.14","gulp-git":"~0.3.6"},"devDependencies":{"gulp-bump":"~0.1.7","gulp-filter":"~0.4.0","gulp-prompt":"~0.1.1","gulp":"~3.6.0","gulp-git":"~0.3.6"},"bugs":{"url":"https://github.com/ikari-pl/gulp-tag-version/issues"},"homepage":"https://github.com/ikari-pl/gulp-tag-version","_id":"gulp-tag-version@1.0.2","dist":{"shasum":"63454d068f65115941eec4a0459eb35480a3d703","size":2161,"noattachment":false,"key":"/gulp-tag-version/-/gulp-tag-version-1.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-tag-version/download/gulp-tag-version-1.0.2.tgz"},"_from":".","_npmVersion":"1.3.14","_npmUser":{"name":"ikari","email":"npm@ikari.pl"},"maintainers":[{"name":"ikari","email":"npm@ikari.pl"}],"directories":{},"publish_time":1397041306091,"_cnpm_publish_time":1397041306091,"_hasShrinkwrap":false},"1.0.1":{"name":"gulp-tag-version","version":"1.0.1","description":"Tag git repository with current package version","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["gulpplugin","git","package.json"],"repository":{"type":"git","url":"http://github.com/ikari-pl/gulp-tag-version.git"},"author":{"name":"Cezar \"ikari\" Pokorski","email":"git@ikari.pl"},"license":"BSD-2-Clause","dependencies":{"map-stream":"~0.1.0","gulp-util":"~2.2.14","gulp-git":"~0.3.6"},"devDependencies":{"gulp-bump":"~0.1.7","gulp-filter":"~0.4.0","gulp-prompt":"~0.1.1","gulp":"~3.6.0","gulp-git":"~0.3.6"},"bugs":{"url":"https://github.com/ikari-pl/gulp-tag-version/issues"},"homepage":"https://github.com/ikari-pl/gulp-tag-version","_id":"gulp-tag-version@1.0.1","dist":{"shasum":"a4af44c8b37a9ac00607c7d91dab42517948b892","size":2260,"noattachment":false,"key":"/gulp-tag-version/-/gulp-tag-version-1.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-tag-version/download/gulp-tag-version-1.0.1.tgz"},"_from":".","_npmVersion":"1.3.14","_npmUser":{"name":"ikari","email":"npm@ikari.pl"},"maintainers":[{"name":"ikari","email":"npm@ikari.pl"}],"directories":{},"publish_time":1397040939714,"_cnpm_publish_time":1397040939714,"_hasShrinkwrap":false},"0.1.0":{"name":"gulp-tag-version","version":"0.1.0","description":"Tag git repository with current package version","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["gulpplugin","git","package.json"],"repository":{"type":"git","url":"http://github.com/ikari-pl/gulp-tag-version.git"},"author":{"name":"Cezar \"ikari\" Pokorski","email":"git@ikari.pl"},"license":"BSD-2-Clause","dependencies":{"map-stream":"~0.1.0","gulp-util":"~2.2.14","gulp-git":"~0.3.6"},"bugs":{"url":"https://github.com/ikari-pl/gulp-tag-version/issues"},"homepage":"https://github.com/ikari-pl/gulp-tag-version","_id":"gulp-tag-version@0.1.0","dist":{"shasum":"b1bd0e9d65f1405de00475a672f1f9644cbe02ce","size":1514,"noattachment":false,"key":"/gulp-tag-version/-/gulp-tag-version-0.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/gulp-tag-version/download/gulp-tag-version-0.1.0.tgz"},"_from":".","_npmVersion":"1.3.14","_npmUser":{"name":"ikari","email":"npm@ikari.pl"},"maintainers":[{"name":"ikari","email":"npm@ikari.pl"}],"directories":{},"publish_time":1396505995474,"_cnpm_publish_time":1396505995474,"_hasShrinkwrap":false}},"readme":"gulp-tag-version\n================\n\n[![npm](https://img.shields.io/npm/v/gulp-tag-version.svg?maxAge=2592000&style=flat-square)]()\n[![npm](https://img.shields.io/npm/dt/gulp-tag-version.svg?maxAge=2592000&style=flat-square)]()\n[![npm](https://img.shields.io/npm/dm/gulp-tag-version.svg?maxAge=2592000&style=flat-square)]()\n\nTag git repository with current package version (gulp plugin).\n\nIt 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`).\n\n\nSimple example gulpfile\n-----------------------\n```js\nvar gulp = require('gulp'),\n    tagVersion = require('gulp-tag-version');\n\n// Assuming there's \"version: 1.2.3\" in package.json,\n// tag the last commit as \"v1.2.3\"\ngulp.task('tag', function() {\n  return gulp.src(['./package.json']).pipe(tagVersion());\n});\n```\n\n\nAdvanced example gulpfile (with bumping and commiting)\n------------------------------------------------------\n\n```js\n\n// dependencies\nvar gulp = require('gulp'),\n    git = require('gulp-git'),\n    bump = require('gulp-bump'),\n    filter = require('gulp-filter'),\n    tagVersion = require('gulp-tag-version');\n\n/**\n * Bumping version number and tagging the repository with it.\n * Please read http://semver.org/\n *\n * You can use the commands\n *\n *     gulp patch     # makes v0.1.0 → v0.1.1\n *     gulp feature   # makes v0.1.1 → v0.2.0\n *     gulp release   # makes v0.2.1 → v1.0.0\n *\n * To bump the version numbers accordingly after you did a patch,\n * introduced a feature or made a backwards-incompatible release.\n */\n\nfunction inc(importance) {\n    // get all the files to bump version in\n    return gulp.src(['./package.json', './bower.json'])\n        // bump the version number in those files\n        .pipe(bump({type: importance}))\n        // save it back to filesystem\n        .pipe(gulp.dest('./'))\n        // commit the changed version number\n        .pipe(git.commit('bumps package version'))\n\n        // read only one file to get the version number\n        .pipe(filter('package.json'))\n        // **tag it in the repository**\n        .pipe(tagVersion());\n}\n\ngulp.task('patch', function() { return inc('patch'); })\ngulp.task('feature', function() { return inc('minor'); })\ngulp.task('release', function() { return inc('major'); })\n```\n\nOther features/remarks\n----------------------\n\n* If you need any special tagging options to be passed down to `git.tag`, just add it to the `tagVersion` options. For example:\n```js\ngulp.task('bump_submodule', function(){\n    return gulp.src('./bower.json',  { cwd: './dist' })\n        .pipe(bump({type: 'patch'}))\n        .pipe(gulp.dest('./',{ cwd: './dist' }))\n        .pipe(git.commit('bumps package version',{cwd: './dist'}))\n        .pipe(filter('bower.json'))\n        .pipe(tagVersion({cwd: './dist'}));\n});\n```\n\n* If you don't want the version number to be read from the input stream, use the `version` parameter:\n```js*\nreturn gulp.src ...\n  ...\n  .pipe(tagVersion({version: '1.2.3'}));\n```\n\nThanks :beer:\n--------\n\n* to guys and gals from Fractal for [Gulp](http://gulpjs.com/) itself, obviously\n* to Steve Lacy (http://slacy.me) for creating [`gulp-bump`](https://github.com/stevelacy/gulp-bump) and [`gulp-git`](https://github.com/stevelacy/gulp-git) used here\n* The main file structure is based on `gulp-bump` a bit as well (this is my first plugin :))\n* To [@pacemkr](https://github.com/pacemkr) for the first pull request I ever got (supporting empty prefix)\n* To [@lapanoid](https://github.com/lapanoid) for passing `opts` down to `git.tag`\n* To [@brianmhunt](https://github.com/brianmhunt) for suggesting the `version` parameter\n* To [@adambuczynski](https://github.com/adambuczynski) for option to customize tag label\n* To [@mjeanroy](https://github.com/mjeanroy) for a gulp-util obsoletion update\n","_attachments":{},"homepage":"https://github.com/ikari-pl/gulp-tag-version#readme","bugs":{"url":"https://github.com/ikari-pl/gulp-tag-version/issues"},"license":"BSD-2-Clause"}