thegarage-gitx 1.5.5.pre1 → 2.0.0.pre1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1b5057c596d4343322b8f10cb5cc5ffa5d88cc5d
-  data.tar.gz: 0a0d051f8550bf0e3570e900bfffa4c11bf17e29
+  metadata.gz: 5afd02a7ef9c6fc40e717fae217988d5b0eb0b0e
+  data.tar.gz: 980ae3bf2e94996ef6d1f14599ae7956a66b7c01
 SHA512:
-  metadata.gz: 363c8537bd5f8a1332a523532d4554f5b7ae72a7cab3c5e943eaf7dbd9239ab1bbe7baac6bc7a97aa8f8f8d86d1992c6c1c19e5bee3c9ed007ac0ce1ab6c28fb
-  data.tar.gz: a6263f625f0c130626419a035d90e8f64c6e7066ff738a1be3dfd3af4c6df791972aff7e81f96ad01859a1195977467d7c8d90827c11cfda5d08c045778d8f9a
+  metadata.gz: 48e0396c3a9d39952560d3a96caea10dedd64e9b0989da918863528a25969736073c7955fa1385d5aa0abe34104b579ab182e352ff2b34fa008c0ca8c0fe771d
+  data.tar.gz: 8fbb99c25f264ea137e5b6501ea4e8a565b7fdd39730b04d274764b41b8e051eb98bb17191783a4ddc4a4a81df56afbc62eace8eab65d8e63787f5e02b9a6c09

data/Guardfile

@@ -0,0 +1,8 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :rspec do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end

data/README.md

