loca 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1d72e91059bc88a4090bd9eb2c6c8f1e45c13704
+  data.tar.gz: e8fda9734eaf1fc2446fdb85490e792db395d6ee
+SHA512:
+  metadata.gz: 71eb60e85d247ce2ee9e14905c685283632262618815a1dccf80af8039a449302f0945af2b40f144358e84ecad73129d72f1adac0183bbd48f6bd4439da611b3
+  data.tar.gz: 129bf8eb437ae3a064b5f9a77e284738eb961f8f6a55ba4c9390b6eba4a91623a73b8664fe200394dd414c083ca6b1e0d16ae348dba6686656889555455258ec

data/bin/loca

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'loca'
+
+Loca::CLI.start(ARGV)

data/lib/loca.rb

@@ -0,0 +1,14 @@
+# Require all runtime dependencies first
+require 'thor'
+require 'colorize'
+require 'mixlib/shellout'
+require 'addressable/uri'
+
+# Start by requiring files with no dependencies on other files, then files with
+# only external gem runtime dependencies (specified above), then files with
+# dependencies on other files within the loca project itself
+require 'loca/version'
+require 'loca/error'
+require 'loca/url'
+require 'loca/git'
+require 'loca/cli'

data/lib/loca/cli.rb

@@ -0,0 +1,47 @@
+module Loca
+  class CLI < Thor
+    include Thor::Actions # https://github.com/erikhuda/thor/wiki/Actions
+
+    map %w(--version -v) => :__print_version
+
+    desc '--version, -v', 'print the version'
+    def __print_version
+      puts Loca::VERSION
+    end
+
+    desc 'c URL', 'Check out a pull request locally'
+    method_option :delete, aliases: '-d', desc: 'Delete the branch instead of creating it'
+    def c(pasted_url)
+      return d(pasted_url) if options[:delete]
+
+      git = Loca::Git.new(pasted_url)
+      branch_name = git.branch_name
+
+      if git.first_time_creating? || yes?("WARN: Branch '#{branch_name}' "\
+        ' already exists. Overwrite? (n)', :yellow)
+        git.fetch
+        git.checkout
+        say "Checked out #{branch_name}!", :green
+      else
+        fail Loca::Error::GitAborted, 'Git checkout aborted!'
+      end
+    end
+
+    desc 'd URL', 'Delete the local branch for that URL'
+    def d(pasted_url)
+      git = Loca::Git.new(pasted_url)
+      branch_name = git.branch_name
+
+      git.delete
+      say "Deleted #{branch_name}!", :green
+    end
+
+    private # rubocop:disable Lint/UselessAccessModifier
+
+    no_commands do # Thor primitive(s) that we want to stub in RSpec
+      def yes?(*args)
+        super
+      end
+    end
+  end
+end

data/lib/loca/error.rb

@@ -0,0 +1,21 @@
+# Using http://ablogaboutcode.com/2011/01/03/using-custom-error-messages-for-cleaner-code/
+# and http://www.simonewebdesign.it/how-to-set-default-message-exception/
+module Loca
+  module Error
+    class Base < StandardError
+      def initialize(message)
+        # To get the message in red
+        $stderr.puts message.red
+        @message = message
+      end
+    end
+
+    InvalidURL = Class.new(Base)
+
+    GitStdErrDetected = Class.new(Base)
+    UnstashedFilesFound = Class.new(Base)
+    OnlyOneBranch = Class.new(Base)
+    RemoteNotSet = Class.new(Base)
+    GitAborted = Class.new(Base)
+  end
+end

data/lib/loca/git.rb

