grunt-git-ref-changed-files

Detects which files have changed between two git refs.

Getting Started

_If you haven't used grunt before, be sure to check out the Getting Started guide._

From the same directory as your project's Gruntfile and package.json, install this plugin with the following command:

npm install grunt-git-ref-changed-files

Once that's done, add this line to your project's Gruntfile:

grunt.loadNpmTasks('grunt-git-ref-changed-files');

Overview

Inside your Gruntfile.js file add a section named refChangedFiles. This section specifies the options to detect which files have changed between two refs (from/to) and a regular expression to filter them.

How it works

It will query which files have changed since the specified from/to parameter using git by running:

git log {ref}..{ref} --name-only --pretty=format:

Finally it will filter the changed files by applying the regexp option to every item. The result of the filtered files changed will be stored in a grunt config item called refChangedFiles.

Config Example

Example to detect if static files where modified since v.100 tag:

refChangedFiles: {
    dist: {
        options: {
            from: 'v.100', // optional: default is HEAD^
            to: 'HEAD', // optional: default is HEAD
            regexp: /public\/lib\/js/, // optional: default is /.*/
        },
        src: 'repoFolder'
    }
}

Then you can access to the filtered changed files using:

grunt.config.get('refChangedFiles');

License

Copyright (c) 2013 Juan Pablo Garcia Licensed under the MIT license.