Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vmware-archive/git_scripts

Developer workflow convenience scripts
https://github.com/vmware-archive/git_scripts

Last synced: 1 day ago
JSON representation

Developer workflow convenience scripts

Awesome Lists containing this project

README

        

[![Build Status](https://travis-ci.org/pivotal/git_scripts.png)](https://travis-ci.org/pivotal/git_scripts)

# Git Scripts

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 like `git about`.

## Gem Installation

gem install pivotal_git_scripts

## System Wide Installation

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

## git-about

`git about` shows settings set by `git pair` and `git project`

## git-pair

Configures git authors when pair programming.

git pair sp js
user.name=Josh Susser & Sam Pierson
[email protected]

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

# .pairs - configuration for 'git pair'
pairs:
# : [; ]
eh: Edward Hieatt
js: Josh Susser; jsusser
sf: Serguei Filimonov; serguei
email:
prefix: pair
domain: pivotallabs.com
no_solo_prefix: true
global: 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 add `global: 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

## git-pair-commit

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 Bar
email_addresses:
jd: [email protected]
fb: [email protected]

### Using git-pair-commit in RubyMine
RubyMine already supports pointing at a custom location for your git executable in the Preferences -> Version Control -> Git
![screen shot 2014-03-11 at 12 49 02 pm](https://f.cloud.github.com/assets/163532/2390097/49c3023e-a956-11e3-8aeb-dcba1a814309.png)
The trick then is that `pair-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 use `pair-commit` if the first arg is `commit`, otherwise just pass through. Here's a ruby script to do just that:
```ruby
#!/usr/bin/env ruby

exit_code = if ARGV[1] == "commit"
system "git pair-commit #{ARGV[1..-1].join(" ")}"
else
system "git #{ARGV.join(" ")}"
end

exit exit_code
```
Make sure it's executable.

## git-project

$ git project pivots

This script sets the user account you will use to access repos hosted on github.com. It creates a symlink from `id_github_current` to `id_github_pivotal`, 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

Authors
====
Copyright (c) 2010 [Pivotal Labs](http://pivotallabs.com). This software is licensed under the MIT License.

### [Contributors](https://github.com/pivotal/git_scripts/contributors)
- git-pair original author [Bryan Helmkamp](http://brynary.com)
- lots of pivots :)
- [James Sanders](https://github.com/jsanders)
- [Todd Persen](https://github.com/toddboom)