gitdown is a script which moderates your git committing activity based on your blood alcohol content (BAC). It uses the DrinkShield for Arduino as a breathalyzer, and a Ruby script as the git hook.
It was built for hackNY's spring 2013 hackathon by Alex Qin (@alexqin) and Geoffrey Litt (@geoffreylitt), and won first place there.
You can watch a demo video of gitdown in action at this Youtube link.
gitdown has three modes of operation:
In Krunk mode and Baller mode, gitdown will mangle your commit messages to make them appear more intoxicated, and will also post your name, current BAC, and the commit message to the official gitdown Tumblr, with a silly related photo attached.
When the "verbose" configuration parameter is turned on as described below, gitdown also gives you helpful facts about your current level of impairment, based on your BAC.
First, clone the repo and install necessary gems:
git clone https://github.com/noidontdig/gitdown.git
cd gitdown
bundle install
To use the script as a hook for the gitdown repo itself, copy it to the proper location:
cp commit-msg .git/hooks/
Using this project requires an Arduino Uno with the DrinkShield attachment. Open the arduino_gitdown/arduino_gitdown.ino
file with the Arduino IDE and load it onto the Arduino.
Then, open the .gitdown
config file and edit the three configuration parameters:
/dev/tty.usbmodem1421
, which happened to work on the Macbook Air used for development.Then, you can try editing a file in the gitdown repo and committing the change, to see the script in action.
echo "random change" >> commit-msg
git commit -a -m "messing up the repo"
Depending on the active mode and your BAC, the script will either permit you to or prevent you from committing!
If you want to actually use gitdown in another repository, copy the commit-msg
script to that repo's .git/hooks
directory, and make sure to copy the .gitdown
config file to that repository as well.