pair 0.0.1

data/.gitignore

@@ -0,0 +1,15 @@
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg

data/.rspec

@@ -0,0 +1 @@
+--color --format=documentation

data/.rvmrc

@@ -0,0 +1,13 @@
+rvm 1.9.2-p180@pair-gem --create
+
+bundler=`gem list bundler | grep bundler`
+if [ $? -eq 1 ] ; then
+  echo "Installing bundler for project:\n\n";
+  gem install --pre bundler;
+
+  echo; read -s -n 1 -p "Run bundler install y/n" confirm; echo; echo;
+  if [ "$confirm" == "y" ]; then
+    bundle install;
+  fi
+fi
+

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,30 @@
+PATH
+  remote: .
+  specs:
+    pair (0.0.1)
+      httparty
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    httparty (0.8.1)
+      multi_json
+      multi_xml
+    multi_json (1.0.3)
+    multi_xml (0.4.1)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  pair!
+  rspec (~> 2.3.0)

data/README.rdoc

@@ -0,0 +1,38 @@
+= Pair
+
+Pair gem for collaborating between two or more remote pairs. The gem will facilite starting a hosted
+session where multiple pairs access the computer of the hosted user.
+
+== Requirements
+
+Hosting Users:
+
+* All users must have a github account with up-to-date public keys
+* Must have a variant of unix installed
+* Must have tmux installed
+
+== Example
+
+=== Interactive hosted session
+
+bin/pairmill host -p<github-user>,<github-user>,<github-user>
+
+=== Interactive hosted session
+
+bin/pairmill host -v<github-user>,<github-user>,<github-user>
+
+== Contributing to pair
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Pair. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,15 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec

data/bin/pair

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$: << File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require "pair/command_line"
+Pair::CommandLine.run!(ARGV)
+

data/lib/pair.rb

@@ -0,0 +1,10 @@
+require 'httparty'
+require 'ruby-debug' if ENV["DEBUGGER"] == "true"
+
+require "pair/version"
+require "pair/api"
+require "pair/session"
+
+module Pair
+  # Your code goes here...
+end

data/lib/pair/api.rb

@@ -0,0 +1,60 @@
+require 'yaml'
+
+module Pair
+  module Api
+    def create_session(session)
+      post("/v1/sessions", {
+        :body => {
+          :session => {
+            :name         => session.name,
+            :viewers      => session.viewers,
+            :participants => session.participants,
+            :tunnel       => {
+              :host_login => session.host_login
+            }
+          }
+        }
+      })
+    end
+
+    def join_session(session)
+      options = { :query => { :name => session.name, :host => session.host, :format => "json" } }
+      get("/v1/sessions/search.json", options)
+    end
+
+    def api_token
+      config[:api_token]
+    end
+
+    def config
+      @config ||= if File.exists?(config_file)
+        YAML.load_file(config_file)[base_uri] || setup_config
+      else
+        setup_config
+      end
+    end
+
+    def config_file
+      File.expand_path("~/.pair.yml")
+    end
+
+    def setup_config
+      config = YAML.load_file(config_file) rescue {}
+
+      print "Please input your API token for #{base_uri}: "
+      config[base_uri] = {:api_token => $stdin.gets.chomp}
+
+      File.open(config_file, 'w') do |f|
+        f.write(YAML.dump(config))
+      end
+
+      config[base_uri]
+    end
+
+    include HTTParty
+    extend self
+
+    base_uri ENV['BASE_URI'] || 'api.pairmill.com'
+    default_params :api_token => api_token
+  end
+end

data/lib/pair/command_line.rb