@@ -1,6 +1,8 @@
 # thegarage-gitx
 
 [![Build Status](https://travis-ci.org/thegarage/thegarage-gitx.png?branch=master)](https://travis-ci.org/thegarage/thegarage-gitx)
+[![Code Coverage](https://coveralls.io/repos/thegarage/thegarage-gitx/badge.png)](https://coveralls.io/r/thegarage/thegarage-gitx)
+[![Code Quality](https://codeclimate.com/github/thegarage/thegarage-gitx/badges)](https://codeclimate.com/github/thegarage/thegarage-gitx)
 
 Useful Git eXtensions for Development workflow at The Garage.
 

data/bin/git-buildtag

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['buildtag'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'buildtag_command.rb')
+args = ARGV.dup.unshift('buildtag')
+Thegarage::Gitx::Cli::BuildtagCommand.start(args)

data/bin/git-cleanup

@@ -1,4 +1,6 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['cleanup'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'cleanup_command.rb')
+args = ARGV.dup.unshift('cleanup')
+Thegarage::Gitx::Cli::CleanupCommand.start(args)
+

data/bin/git-integrate

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['integrate'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'integrate_command.rb')
+args = ARGV.dup.unshift('integrate')
+Thegarage::Gitx::Cli::IntegrateCommand.start(args)

data/bin/git-nuke

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['nuke'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'nuke_command.rb')
+args = ARGV.dup.unshift('nuke')
+Thegarage::Gitx::Cli::NukeCommand.start(args)

data/bin/git-release

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['release'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'release_command.rb')
+args = ARGV.dup.unshift('release')
+Thegarage::Gitx::Cli::ReleaseCommand.start(args)

data/bin/git-reviewrequest

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['reviewrequest'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'review_request_command.rb')
+args = ARGV.dup.unshift('reviewrequest')
+Thegarage::Gitx::Cli::ReviewReqeustCommand.start(args)

data/bin/git-share

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['share'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'share_command.rb')
+args = ARGV.dup.unshift('share')
+Thegarage::Gitx::Cli::ShareCommand.start(args)

data/bin/git-start

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['start'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'start_command.rb')
+args = ARGV.dup.unshift('start')
+Thegarage::Gitx::Cli::StartCommand.start(args)

data/bin/git-track

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['track'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'track_command.rb')
+args = ARGV.dup.unshift('track')
+Thegarage::Gitx::Cli::TrackCommand.start(args)

data/bin/git-update

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
 
-require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx', 'cli.rb')
-Thegarage::Gitx::CLI.start (['update'] + ARGV)
+require File.join(File.dirname(__FILE__), '..', 'lib', 'thegarage/gitx/cli', 'update_command.rb')
+args = ARGV.dup.unshift('update')
+Thegarage::Gitx::Cli::UpdateCommand.start(args)

data/lib/thegarage/gitx/cli/base_command.rb

@@ -0,0 +1,74 @@
+require 'thor'
+require 'pathname'
+require 'rugged'
+require 'English'
+require 'thegarage/gitx'
+
+module Thegarage
+  module Gitx
+    module Cli
+      class BaseCommand < Thor
+        include Thor::Actions
+
+        AGGREGATE_BRANCHES = %w( staging prototype )
+        RESERVED_BRANCHES = %w( HEAD master next_release ) + AGGREGATE_BRANCHES
+        add_runtime_options!
+
+        method_option :trace, :type => :boolean, :aliases => '-v'
+        def initialize(*args)
+          super(*args)
+          RestClient.proxy = ENV['HTTPS_PROXY'] if ENV.has_key?('HTTPS_PROXY')
+          RestClient.log = Logger.new(STDOUT) if options[:trace]
+        end
+
+        private
+
+        def repo
+          @repo ||= begin
+            path = Dir.pwd
+            root_path = Rugged::Repository.discover(path)
+            Rugged::Repository.new(root_path)
+          end
+        end
+
+        # lookup the current branch of the repo
+        def current_branch
+          repo.branches.find(&:head?)
+        end
+
+        # execute a shell command and raise an error if non-zero exit code is returned
+        # return the string output from the command
+        def run_cmd(cmd, options = {})
+          say "$ #{cmd}"
+          output = `#{cmd}`
+          success = $CHILD_STATUS.to_i == 0
+          fail "#{cmd} failed" unless success || options[:allow_failure]
+          output
+        end
+
+        def aggregate_branch?(branch)
+          AGGREGATE_BRANCHES.include?(branch)
+        end
+
+        def assert_not_protected_branch!(branch, action)
+          raise "Cannot #{action} reserved branch" if RESERVED_BRANCHES.include?(branch) || aggregate_branch?(branch)
+        end
+
+        # retrieve a list of branches
+        def branches(options = {})
+          branches = []
+          args = []
+          args << '-r' if options[:remote]
+          args << "--merged #{options[:merged].is_a?(String) ? options[:merged] : ''}" if options[:merged]
+          output = `git branch #{args.join(' ')}`.split("\n")
+          output.each do |branch|
+            branch = branch.gsub(/\*/, '').strip.split(' ').first
+            branch = branch.split('/').last if options[:remote]
+            branches << branch unless RESERVED_BRANCHES.include?(branch)
+          end
+          branches.uniq
+        end
+      end
+    end
+  end
+end

data/lib/thegarage/gitx/cli/buildtag_command.rb

@@ -0,0 +1,39 @@
+require 'thor'
+require 'thegarage/gitx'
+require 'thegarage/gitx/cli/base_command'
+
+module Thegarage
+  module Gitx
+    module Cli
+      class BuildtagCommand < BaseCommand
+        TAGGABLE_BRANCHES = %w( master staging )
+
+        desc 'buildtag', 'create a tag for the current Travis-CI build and push it back to origin'
+        def buildtag
+          branch = ENV['TRAVIS_BRANCH']
+          pull_request = ENV['TRAVIS_PULL_REQUEST']
+
+          raise "Unknown branch. ENV['TRAVIS_BRANCH'] is required." unless branch
+
+          if pull_request != 'false'
+            say "Skipping creation of tag for pull request: #{pull_request}"
+          elsif !TAGGABLE_BRANCHES.include?(branch)
+            say "Cannot create build tag for branch: #{branch}. Only #{TAGGABLE_BRANCHES} are supported."
+          else
+            label = "Generated tag from TravisCI build #{ENV['TRAVIS_BUILD_NUMBER']}"
+            create_build_tag(branch, label)
+          end
+        end
+
+        private
+
+        def create_build_tag(branch, label)
+          timestamp = Time.now.utc.strftime '%Y-%m-%d-%H-%M-%S'
+          git_tag = "build-#{branch}-#{timestamp}"
+          run_cmd "git tag #{git_tag} -a -m '#{label}'"
+          run_cmd "git push origin #{git_tag}"
+        end
+      end
+    end
+  end
+end

data/lib/thegarage/gitx/cli/cleanup_command.rb

@@ -0,0 +1,36 @@
+require 'thor'
+require 'thegarage/gitx'
+require 'thegarage/gitx/cli/base_command'
+
+module Thegarage
+  module Gitx
+    module Cli
+      class CleanupCommand < BaseCommand
+        desc 'cleanup', 'Cleanup branches that have been merged into master from the repo'
+        def cleanup
+          run_cmd "git checkout #{Thegarage::Gitx::BASE_BRANCH}"
+          run_cmd "git pull"
+          run_cmd 'git remote prune origin'
+
+          say "Deleting local and remote branches that have been merged into "
+          say Thegarage::Gitx::BASE_BRANCH, :green
+          merged_remote_branches.each do |branch|
+            run_cmd "git push origin --delete #{branch}"
+          end
+          merged_local_branches.each do |branch|
+            run_cmd "git branch -d #{branch}"
+          end
+        end
+      end
+
+      private
+      def merged_local_branches
+        branches(:merged => true).reject { |b| aggregate_branch?(b) }
+      end
+
+      def merged_remote_branches
+        branches(:merged => true, :remote => true).reject { |b| aggregate_branch?(b) }
+      end
+    end
+  end
+end

data/lib/thegarage/gitx/cli/integrate_command.rb

@@ -0,0 +1,40 @@
+require 'thor'
+require 'thegarage/gitx'
+require 'thegarage/gitx/cli/base_command'
+require 'thegarage/gitx/cli/update_command'
+
+module Thegarage
+  module Gitx
+    module Cli
+      class IntegrateCommand < BaseCommand
+        desc 'integrate', 'integrate the current branch into one of the aggregate development branches (default = staging)'
+        def integrate(target_branch = 'staging')
+          branch = current_branch.name
+          assert_not_protected_branch!(branch, 'integrate') unless aggregate_branch?(target_branch)
+          raise "Only aggregate branches are allowed for integration: #{AGGREGATE_BRANCHES}" unless aggregate_branch?(target_branch) || target_branch == Thegarage::Gitx::BASE_BRANCH
+
+          UpdateCommand.new.update
+
+          say "Integrating "
+          say "#{branch} ", :green
+          say "into "
+          say target_branch, :green
+
+          refresh_branch_from_remote target_branch
+          run_cmd "git pull . #{branch}"
+          run_cmd "git push origin HEAD"
+          run_cmd "git checkout #{branch}"
+        end
+
+        private
+
+        # nuke local branch and pull fresh version from remote repo
+        def refresh_branch_from_remote(target_branch)
+          run_cmd "git branch -D #{target_branch}", :allow_failure => true
+          run_cmd "git fetch origin"
+          run_cmd "git checkout #{target_branch}"
+        end
+      end
+    end
+  end
+end

data/lib/thegarage/gitx/cli/nuke_command.rb

@@ -0,0 +1,64 @@
+require 'thor'
+require 'thegarage/gitx'
+require 'thegarage/gitx/cli/base_command'
+
+module Thegarage
+  module Gitx
+    module Cli
+      class NukeCommand < BaseCommand
+        desc 'nuke', 'nuke the specified aggregate branch and reset it to a known good state'
+        method_option :destination, :type => :string, :aliases => '-d', :desc => 'destination branch to reset to'
+        def nuke(bad_branch)
+          good_branch = options[:destination] || ask("What branch do you want to reset #{bad_branch} to? (default: #{bad_branch})")
+          good_branch = bad_branch if good_branch.length == 0
+
+          last_known_good_tag = current_build_tag(good_branch)
+          return unless yes?("Reset #{bad_branch} to #{last_known_good_tag}? (y/n)", :green)
+          fail "Only aggregate branches are allowed to be reset: #{AGGREGATE_BRANCHES}" unless aggregate_branch?(bad_branch)
+          return if migrations_need_to_be_reverted?(bad_branch, last_known_good_tag)
+
+          say "Resetting "
+          say "#{bad_branch} ", :green
+          say "branch to "
+          say last_known_good_tag, :green
+
+          run_cmd "git checkout #{Thegarage::Gitx::BASE_BRANCH}"
+          run_cmd "git branch -D #{bad_branch}", :allow_failure => true
+          run_cmd "git push origin --delete #{bad_branch}", :allow_failure => true
+          run_cmd "git checkout -b #{bad_branch} #{last_known_good_tag}"
+          run_cmd "git push origin #{bad_branch}"
+          run_cmd "git branch --set-upstream-to origin/#{bad_branch}"
+          run_cmd "git checkout #{Thegarage::Gitx::BASE_BRANCH}"
+        end
+
+        private
+
+        def migrations_need_to_be_reverted?(bad_branch, last_known_good_tag)
+          return false unless File.exists?('db/migrate')
+          outdated_migrations = run_cmd("git diff #{last_known_good_tag}...#{bad_branch} --name-only db/migrate").split
+          return false if outdated_migrations.empty?
+
+          say "#{bad_branch} contains migrations that may need to be reverted.  Ensure any reversable migrations are reverted on affected databases before nuking.", :red
+          say 'Example commands to revert outdated migrations:'
+          outdated_migrations.reverse.each do |migration|
+            version = File.basename(migration).split('_').first
+            say "rake db:migrate:down VERSION=#{version}"
+          end
+          !yes?("Are you sure you want to nuke #{bad_branch}? (y/n) ", :green)
+        end
+
+        def current_build_tag(branch)
+          last_build_tag = build_tags_for_branch(branch).last
+          raise "No known good tag found for branch: #{branch}.  Verify tag exists via `git tag -l 'build-#{branch}-*'`" unless last_build_tag
+          last_build_tag
+        end
+
+        def build_tags_for_branch(branch)
+          run_cmd "git fetch --tags"
+          build_tags = run_cmd("git tag -l 'build-#{branch}-*'").split
+          build_tags.sort
+        end
+      end
+    end
+  end
+end

data/lib/thegarage/gitx/cli/release_command.rb

@@ -0,0 +1,31 @@
+require 'thor'
+require 'thegarage/gitx'
+require 'thegarage/gitx/cli/base_command'
+require 'thegarage/gitx/cli/update_command'
+require 'thegarage/gitx/cli/integrate_command'
+require 'thegarage/gitx/cli/cleanup_command'
+
+module Thegarage
+  module Gitx
+    module Cli
+      class ReleaseCommand < BaseCommand
+        desc 'release', 'release the current branch to production'
+        def release
+          return unless yes?("Release #{current_branch.name} to production? (y/n)", :green)
+
+          branch = current_branch.name
+          assert_not_protected_branch!(branch, 'release')
+          UpdateCommand.new.update
+
+          run_cmd "git checkout #{Thegarage::Gitx::BASE_BRANCH}"
+          run_cmd "git pull origin #{Thegarage::Gitx::BASE_BRANCH}"
+          run_cmd "git pull . #{branch}"
+          run_cmd "git push origin HEAD"
+
+          IntegrateCommand.new.integrate('staging')
+          CleanupCommand.new.cleanup
+        end
+      end
+    end
+  end
+end

data/lib/thegarage/gitx/cli/review_request_command.rb

@@ -0,0 +1,203 @@
+require 'thor'
+require 'thegarage/gitx'
+require 'thegarage/gitx/cli/base_command'
+require 'json'
+
+module Thegarage
+  module Gitx
+    module Cli
+      class ReviewRequestCommand < BaseCommand
+        CLIENT_URL = 'https://github.com/thegarage/thegarage-gitx'
+        PULL_REQUEST_FOOTER = <<-EOS.dedent
+          # Pull Request Protips(tm):
+          # * Include description of how this change accomplishes the task at hand.
+          # * Use GitHub flavored Markdown http://github.github.com/github-flavored-markdown/
+          # * Review CONTRIBUTING.md for recommendations of artifacts, links, images, screencasts, etc.
+          #
+          # This footer will automatically be stripped from the pull request description
+        EOS
+
+        desc "reviewrequest", "Create or update a pull request on github"
+        method_option :description, :type => :string, :aliases => '-d', :desc => 'pull request description'
+        method_option :assignee, :type => :string, :aliases => '-a', :desc => 'pull request assignee'
+        method_option :open, :type => :boolean, :aliases => '-o', :desc => 'open the pull request in a web browser'
+        # @see http://developer.github.com/v3/pulls/
+        def reviewrequest
+          fail 'Github authorization token not found' unless authorization_token
+
+          branch = current_branch.name
+          pull_request = find_pull_request(branch)
+          if pull_request.nil?
+            update
+            changelog = run_cmd "git log #{Thegarage::Gitx::BASE_BRANCH}...#{branch} --no-merges --pretty=format:'* %s%n%b'"
+            pull_request = create_pull_request(branch, changelog, options)
+            say 'Pull request created: '
+            say pull_request['html_url'], :green
+          end
+          assign_pull_request(pull_request, options[:assignee]) if options[:assignee]
+
+          run_cmd "open #{pull_request['html_url']}" if options[:open]
+        end
+
+        private
+
+        # returns [Hash] data structure of created pull request
+        # request github authorization token
+        # User-Agent is required
+        # store the token in local git config
+        # @returns [String] auth token stored in git (current repo, user config or installed global settings)
+        # @see http://developer.github.com/v3/oauth/#scopes
+        # @see http://developer.github.com/v3/#user-agent-required
+        def authorization_token
+          auth_token = repo.config['thegarage.gitx.githubauthtoken']
+          return auth_token unless auth_token.to_s.blank?
+
+          fail "Github user not configured.  Run: `git config --global github.user 'me@email.com'`" unless username
+          password = ask("Github password for #{username}: ", :echo => false)
+
+          client_name = "The Garage Git eXtensions - #{remote_origin_name}"
+          payload = {
+            :scopes => ['repo'],
+            :note => client_name,
+            :note_url => CLIENT_URL
+          }.to_json
+          response = RestClient::Request.new({
+            :url => "https://api.github.com/authorizations",
+            :method => "POST",
+            :user => username,
+            :password => password,
+            :payload => payload,
+            :headers => {
+              :accept => :json,
+              :content_type => :json,
+              :user_agent => 'thegarage/gitx'
+            }
+          }).execute
+          data = JSON.parse response.body
+          token = data['token']
+          repo.config['thegarage.gitx.githubauthtoken'] = token
+          token
+        rescue RestClient::Exception => e
+          process_error e
+        end
+
+        # @see http://developer.github.com/v3/pulls/
+        def create_pull_request(branch, changelog, options = {})
+          body = pull_request_body(changelog, options[:description])
+
+          say "Creating pull request for "
+          say "#{branch} ", :green
+          say "against "
+          say "#{Thegarage::Gitx::BASE_BRANCH} ", :green
+          say "in "
+          say remote_origin_name, :green
+
+          payload = {
+            :title => branch,
+            :base => Thegarage::Gitx::BASE_BRANCH,
+            :head => branch,
+            :body => body
+          }.to_json
+          response = RestClient::Request.new(:url => pull_request_url, :method => "POST", :payload => payload, :headers => request_headers).execute
+          pull_request = JSON.parse response.body
+
+          pull_request
+        rescue RestClient::Exception => e
+          process_error e
+        end
+
+        def assign_pull_request(pull_request, assignee)
+          say "Assigning pull request to "
+          say assignee, :green
+
+          branch = pull_request['head']['ref']
+          payload = {
+            :title => branch,
+            :assignee => assignee
+          }.to_json
+          RestClient::Request.new(:url => pull_request['issue_url'], :method => "PATCH", :payload => payload, :headers => request_headers).execute
+        rescue RestClient::Exception => e
+          process_error e
+        end
+
+        # @returns [Hash] data structure of pull request info if found
+        # @returns nil if no pull request found
+        def find_pull_request(branch)
+          head_reference = [remote_origin_name.split('/').first, branch].join(':')
+          params = {
+            head: head_reference,
+            state: 'open'
+          }
+          response = RestClient::Request.new(:url => pull_request_url, :method => "GET", :headers => request_headers.merge(params: params)).execute
+          data = JSON.parse(response.body)
+          data.first
+        rescue RestClient::Exception => e
+          process_error e
+        end
+
+        def process_error(e)
+          data = JSON.parse e.http_body
+          say "Github request failed: #{data['message']}", :red
+          throw e
+        end
+
+        def pull_request_url
+          "https://api.github.com/repos/#{remote_origin_name}/pulls"
+        end
+
+        def request_headers
+          {
+            :accept => :json,
+            :content_type => :json,
+            'Authorization' => "token #{authorization_token}"
+          }
+        end
+
+        # @returns [String] github username (ex: 'wireframe') of the current github.user
+        # @returns empty [String] when no github.user is set on the system
+        def username
+          repo.config['github.user']
+        end
+
+        # lookup the current repository of the PWD
+        # ex: git@github.com:socialcast/thegarage/gitx.git OR https://github.com/socialcast/thegarage/gitx.git
+        def remote_origin_name
+          remote = repo.config['remote.origin.url']
+          remote.to_s.gsub(/\.git$/,'').split(/[:\/]/).last(2).join('/')
+        end
+
+        def pull_request_body(changelog, description = nil)
+          description_template = []
+          description_template << "#{description}\n" if description
+          description_template << '### Changelog'
+          description_template << changelog
+          description_template << PULL_REQUEST_FOOTER
+
+          body = input_from_editor(description_template.join("\n"))
+          body.gsub(PULL_REQUEST_FOOTER, '').chomp.strip
+        end
+
+        # launch configured editor to retreive message/string
+        def input_from_editor(initial_text = '')
+          Tempfile.open('reviewrequest.md') do |f|
+            f << initial_text
+            f.flush
+
+            editor = repo.config['core.editor'] || ENV['EDITOR'] || 'vi'
+            flags = case editor
+            when 'mate', 'emacs', 'subl'
+              '-w'
+            when 'mvim'
+              '-f'
+            else
+              ''
+            end
+            pid = fork { exec([editor, flags, f.path].join(' ')) }
+            Process.waitpid(pid)
+            File.read(f.path)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/thegarage/gitx/cli/share_command.rb

@@ -0,0 +1,17 @@
+require 'thor'
+require 'thegarage/gitx'
+require 'thegarage/gitx/cli/base_command'
+
+module Thegarage
+  module Gitx
+    module Cli
+      class ShareCommand < BaseCommand
+        desc 'share', 'Share the current branch in the remote repository'
+        def share
+          run_cmd "git push origin #{current_branch.name}"
+          run_cmd "git branch --set-upstream-to origin/#{current_branch.name}"
+        end
+      end
+    end
+  end
+end