Gitwatcher NPM

Git Watcher

Watches you git commit files and warns you if somebody modified, removed or added a file that was blacklisted.

It was done to be initially used together with travis-ci, but can be used with other CI tools as well, as long it complies to the following requirements:

has nodejs environment
allow to install npm packages
access to build current commit or commit range ids

Using

Configuration

Add a config file to your project, the default path is .gitwatcher.json but can be changed in runtime using the --option, then add your list of files to be watched there.

There is a sample file in the repo that can be used as a template for that.

Travis-CI Instalation and Usage

There are several ways of installing and using in your project. There are some examples bellow and a demo project here to check the usage.

using npm global instalation:

Add the following code to the before_install section of yout .travis.yml file

- npm install -g gitwatcher
- git-watcher-files --commit $TRAVIS_COMMIT_RANGE

using source directly and npm link

Add the following lines to the before_install section of your .travis.yml

- git clone https://github.com/felipesabino/gitwatcher
- cd gitwatcher
- npm install
- npm link
- cd ..
- git-watcher-files --commit $TRAVIS_COMMIT_RANGE

using as devDependency in your `package.json` (only for node.js apps)

Add gitwatcher dependency to your package.json devDependencies section

...
  "devDependencies": {
    "gitwatcher": "*"
  }
...

And then the following code to the before_script section of yout .travis.yml file

- ./node_modules/.bin/git-watcher-files --commit $TRAVIS_COMMIT_RANGE

Important: Notice that the instalation using devDependency needs the script to be added to before_script as it will depend on an npm install which travis does automatically at the install step. Check the build lifecycle documentation for more information.