edsinclair-git-pair 0.3.0

data/.autotest

@@ -0,0 +1,5 @@
+Autotest.add_hook :initialize do |autotest|
+  [/\.git/, /pkg\//, /\.gemspec$/, /\.log$/].each do |regexp|
+    autotest.add_exception regexp
+  end
+end

data/.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in git-pair.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Chris Kampmeier
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,57 @@
+# git-pair
+
+A git porcelain for changing `user.name` and `user.email` so you can commit as
+more than one author.
+
+## Usage
+
+Install the gem:
+
+    gem install edsinclair-git-pair
+
+And here's how to use it!
+
+    $ git pair
+
+    General Syntax:
+      git pair [reset | authors | options]
+
+    Options:
+        -a, --add AUTHOR                 Add an author. Format: "Author Name <author@example.com>"
+        -r, --remove NAME                Remove an author. Use the full name.
+        -d, --reset                      Reset current author to default (global) config
+        -s, --show 'aa [bb]'             Show the string to be used for the commit author field
+            --install-hook               Install a post-commit hook for the current repo. See git-pair/hooks/post-commit for more information.
+            --email EMAIL                Add a default email address to be used for pairs
+
+    Switching authors:
+      git pair aa [bb]                   Where AA and BB are any abbreviation of an
+                                         author's name. You can specify one or more authors.
+
+    Current config:
+         Author list: Adam McCrea
+                      Jon Distad
+
+      Current author: Jon Distad + Adam McCrea
+       Current email: devs+jd+am@edgecase.com
+
+## How does it work?
+
+The list of authors is maintained in the global git configuration file.
+The current author is set in the git configuration local to the project.
+The email address for a pair will be generated using the first author's email
+domain and the initials separated by a '+' will precede the '@'.
+Alternatively you can specify an email address to be used for pair commits.
+For example: if you specify pair@example.net the pair email address will be pair+aa+bb@example.net
+
+## About this version
+
+This was forked from http://github.com/edgecase/git-pair which in turn was
+forked from http://github.com/chrisk/git-pair.  Many thanks to Chris Kampmeier
+for the original version and Adam McCrea, John Distad and Ehren Murdick for the
+features they added to the edgecase release.  This version adds a --show, --email
+and --install-hook options and converts the gem to use Bundler for dependency management.
+
+## License
+
+Copyright (c) 2009 Chris Kampmeier. See `LICENSE` for details.

data/Rakefile

@@ -0,0 +1,19 @@
+require "rubygems"
+require "bundler"
+Bundler.setup
+require 'bundler/gem_tasks'
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+  task :features
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task :default => :features
+
+# Don't print commands when shelling  out (for example, running Cucumber)
+RakeFileUtils.verbose(false)

data/bin/git-pair

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'git-pair'
+require 'git-pair/command'
+
+GitPair::Command.run!(ARGV)

data/config/cucumber.yml

@@ -0,0 +1,3 @@
+default: --format progress --color features
+autotest: --format pretty
+autotest-all: --profile default

data/edsinclair-git-pair.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "git-pair/version"
+
+Gem::Specification.new do |s|
+  s.name        = "edsinclair-git-pair"
+  s.version     = GitPair::VERSION
+  s.authors     = ["Chris Kampmeier", "Adam McCrea", "Jon Distad", "Eirik Dentz Sinclair", "Tim Gildea"]
+  s.email       = ["eirik@efficiency20.com"]
+  s.homepage    = ""
+  s.date        = %q{2011-08-24}
+  s.summary     = %q{Configure git to commit as more than one author}
+  s.description = %q{A git porcelain for pair programming. Changes git-config's user.name and user.email settings so you can commit as more than one author.}
+
+  s.rubyforge_project = "git-pair"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.add_development_dependency "cucumber"
+  s.add_development_dependency "ruby-debug"
+end

data/features/adding_an_author.feature

@@ -0,0 +1,27 @@
+Feature: Adding an author
+  In order to commit as a pair
+  A user should be able to
+  add a name and email to the list of authors
+
+  Scenario: adding a name and email
+    When I add the author "Linus Torvalds <linus@example.org>"
+    Then `git pair` should display "Linus Torvalds" in its author list
+
+  Scenario: adding the same name and email twice
+    When I add the author "Linus Torvalds <linus@example.org>"
+    And I add the author "Linus Torvalds <linus@example.org>"
+    Then `git pair` should display "Linus Torvalds" in its author list only once
+    And the gitconfig should include "Linus Torvalds" in its author list only once
+
+  Scenario: adding the same name twice with different emails
+    When I add the author "Linus Torvalds <linus@example.org>"
+    And I add the author "Linus Torvalds <linus@example.com>"
+    Then `git pair` should display "Linus Torvalds" in its author list only once
+    And the gitconfig should include "Linus Torvalds" in its author list only once
+    And the gitconfig should include "linus@example.org" as the email of "Linus Torvalds"
+
+  Scenario: adding a malformed author string
+    When I add the author " "
+    And  I add the author "Bob Dole"
+    And  I add the author "Jimmy <asdf"
+    Then the config file should have no authors

data/features/authors.feature

@@ -0,0 +1,33 @@
+Feature: seeing authors on console
+  In order to see the current author
+  A user should be able to
+  get the author string for a set of initials
+
+  Scenario: No authors have been added
+    When I specify the initials "AA BB"
+    Then the last command's output should include "Please add some authors first"
+
+  Scenario: A single author
+    Given I have added the author "Linus Torvalds <linus@example.net>"
+    When I specify the initials "LT"
+    Then the last command's output should include "Linus Torvalds <linus@example.net>"
+
+  Scenario: Two authors
+    Given I have added the author "Linus Torvalds <linus@example.net>"
+    And I have added the author "Junio C Hamano <junio@example.org>"
+    And my global Git configuration is setup with email "devs@example.com"
+    When I specify the initials "LT JCH"
+    Then the last command's output should include "Linus Torvalds & Junio C Hamano <lt+jch@example.net>"
+
+  Scenario: A single author and the pair email has been set
+    Given I have set the pair email to "devs@widgets.com"
+    And I have added the author "Linus Torvalds <linus@example.net>"
+    When I specify the initials "LT"
+    Then the last command's output should include "Linus Torvalds <linus@example.net>"
+
+  Scenario: Pairing with two authors and the pair email has been set
+    Given I have set the pair email to "devs@widgets.com"
+    And I have added the author "Linus Torvalds <linus@example.net>"
+    And I have added the author "Junio C Hamano <junio@example.org>"
+    When I specify the initials "LT JCH"
+    Then the last command's output should include "Linus Torvalds & Junio C Hamano <devs+lt+jch@widgets.com>"

data/features/removing_an_author.feature

@@ -0,0 +1,19 @@
+Feature: Adding an author
+  In order remove old pairing partners
+  A user should be able to
+  remove a name from the list of authors
+
+  Scenario: removing a name
+    When I add the author "Linus Torvalds <linus@example.org>"
+    And I add the author "Junio C Hamano <junio@example.org>"
+    And I remove the name "Junio C Hamano"
+    Then `git pair` should display the following author list:
+      | name           |
+      | Linus Torvalds |
+
+  Scenario: removing all names
+    When I add the author "Linus Torvalds <linus@example.org>"
+    And I add the author "Junio C Hamano <junio@example.org>"
+    And I remove the name "Linus Torvalds"
+    And I remove the name "Junio C Hamano"
+    Then `git pair` should display an empty author list

data/features/resetting_the_pair.feature

@@ -0,0 +1,11 @@
+Feature: Resetting the pair
+  In order reset to the global author
+  A user should be able to
+  reset to the Global User
+
+  Scenario: resetting the current authors
+    Given I have added the author "Linus Torvalds <linus@example.org>"
+    And my global Git configuration is setup with user "Global User"
+    And I switch to the pair "LT"
+    When I reset the current authors
+    Then `git pair` should display "Global User" for the current author

data/features/setting_email_options.feature

@@ -0,0 +1,8 @@
+Feature: Setting a pair email
+  In order to commit as a pair
+  A user should be able to
+  set a pair email address
+
+  Scenario: setting a pair email
+    When I set the pair email to "pair@widgets.com"
+    Then `git pair` should display "pair@widgets.com" as its pair email

data/features/step_definitions/config_steps.rb

@@ -0,0 +1,120 @@
+Given /^I have added the author "([^\"]*)"$/ do |name_and_email|
+  When %(I add the author "#{name_and_email}")
+end
+
+Given /^my global Git configuration is setup with user "([^\"]*)"$/ do |name|
+  git_config "--global user.name \"#{name}\""
+end
+
+Given /^my global Git configuration is setup with email "([^\"]*)"$/ do |email|
+  git_config "--global user.email \"#{email}\""
+end
+
+When /^I (?:have )?set the pair email to "([^"]*)"$/ do |email|
+  git_pair %(--email "#{email}")
+end
+
+Then /^`git pair` should display "([^"]*)" as its pair email$/ do |email|
+  output = git_pair
+  assert_equal email, current_pair_email_from_output(output)
+end
+
+When /^I add the author "([^\"]*)"$/ do |name_and_email|
+  git_pair %(--add "#{name_and_email}")
+end
+
+When /^I remove the name "([^\"]*)"$/ do |name|
+  git_pair %(--remove "#{name}")
+end
+
+When /^I specify the initials "([^"]*)"$/ do |abbreviations|
+  @output = git_pair %(--show "#{abbreviations}")
+end
+
+When /^I (?:try to )?switch to the pair "([^\"]*)"$/ do |abbreviations|
+  @output = git_pair abbreviations
+end
+
+When /^I reset the current authors$/ do
+  git_pair '--reset'
+end
+
+Then /^`git pair` should display "([^\"]*)" in its author list$/ do |name|
+  output = git_pair
+  authors = authors_list_from_output(output)
+  assert authors.include?(name)
+end
+
+Then /^`git pair` should display "([^\"]*)" in its author list only once$/ do |name|
+  output = git_pair
+  authors = authors_list_from_output(output)
+  assert_equal 1, authors.select { |author| author == name}.size
+end
+
+Then /^`git pair` should display no authors$/ do
+  output = git_pair
+  authors = authors_list_from_output(output)
+  authors.size.should be_zero
+end
+
+
+Then /^`git pair` should display "([^\"]*)" for the current author$/ do |names|
+  output = git_pair
+  assert_equal names, current_author_from_output(output)
+end
+
+Then /^`git pair` should display "([^\"]*)" for the current email$/ do |email|
+  output = git_pair
+  assert_equal email, current_email_from_output(output)
+end
+
+Then /^the gitconfig should include "([^\"]*)" in its author list only once$/ do |name|
+  output = git_config
+  authors = output.split("\n").map { |line| line =~ /^git-pair\.authors=(.*) <[^>]+>$/; $1 }.compact
+  assert_equal 1, authors.select { |author| author == name}.size
+end
+
+Then /^the gitconfig should include "([^\"]*)" as the email of "([^\"]*)"$/ do |email, name|
+  output = git_config
+  authors = output.split("\n").map { |line| line =~ /^git-pair\.authors=.* <([^>]+)>$/; $1 }.compact
+  assert_equal 1, authors.select { |author| author == email}.size
+end
+
+Then /^`git pair` should display the following author list:$/ do |table|
+  output = git_pair
+  names = authors_list_from_output(output).map { |name| {"name" => name} }
+  table.diff! names
+end
+
+Then /^`git pair` should display an empty author list$/ do
+  output = git_pair
+  assert authors_list_from_output(output).empty?
+end
+
+Then /^the last command's output should include "([^\"]*)"$/ do |output|
+  assert @output.include?(output)
+end
+
+Then /^the config file should have no authors$/ do
+  assert git_config(%(--global --get-all git-pair.authors)).empty?
+end
+
+def current_pair_email_from_output(output)
+  output =~ /Pair email: (.*?)\n/im
+  $1.strip
+end
+
+def authors_list_from_output(output)
+  output =~ /Author list: (.*?)\n\s?\n/im
+  $1.strip.split("\n").map { |name| name.strip }
+end
+
+def current_author_from_output(output)
+  output =~ /Current author: (.*?)\n/im
+  $1.strip
+end
+
+def current_email_from_output(output)
+  output =~ /Current email: (.*?)\n/im
+  $1.strip
+end