@@ -0,0 +1,60 @@
+require "pair"
+require "optparse"
+
+module Pair
+  class CommandLine
+    attr_accessor :arguments,  :options
+    private       :arguments=, :options=
+
+    def self.run!(*arguments)
+      new(*arguments).run!
+    end
+
+    def initialize(arguments)
+      self.arguments = arguments
+      self.options   = {}
+    end
+
+    def run!
+      case command = arguments.shift
+      when 'host'
+        require "pair/command_line/host"
+        Host.run!(arguments)
+      else
+        unknown_command(command)
+      end
+    rescue SystemExit
+      raise
+    rescue
+      if $-d
+        STDOUT.puts "\n"
+        STDOUT.puts "  Please contact support@pairmill.com, there"
+        STDOUT.puts "  was an issue creating your session."
+        STDOUT.puts "\n"
+      else
+        raise
+      end
+    end
+
+    private
+    def unknown_command(command)
+      puts "Unknown command: #{command}" if command
+
+      #{$0} join [options]
+      abort %Q[
+        Usage: #{$0} host [options]
+
+        You can pass -h to a subcommand to learn more about it.
+
+          e.g. #{$0} join -h
+      ].gsub(/^ {0,9}/,'')
+    end
+
+    def parse
+      opts = OptionParser.new { |o| yield(o) }
+      opts.parse!(arguments)
+      opts
+    end
+  end
+end
+

data/lib/pair/command_line/host.rb

@@ -0,0 +1,44 @@
+require "pair/command_line"
+
+module Pair
+  class CommandLine
+    class Host < self
+      def run!
+        parse!
+        Pair::Session.host(options)
+      end
+
+      def parse!
+        opts = parse do |opts|
+          opts.banner = "Usage: #{$0} host [-s SESSION_NAME] [-v PAIR[,PAIR[,...]] [-p PAIR[,PAIR[,...]]" +
+                        "\n\n" +
+                        "At least one PAIR (of any type must be defined). A PAIR takes the form of a Github username." +
+                        "\n\n"+
+                        "Options:"
+
+          opts.on("-s", "--session-name=SESSION_NAME", "Automatically generated by server if not provided.") do |session_name|
+            options[:name] = session_name
+          end
+
+          opts.on("-v", "--viewers=PAIRS", Array) do |pairs|
+            options[:viewers] = pairs
+          end
+
+          opts.on("-p", "--participants=PAIRS", Array) do |pairs|
+            options[:participants] = pairs
+          end
+
+          opts.on_tail("-h", "--help", "Display this text") do
+            puts opts
+            exit
+          end
+        end
+
+        if options[:viewers].to_a.empty? && options[:participants].to_a.empty?
+          $stderr.puts "ERROR: At least one PAIR is required...\n\n"
+          abort(opts.inspect)
+        end
+      end
+    end
+  end
+end

data/lib/pair/session.rb

@@ -0,0 +1,15 @@
+require "pair/session/tmux"
+require "pair/session/tunnel"
+require "pair/session/authorized_keys_file"
+require "pair/session/hosted_session"
+
+module Pair
+  class Session
+    attr_accessor :host,  :name,  :options,  :viewers,  :participants
+    private       :host=, :name=, :options=, :viewers=, :participants=
+
+    def initialize(options = {})
+      self.options = options
+    end
+  end
+end

data/lib/pair/session/authorized_keys_file.rb