@@ -0,0 +1,117 @@
+module Loca
+  class Git
+    include Thor::Actions
+
+    attr_reader :branch_name
+
+    def initialize(url, remote = nil)
+      @url = Loca::URL.new(url)
+      @branch_name = @url.branch_name
+
+      ensure_git_repo
+      ensure_no_unstashed_files
+      @remote_name = remote || extract_remote_name
+    end
+
+    def delete
+      # Cannot delete a branch you are currently on:
+      checkout_another_branch if @branch_name == current_branch
+      git "branch -D #{@branch_name}"
+    end
+
+    def checkout
+      git "checkout #{@branch_name}", false # prints to stderr for some reason
+    end
+
+    def fetch
+      # To avoid fatal error: Refusing to fetch into current branch
+      delete unless first_time_creating?
+      # Performs `git fetch upstream pull/PR_NUMBER/head:BRANCH_NAME`
+      git "fetch #{@remote_name} pull/#{@url.pr_num}/head:#{@branch_name}", false # shellout has stderr for some reason
+    end
+
+    def first_time_creating? # Keep this a public method so we can prompt the user for overwrite
+      branches.include?(@branch_name) ? false : true
+    end
+
+    # Example
+    #
+    # git_match_http?("https://github.com/smoll/loca.git", "https://github.com/smoll/loca/pull/1")
+    # => true
+    def git_match_http?(git, http)
+      format = lambda do |uri| # Strip off uri scheme & trailing '.git'
+        uri.sub('https://', '')
+        .sub('http://', '')
+        .sub('git://', '')
+        .sub(/.git$/, '')
+      end
+      format.call(http).start_with?(format.call(git))
+    end
+
+    private
+
+    def git(cmd, fail_on_stderr = true)
+      shellout = Mixlib::ShellOut.new "git #{cmd}"
+      shellout.run_command
+      return shellout.stdout if shellout.stderr.empty?
+      if fail_on_stderr
+        fail Loca::Error::GitStdErrDetected, "#{shellout.stderr.strip}"
+      else
+        $stderr.puts shellout.stderr.strip.yellow
+      end
+      shellout.stdout.strip
+    end
+
+    def branches
+      git("for-each-ref refs/heads/ --format='%(refname:short)'").split("\n")
+    end
+
+    def current_branch
+      git('rev-parse --abbrev-ref HEAD').strip
+    end
+
+    def ensure_git_repo
+      git 'rev-parse'
+    end
+
+    def ensure_no_unstashed_files
+      val = git 'status --porcelain'
+      fail Loca::Error::UnstashedFilesFound, 'Commit or stash your files before continuing!' unless val.empty?
+    end
+
+    def checkout_another_branch
+      another = branches.find { |branch| branch != current_branch }
+      fail Loca::Error::OnlyOneBranch, 'No other branch to checkout!' unless another
+      git "checkout #{another}", false # prints to stderr for some reason
+    end
+
+    def remote_mapping
+      names = git('remote show -n').split("\n")
+      mapping = {}
+      names.each do |name|
+        mapping[name] = git("config --get remote.#{name}.url").strip
+      end
+      mapping
+    end
+
+    def extract_remote_name
+      match = remote_mapping.find { |_name, url| git_match_http?(url, @url.to_s) }
+      unless match
+        if yes?("Remote #{(@url)} not set. Would you like to set it as 'auto_loca_remote'?")
+          set_remote
+        else
+          fail Loca::Error::RemoteNotSet, "You must set the repo (#{@url}) as a remote "\
+          "(see `git remote -v'). All remotes: #{remote_mapping}"
+        end
+      end
+      match.first
+    end
+
+    def set_remote
+      uri = Addressable::URI.parse(@url)
+      uri.path = uri.path.split('/')[0..2].join('/')
+      remote_url = "#{uri}.git"
+      git "remote add upstream #{remote_url}"
+    end
+  end
+end

data/lib/loca/url.rb