data/features/support/env.rb

@@ -0,0 +1,50 @@
+require 'tmpdir'
+require 'test/unit/assertions'
+World(Test::Unit::Assertions)
+
+
+module RepositoryHelper
+  # TODO: use 1.8.7's Dir.mktmpdir?
+  TEST_REPO_PATH         = File.join(Dir::tmpdir, "git-pair-test-repo")
+  TEST_REPO_DOT_GIT_PATH = "#{TEST_REPO_PATH}/.git"
+
+  PROJECT_PATH       = File.join(File.dirname(__FILE__), "../..")
+  GIT_PAIR           = "#{PROJECT_PATH}/bin/git-pair"
+  CONFIG_BACKUP_PATH = "#{PROJECT_PATH}/tmp"
+
+  def git_pair(options = "")
+    output = `HOME=#{TEST_REPO_PATH} GIT_DIR=#{TEST_REPO_DOT_GIT_PATH} #{GIT_PAIR} #{options} 2>&1`
+    output.gsub(/\e\[\d\d?m/, '')  # strip any ANSI colors
+  end
+
+  def git_config(options = nil)
+    options ||= "--list"
+    `HOME=#{TEST_REPO_PATH} GIT_DIR=#{TEST_REPO_DOT_GIT_PATH} git config #{options} 2>&1`
+  end
+
+  def backup_gitconfigs
+    FileUtils.mkdir_p CONFIG_BACKUP_PATH
+    FileUtils.cp File.expand_path("~/.gitconfig"), "#{CONFIG_BACKUP_PATH}/.gitconfig.backup"
+    FileUtils.cp "#{PROJECT_PATH}/.git/config", "#{CONFIG_BACKUP_PATH}/config.backup"
+  end
+
+  def restore_gitconfigs
+    FileUtils.cp "#{CONFIG_BACKUP_PATH}/config.backup",     "#{PROJECT_PATH}/.git/config"
+    FileUtils.cp "#{CONFIG_BACKUP_PATH}/.gitconfig.backup", File.expand_path("~/.gitconfig")
+    FileUtils.rm_rf CONFIG_BACKUP_PATH
+  end
+end
+
+World(RepositoryHelper)
+
+
+Before do
+  backup_gitconfigs
+  FileUtils.mkdir_p RepositoryHelper::TEST_REPO_DOT_GIT_PATH
+  `GIT_DIR=#{RepositoryHelper::TEST_REPO_DOT_GIT_PATH} && git init`
+end
+
+After do
+  FileUtils.rm_rf RepositoryHelper::TEST_REPO_PATH
+  restore_gitconfigs
+end

data/features/switching_authors.feature

@@ -0,0 +1,45 @@
+Feature: Switching authors
+  In order to indicate which authors are committing
+  A user should be able to
+  change the currently active pair
+
+  Scenario: No authors have been added
+    When I try to switch to the pair "AA BB"
+    Then the last command's output should include "Please add some authors first"
+
+  Scenario: Pairing with a single author
+    Given I have added the author "Linus Torvalds <linus@example.net>"
+    When I switch to the pair "LT"
+    Then `git pair` should display "Linus Torvalds" for the current author
+    And `git pair` should display "linus@example.net" for the current email
+
+  Scenario: Pairing with two authors
+    Given I have added the author "Linus Torvalds <linus@example.net>"
+    And I have added the author "Junio C Hamano <junio@example.org>"
+    And my global Git configuration is setup with email "devs@example.com"
+    When I switch to the pair "LT JCH"
+    Then `git pair` should display "Linus Torvalds & Junio C Hamano" for the current author
+    And `git pair` should display "lt+jch@example.net" for the current email
+
+  Scenario: Pairing with two authors the pair email domain is set to the first author
+    Given I have added the author "Linus Torvalds <linus@example.net>"
+    And I have added the author "Junio C Hamano <junio@example.org>"
+    And my global Git configuration is setup with email "devs@example.com"
+    When I switch to the pair "JCH LT"
+    Then `git pair` should display "Junio C Hamano & Linus Torvalds" for the current author
+    And `git pair` should display "jch+lt@example.org" for the current email
+
+  Scenario: Pairing with a single author and the pair email has been set
+    Given I have set the pair email to "devs@widgets.com"
+    And I have added the author "Linus Torvalds <linus@example.net>"
+    When I switch to the pair "LT"
+    Then `git pair` should display "Linus Torvalds" for the current author
+    And `git pair` should display "linus@example.net" for the current email
+
+  Scenario: Pairing with two authors and the pair email has been set
+    Given I have set the pair email to "devs@widgets.com"
+    And I have added the author "Linus Torvalds <linus@example.net>"
+    And I have added the author "Junio C Hamano <junio@example.org>"
+    When I switch to the pair "LT JCH"
+    Then `git pair` should display "Linus Torvalds & Junio C Hamano" for the current author
+    And `git pair` should display "devs+lt+jch@widgets.com" for the current email

data/hooks/post-commit

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+#
+# This post-commit hook looks for one or more initials inside parentheses at the end of
+# the commit message and uses them to amend the commit author field using the git pair authors
+# matching those initials.
+#
+# To enable this hook, add a symlink to project/.git/hooks/post-commit that points to this file
+
+revision, author, body = %x[git log HEAD -1 --format="%H<separator>%an <%ae><separator>%B"].split("<separator>")
+
+pair_regex     = Regexp.new(/^([^(]*)\(([^)]*)\)$/)
+initials_regex = Regexp.new(/\/|\s|,/)
+
+if body.match(pair_regex)
+  message  = $1.strip # raw commit message without initials
+  initials = $2.split(initials_regex)
+
+  git_pair_author  = %x[git pair -s "#{initials.join(' ')}"].chomp
+  git_amend_author = %Q(git commit --amend --author="#{git_pair_author}" --message="#{message}")
+
+  if git_pair_author.empty?
+    puts "One or more of the initials: (#{initials.join(',')}) didn't match any of the git pair authors."
+    puts "You can use the following command to manually amend the HEAD commit:\n\n"
+    puts %Q(  git commit --amend --author="First Last & First Last <pair+fl+fl@example.com>"\n\n)
+  elsif git_pair_author != author
+    puts "Amending revision: #{revision} author from: #{author}"
+    puts "To: #{git_pair_author}"
+    system(git_amend_author)
+    new_sha = %x[git rev-parse HEAD].chomp
+    puts "Succeeded! New SHA is: #{new_sha}"
+  end
+end

data/lib/git-pair.rb

@@ -0,0 +1,11 @@
+require "git-pair/version"
+
+module GitPair
+  autoload :Command, 'git-pair/command'
+  autoload :Author,  'git-pair/author'
+  autoload :Config,  'git-pair/config'
+  autoload :Display, 'git-pair/display'
+
+  class NoMatchingAuthorsError < ArgumentError; end
+  class MissingConfigurationError < RuntimeError; end
+end

data/lib/git-pair/author.rb

@@ -0,0 +1,77 @@
+module GitPair
+  class Author
+
+    ValidAuthorStringRegex = /^\s*([^<]+)<([^>]+)>\s*$/
+
+    class InvalidAuthorString < TypeError; end
+
+    def self.all
+      Config.all_author_strings.map { |string| new(string) }
+    end
+
+    def self.find_all(abbrs)
+      raise MissingConfigurationError, "Please add some authors first" if all.empty?
+      abbrs.map { |abbr| self.find(abbr) }
+    end
+
+    def self.find(abbr)
+      all.find { |author| author.match?(abbr) } ||
+        raise(NoMatchingAuthorsError, "no authors matched #{abbr}")
+    end
+
+    def self.email(authors)
+      if authors.length == 1
+        authors.first.email
+      else
+        author_names = authors.map { |a| a.initials }
+        if self.authors_prefix
+          author_names.unshift(authors_prefix)
+        end
+        initials_string = author_names.join('+')
+        "#{initials_string}@#{authors_email(authors)}"
+      end
+    end
+
+    def self.authors_prefix
+      return Config.pair_email.split("@").first unless Config.pair_email.empty?
+    end
+
+    def self.authors_email(authors)
+      return Config.pair_email.split("@").last unless Config.pair_email.empty?
+      return authors.first.email.split("@").last
+    end
+
+    def self.exists?(author)
+      self.all.find { |a| a.name == author.name }
+    end
+
+    def self.valid_string?(author_string)
+      author_string =~ ValidAuthorStringRegex
+    end
+
+    attr_reader :name, :email
+
+    def initialize(string)
+      unless Author.valid_string?(string)
+        raise(InvalidAuthorString, "\"#{string}\" is not a valid name and email")
+      end
+
+      string =~ ValidAuthorStringRegex
+      @name = $1.to_s.strip
+      @email = $2.to_s.strip
+    end
+
+    def <=>(other)
+      name.split.last <=> other.name.split.last
+    end
+
+    def initials
+      name.split.map { |word| word[0].chr }.join.downcase
+    end
+
+    def match?(abbr)
+      abbr.downcase == initials
+    end
+
+  end
+end

data/lib/git-pair/command.rb

@@ -0,0 +1,152 @@
+require 'optparse'
+require 'ostruct'
+require 'pathname'
+
+module GitPair
+  module Command
+    extend self
+
+    C_BOLD, C_REVERSE, C_RED, C_RESET = "\e[1m", "\e[7m", "\e[91m", "\e[0m"
+
+    def run!(args)
+      options = OpenStruct.new(:update  => true,
+                               :authors => [])
+
+      parser = OptionParser.new do |opts|
+        opts.banner = highlight('General Syntax:')
+        opts.separator '  git pair [reset | authors | options]'
+
+        opts.separator ' '
+        opts.separator highlight('Options:')
+
+        opts.on '-a', '--add AUTHOR',    'Add an author. Format: "Author Name <author@example.com>"' do |author|
+          options.add_author = Author.new(author)
+          Config.add_author(options.add_author)
+        end
+
+        opts.on '-r', '--remove NAME', 'Remove an author. Use the full name.' do |name|
+          options.remove_author = name
+          Config.remove_author options.remove_author
+        end
+
+        opts.on '-d', '--reset', 'Reset current author to default (global) config' do
+          options.reset = true
+          Config.reset
+        end
+
+        opts.on '--install-hook', 'Install a post-commit hook for the current repo. See git-pair/hooks/post-commit for more information.' do
+          options.symlink = true
+        end
+
+        opts.on '--email EMAIL', 'Add a default email address to be used for pairs' do |email|
+          puts "Setting email to #{email}"
+          options.pair_email = email
+          Config.set_pair_email(options.pair_email)
+        end
+
+        opts.on '-s', "--show 'aa [bb]'", 'Show the string to be used for the commit author field' do |initials|
+          options.update = false
+          options.authors = Author.find_all(initials.split(' '))
+        end
+
+        opts.separator ' '
+        opts.separator highlight('Switching authors:')
+        opts.separator '  git pair aa [bb]                   Where AA and BB are any abbreviation of an'
+        opts.separator ' '*37 + 'author\'s name. You can specify one or more authors.'
+
+        opts.separator ' '
+        opts.separator highlight('Current config:')
+        opts.separator author_list.split("\n")
+        opts.separator ' '
+        opts.separator pair_email.split("\n")
+        opts.separator ' '
+        opts.separator current_author_info.split("\n")
+      end
+
+      initials = parser.parse!(args.dup)
+
+      initials = initials.map { |e| e.split(' ') }.flatten # in case initials are enclosed in quotes
+
+      if options.authors.empty? && !initials.empty?
+        options.authors = Author.find_all(initials)
+      end
+
+      if args.empty?
+        puts parser.help
+      elsif options.authors && !options.update
+        puts Display.git_author options.authors
+      elsif options.symlink
+        symlink_post_commit_hook
+      elsif options.authors.empty?
+        puts author_list
+        puts
+        puts current_author_info
+      else
+        Config.switch(options.authors)
+        puts current_author_info
+      end
+
+    rescue OptionParser::MissingArgument
+      abort "missing required argument", parser.help
+    rescue OptionParser::InvalidOption, OptionParser::InvalidArgument => e
+      abort e.message.sub(':', ''), parser.help
+    rescue NoMatchingAuthorsError => e
+      abort e.message, "\n" + author_list
+    rescue MissingConfigurationError => e
+      abort e.message, parser.help
+    rescue Author::InvalidAuthorString => e
+      abort e.message, parser.help
+    end
+
+    def author_list
+      "     #{bold 'Author list:'} #{Author.all.sort.map { |a| a.name }.join "\n                  "}"
+    end
+
+    def pair_email
+      "      #{bold 'Pair email:'} #{Config.pair_email} \n"
+    end
+
+    def current_author_info
+      "  #{bold 'Current author:'} #{Config.current_author}\n" +
+      "   #{bold 'Current email:'} #{Config.current_email}\n "
+    end
+
+    def abort(error_message, extra = "")
+      super red(" Error: #{error_message}\n") + extra
+    end
+
+    def highlight(string)
+      "#{C_REVERSE}#{string}#{C_RESET}"
+    end
+
+    def bold(string)
+      "#{C_BOLD}#{string}#{C_RESET}"
+    end
+
+    def red(string)
+      "#{C_RED}#{C_REVERSE}#{string}#{C_RESET}"
+    end
+
+    def symlink_post_commit_hook
+      this_directory    = Pathname.new File.expand_path(File.dirname(__FILE__))
+      post_commit_hook  = Pathname.new(File.join(this_directory, "..", "..", "hooks", "post-commit")).realpath
+      project_git_hooks = File.join(Dir.pwd, ".git", "hooks")
+
+      if File.exists?(post_commit_hook) && File.exists?(project_git_hooks)
+        symlink_target = Pathname.new(File.join(project_git_hooks, "post-commit"))
+
+        puts "Symlinking: #{symlink_target}\nto #{post_commit_hook}.\n\n"
+
+        if File.exists?(symlink_target)
+          puts "Can't create symlink! #{symlink_target} already exists."
+        else
+          symlink_target.make_symlink(post_commit_hook)
+          puts "Succceded!"
+        end
+      elsif !File.exists?(project_git_hooks)
+        puts "The current directory doesn't appear to be a valid git repository."
+      end
+    end
+  end
+end
+

data/lib/git-pair/config.rb

@@ -0,0 +1,53 @@
+module GitPair
+  module Config
+    extend self
+
+    def all_author_strings
+      `git config --global --get-all git-pair.authors`.split("\n")
+    end
+
+    def all_author_strings
+      `git config --global --get-all git-pair.authors`.split("\n")
+    end
+
+    def add_author(author)
+      unless Author.exists?(author)
+        `git config --global --add git-pair.authors "#{author.name} <#{author.email}>"`
+      end
+    end
+
+    def remove_author(name)
+      `git config --global --unset-all git-pair.authors "^#{name} <"`
+      `git config --global --remove-section git-pair` if all_author_strings.empty?
+    end
+
+    def switch(authors)
+      `git config user.name "#{authors.map { |a| a.name }.join(' & ')}"`
+      `git config user.email "#{Author.email(authors)}"`
+    end
+
+    def reset
+      `git config --remove-section user`
+    end
+
+    def default_email
+      `git config --global --get user.email`.strip
+    end
+
+    def current_author
+      `git config --get user.name`.strip
+    end
+
+    def current_email
+      `git config --get user.email`.strip
+    end
+
+    def pair_email
+      `git config --global --get git-pair.email`.strip
+    end
+
+    def set_pair_email(email)
+      `git config --global git-pair.email "#{email}"`
+    end
+  end
+end

data/lib/git-pair/display.rb

@@ -0,0 +1,9 @@
+module GitPair
+  module Display
+    extend self
+
+    def git_author(authors)
+      "#{authors.map { |a| a.name }.join(' & ')} <#{Author.email(authors)}>"
+    end
+  end
+end

data/lib/git-pair/version.rb

@@ -0,0 +1,3 @@
+module GitPair
+  VERSION = "0.3.0"
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification 
+name: edsinclair-git-pair
+version: !ruby/object:Gem::Version 
+  hash: 19
+  prerelease: 
+  segments: 
+  - 0
+  - 3
+  - 0
+  version: 0.3.0
+platform: ruby
+authors: 
+- Chris Kampmeier
+- Adam McCrea
+- Jon Distad
+- Eirik Dentz Sinclair
+- Tim Gildea
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-24 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+  name: cucumber
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+  name: ruby-debug
+description: A git porcelain for pair programming. Changes git-config's user.name and user.email settings so you can commit as more than one author.
+email: 
+- eirik@efficiency20.com
+executables: 
+- git-pair
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .autotest
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/git-pair
+- config/cucumber.yml
+- edsinclair-git-pair.gemspec
+- features/adding_an_author.feature
+- features/authors.feature
+- features/removing_an_author.feature
+- features/resetting_the_pair.feature
+- features/setting_email_options.feature
+- features/step_definitions/config_steps.rb
+- features/support/env.rb
+- features/switching_authors.feature
+- hooks/post-commit
+- lib/git-pair.rb
+- lib/git-pair/author.rb
+- lib/git-pair/command.rb
+- lib/git-pair/config.rb
+- lib/git-pair/display.rb
+- lib/git-pair/version.rb
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: git-pair
+rubygems_version: 1.8.8
+signing_key: 
+specification_version: 3
+summary: Configure git to commit as more than one author
+test_files: 
+- features/adding_an_author.feature
+- features/authors.feature
+- features/removing_an_author.feature
+- features/resetting_the_pair.feature
+- features/setting_email_options.feature
+- features/step_definitions/config_steps.rb
+- features/support/env.rb
+- features/switching_authors.feature