@@ -0,0 +1,100 @@
+module Pair
+  class Session
+    class AuthorizedKeysFile
+      ACCESS_TYPE = "type"
+      KEYS        = "keys"
+
+      attr_accessor :member_keys
+      attr_accessor :session
+      attr_accessor :key_file_path
+
+      def initialize(member_keys = {}, session)
+        self.member_keys = member_keys
+        self.session = session
+        self.key_file_path = File.expand_path("~/.ssh/authorized_keys")
+      end
+
+      def install
+        return nil if self.member_keys.values.empty? || self.member_keys.values.map { |k,v| v }.empty?
+
+        backup_authorized_keys if key_file_exists?
+        create_authorized_keys
+      end
+
+      def cleanup
+        cleanup_authorized_keys
+      end
+
+      def cleanup_authorized_keys
+        remove_existing_file
+        move_backup_file if backup_key_file_exists?
+      end
+
+      def backup_authorized_keys
+        puts "Backing up authorized_keys: #{self.key_file_path}" if $-d
+        FileUtils.cp(self.key_file_path, backup_key_file_path)
+      end
+
+      def remove_existing_file
+        puts "Removing authorized_keys: #{self.key_file_path}" if $-d
+        FileUtils.rm(self.key_file_path)
+      end
+
+      def move_backup_file
+        puts "Moving backup: #{self.backup_key_file_path}" if $-d
+        FileUtils.mv(backup_key_file_path, self.key_file_path)
+      end
+
+      def line_numbers_of(key)
+        `grep -ns ".*#{key}.*" #{self.key_file_path} | sed 's/\:.*//'`.split('\n').map(&:strip)
+      end
+
+      def key_file_exists?
+        File.exists? self.key_file_path
+      end
+
+      def backup_key_file_exists?
+        File.exists? backup_key_file_path
+      end
+
+      def backup_key_file_path
+        "#{self.key_file_path}.pair"
+      end
+
+      private
+
+      def create_authorized_keys
+        File.open(self.key_file_path, 'w') do |file|
+          self.member_keys.each do |user, hash|
+            write_comment_for user, file
+            write_rows_for hash[KEYS], hash[ACCESS_TYPE], file
+          end
+        end
+
+        self.key_file_path
+      end
+
+      def write_comment_for user, in_file
+        in_file.puts "# #{user}"
+      end
+
+      def write_rows_for keys, of_type, in_file
+        keys.each do |key|
+          in_file.puts "command=\"#{command(session, of_type)}\",#{key_options.join(',')} #{key["content"]} #id:#{key["id"]}"
+        end
+        in_file.puts ""
+      end
+
+      def command(session, type)
+        options = ["-S /tmp/pairmill/tmux-#{session.name} attach"]
+        options << "-r" if type == 'viewer'
+
+        "/usr/local/bin/tmux #{options.join(' ')}"
+      end
+
+      def key_options
+        %w{no-port-forwarding no-X11-forwarding no-agent-forwarding}
+      end
+    end
+  end
+end

data/lib/pair/session/hosted_session.rb

@@ -0,0 +1,90 @@
+module Pair
+  class Session
+    class HostedSession < self
+      attr_accessor :tunnel,  :authorized_keys_file,  :tmux,  :response
+      private       :tunnel=, :authorized_keys_file=, :tmux=, :response=
+
+      def initialize(options = {})
+        puts "Hosting session #{"called #{options[:name].inspect} " if options[:name]}..."
+
+        self.name         = options.delete(:name)
+        self.viewers      = options.delete(:viewers)      || []
+        self.participants = options.delete(:participants) || []
+        self.tmux         = Tmux.new(self)
+
+        super(options)
+      end
+
+      def start!
+        if setup
+          display_startup_message
+
+          tunnel.open do
+            tmux.start
+            tmux.attach
+          end
+        else
+          puts "There was a problem starting the host session %s" % (name && name.inspect)
+          puts "response: #{response.inspect}" if response && $-d
+          puts ""
+        end
+
+        exit
+      end
+
+      def display_startup_message
+        puts "Your pairs can connect to this session using the following command:"
+        puts ""
+        puts "	#{connect_command}"
+        puts ""
+        print "Press any key to continue..."
+
+        gets
+      end
+
+      # TODO: this should get host/user from response
+      def connect_command
+        "ssh-add; ssh -tqA -l#{bastion["join_user"]} #{bastion["host"]} #{name}"
+      end
+
+      def bastion
+        response["tunnel"]["bastion"]
+      end
+
+      def host_login
+        `whoami`.chomp
+      end
+
+      def cleanup_authorized_keys
+        authorized_keys_file.cleanup
+      end
+
+      private
+
+      def setup
+        create_session_on_server && authorized_keys_file.install
+      end
+
+      def create_session_on_server
+        self.response = Api.create_session(self)["session"]
+
+        if self.response
+          self.name                 = response["name"]
+          self.tunnel               = Tunnel.new(self.response["tunnel"].merge(:host => true))
+          self.authorized_keys_file = AuthorizedKeysFile.new(self.response["member_keys"], self)
+        end
+      end
+
+      def stop!
+        tunnel.close
+        tmux.stop
+        cleanup_authorized_keys
+      end
+    end
+
+    def self.host(options)
+      HostedSession.new(options).start!
+    end
+  end
+end
+

data/lib/pair/session/tmux.rb