@@ -0,0 +1,37 @@
+module Loca
+  class URL
+    attr_reader :branch_name
+    attr_reader :pr_num
+
+    def initialize(url)
+      @url = url
+      ensure_well_formed
+
+      @branch_name = extract_branch_name
+      @pr_num = extract_pr_num
+    end
+
+    def to_s
+      @url
+    end
+
+    def ensure_well_formed
+      # TODO: add more checks via Addressable::URI
+      segments = URI(@url).path.split('/')
+      int = Integer(segments[-1]) rescue false # replace with coercible gem?
+      pull = segments[-2] == 'pull'
+
+      fail Loca::Error::InvalidURL, "Doesn't appear to be a well-formed URL: #{@url}" unless int && pull
+    end
+
+    private
+
+    def extract_branch_name
+      "PULL_#{extract_pr_num}"
+    end
+
+    def extract_pr_num
+      URI(@url).path.split('/').last
+    end
+  end
+end

data/lib/loca/version.rb

@@ -0,0 +1,3 @@
+module Loca
+  VERSION = '0.0.1'
+end

data/spec/e2e/github_spec.rb

@@ -0,0 +1,43 @@
+describe 'Checking out a GitHub PR locally' do
+  let(:pr_url) { 'https://github.com/octocat/Spoon-Knife/pull/4865' }
+  let(:expected_branch_name) { 'PULL_4865' }
+
+  before(:each) do
+    clone_test_repo
+    cd_to_cloned_dir
+  end
+
+  after(:each) { teardown }
+
+  context "the repo exists as the 'upstream' remote" do
+    before(:each)  { set_upstream }
+
+    it 'checks out then deletes' do
+      shellout! "loca c #{pr_url}"
+      expect(current_branch.strip).to eq expected_branch_name
+      shellout! "loca c #{pr_url} -d"
+      expect(current_branch.strip).to_not eq expected_branch_name
+    end
+
+    it 'checks out then prompts to overwrite' do
+      shellout! "loca c #{pr_url}"
+      expect(current_branch.strip).to eq expected_branch_name
+      shellout! "loca c #{pr_url}", input: 'yes'
+      expect(current_branch.strip).to eq expected_branch_name
+    end
+  end
+
+  context 'the repo does not exist as a remote' do
+    it 'fails to checkout' do
+      expect { shellout! "loca c #{pr_url}" }.to raise_error
+      expect(current_branch.strip).to_not eq expected_branch_name
+    end
+  end
+
+  context 'the wrong URL is supplied' do
+    it 'fails to checkout' do
+      expect { shellout! 'loca c https://github.com/octocat/Spoon-Knife/wrong/4865' }.to raise_error
+      expect(current_branch.strip).to_not eq expected_branch_name
+    end
+  end
+end

data/spec/loca/cli_spec.rb

@@ -0,0 +1,69 @@
+describe Loca::CLI do
+  let(:invalid_url) { 'https://github.com/fakez/fakezz/pull/1' }
+  let(:url) { 'https://github.com/smoll/loca/pull/1' }
+  subject { described_class.new }
+
+  before do # ensure we don't shell out to git
+    allow_any_instance_of(Loca::Git).to receive(:fetch)
+    allow_any_instance_of(Loca::Git).to receive(:checkout)
+  end
+
+  describe 'c' do
+    it 'fetches and checks out the branch locally' do
+      expect_any_instance_of(Loca::Git).to receive(:branch_name).and_return 'PULL_1'
+      expect_any_instance_of(Loca::Git).to receive(:first_time_creating?).and_return true
+
+      output = capture(:stdout) { described_class.start(%W(c #{url})) }.strip
+      expect(output).to end_with 'Checked out PULL_1!'
+    end
+
+    it 'fetches and overwrites existing branch if the user says yes to overwrite' do
+      expect_any_instance_of(Loca::Git).to receive(:branch_name).and_return 'PULL_1'
+      expect_any_instance_of(Loca::Git).to receive(:first_time_creating?).and_return false
+      silence(:stdout) { allow_any_instance_of(described_class).to receive(:yes?).and_return true }
+
+      output = capture(:stdout) { described_class.start(%W(c #{url})) }.strip
+      expect(output).to end_with 'Checked out PULL_1!'
+    end
+
+    it 'raises an error when the branch exists and the user says no to overwrite' do
+      expect_any_instance_of(Loca::Git).to receive(:branch_name).and_return 'PULL_1'
+      expect_any_instance_of(Loca::Git).to receive(:first_time_creating?).and_return false
+      silence(:stdout) { allow_any_instance_of(described_class).to receive(:yes?).and_return false }
+
+      expect { silence(:stderr) { described_class.start(%W(c #{url})) } }.to raise_error
+    end
+
+    it 'raises an error when an invalid repo is supplied' do
+      expect { silence(:stderr) { described_class.start(%W(c #{invalid_url})) } }.to raise_error
+    end
+
+    it 'deletes when the delete flag is appended' do
+      expect_any_instance_of(Loca::Git).to receive(:branch_name).and_return 'PULL_1'
+      expect_any_instance_of(Loca::Git).to receive(:delete)
+
+      output = capture(:stdout) { described_class.start(%W(c #{url} -d)) }.strip
+      expect(output).to eq 'Deleted PULL_1!'
+    end
+  end
+
+  describe 'd' do
+    it 'deletes' do
+      expect_any_instance_of(Loca::Git).to receive(:branch_name).and_return 'PULL_1'
+      expect_any_instance_of(Loca::Git).to receive(:delete)
+
+      output = capture(:stdout) { described_class.start(%W(d #{url})) }.strip
+      expect(output).to eq 'Deleted PULL_1!'
+    end
+
+    it 'raises an error when an invalid repo is supplied' do
+      expect { silence(:stderr) { described_class.start(%W(d #{invalid_url})) } }.to raise_error
+    end
+  end
+
+  describe '--version' do
+    it 'returns the correct version' do
+      expect(capture(:stdout) { described_class.start(%w(-v)) }.strip).to eq(Loca::VERSION)
+    end
+  end
+end

data/spec/loca/git_spec.rb

@@ -0,0 +1,152 @@
+describe Loca::Git do
+  let(:pid) { 1 } # Pull request ID
+  let(:url) { "https://github.com/smoll/loca/pull/#{pid}" }
+  let(:remote_name) { 'loca-fake-remote' }
+  let(:remote_url) { 'https://github.com/smoll/loca.git' }
+  subject { described_class.new(url, remote_name) }
+
+  let(:expected_branch_name) { "PULL_#{pid}" }
+  let(:branches_without_expected) { ['master'] }
+  let(:branches_with_expected) { branches_without_expected << expected_branch_name }
+
+  describe '#git' do # private method that shells out to git
+    it 'raises an error when an invalid git command is supplied' do
+      expect { capture(:stderr) { subject.send(:git, 'not-a-git-command') } }.to raise_error
+    end
+
+    it 'prints to stderr when an invalid git command is supplied, but we do not want to fail on stderr' do
+      output = capture(:stderr) { subject.send(:git, 'not-a-git-command', false) }
+      expect(output).to include "git: 'not-a-git-command' is not a git command"
+    end
+  end
+
+  describe '#branches' do # private method
+    it 'returns all local branches' do
+      cmd = "for-each-ref refs/heads/ --format='%(refname:short)'"
+      expect(subject).to receive(:git).with(cmd).and_return 'a_branch'
+      expect(subject.send(:branches)).to eq ['a_branch']
+    end
+  end
+
+  describe '#remote_mapping' do # private method
+    it "returns all of the repo's remotes" do
+      expect(subject).to receive(:git).with('remote show -n').and_return remote_name
+      expect(subject).to receive(:git).with("config --get remote.#{remote_name}.url").and_return remote_url
+      expect(subject.send(:remote_mapping)).to eq(remote_name => remote_url)
+    end
+  end
+
+  describe '#extract_remote_name' do # private method
+    it 'returns the local repo remote name corresponding to the Pull Request URL' do
+      expect(subject).to receive(:remote_mapping).and_return(remote_name => remote_url) # investigate this
+
+      expect(subject.send(:extract_remote_name)).to eq remote_name
+    end
+  end
+
+  describe '#current_branch' do # private method
+    it 'returns the current branch' do
+      expect(subject).to receive(:git).with('rev-parse --abbrev-ref HEAD').and_return "branch_name\n"
+      expect(subject.send(:current_branch)).to eq 'branch_name'
+    end
+  end
+
+  describe '#checkout' do # private method
+    it 'checks out the expected branch' do
+      expect(subject).to receive(:git).with("checkout #{expected_branch_name}", false).once
+      subject.send(:checkout)
+    end
+  end
+
+  describe '#checkout_another_branch' do # private method
+    it 'checks out a branch that is not the current one' do
+      allow(subject).to receive(:branches).and_return %w(branch1 branch2)
+      allow(subject).to receive(:current_branch).and_return 'branch1'
+      expect(subject).to receive(:git).with('checkout branch2', false).once
+      silence(:stdout) { subject.send(:checkout_another_branch) }
+    end
+
+    it 'raises an error when there is no other branch to check out' do
+      allow(subject).to receive(:branches).and_return ['branch1']
+      allow(subject).to receive(:current_branch).and_return 'branch1'
+
+      expect { silence(:stderr) { subject.send(:checkout_another_branch) } }.to raise_error
+    end
+  end
+
+  describe '#fetch' do
+    before do
+      allow(subject).to receive(:git) # ensure we don't actually shell out to `git`
+    end
+
+    it 'deletes before fetching when the branch already exists' do
+      allow(subject).to receive(:branches).and_return branches_with_expected
+      expect(subject).to receive(:delete).once
+
+      subject.fetch
+    end
+
+    it 'fetches the remote pull request' do
+      allow(subject).to receive(:branches).and_return branches_without_expected
+
+      # Investigate why this git command prints to $stderr, i.e. we must pass false as the 2nd arg:
+      expect(subject).to receive(:git).with("fetch #{remote_name} pull/#{pid}/head:#{expected_branch_name}", false)
+
+      subject.fetch
+    end
+  end
+
+  describe '#delete' do # should attempt to delete a branch with name 'PULL_1'
+    it 'raises an error when the branch does not exist' do
+      allow(subject).to receive(:branches).and_return branches_without_expected
+      expect { silence(:stderr) { subject.delete } }.to raise_error
+    end
+
+    it 'deletes the branch when it exists' do
+      allow(subject).to receive(:branches).and_return branches_with_expected
+      allow(subject).to receive(:current_branch).and_return('master')
+      expect(subject).to receive(:git).with("branch -D #{expected_branch_name}").once
+
+      subject.delete
+    end
+
+    it 'checks out another branch if attempting to delete current branch' do
+      allow(subject).to receive(:branches).and_return branches_with_expected
+      allow(subject).to receive(:current_branch).and_return expected_branch_name
+
+      expect(subject).to receive(:checkout_another_branch).once
+      expect(subject).to receive(:git).with("branch -D #{expected_branch_name}").once
+
+      subject.delete
+    end
+  end
+
+  describe '#first_time_creating?' do
+    it 'returns false when the branch already exists' do
+      allow(subject).to receive(:branches).and_return branches_with_expected
+      expect(subject.first_time_creating?).to eq false
+    end
+
+    it 'returns true when the branch does not exist' do
+      allow(subject).to receive(:branches).and_return branches_without_expected
+      expect(subject.first_time_creating?).to eq true
+    end
+  end
+
+  describe '#git_match_http?' do
+    it 'returns true when matching urls are supplied' do
+      git_url = 'https://github.com/smoll/loca.git'
+      expect(subject.git_match_http?(git_url, url)).to eq true
+    end
+
+    it 'returns true when different URI schemes but matching urls are supplied' do
+      git_url = 'git://github.com/smoll/loca.git'
+      expect(subject.git_match_http?(git_url, url)).to eq true
+    end
+
+    it 'returns false when non-matching urls are supplied' do
+      git_url = 'git://github.com/someoneelse/loca.git'
+      expect(subject.git_match_http?(git_url, url)).to eq false
+    end
+  end
+end

data/spec/loca/url_spec.rb

@@ -0,0 +1,47 @@
+describe Loca::URL do
+  let(:pid) { 1 } # Pull request ID
+  let(:url) { "https://github.com/smoll/loca/pull/#{pid}" }
+  subject { described_class.new(url) }
+
+  let(:expected_branch_name) { "PULL_#{pid}" }
+  let(:expected_pr_num) { pid.to_s }
+
+  describe '#initialize' do
+    it 'does not raise an error for a valid URL' do
+      expect { Loca::URL.new(url) }.to_not raise_error
+    end
+    # it 'does not raise an error for a GitHub PR URL with additional segments' do
+    #   expect { Loca::URL.new("#{url}/something/something") }.to_not raise_error # TODO: technical improvement
+    # end
+    it 'raises an error for a non-URL' do
+      expect { silence(:stderr) { Loca::URL.new('not a URL') } }.to raise_error
+    end
+    it 'raises an error for a non-GitHub URL' do
+      expect { silence(:stderr) { Loca::URL.new('http://bad-url-here.com') } }.to raise_error
+    end
+    it 'raises an error for a GitHub non-PR URL' do
+      expect { silence(:stderr) { Loca::URL.new('https://github.com/smoll/loca/something/something') } }.to raise_error
+    end
+    it 'raises an error for a GitHub URL without an integer in the PID location' do
+      expect { silence(:stderr) { Loca::URL.new('https://github.com/smoll/loca/pull/NaN') } }.to raise_error
+    end
+  end
+
+  describe '#to_s' do
+    it 'returns the url passed to the constructor' do
+      expect(subject.to_s).to eq url
+    end
+  end
+
+  describe '#extract_branch_name' do # private method
+    it 'returns the expected branch name' do
+      expect(subject.send(:extract_branch_name)).to eq expected_branch_name
+    end
+  end
+
+  describe '#extract_pr_num' do # private method
+    it 'returns the expected branch name' do
+      expect(subject.send(:extract_pr_num)).to eq "#{pid}"
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,84 @@
+# Using https://raw.githubusercontent.com/bbatsov/rubocop/master/spec/spec_helper.rb as a guide
+require 'simplecov'
+require 'coveralls'
+require 'codeclimate-test-reporter'
+
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter,
+  CodeClimate::TestReporter::Formatter
+]
+SimpleCov.start
+
+require 'bundler/setup'
+Bundler.setup # From http://stackoverflow.com/a/4402193
+
+require 'loca'
+
+# 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|
+  config.include Features::GitHubHelper
+
+  config.order = :random
+
+  config.expect_with :rspec do |expectations|
+    expectations.syntax = :expect # Disable `should`
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.syntax = :expect # Disable `should_receive` and `stub`
+    mocks.verify_partial_doubles = true # Avoid La La Land,
+    # read http://wegowise.github.io/blog/2014/09/03/rspec-verifying-doubles/
+  end
+
+  config.before do
+    ARGV.replace []
+  end
+
+  # From https://raw.githubusercontent.com/erikhuda/thor/master/spec/helper.rb
+  # Captures the output for analysis later
+  #
+  # @example Capture `$stderr`
+  #
+  #     output = capture(:stderr) { $stderr.puts "this is captured" }
+  #
+  # @param [Symbol] stream `:stdout` or `:stderr`
+  # @yield The block to capture stdout/stderr for.
+  # @return [String] The contents of $stdout or $stderr
+  # rubocop:disable Lint/Eval
+  def capture(stream)
+    begin
+      stream = stream.to_s
+      eval "$#{stream} = StringIO.new"
+      yield
+      result = eval("$#{stream}").string
+    ensure
+      eval("$#{stream} = #{stream.upcase}")
+    end
+
+    result
+  end
+  # rubocop:enable Lint/Eval
+
+  # This code was adapted from Ruby on Rails, available under MIT-LICENSE
+  # Copyright (c) 2004-2013 David Heinemeier Hansson
+  def silence_warnings
+    old_verbose, $VERBOSE = $VERBOSE, nil
+    yield
+  ensure
+    $VERBOSE = old_verbose
+  end
+
+  # Silences the output stream
+  #
+  # @example Silence `$stdout`
+  #
+  #     silence(:stdout) { $stdout.puts "hi" }
+  #
+  # @param [IO] stream The stream to use such as $stderr or $stdout
+  # @return [nil]
+  alias :silence :capture # rubocop:disable Style/Alias
+end

data/spec/support/features/github_helper.rb

@@ -0,0 +1,55 @@
+require 'mixlib/shellout'
+require 'fileutils'
+
+module Features
+  module GitHubHelper
+    def teardown
+      return_to_original_wd
+      FileUtils.rm_rf absolute_path
+    end
+
+    def cd_to_cloned_dir
+      @original_wd = Dir.pwd
+      Dir.chdir(absolute_path)
+    end
+
+    def return_to_original_wd
+      Dir.chdir(@original_wd)
+    end
+
+    def clone_test_repo
+      shellout! "git clone https://github.com/smoll/Spoon-Knife ./#{rel_path}"
+    end
+
+    def set_upstream
+      shellout! 'git remote add upstream https://github.com/octocat/Spoon-Knife.git'
+    end
+
+    def current_branch
+      shellout! 'git rev-parse --abbrev-ref HEAD'
+    end
+
+    def shellout!(cmd, opts = {})
+      opts = {
+        input: nil
+      }.merge(opts)
+      sh = opts[:input].nil? ? Mixlib::ShellOut.new(cmd.to_s) : Mixlib::ShellOut.new(cmd.to_s, input: opts[:input].to_s)
+      sh.run_command
+
+      sh.error! if opts[:input].nil? # NOTE: CLI exits non-zero if waiting on user input
+      sh.stdout
+    end
+
+    private
+
+    def rel_path
+      absolute_path.split(Dir.pwd.to_s)[1].sub('/', '')
+    end
+
+    def absolute_path
+      path = File.expand_path('../../../tmp/cloned', __FILE__)
+      FileUtils.mkdir_p path
+      path
+    end
+  end
+end

metadata

@@ -0,0 +1,224 @@
+--- !ruby/object:Gem::Specification
+name: loca
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- smoll
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.5
+- !ruby/object:Gem::Dependency
+  name: mixlib-shellout
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.7
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.29.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.29.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.9
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.9
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.6
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+description: 
+email:
+- mollah@gmail.com
+executables:
+- loca
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/loca
+- lib/loca.rb
+- lib/loca/cli.rb
+- lib/loca/error.rb
+- lib/loca/git.rb
+- lib/loca/url.rb
+- lib/loca/version.rb
+- spec/e2e/github_spec.rb
+- spec/loca/cli_spec.rb
+- spec/loca/git_spec.rb
+- spec/loca/url_spec.rb
+- spec/spec_helper.rb
+- spec/support/features/github_helper.rb
+homepage: https://github.com/smoll/loca
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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.6
+signing_key: 
+specification_version: 4
+summary: CLI for checking out GitHub Pull Requests locally
+test_files:
+- spec/e2e/github_spec.rb
+- spec/loca/cli_spec.rb
+- spec/loca/git_spec.rb
+- spec/loca/url_spec.rb
+- spec/spec_helper.rb
+- spec/support/features/github_helper.rb