git-test

Simple CLI utility to test git output and return exit 1 if a test fails

Installation

npm install -g git-test-cli

Usage

[master] > git-test -b master && echo on master || echo not on master
on master

[master] > git checkout feature
[feature] > git-test -b master && echo on master || echo not on master
not on master

The intended use is as a scripting helper, e.g. to perform certain actions during automated processes (such as builds) based on the current git branch. For example, using husky, the following will run tests before pushing code to master:

{
   "scripts": {
       "prepush": "git-test -b master && npm test || git-test -x -b master"
   } 
}

The -x option inverts the result of the test, e.g. tests that the branch is not master. The negative test following the || is needed to ensure the logic following the initial test is atomic. That is, every logical test that starts with the assertion "if I'm on this branch" should end with an "or" condition of "if I'm not on this branch".

Right now it's only feature is to test which branch is active. If I need more... I will add it.

Options

--branch [branch-name]

-b [branch-name]

Test that the current git repo is on [branch-name]

--except [branch-name]

-x [branch-name]

Invert the result of every other test

--help

Show help

--status

Just output the status info I obtained from git as JSON (for diagnostics)