bitbucket-build-status-hook

Bitbucket Build Status Hook

This is a Git hook for retrieving build Statuses for commits in Git repositories hosted on Bitbucket.

Usage

You can run bitbucket-build-status to check the build statuses of your repository's HEAD commit at any time, but this tool is most useful when symlinked as a post-commit hook:

$ cd some_git_repo

$ ln -s /usr/local/bin/bitbucket-build-status .git/hooks/post-checkout

$ git checkout master

Switched to branch 'master'
Sweet action! 234ffc1 has 5 green builds

$ git checkout my_feature

Switched to branch 'my_feature'
Oh no! f2ec0c2 has 3 failed builds (Test on Saucelabs, Test with Firefox, AUI-JIRA visual regression)
Details at https://bitbucket.org/atlassian/aui/commits/f2ec0c22635271c39c43143f49cb07588b12bf68

Installation

• Install Node.js and npm
• Run npm install -g bitbucket-build-status
• Run ln -s /usr/local/bin/bitbucket-build-status .git/hooks/post-checkout from the root of a Git repository hosted on Bitbucket
• Run git checkout HEAD to test that the hook is properly installed

Credential management

The first time you upload a file you will be prompted for your Bitbucket email and password. These will be used to retrieve an OAuth refresh token which is stored in ~/.bitbucket-build-status and used for subsequent requests. Treat this token carefully as it can be used to read repository data on your behalf.