You Shall Not Commit

Wizards are great they destroy magic rings, slay dragons kick tyrant kings from thrones and crown rightful heirs a kingdom. When they aren't off on a quest you can employ a wizard to guard your code from the forces of chao better known as carless developers.

YouShallNotCommit is a pre-commit hook for git that works wih npm scripts, you define scripts as normal in your package.json. Then add a pre-commit array to the package.json the wizard will run these scripts when you attempt to commit code to your git repo helping keep the orcs from the realm of broken code from breaching the gates of your repo.

Recommended spells

Some spells/scripts that I like to give my wizard

• JSHint
• David
• Missing
• Any unit tests, I like tape.

Please feel free to suggest more.

Installation

Recommed installing this as a dev dependency.

npm install YouShallNotCommit --save-dev

Running this will place a pre-commit script in your .git/hooks folder if one doesn't already exist. It uses the magic of the install attribute in package.json.

Define a set of scripts

scripts: {
  "findHobbit": "echo found hobbit && exit 0",
  "goOnQuest": "echo 'Off to the mountains' && exit 0",
  "killDragin": "echo 'Dragon dead' && exit 0",
  "smokeSwapWeed": "echo 'smoking is bad'; exit 1"
}

The exit 1 is important, any script that exits with a code other than 0 will result in the commit being aborted.

Tell the wizard which scripts he should use. Nothing is run by default you have complete control over what the wizard will do. Killing dragons each timme you check in code may take time and result in grumpy developers so we can just leave that script out.

pre-commit[
  "findHobbit",
  "goOnQuest",
  "smokeSwapWeed"
]

How does this differ from similar modules

Apart from the talk of wizards, spells and orcs? Other pre-commit hooks that I've seen assume that the .git lives in the same folder as package.json while this is probably fine for most projects I have worked on projects which have had a number of sub folders each with their own package.json. Here the wizard was able to begin the quest for the .git folder and keep moving up the directory tree until it was found.

The wizard will then look at the files being committed find the appropriate package.json for each and run the scripts you have befined for each.

License

MIT