• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

therealklanni/git-guppy: Simple git-hook integration for your gulp workflows.

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

therealklanni/git-guppy

开源软件地址(OpenSource Url):

https://github.com/therealklanni/git-guppy

开源编程语言(OpenSource Language):

JavaScript 100.0%

开源软件介绍(OpenSource Introduction):

Travis npm npm semantic-release Beerpay

git-guppy

guppy

Simple git-hook integration for your gulp workflows.

guppy streamlines and extends your git-hooks by integrating them with your gulp workflow. This enables you to have gulp tasks that run when triggered by a git-hook, which means you can do cool things like abort a commit if your tests are failing. Git-hooks can now be managed through npm, allowing them to automatically be installed and updated. And because they integrate with gulp, it's easy to modify the workflow and even combine hooks with your other gulp tasks.

guppy leverages these powerful existing systems as its backbone, allowing guppy (and therefore your git-hooks) to remain as simple and lightweight as possible through interfaces you're already familiar with.

A git-hook that lint-checks your code and makes sure your unit tests pass before committing could be as simple as

gulp.task('pre-commit', ['lint', 'unit']);

Install

npm i git-guppy --save-dev

Usage

Git integration

Automatic!

The actual scripts that git will run to trigger guppy's hooks will be automatically installed to your .git/hooks/ directory. These are just a wrapper for invoking the gulp tasks that guppy registers.

Typically, a workflow can be added to your gulp tasks via a guppy-hook. A guppy-hook is like a git-hook preconfigured for specific gulp workflows.

You can install guppy-hooks via npm just like any other package. For every valid git-hook name, there exists a "guppy-[hookname]" package that automatically installs the related hook to your .git/hooks dir, e.g. "guppy-pre-commit" or "guppy-post-update". Just add the guppy-hook you need as a dev-dependency in your project.

Search "guppy-hook" on npm to find all guppy-hook packages. Or run npm search guppy-hook from the commandline.

gulp integration

⚠️ Stop! If you are using a guppy-hook package, refer to the documentation for that package. You do not need the steps below unless you are adding custom guppy integration to your gulpfile or authoring your own guppy-hook package.

guppy exposes a few simple methods to help you superpower your git-hooks with gulp tasks.

Before you dive in, initialize guppy by passing in your gulp reference:

var gulp = require('gulp');
var guppy = require('git-guppy')(gulp);

Then simply define some gulp tasks in your gulpfile.js whose names match whichever git-hooks you want to be triggerable by git.

gulp.task('pre-commit', function () {
  // see below
});

Note: if you are working directly with guppy rather than installing a guppy-hook you will need to manually install the associated git-hooks using the guppy-cli commandline tool.

guppy.src(hookName)

Supported hooks: applypatch-msg, commit-msg, pre-applypatch, pre-commit, prepare-commit-msg

Pass in the name of the desired git-hook and get back the related filenames. This allows you to work with the source file directly, for example to modify a commit-msg programmatically or lint changed files.

Note for pre-commit and pre-applypatch this will give you the working-copy, not the indexed (staged) changes. If you want the indexed changes, use guppy.stream() instead.

// contrived example
gulp.task('pre-commit', function () {
  return gulp.src(guppy.src('pre-commit'))
    .pipe(gulpFilter(['*.js']))
    .pipe(jshint())
    .pipe(jshint.reporter(stylish))
    .pipe(jshint.reporter('fail'));
});

guppy.src(hookName[, fn])

Supported hooks: all

If you pass the optional fn argument, it will be passed to gulp.task() as the task callback, but the first argument will be the related filenames (or null, if none) and a second optional argument may also be supplied (when applicable) with any additional arguments received from the git-hook as an array. gulp will provide its callback as the last argument.

// less contrived example
gulp.task('pre-commit', guppy.src('pre-commit', function (filesBeingCommitted) {
  return gulp.src(filesBeingCommitted)
    .pipe(gulpFilter(['*.js']))
    .pipe(jshint())
    .pipe(jshint.reporter(stylish))
    .pipe(jshint.reporter('fail'));
}));

// another contrived example
gulp.task('pre-push', guppy.src('pre-push', function (files, extra, cb) {
  var branch = execSync('git rev-parse --abbrev-ref HEAD');

  if (branch === 'master') {
    cb('Don\'t push master!')
  } else {
    cb();
  }
}));

guppy.stream(hookName[, options])

Supported hooks: applypatch-msg, commit-msg, pre-applypatch, pre-commit, prepare-commit-msg

Pass in the name of the git-hook to produce a stream of the related files. You can pass options as a second argument, please refer to the docs for gulp.src for more information on available options.

Note that depending on the git-hook, you may be acting on files that differ from your working copy, such as those staged for commit (as with 'pre-commit' for example), rather than the working copy. If you need to act on the working-copy files, use guppy.src() instead.

gulp.task('pre-commit', function () {
  return guppy.stream('pre-commit')
    .pipe(gulpFilter(['*.js']))
    .pipe(jshint())
    .pipe(jshint.reporter(stylish))
    .pipe(jshint.reporter('fail'));
});

Additional notes

For many git-hooks there are no files associated, so for those it makes sense to only add other gulp tasks as dependencies to invoke a workflow, however some will still receive some arguments (passed in by guppy.src() when used as a callback) for more advanced use cases.

gulp.task('post-checkout', ['lint']);

Writing guppy-hooks

stay tuned

For details on what arguments each git-hook receives and what result a non-zero exit status would have, check the git-scm docs.

Author

Kevin Lanni

License

MIT © Kevin Lanni




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap