pair-up 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2c85ff4124c27a9d99a65ba8d69c7bf7ae3b9b4a
+  data.tar.gz: 8ea00b9f79aa675a2f1d0b001de8dda9b3289ff5
+SHA512:
+  metadata.gz: 8e2501b0b20763e21a031df15d85c681710698c0646ad1ba29c55dffb77a022f95bf3c93dcf2e98d5309a23d716b3230d64a9665204c7f05262e98849a88b1e3
+  data.tar.gz: 3be127eb8ec810b9b1916dc8cdf0fd686d1895c012b0b1e09431cfaf9e4dc94c0fb9742ce6ac023b8d2b1d874fef4291f4eeef7fa607cfd07c7cf41557bb34e8

data/Gemfile

@@ -0,0 +1,6 @@
+source 'http://rubygems.org'
+
+gem 'highline', '~>1.6.2'
+gem 'rake'
+gem 'rspec', '~> 3.2.0'
+gem 'pry'

data/Gemfile.lock

@@ -0,0 +1,35 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    coderay (1.0.9)
+    diff-lcs (1.2.5)
+    highline (1.6.20)
+    method_source (0.8.2)
+    pry (0.9.12.2)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rake (10.1.0)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.0)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.1)
+    slop (3.4.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  highline (~> 1.6.2)
+  pry
+  rake
+  rspec (~> 3.2.0)

data/LICENSE.md

@@ -0,0 +1,9 @@
+(The MIT License)
+
+Copyright (c) 2009-2011 Rogelio J. Samour
+
+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,96 @@
+Git Pair
+=====
+by Andre Helberg (@A-Helberg)
+
+[![Build Status](https://travis-ci.org/A-Helberg/git-pair.svg)](https://travis-ci.org/A-Helberg/git-pair)
+
+Description:
+-----------
+
+Git Pair allows developers to be jointly credited when Pair Programming and using Git.
+
+Features:
+--------
+
+* Persists pair between different terminal instances.
+* Can be used in OSX GUI applications ( after restarting the application )
+* Allows you to expire the pair information in N hours. e.g. git pair --expire 8 fry leela
+
+Installation & Usage:
+----------
+Install the gem and add the setup to the end of your zshrc or bashrc file
+```shell
+$ gem install git-pair 
+```
+
+```shell
+$ pair --setup >> ~/.zshrc
+```
+
+Restart your terminal.
+
+To pair with someone replace the following names with your github names
+```shell
+$ pair A-Helberg aleciafb
+```
+
+Now just commit as you usually would. If you use a gui application on OSX, remember to restart it when you setupa new pair or switch pairs for it to take effect. The first person will be used as the author and the second person as the committer.
+
+ To switch the pairs around run:
+``` shell
+$ pair --switch
+```
+
+Don't forget to unpair when you are done:
+``` shell
+$ pair -u
+```
+
+For some help and a complete list of features:
+```shell
+$ pair -h
+```
+
+Install:
+-------
+
+``` shell
+gem install git-pair
+```
+
+``` shell
+pair --setup 
+```
+
+* this prints out the necessary shell function and aliases you need to add to your ~/.bashrc or ~/.zshrc
+  - eg. `pair --setup >> ~/.zshrc`
+* Or copy/paste [the code](lib/git-pair/git-pair.sh) into your ~/.bashrc or ~/.zshrc
+* As another option, copy/symlink the script to a separate file (e.g. `~/.bash/git-pair.sh` or `/etc/profile.d/git-pair.sh`) and source it. You can get the path using `pair --setup-path`.
+* Restart your terminal.
+
+Development:
+-----------
+
+* Fork git-pair
+* Add tests and code for your feature
+* Create a pull request
+* Double-check TravisCI to make sure all tests pass
+
+Requirements:
+------------
+
+* Git, HighLine
+
+Acknowledgements:
+----------------
+
+* Rogelio J. Samour (http://blog.therubymug.com)
+* Stephen Caudill
+* Les Hill
+* Tim Pope
+
+License:
+-------
+Released under the MIT License.  See the [LICENSE][license] file for further details.
+
+[license]: https://github.com/A-Helberg/git-pair/blob/master/LICENSE.md

data/Rakefile

@@ -0,0 +1,122 @@
+#############################################################################
+#
+# Helper functions
+#
+#############################################################################
+
+def name
+  @name ||= Dir['*.gemspec'].first.split('.').first
+end
+
+def version
+  line = File.read("lib/#{name}.rb")[/^\s*VERSION\s*=\s*.*/]
+  line.match(/.*VERSION\s*=\s*['"](.*)['"]/)[1]
+end
+
+def date
+  Date.today.to_s
+end
+
+def gemspec_file
+  "#{name}.gemspec"
+end
+
+def gem_file
+  "#{name}-#{version}.gem"
+end
+
+def replace_header(head, header_name)
+  head.sub!(/(\.#{header_name}\s*= ').*'/) { "#{$1}#{send(header_name)}'"}
+end
+
+#############################################################################
+#
+# Standard tasks
+#
+#############################################################################
+
+require 'rspec'
+require 'rspec/core/rake_task'
+
+desc "Run all specs"
+task RSpec::Core::RakeTask.new('spec')
+
+task :default => "spec"
+
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -r ./lib/#{name}.rb"
+end
+
+#############################################################################
+#
+# Custom tasks (add your own tasks here)
+#
+#############################################################################
+
+
+#############################################################################
+#
+# Packaging tasks
+#
+#############################################################################
+
+desc "Create tag v#{version} and build and push #{gem_file} to Rubygems"
+task :release => :build do
+  unless `git branch` =~ /^\* master$/
+    puts "You must be on the master branch to release!"
+    exit!
+  end
+  sh "git commit --allow-empty -a -m 'Release #{version}'"
+  sh "git tag v#{version}"
+  sh "git push origin master"
+  sh "git push origin v#{version}"
+  sh "gem push pkg/#{name}-#{version}.gem"
+end
+
+desc "Build #{gem_file} into the pkg directory"
+task :build => :gemspec do
+  sh "mkdir -p pkg"
+  sh "gem build #{gemspec_file}"
+  sh "mv #{gem_file} pkg"
+end
+
+desc "Generate #{gemspec_file}"
+task :gemspec => :validate do
+  # read spec file and split out manifest section
+  spec = File.read(gemspec_file)
+  head, manifest, tail = spec.split("  # = MANIFEST =\n")
+
+  # replace name version and date
+  replace_header(head, :name)
+  replace_header(head, :version)
+  replace_header(head, :date)
+
+  # determine file list from git ls-files
+  files = `git ls-files`.
+    split("\n").
+    sort.
+    reject { |file| file =~ /^\./ }.
+    reject { |file| file =~ /^(rdoc|pkg)/ }.
+    map { |file| "    #{file}" }.
+    join("\n")
+
+  # piece file back together and write
+  manifest = "  s.files = %w[\n#{files}\n  ]\n"
+  spec = [head, manifest, tail].join("  # = MANIFEST =\n")
+  File.open(gemspec_file, 'w') { |io| io.write(spec) }
+  puts "Updated #{gemspec_file}"
+end
+
+desc "Validate #{gemspec_file}"
+task :validate do
+  libfiles = Dir['lib/*'] - ["lib/#{name}.rb", "lib/#{name}"]
+  unless libfiles.empty?
+    puts "Directory `lib` should only contain a `#{name}.rb` file and `#{name}` dir."
+    exit!
+  end
+  unless Dir['VERSION*'].empty?
+    puts "A `VERSION` file at root level violates Gem best practices."
+    exit!
+  end
+end

data/bin/pair

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(File.join(File.dirname(__FILE__), %w[.. lib git-pair]))
+
+args = ARGV
+options = []
+opts = OptionParser.new do |opts|
+  opts.banner = "Usage: git pair [options] first_pair_username second_pair_username"
+  opts.separator ""
+  opts.separator "General options:"
+
+  opts.on("-s", "--setup", "Print out shell goodies") do
+    options = [:setup]
+  end
+
+  opts.on("--setup-path", "Print out path to shell goodies") do
+    options = [:print_setup_path]
+  end
+
+  opts.on("-e N", "--expire N", Integer, "Expire pair information in N hours.") do |n|
+    options = [:expire, n]
+  end
+
+  opts.on("-u", "--unpair", "Clear pair information") do
+    options = [:unpair]
+  end
+
+  opts.on("--switch", "Switch author and committer") do
+    options = [:switch]
+  end
+
+  opts.separator ""
+  opts.separator "Common options:"
+  
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end
+
+  opts.on_tail("-v", "--version", "Show version") do
+    abort "git pair v#{GitPair::VERSION}"
+  end
+end
+
+if args.any?
+  opts.parse!(args)
+  if options.delete(:expire)
+    system(GitPair.expire_command(options.pop))
+  end
+
+  options = [:export, args] if options.empty?
+else
+  options = [:print_info]
+end
+
+GitPair.send(*options)

data/git-pair.gemspec

@@ -0,0 +1,49 @@
+# -*- encoding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.rubygems_version = '1.3.5'
+
+  s.name = %q{pair-up}
+  s.version = '1.0.0'
+  s.date = Time.now.strftime('%F')
+  s.license = 'MIT'
+
+  s.description = %q{Git author attribution helper for pair programmers.}
+  s.summary = %q{pair-up allows developers to be properly credited when Pair Programming and using Git.}
+  s.authors = [%q{Andre Helberg}]
+  s.email         = ["helberg.andre@gmail.com"]
+  s.homepage = %q{http://github.com/A-Helberg/git-pair}
+  s.require_paths = %w[lib]
+  s.extra_rdoc_files = %w[README.md LICENSE.md]
+  s.rdoc_options = [%q{--charset=UTF-8}]
+
+  s.executables = [%q{pair}]
+  s.add_development_dependency(%q<rspec>, ["~> 3.2"])
+  s.add_runtime_dependency(%q<highline>, ["~> 1.6"])
+
+  ## Leave this section as-is. It will be automatically generated from the
+  ## contents of your Git repository via the gemspec task. DO NOT REMOVE
+  ## THE MANIFEST COMMENTS, they are used as delimiters by the task.
+  # = MANIFEST =
+  s.files = %w[
+    Gemfile
+    Gemfile.lock
+    LICENSE.md
+    README.md
+    Rakefile
+    bin/pair
+    git-pair.gemspec
+    lib/git-pair.rb
+    lib/git-pair/participant.rb
+    lib/git-pair/git-pair.sh
+    lib/git-pair/ui.rb
+    spec/git-pair/participant_spec.rb
+    spec/git-pair/ui_spec.rb
+    spec/git-pair_spec.rb
+    spec/spec_helper.rb
+  ]
+  # = MANIFEST =
+
+  s.test_files    = s.files.grep(%r{^spec/})
+end

data/lib/git-pair.rb

@@ -0,0 +1,161 @@
+require 'highline'
+require 'yaml'
+
+require File.expand_path(File.join(File.dirname(__FILE__), %w[.. lib git-pair ui]))
+require File.expand_path(File.join(File.dirname(__FILE__), %w[.. lib git-pair participant]))
+
+module GitPair
+
+  VERSION = '1.0.0'
+
+  def self.print_info
+    if GitPair.pairing? && STDOUT.tty?
+      GitPair::UI.highline.say("Author: #{GitPair.git_author_name} <#{GitPair.git_author_email}>, Comitter: #{GitPair.git_committer_name} <#{GitPair.git_committer_email}>")
+    end
+  end
+
+  def self.export(pairs)
+    GitPair.current_pair = pairs
+
+    if GitPair.mac?
+      `launchctl setenv GIT_AUTHOR_NAME '#{GitPair.git_author_name}' GIT_AUTHOR_EMAIL '#{GitPair.git_author_email}'`
+      `launchctl setenv GIT_COMMITTER_NAME '#{GitPair.git_committer_name}' GIT_COMMITTER_EMAIL '#{GitPair.git_committer_email}'`
+    end
+
+    write_export_file
+    print_info
+  end
+
+  def self.expire_command(time)
+    %Q(sleep #{to_seconds(time)} && #{GitPair.bin_path} --unpair&)
+  end
+
+  def self.unpair
+    GitPair.current_pair = []
+
+    if GitPair.mac?
+      `launchctl unsetenv GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL`
+      `launchctl unsetenv GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL`
+    end
+
+    write_export_file
+  end
+
+  def self.author_command
+    if GitPair.pairing?
+      "export GIT_AUTHOR_NAME='#{GitPair.git_author_name}' GIT_AUTHOR_EMAIL='#{GitPair.git_author_email}' GIT_COMMITTER_NAME='#{GitPair.git_committer_name}' GIT_COMMITTER_EMAIL='#{GitPair.git_committer_email}'"
+    else
+      "unset GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL"
+    end
+  end
+
+  def self.current_pair
+    config[:current_pair] ||= []
+  end
+
+  def self.switch
+    if not current_pair.empty?
+      GitPair.export current_pair.reverse
+    end
+  end
+
+  def self.current_pair=(pairs)
+    config[:current_pair] = []
+    pairs.each do |participant|
+      if GitPair::Participant.find(participant)
+        config[:current_pair] << participant
+      else
+        if GitPair::UI.prompt_for_pair(participant)
+          config[:current_pair] << participant
+        end
+      end
+    end
+    write_file
+  end
+
+  def self.git_author_name
+    dev = GitPair::Participant.find(current_pair[0])
+    dev["name"]
+  end
+
+  def self.git_author_email
+    dev = GitPair::Participant.find(current_pair[0])
+    dev["email"]
+  end
+
+  def self.git_committer_name
+    dev = GitPair::Participant.find(current_pair[1])
+    dev["name"]
+  end
+
+  def self.git_committer_email
+    dev = GitPair::Participant.find(current_pair[1])
+    dev["email"]
+  end
+
+  def self.setup_path
+    File.join(File.dirname(__FILE__), 'git-pair', 'git-pair.sh')
+  end
+
+  def self.print_setup_path
+    puts setup_path
+  end
+
+  def self.setup
+    GitPair::UI.highline.say(File.read(setup_path))
+  end
+
+  def self.write_file
+    File.open(gitpairrc, File::CREAT|File::TRUNC|File::RDWR, 0644) do |out|
+      YAML.dump(config, out)
+    end
+  end
+
+  private
+
+  def self.mac?
+    (/darwin14/ =~ RUBY_PLATFORM)
+  end
+
+  def self.config
+    @config ||= get_config
+  end
+
+  def self.get_config
+    if File.exists?(gitpairrc)
+      yamlized = YAML::load_file(gitpairrc)
+      return yamlized if yamlized.kind_of?(Hash)
+    end
+    return {}
+  end
+
+  def self.gitpairrc
+    File.expand_path('~/.git-pairrc')
+  end
+
+  def self.gitpair_export_authors
+    File.expand_path('~/.git-pair_export_authors')
+  end
+
+  def self.bin_path
+    %x[which git-pair].chomp
+  end
+
+  def self.pairing?
+    current_pair.any?
+  end
+
+  def self.to_seconds(value)
+    value = value.to_s.gsub(/[^\d]/, '').to_i
+    unless value.zero?
+      value * 60 * 60
+    else
+      raise StandardError
+    end
+  end
+
+  def self.write_export_file
+    File.open(gitpair_export_authors, 'w'){|f| f.write(author_command) }
+  end
+
+end

data/lib/git-pair/git-pair.sh

@@ -0,0 +1,11 @@
+# Add the following to your ~/.bashrc or ~/.zshrc
+#
+# Alternatively, copy/symlink this file and source in your shell.  See `git pair --setup-path`.
+
+pair() {
+  command pair "$@"
+  if [[ -s "$HOME/.git-pair_export_authors" ]] ; then source "$HOME/.git-pair_export_authors" ; fi
+}
+
+# Uncomment to persist pair info between terminal instances
+# pair

data/lib/git-pair/participant.rb

@@ -0,0 +1,41 @@
+module GitPair
+  class Participant
+
+    def self.add(github, email, name)
+      unless find(github)
+        available_pairs[github] = {}
+        available_pairs[github]["email"] = email
+        available_pairs[github]["name"] = name
+      end
+    end
+
+    def self.find(github)
+      available_pairs[github]
+    end
+
+    def self.write_file
+      File.open(pairs_file, File::CREAT|File::TRUNC|File::RDWR, 0644) do |out|
+        YAML.dump(available_pairs, out)
+      end
+    end
+
+    private
+
+    def self.pairs_file
+      File.expand_path("~/.git-pair_pairs")
+    end
+
+    def self.available_pairs
+      @available_pairs ||= get_available_pairs
+    end
+
+    def self.get_available_pairs
+      if File.exists?(pairs_file)
+        yamlized = YAML::load_file(pairs_file)
+        return yamlized if yamlized.kind_of?(Hash)
+      end
+      return {}
+    end
+
+  end
+end

data/lib/git-pair/ui.rb

@@ -0,0 +1,27 @@
+HighLine.track_eof = false
+
+module GitPair
+  class UI
+
+    def self.prompt_for_pair(new_participant)
+      highline.say("I don't know who #{new_participant} is.")
+      if highline.agree("Do you want to add #{new_participant} to ~/.git-pair_pairs? (yn)")
+        participant_name = highline.ask("What is #{new_participant}'s full name?").to_s
+        participant_email = highline.ask("What is #{new_participant}'s email?").to_s
+        GitPair::Participant.add(new_participant, participant_email, participant_name)
+        GitPair::Participant.write_file
+        return new_participant
+      else
+        highline.say("Ignoring #{new_participant}.")
+      end
+      return nil
+    end
+
+    private
+
+    def self.highline
+      @highline ||= HighLine.new
+    end
+
+  end
+end

data/spec/git-pair/participant_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe GitPair::Participant do
+
+  let(:base_pairs) do
+    {
+      'bender' => {"email"=>"rcrichoch@fakeinbox.com", "name"=>"Rogelio J. Samour"},
+      'fry'    => {"email"=>"crichoch@fakeinbox.com", "name"=>"Phillip J. Fry"},
+      'leela'  => {"email"=>"stepriso@fakeinbox.com", "name"=>"Turanga Leela"}
+    }
+  end
+
+  describe ".write_file" do
+    it "writes the contents of GitPair::Participant.available_pairs to the hitch_pairs file" do
+      expect(YAML).to receive(:dump)
+      GitPair::Participant.write_file
+    end
+  end
+
+  describe ".add" do
+
+    context "when the participant is not present" do
+      it "adds the participant to GitPair::Participant.available_pairs" do
+        allow(GitPair::Participant).to receive(:get_available_pairs) { {} }
+        GitPair::Participant.add("therubymug", "rcrichoch@fakeinbox.com", "Rogelio J. Samour")
+        expect(GitPair::Participant.available_pairs).to eql({"therubymug"=>{"email"=>"rcrichoch@fakeinbox.com", "name"=>"Rogelio J. Samour"}})
+      end
+    end
+
+  end
+
+  describe ".find" do
+
+    context "when the participant is present" do
+      it "and_return the full name" do
+        expect(GitPair::Participant.find("therubymug")).to eql({"email"=>"rcrichoch@fakeinbox.com", "name"=>"Rogelio J. Samour"})
+      end
+    end
+
+    context "when the participant is not present" do
+      it "and_return nil" do
+        expect(GitPair::Participant.find("nobody")).to be_nil
+      end
+    end
+
+  end
+
+end

data/spec/git-pair/ui_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+
+describe GitPair::UI do
+
+  describe '.prompt_for_pair' do
+
+    let(:new_author) { 'leela' }
+    let(:new_author_name) { 'Turanga Leela' }
+    let(:new_author_email) { 'Turanga Leela' }
+
+
+    before do
+      allow(GitPair::UI.highline).to receive(:ask) {new_author_name}
+      # expect(GitPair::UI.highline).to receive(:say)
+    end
+
+    it 'states that the new pair is not in the git-pair_pairs file' do
+      expect(GitPair::UI.highline).to receive(:say).with("I don't know who #{new_author} is.")
+      GitPair::UI.prompt_for_pair(new_author)
+    end
+
+    it 'prompts for pair' do
+      expect(GitPair::UI.highline).to receive(:say)
+      expect(GitPair::UI.highline).to receive(:agree).with("Do you want to add #{new_author} to ~/.git-pair_pairs? (yn)")
+      expect(GitPair::UI.highline).to receive(:say)
+      GitPair::UI.prompt_for_pair(new_author)
+    end
+
+    context 'when user does not agree to add new author' do
+      it "states it's ignoring the author" do
+        allow(GitPair::UI.highline).to receive(:agree) {false}
+        expect(GitPair::UI.highline).to receive(:say)
+        expect(GitPair::UI.highline).to receive(:say).with("Ignoring #{new_author}.")
+        GitPair::UI.prompt_for_pair(new_author)
+      end
+    end
+
+    context 'when user agrees to add new author' do
+
+      before do
+        allow(GitPair::UI.highline).to receive(:agree) {true}
+        expect(GitPair::UI.highline).to receive(:say)
+      end
+
+      it "asks for the new author's name" do
+        expect(GitPair::UI.highline).to receive(:ask).with("What is #{new_author}'s full name?")
+        GitPair::UI.prompt_for_pair(new_author)
+      end
+
+      it "adds the new author" do
+        expect(GitPair::Participant).to receive(:add).with(new_author, new_author_name, new_author_email)
+        GitPair::UI.prompt_for_pair(new_author)
+      end
+
+      it "writes the ~/.hitch_pairs file" do
+        expect(GitPair::Participant).to receive(:write_file)
+        GitPair::UI.prompt_for_pair(new_author)
+      end
+
+    end
+
+  end
+
+end

data/spec/git-pair_spec.rb

@@ -0,0 +1,233 @@
+require 'spec_helper'
+
+describe GitPair do
+
+  let(:pairs_data) {
+    {
+      'leela'    => { 'name' => 'Turanga Leela',    'email' => 'leela@futurama.test'}, 
+      'fry'      => { 'name' => 'Philip J. Fry',    'email' => 'fry@futurama.test'}, 
+      'zoidberg' => { 'name' => 'John A. Zoidberg', 'email' => 'zoidberg@futurama.test' }
+    }
+  }
+
+  let(:gitpair_config) do
+    {
+      :current_pair => ["leela", "fry"]
+    }
+  end
+
+  before do
+    allow(GitPair::Participant).to receive(:config) { gitpair_config }
+    allow(GitPair::Participant).to receive(:available_pairs) { pairs_data }
+    allow(GitPair).to receive(:write_file)
+  end
+
+  describe '.print_info' do
+
+    context 'when pairing' do
+      it 'returns the author and commiters names and emails' do
+        expect(GitPair::UI.highline).to receive(:say).with("Author: Turanga Leela <leela@futurama.test>, Comitter: Philip J. Fry <fry@futurama.test>")
+        GitPair.current_pair = ['leela', 'fry']
+        GitPair.print_info
+      end
+    end
+
+    context 'when not pairing' do
+      it 'returns nothing' do
+        GitPair.current_pair = []
+        expect(GitPair.print_info).to be_nil
+      end
+    end
+
+    context 'when not in an interactive shell' do
+      it 'returns nothing' do
+        allow(STDOUT).to receive(:tty?) { false }
+        expect(GitPair::UI.highline).to_not receive(:say)
+        GitPair.current_pair = ['leela', 'fry']
+        GitPair.print_info
+      end
+    end
+
+  end
+
+  describe '.switch' do
+
+    it "switches the author and commiter around" do
+      allow(GitPair::UI.highline).to receive(:say)
+      GitPair.current_pair= ['leela', 'fry']
+      expect(GitPair.current_pair).to eql(['leela', 'fry'])
+      GitPair.switch
+      expect(GitPair.current_pair).to eql(["fry", "leela"])
+    end
+  end
+
+  describe '.export' do
+
+    let(:pairs) { ['fry', 'leela'] }
+
+    before do
+      allow(GitPair).to receive(:print_info)
+    end
+
+    it 'sets the current pair' do
+      expect(GitPair).to receive(:current_pair=) {pairs}
+      GitPair.export(pairs)
+    end
+
+    it 'writes the export file' do
+      expect(GitPair).to receive(:write_export_file)
+      GitPair.export(pairs)
+    end
+
+    it 'prints out pair info' do
+      expect(GitPair).to receive(:print_info)
+      GitPair.export(pairs)
+    end
+
+  end
+
+  describe '.expire_command' do
+    before do
+      allow(GitPair).to receive(:bin_path) {'/usr/local/bin/git-pair'}
+    end
+
+    context 'with a valid string' do
+      let(:time_string) { '8' }
+      it 'returns the system command to call' do
+        expect(GitPair.expire_command(time_string)).to eql('sleep 28800 && /usr/local/bin/git-pair --unpair&')
+      end
+    end
+
+    context 'with a valid integer' do
+      let(:time_string) { 8 }
+      it 'returns the system command to call' do
+        expect(GitPair.expire_command(time_string)).to  eql('sleep 28800 && /usr/local/bin/git-pair --unpair&')
+      end
+    end
+
+    context 'with an invalid string' do
+      let(:time_string) { 'BAR' }
+      it 'raises an error' do
+        expect {GitPair.expire_command(time_string)}.to raise_error(StandardError)
+      end
+    end
+
+  end
+
+  describe '.unpair' do
+
+    let(:pairs) { ['fry', 'leela'] }
+
+    it 'sets the current pair to an empty array' do
+      allow(GitPair).to receive(:current_pair=)
+      GitPair.unpair
+    end
+
+    it 'writes the export file' do
+      allow(GitPair).to receive(:write_export_file)
+      GitPair.unpair
+    end
+
+  end
+
+  describe '.author_command' do
+
+    context 'when pairing' do
+      it 'returns the export shell command for GIT_AUTHOR_* and GIT_COMMITTER_*' do
+        GitPair.current_pair = ['leela', 'fry']
+        expect(GitPair.author_command).to eql("export GIT_AUTHOR_NAME='Turanga Leela' GIT_AUTHOR_EMAIL='leela@futurama.test' GIT_COMMITTER_NAME='Philip J. Fry' GIT_COMMITTER_EMAIL='fry@futurama.test'")
+      end
+
+      it 'uses the first pair as author and the second as commiter' do
+        GitPair.current_pair = ['fry', 'leela']
+        expect(GitPair.author_command).to eql("export GIT_AUTHOR_NAME='Philip J. Fry' GIT_AUTHOR_EMAIL='fry@futurama.test' GIT_COMMITTER_NAME='Turanga Leela' GIT_COMMITTER_EMAIL='leela@futurama.test'")
+      end
+    end
+
+    context 'when not pairing' do
+      it 'returns the unset shell command for GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL' do
+        GitPair.current_pair = []
+        expect(GitPair.author_command).to eql("unset GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL")
+      end
+    end
+
+    context 'with more than 2 developers' do
+      it "ignores the everyone but the first two" do
+        GitPair.current_pair = ['leela', 'fry', 'zoidberg']
+        expect(GitPair.author_command).to eql("export GIT_AUTHOR_NAME='Turanga Leela' GIT_AUTHOR_EMAIL='leela@futurama.test' GIT_COMMITTER_NAME='Philip J. Fry' GIT_COMMITTER_EMAIL='fry@futurama.test'")
+      end
+    end
+
+  end
+
+  describe '.current_pair' do
+    it 'returns an array of Github usernames' do
+      allow(GitPair).to receive(:config) {gitpair_config}
+      expect(GitPair.current_pair).to eql(['leela', 'fry'])
+    end
+  end
+
+  describe '.current_pair=' do
+
+    before { allow(GitPair).to receive(:write_file) }
+
+    it 'writes the git-pairrc file' do
+      expect(GitPair).to receive(:write_file)
+      GitPair.current_pair = ['leela', 'fry']
+    end
+
+    context 'when there are no new participants' do
+      it 'sets the current pair with the participants given' do
+        GitPair.current_pair = ['leela', 'fry']
+        expect(GitPair.current_pair).to eql(['leela', 'fry'])
+      end
+    end
+
+    context 'when there are new participants' do
+
+      let(:new_participant) { 'therubymug' }
+
+      it "prompts for the new participant's info" do
+        expect(GitPair::UI).to receive(:prompt_for_pair).with(new_participant)
+        GitPair.current_pair = [new_participant, 'fry']
+      end
+
+      it 'adds the new participant to current pair' do
+        allow(GitPair::UI).to receive(:prompt_for_pair) {new_participant}
+        GitPair.current_pair = [new_participant, 'fry']
+        expect(GitPair.current_pair).to eql([new_participant, 'fry'])
+      end
+
+    end
+  end
+
+  describe '.git_author_name' do
+    it "returns the first participant's name" do
+      allow(GitPair).to receive(:config) { gitpair_config }
+      expect(GitPair.git_author_name).to eql('Turanga Leela')
+    end
+  end
+
+  describe '.git_author_email' do
+    it "returns the first participant's email" do
+      allow(GitPair).to receive(:config) { gitpair_config }
+      expect(GitPair.git_author_email).to eql('leela@futurama.test')
+    end
+  end
+
+  describe '.git_committer_name' do
+    it "returns the second participant's name" do
+      allow(GitPair).to receive(:config) { gitpair_config }
+      expect(GitPair.git_committer_name).to eql('Philip J. Fry')
+    end
+  end
+
+  describe '.git_committer_email' do
+    it "returns the second participant's email" do
+      allow(GitPair).to receive(:config) { gitpair_config }
+      expect(GitPair.git_committer_email).to eql('fry@futurama.test')
+    end
+  end
+
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'rspec'
+require 'fileutils'
+require 'tempfile'
+require 'pry'
+
+require File.join(File.dirname(__FILE__), '..', 'lib', 'git-pair')
+
+RSpec.configure do |config|
+  config.color = true
+  config.formatter = 'progress'
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: pair-up
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Andre Helberg
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+description: Git author attribution helper for pair programmers.
+email:
+- helberg.andre@gmail.com
+executables:
+- pair
+extensions: []
+extra_rdoc_files:
+- README.md
+- LICENSE.md
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.md
+- README.md
+- Rakefile
+- bin/pair
+- git-pair.gemspec
+- lib/git-pair.rb
+- lib/git-pair/git-pair.sh
+- lib/git-pair/participant.rb
+- lib/git-pair/ui.rb
+- spec/git-pair/participant_spec.rb
+- spec/git-pair/ui_spec.rb
+- spec/git-pair_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/A-Helberg/git-pair
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--charset=UTF-8"
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 2
+summary: pair-up allows developers to be properly credited when Pair Programming and
+  using Git.
+test_files:
+- spec/git-pair/participant_spec.rb
+- spec/git-pair/ui_spec.rb
+- spec/git-pair_spec.rb
+- spec/spec_helper.rb