@@ -0,0 +1,74 @@
+require 'fileutils'
+
+module Pair
+  class Session
+    class Tmux
+      TMP_PATH = "/tmp"
+
+      attr_accessor :session
+      private       :session=
+
+      def initialize(session)
+        self.session = session
+        create_socket_directory
+      end
+
+      def app_path
+        self.class.to_s.split('::').first.downcase
+      end
+
+      def unique
+        @unique ||= srand.to_s[0,5]
+      end
+
+      def start
+        args = %W[-S #{socket_path} new-session -d]
+        system "tmux", *args
+
+        at_exit { stop }
+      end
+
+      def stop
+        `lsof -t #{socket_path}/ | xargs kill -9`
+        FileUtils.rm_f(socket_path)
+        self.session.cleanup_authorized_keys if self.session.respond_to?(:cleanup_authorized_keys)
+      end
+
+      def window(command)
+        args = %W[
+          -S #{socket_path}
+          new-window
+          -t #{session.name}:0
+          -n 'Pairing'
+          'ssh pair@bastion.pairmill.com -A'
+        ]
+
+        system "tmux", *args
+      end
+
+      def attach(read_only = false)
+        args = %W[-S #{socket_path} attach]
+        args += " -r" if read_only
+
+        system "tmux", *args
+      end
+
+      private
+      def create_socket_directory
+        FileUtils.mkdir_p(socket_directory, :mode => 0700)
+      end
+
+      def socket_directory
+        File.join TMP_PATH, app_path
+      end
+
+      def socket_path
+        File.join socket_directory, socket_name
+      end
+
+      def socket_name
+        "tmux-#{session.name}"
+      end
+    end
+  end
+end

data/lib/pair/session/tunnel.rb

@@ -0,0 +1,62 @@
+module Pair
+  class Session
+    class Tunnel
+      attr_accessor :options,  :tunnel
+      private       :options=, :tunnel=
+
+      # E.g. options:
+      # {
+      #   "host_port"  => 22,
+      #   "host_login" => "bjeanes",
+      #   "port"       => 2222,
+      #   "bastion" => {
+      #     "host"       => "bastion.pairmill.com",
+      #     "ip_address" => "12.12.12.12",
+      #     "ssh_port"   => 22,
+      #     "host_user"  => "host",
+      #     "join_user"  => "join",
+      #   }
+      # }
+      def initialize(options)
+        self.options = options
+      end
+
+      def open
+        self.tunnel = IO.popen(ssh_command)
+        puts "SSH tunnel started (PID = #{tunnel.pid})" if $-d
+        at_exit { close }
+        yield if block_given?
+      end
+
+      def close
+        @tunnel_closed ||= begin
+          puts "Closing connection..."
+          Process.kill("INT", tunnel.pid)
+          Process.wait
+          true
+        end
+      end
+
+      private
+
+      def ssh_command
+        options = []
+        if self.options[:host]
+          options << "-nq"
+          options << "-l #{bastion["host_user"]}"
+          options << "-p #{bastion["ssh_port"]}" unless bastion["ssh_port"] == 22
+          options << "-R #{port}:localhost:#{host_port}"
+        else
+          options << "-tAq"
+          options << "-l #{bastion["join_user"]}"
+        end
+
+        "ssh #{bastion["host"]} #{options.join(" ")}"
+      end
+
+      def method_missing(method, *args, &block)
+        options[method.to_s] || super(method, *args, &block)
+      end
+    end
+  end
+end

data/lib/pair/version.rb

@@ -0,0 +1,3 @@
+module Pair
+  VERSION = "0.0.1"
+end

data/pair.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/pair/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Bodaniel Jeanes", "Chad W. Pry"]
+  gem.email         = ["me@bjeanes.com", "chad.pry@gmail.com"]
+  gem.description   = %q{Effortless remote pairing}
+  gem.summary       = %q{Pair with remote programmers with a single command.}
+  gem.homepage      = "http://www.pairmill.com"
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "pair"
+  gem.require_paths = ["lib"]
+  gem.version       = Pair::VERSION
+
+  gem.add_dependency("httparty", "~> 0.8.1")
+
+  gem.add_development_dependency("rspec", "~> 2.3.0")
+end

data/spec/fixture_helper.rb

@@ -0,0 +1,28 @@
+require 'yaml'
+
+class FixtureHelper
+  FIXTURE_FILES = Dir[File.expand_path("#{Dir.pwd}/spec/fixtures/*.yml")]
+
+  class << self
+    def method_missing(sym, *args, &block)
+      if fixture_exists? sym
+        load_fixture(sym)
+      else
+        super(sym, args, block)
+      end
+    end
+
+    def load_fixture name
+      instance_variable_get("@#{name}") || instance_variable_set("@#{name}", YAML.load_file(FIXTURE_FILES[line_of_fixture(name)]))
+    end
+
+    def fixture_exists? name
+      !line_of_fixture(name).nil?
+    end
+
+    def line_of_fixture name
+      FIXTURE_FILES.map { |f| f.split('/').last }.index("#{name}.yml")
+    end
+  end
+end
+

data/spec/fixtures/api_hosted_session.yml

@@ -0,0 +1,13 @@
+session:
+  id: 124
+  version: 0.1.0
+  name: Testing Channel
+  tunnel:
+    ssh_user: host
+    ssh_server: bastion.pairmill.com
+    ssh_port: 22
+    remote_binding: localhost
+    remote_user: chad
+    remote_port: 22
+    tunnel_port: 2222
+

data/spec/fixtures/api_joined_session.yml

@@ -0,0 +1,8 @@
+session:
+  id: 124
+  version: 0.1.0
+  name: Testing Channel
+  tunnel:
+    ssh_user: host
+    ssh_server: bastion.pairmill.com
+    ssh_port: 22

data/spec/fixtures/user_keys.yml

@@ -0,0 +1,18 @@
+:"chad.pry@gmail.com":
+  :type: interactive
+  :keys:
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAyIMHpjBSmn5/6iOjohj6u/WOm80OHc5S5srm3ARwrPx0oLSaMiMpt1cE+N2Tfz76xUkgqaYTjYoOIToJAJEufEdIlsvVfwrJlZ1/gY7mNV1K4W68gt5Z3xtOj6kaD8j6H385/qKUoMNzOAy6hA6PcpxbfCEP8N5NCIXiAldrxouf/Xh8Gd+AS4eaXzYarf/ShPAOoO/QqxWBgNNbyi/x8ulcxORxjIx0l4YSKHtWzHyypWVBjf0Ifd5bXUU13I20kG/D5SHFO5oYu6vC/jj9Ei4/jyzkvGH+2wcOTE5CjSr2kZ2Y55dFi/Kuu76wLgIVi5Ka6Z88208KXC97Mx4aQQ==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC0GKrgfzjAC2cXF3gZONipGwBNZaEaZk2Z23gpCZ1t7UH5JCZtoFT3ABtv4AAlwgXvW3Gnc4ycKT0ldkqwArAxjDDFzXdOvln7acWTNdoCchkJ6A9p3x14FhyhtyhvIRbJSqlKwd0AlgutehErvT31xX0b1sRF2pR3iaM/XTJFjr/49XD9iowH0zhLtD7FnNVwtZ4tGODRjU2p7bPPsvMYSwQ4oPbhC5ypzUaI6PQlSlgwljsdFK/NfGnMQK/7nWSlah+cbmJVwoXGZZFlmwsgvbg5qmG6bdtf602bRsU4utfGtOBAqkXc8C8EVDG68AzYbQrm95EsE+eQ8itV6Fr5
+:"me@bjeanes.com":
+  :type: interactive
+  :keys:
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA7G6H0jo9njZdmPkHcSartymreAugZUOGTMvzrqfarvmejSM2K3k7IdCH5jO4PSQrmIKuV2MW01yc1s1DGSAjD77jji2fJrbv/zg5az0CyiCrX0w2drBIOecGkXFVuHbFEicXpCoOm9ieek0JR7LALw5kRyDcQnacmvV1d4/vnX4lG0fm4XWtLNi/0Vf1pcI+K+Ew/JGEVJNelYB3SaUihjDlID0nRR8jgc2WytT4srylPlhrjqvdV5dFkTA3l5RzmlF1KvoGacEqUEgzSW8RvDg6akg3XsTAhlfumq3UAF44BJ7zSOV/Z4RrBAGYbYXTBZkI26trzUX9SiLuGEzZ5Q==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA62DymZvqPPXGFiq+d1ct/fhSOsUvFwxwfU8KkRTYMlApv8MDpg25X/PKyFwFDaHqKxzdkVRbeTuRdrkwRssRahxoXH4JTUhwviN+JrjSNw2saHdQEg/J4V/+p7PEmsAokXyYC0m/F9CO1EcyOMxjD4eU13f73KX7Ina9beOpDshjzzvW3jDrk1zS4q7C36uD8Ncn7dRlpTXCoJQSyBigxT4cJEvn9VX0z2Er5UZcz3JwJV/vDSUGjV+lNQECT5FsX1Glx/lSLuyIGrnRUiYjLNER0y3uO2gncQ198KN8GHH6SZzPOmq2KuR5iKNhUtPVXpcPic19BafPCTsoDyicmQ==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAvsdraiKK/2ngrGpYZjbU0leHFpeX9gWxB9epecYFDDNGyBkCQebQY1KAHQEWpRWijkUvhy7smNoGnhpTdI/P2g8v+h+p6UKdGd8dV54rjITYonGJQ0TGsCMVwaPQQckwjClHLY/UV/gP6JJurX1wNrjLugTV+ZXCBSrE6tC12qEjMpG/49ql8WtIb7uMwN3arhY/7DC5L6umWTw67gl096saq0fZ65LxsfjRTrWGnP+fikGtDgBYopE0cACDedKjw8v1+/pF+B4K3OL+hqRmgY+f/+dwPfPqZpYmd8lRnKY2cYVvv3a2CqrD7azj0+DTFO/n302puT6iUsvqQ/q01Q==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAzNrq260yIKNntEiIheoP6y8TWOf1zPjJJ3ZVy5rDvhtXaQzMFajQkKT54iRS6VZRQC4QB5H7DcT+NDanw7xkHMj44LA8qtiW9I5rFSu6XQIc1wxM0exuUD3R/qE9S1yker3QOTaaMiePmwOpN95ZtET6a1VFWCORxsxJ56mp3pgHryeMeEVJo17nSjXiodZ+DawM5YoAniRgWQSZXfu1eaNU/r8uHspwEl+kfFS7Bij0AL3jZj2fPJOSx2blHSYFEMQajE/DIQ/abeEkEFbYVrzJzVlEOONUCWQbixI+usySwrEJiNUDY2dij1OHwxONAUDF5maheVBQ1ceO9H5W4Q==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEApzAg5xAIS3kWxg1Sfs6iQ0kdb1221J75vs9tsFpfVgCefhYd4huBwXOZ3AQmcw2K4olGcwmbvYgZl17lXywJ0hlJ8HI9S9T34ooIj7NW9OBC03xTy98HxGON8++o3Youue7NaHIuQ2SG+m5R9bUKc2Zt7NxCP5f1Y4gDrSB6CDBUJ/53aEtfqynw2eAxvmG2ccRriFtLzyK8G/ylOSya2D34E1bET5Ca3s1rfO70iNg6z6Q9fYjRzXspDP+Fbk3JADa8YC2gtPEs4amOHtNvanvjwbGh/V5PqqoYrjomvLj4ksRkWEsPaXlgQR4A5+/0ng/mgpHB+TPCT3y914vPww==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAunpMQw/49hXvh1Lf4IWYecJVOatvD3rJ/VgyPtpxVAwaCNAeWp1nKCKy68SO+z1NWhDcjsyzOQTtI8fdAn992SZRq2KMHlWVlmV3w2bal0AiES5bKqJfb3jfHBI1nyKBSML3Z74gV9ytULMn6COgRPMuraJiFDC7L1A2JsKT4AmTYZ6QAoD0eAlQeHw3OYmSCp5ExTjVhlEwN0di497N63KcjjVs2BYqwwUBeOI6iB7MVkZ0+l/Waq2zhh0ayqWREJfIdAUvjf/vgvN3H3G7d7cWJNu42IVQlZHE2CwE9u5krKRi1L28iPleK/px2Ny/fRlGYMKplsf5GEct1OrxKw==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAxdP10RggBts2yKeOEqkPaPa2x12KWfzLWFTYcQ0IZhFEQK3VQFNDLg78jK6fNdzx1fuDlFR5Zp5ftOW9ltw/cXSgJE90jWKHFtGLljQoCsj0LreAXRGmqFzz7rVFCZYXYLwQjnyYvYXA/B/yfNpaDGVOUVievYxA12BS12s4FY5/+1bvkW1KlBdQvlPecFNyKHhEuxekwM/7TbHhBbberjqsxXKMANb3+IZ/JwNCmqlcPVz3iFE33NM8465852nNpOP1qmA32oE6UHxULqsaEPjGvF1GfsFw5235rgaYk+tLwQ2BMIsHUHLGFzR/HTud53E289itY0/JwTRRI9Ih2w==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAykMNkh+QNla1nVEtup9ZCAPF841jscTj/Jltp8U3mkL0YmCybrH1a92xtAJr1jHqERXzjmtjhdLcXhdW7f+O2OgeJWK/KXQXDoptHL8NQxnG3DF8R4pF93XbldAHaEhEiysmkKOLC1axan+iK16eC7Q0cwPhXdvUqF3cjUlcdi1coJIS9fXJczxzpnNlhBMHKOs7NK9QyPyhOXPmObHbLQfWnIowp3hJg4WBQk/s0zAAaXSzwVxoj8Hfz1UwzEMyDFKV9HPyu6i+zxGO6z01w4GnvMD7+Nmq3/ynJhooxxGboc5MmzKo8foedyzPHMXwigNNNRFHo0JLMnrooLjZSQ==
+    - ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAvCv77nf5C5eyzaFpojxIVxmHRDYzfpPfd/4c8rrvTJaeAJBCpnDgkoDNOO1r2VueEjK4rDLhwautumRfLk3k4E/t1Cngh+H1k1sfckPzjsrOfrVVMwG//h+F3Aon1HD1bMDTFQXVHkaavfMy/pCgc5pqR7/T14VxTpRf4LlP+ZYb5P3Q+zDsK3Y+MRkeECY4XSXjqX4w8RHYlgRTS/tHeXUlVQwaHwkXfPyEG9JBTq+Gc8ta4ZcXfFQ6M2WXDdnwpfiQpO7hHzqvhVgZyR0KbSGQQ+agwB+15qzDE4YnLwMsI5wx+AQGOALRhgvSRwES8aa2+hFx/l7pvWRrCrjcMw== bjeanes@g10506.cybergroupon.net
+

data/spec/pairmill/session/authorized_keys_file_spec.rb

@@ -0,0 +1,79 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+require 'fileutils'
+
+describe Pairmill::Session::AuthorizedKeysFile do
+  let(:member_keys) { FixtureHelper.user_keys }
+  let(:session) { "testing-session" }
+  let(:subject) { Pairmill::Session::AuthorizedKeysFile.new(member_keys, session) }
+
+  before do
+    subject.stub!(:backup_authorized_keys)
+    subject.stub!(:create_authorized_keys)
+    subject.stub!(:remove_existing_file)
+    subject.stub!(:move_backup_file)
+  end
+
+  describe "when instantiating an object" do
+    it "sets the instance member_keys value" do
+      subject.member_keys.should == member_keys
+    end
+
+    it "sets the key file path to the current user" do
+      subject.key_file_path.should == File.expand_path("~/.ssh/authorized_keys")
+    end
+  end
+
+  describe "key_file_exists?" do
+    it "is true when the key file path exists" do
+      File.should_receive(:exists?).with(subject.key_file_path).and_return(true)
+      subject.key_file_exists?.should be_true
+    end
+  end
+
+  describe "backup_key_file_exists?" do
+    it "is true when the backup key file path exists" do
+      File.should_receive(:exists?).with(subject.backup_key_file_path).and_return(true)
+      subject.backup_key_file_exists?.should be_true
+    end
+  end
+
+  describe "installing an authorized keys file" do
+    describe "when an existing file is present" do
+      it "is backed up" do
+        subject.stub!(:key_file_exists?).and_return(true)
+        subject.should_receive(:backup_authorized_keys)
+        subject.install
+      end
+
+      it "adds a new file" do
+        subject.should_receive(:create_authorized_keys)
+        subject.install
+      end
+    end
+
+    describe "when there is not an existing file" do
+      it "does not backup" do
+        subject.should_not_receive(:move_backup_file)
+        subject.install
+      end
+    end
+  end
+
+  describe "cleaning up an authorized keys file" do
+    before do
+      subject.stub!(:key_file_exists?).and_return(true)
+      subject.stub!(:backup_key_file_exists?).and_return(true)
+    end
+
+    it "removes the current authorized keys file" do
+      subject.should_receive(:remove_existing_file)
+      subject.cleanup
+    end
+
+    it "moves an existing backup key file" do
+      subject.should_receive(:move_backup_file)
+      subject.cleanup
+    end
+  end
+end

data/spec/pairmill/session/joined_session_spec.rb

@@ -0,0 +1,16 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe Pairmill::Session::JoinedSession do
+  let(:host) { "chad.pry@gmail.com" }
+  let(:name) { "testing-conference" }
+
+  describe "when instantiating an object" do
+    it "sets the host" do
+      Pairmill::Session::JoinedSession.new(host, name).host.should == host
+    end
+
+    it "sets the name" do
+      Pairmill::Session::JoinedSession.new(host, name).name.should == name
+    end
+  end
+end

data/spec/pairmill/session/session_spec.rb

@@ -0,0 +1,40 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+describe Pairmill::Session do
+  let(:host) { "chad.pry@gmail.com" }
+  let(:name) { "testing-conference" }
+
+#  describe "when joining a session" do
+#    describe "the returned session" do
+#      let(:joined_session) { Pairmill::Session::JoinedSession.new(host, name) }
+#
+#      before do
+#        Pairmill::Session::JoinedSession.stub!(:new).and_return(joined_session)
+#      end
+#
+#      it "starts a joined session" do
+#        joined_session.should_receive(:start!)
+#        Pairmill::Session.join(:host => host, :session_name => name)
+#      end
+#    end
+#  end
+
+  describe "starting a session" do
+    let(:session_json) { FixtureHelper.api_joined_session }
+
+    before do
+      Pairmill::Api.stub!(:join_session).and_return(session_json)
+    end
+
+    it "fetches a session from the api" do
+      session = Pairmill::Session::JoinedSession.new(host, name)
+      session.should_receive(:fetch_session_details)
+      session.start!
+    end
+    
+    it "returns a joined session instance" do
+      session = Pairmill::Session::JoinedSession.new(host, name)
+      session.should be_a(Pairmill::Session::JoinedSession)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'json'
+require 'fixture_helper'
+require 'pairmill'
+require 'pairmill/session'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: pair
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Bodaniel Jeanes
+- Chad W. Pry
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-11-26 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: &70280668289560 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *70280668289560
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70280668276060 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *70280668276060
+description: Effortless remote pairing
+email:
+- me@bjeanes.com
+- chad.pry@gmail.com
+executables:
+- pair
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rvmrc
+- Gemfile
+- Gemfile.lock
+- README.rdoc
+- Rakefile
+- bin/pair
+- lib/pair.rb
+- lib/pair/api.rb
+- lib/pair/command_line.rb
+- lib/pair/command_line/host.rb
+- lib/pair/session.rb
+- lib/pair/session/authorized_keys_file.rb
+- lib/pair/session/hosted_session.rb
+- lib/pair/session/tmux.rb
+- lib/pair/session/tunnel.rb
+- lib/pair/version.rb
+- pair.gemspec
+- spec/fixture_helper.rb
+- spec/fixtures/api_hosted_session.yml
+- spec/fixtures/api_joined_session.yml
+- spec/fixtures/user_keys.yml
+- spec/pairmill/session/authorized_keys_file_spec.rb
+- spec/pairmill/session/joined_session_spec.rb
+- spec/pairmill/session/session_spec.rb
+- spec/spec_helper.rb
+homepage: http://www.pairmill.com
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Pair with remote programmers with a single command.
+test_files:
+- spec/fixture_helper.rb
+- spec/fixtures/api_hosted_session.yml
+- spec/fixtures/api_joined_session.yml
+- spec/fixtures/user_keys.yml
+- spec/pairmill/session/authorized_keys_file_spec.rb
+- spec/pairmill/session/joined_session_spec.rb
+- spec/pairmill/session/session_spec.rb
+- spec/spec_helper.rb