Repository files navigation

These scripts are helpers for managing developer workflow when using git repos hosted on GitHub. Install as a rubygem and they can be run as standard git commands likegit about.

gem install pivotal_git_scripts

cd /usr/local/bin && curl -L http://github.com/pivotal/git_scripts/tarball/master | gunzip | tar xvf - --strip=2

git about shows settings set bygit pair andgit project

Configures git authors when pair programming.

git pair sp jsuser.name=Josh Susser & Sam Piersonuser.email=pair+jsusser+sam@pivotallabs.com

Create a.pairs config file in project root or your home folder.

# .pairs - configuration for 'git pair'pairs:  # <initials>: <Firstname> <Lastname>[; <email-id>]  eh: Edward Hieatt  js: Josh Susser; jsusser  sf: Serguei Filimonov; sergueiemail:  prefix: pair  domain: pivotallabs.com  no_solo_prefix: trueglobal: false  # Set to true for git-pair to change git configuration for all your projects

By default this affects the current project (.git/config).Use the--global option or addglobal: true to your.pairs file to set the global git configuration for all projects (~/.gitconfig).

Options are:

-g, --global                     Modify global git options instead of local-v, --version                    Show Version-h, --help                       Show this.

When you're done pairing, change git's configuration to use your personal details.

git pair <your-initials>

Makes a git commit as normal, but chooses one of the pair members randomly to get credit for the commit on github (by setting the author email to that member's email address). The author name on the commit will list all members of the pair, as usual.

If pair members have email addresses on different domains, you can specify them separately in your.pairs file.

pairs:  jd: Jane Doe  fb: Frances Baremail_addresses:  jd: jane@awesome.local  fb: frances@foo.bar

RubyMine already supports pointing at a custom location for your git executable in the Preferences -> Version Control -> GitThe trick then is thatpair-commit doesn't encompass all git functionality, so you can't just point RubyMine directly at it, you need something in the middle that will usepair-commit if the first arg iscommit, otherwise just pass through. Here's a ruby script to do just that:

#!/usr/bin/env rubyexit_code=ifARGV[1] =="commit"system"git pair-commit#{ARGV[1..-1].join(" ")}"elsesystem"git#{ARGV.join(" ")}"endexitexit_code

Make sure it's executable.

$ git project pivots

This script sets the user account you will use to access repos hosted on github.com. It creates a symlink fromid_github_current toid_github_pivotal<project>, which switches the SSH key you are currently using to access GitHub repos. Make sure you have the following lines in your .ssh/config file:

Host github.com  User git  IdentityFile /Users/pivotal/.ssh/id_github_current

Copyright (c) 2010Pivotal Labs. This software is licensed under the MIT License.

• git-pair original authorBryan Helmkamp
• lots of pivots :)
• James Sanders
• Todd Persen