papa 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 71de33eed576744cad1400a5d795616b436d8146
-  data.tar.gz: e2a1e530d112d5c819d487c1804e31d119d76cdb
+  metadata.gz: 4e79d7aa5abd7759a7acee2ac1538c6f4b3bc69e
+  data.tar.gz: 7eb13ccb695d9c423d1b3f60dd552184ef86c705
 SHA512:
-  metadata.gz: 1e686d587e3b4d15b6a72da07663e270b97eef6f7bfa5e1c190a4ad234af3a558605005ad9805cb4ad849647f45070de2792fa692ac5cbb35950f56b804e9a76
-  data.tar.gz: f9f40abba6bddd80576d0d8a76b704262415430b712c42a34c207a45fe826d46f8337f7758d3698bec5bcc194eb441fa192047d29fbc1b4e91a7f1a5fb8436c7
+  metadata.gz: 807475a93bd68e8e520a7f069d38e1dee3c8e6491f81c21835140fa50af63e7f174994b69b5b2b2e82d6aeb7a5aa226063508ebbfe3f09fcc2911c0868879520
+  data.tar.gz: fd5289d8f9149e28666954a68def6ac64c9f1af26f5dfcdb3d1719a81244be2c2007e6720a5e046f18d3437e867ead2c6be84cea66d4079f570b1da898d474fc

data/CHANGELOG.md

@@ -1,11 +1,18 @@
 # Changelog
 
+## 0.3.0
+* Used open3 for easier output and exit status handling
+* Added more descriptive output messages
+* Prompt vi when no branches are specified in add
+* Improved sandbox path generation
+* Added `papa sandbox clean` to remove old generated sandbox directories
+
 ## 0.2.0
-* Added `integration [start]`
-* Added `deploy` via larga
+* Added `papa integration [start]`
+* Added `papa deploy` via larga
 * Hard reset local feature and bugfix branches to remote versions before adding
 
 ## 0.1.0
 * Initial release
-* Added `release [start, add, finish]`, `hotfix [start, add, finish]` and `sandbox [generate]` commands
+* Added `papa release [start, add, finish]`, `papa hotfix [start, add, finish]` and `papa sandbox [generate]` commands
 * Added simple error handling for some git commands for when they fail

data/README.md

@@ -1,39 +1,161 @@
-# Papa
+# Papa [![Gem Version](https://badge.fury.io/rb/papa.svg)](https://badge.fury.io/rb/papa) [![Build Status](https://travis-ci.org/b-ggs/papa.svg?branch=master)](https://travis-ci.org/b-ggs/papa) [![Maintainability](https://api.codeclimate.com/v1/badges/cec506e3421dc3e08eeb/maintainability)](https://codeclimate.com/github/b-ggs/papa/maintainability)
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/papa`. To experiment with that code, run `bin/console` for an interactive prompt.
+Helper tool for inDinero's git workflow. Ako ang papa mo.
 
-TODO: Delete this and the text above, and describe your gem
+## Contents
 
-## Installation
+* [Getting Started](#getting-started)
+* [Commands](#commands)
+	* [papa release](#papa-release)
+	* [papa hotfix](#papa-hotfix)
+	* [papa integration](#papa-integration)
+	* [papa deploy](#papa-deploy)
+	* [papa sandbox](#papa-sandbox)
 
-Add this line to your application's Gemfile:
+## Getting Started
 
-```ruby
-gem 'papa'
+Install `papa` from Rubygems.
+
+```
+$ gem install papa
+```
+
+That's it, you're ready to go!
+
+## Commands
+
+### `papa release`
+
+#### Starting a release branch
+
+This will create a new release branch based on the current `develop` branch. The release branch will be pushed to origin.
+
+```
+$ papa release start -v, --version=VERSION
+```
+
+###### Sample Usage:
+
+```
+$ papa release start -v 17.12.0
+```
+
+#### Adding feature branches to a release branch
+
+This will rebase all new feature branches from the release branch and then subsequently merge the updated feature branch into the release branch. The updated release branch will be pushed to origin.
+
+```
+$ papa release add -v, --version=VERSION [-b, --feature-branches=one two three]
 ```
 
-And then execute:
+If `--feature-branches` is not specified, it will prompt a vi session where you can enter the branch names separated by line breaks.
 
-    $ bundle
+##### Sample Usage:
 
-Or install it yourself as:
+If you want to specify the feature branches using `--feature-branches`:
 
-    $ gem install papa
+```
+$ papa release add -v 17.12.0 -b feature/1 feature/2 feature/3
+```
+
+If you want to use vi to specify the feature branches:
+
+```
+$ papa release add -v 17.12.0
+```
 
-## Usage
+#### Finishing a release branch
 
-TODO: Write usage instructions here
+The finished release branch will be merged to `master` and `develop`. The updated `master` and `develop` branches will be pushed to origin.
 
-## Development
+```
+$ papa release finish -v, --version=VERSION
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+##### Sample Usage:
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+```
+$ papa release finish -v 17.12.0
+```
 
-## Contributing
+### `papa hotfix`
+
+#### Starting a hotfix branch
+
+This will create a new hotfix branch based on the current `master` branch. The hotfix branch will be pushed to origin.
+
+```
+$ papa hotfix start -v, --version=VERSION
+```
+
+###### Sample Usage:
+
+```
+$ papa hotfix start -v 17.12.0
+```
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/b-ggs/papa.
+#### Adding bugfix branches to a hotfix branch
 
-## License
+This will rebase all new bugfix branches from the hotfix branch and then subsequently merge the updated bugfix branch into the release branch. The updated release branch will be pushed to origin.
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+```
+$ papa hotfix add -v, --version=VERSION [-b, --bugfix-branches=one two three]
+```
+
+If `--bugfix-branches` is not specified, it will prompt a vi session where you can enter the branch names separated by line breaks.
+
+##### Sample Usage:
+
+If you want to specify the bugfix branches using `--bugfix-branches`:
+
+```
+$ papa hotfix add -v 17.12.0 -b bugfix/1 bugfix/2 bugfix/3
+```
+
+If you want to use vi to specify the bugfix branches:
+
+```
+$ papa hotfix add -v 17.12.0
+```
+
+#### Finishing a hotfix branch
+
+The finished hotfix branch will be merged to `master` and `develop`. The updated `master` and `develop` branches will be pushed to origin.
+
+```
+$ papa release hotfix -v, --version=VERSION
+```
+
+##### Sample Usage:
+
+```
+$ papa release hotfix -v 17.12.0
+```
+
+### `papa integration`
+
+#### Starting an integration branch
+
+This will create a new integration branch based on the specified base branch. The integration branch will be pushed to origin.
+
+```
+$ papa integration start -b, --base-branch=BASE_BRANCH
+```
+
+##### Sample Usage:
+
+```
+$ papa integration start -b develop
+```
+
+### `papa deploy`
+
+### `papa sandbox`
+
+#### Generating a new sandbox
+
+This will generate a git repository that you can use to test out `papa`.
+
+```
+$ papa sandbox generate
+```

data/lib/papa.rb

@@ -1,11 +1,13 @@
 require 'thor'
 require 'papa/thor'
+require 'papa/string'
 require 'papa/version'
 require 'papa/cli'
 require 'papa/command'
 require 'papa/command_queue'
 require 'papa/git'
 require 'papa/output'
+require 'papa/helpers'
 
 module Papa
 end

data/lib/papa/cli/hotfix.rb

@@ -12,10 +12,10 @@ module Papa
 
     desc 'add', 'Add bugfix branches to a hotfix branch'
     option :version, aliases: '-v', required: true
-    option :bugfix_branches, aliases: '-b', type: :array, required: true
+    option :bugfix_branches, aliases: '-b', type: :array
     def add
       version = options[:version]
-      bugfix_branches = options[:bugfix_branches]
+      bugfix_branches = options[:bugfix_branches] || []
 
       require 'papa/common/add'
       require 'papa/hotfix/add'

data/lib/papa/cli/release.rb

@@ -12,10 +12,10 @@ module Papa
 
     desc 'add', 'Add feature branches to a release branch'
     option :version, aliases: '-v', required: true
-    option :feature_branches, aliases: '-b', type: :array, required: true
+    option :feature_branches, aliases: '-b', type: :array
     def add
       version = options[:version]
-      feature_branches = options[:feature_branches]
+      feature_branches = options[:feature_branches] || []
 
       require 'papa/common/add'
       require 'papa/release/add'

data/lib/papa/cli/sandbox.rb

@@ -2,11 +2,16 @@ module Papa
   class Sandbox < Thor
     desc 'generate', 'Generate a sandbox environment'
     option :override_origin, aliases: '-o'
+    option :override_path_prefix, aliases: '-p'
     def generate
-      override_origin = options[:override_origin]
-
       require 'papa/sandbox/generate'
-      Sandbox::Generate.new(override_origin: override_origin).run
+      Sandbox::Generate.new(options).run
+    end
+
+    desc 'clean', 'Clean up sandbox directories in /tmp'
+    def clean
+      require 'papa/sandbox/clean'
+      Sandbox::Clean.new.run
     end
   end
 end

data/lib/papa/command.rb

@@ -1,30 +1,27 @@
+require 'open3'
+
 module Papa
   class Command
-    attr_accessor :command, :output, :exit_status
+    attr_accessor :command, :stdout, :stderr, :exit_status, :silent
 
     def initialize(command, options = {})
       @command = command
-      @output = nil
-      @exit_status = nil
-      @output_redirect =
-        if options[:silent]
-          Output::REDIRECT_TO_NULL
-        else
-          ''
-        end
+      @silent = options.has_key?(:silent) ? options[:silent] : false
     end
 
     def run
-      return if @command.nil?
-      output = `#{@command} #{@output_redirect}`
-      exit_status = $?.exitstatus
-      @output = output
-      @exit_status = exit_status
+      return if command.nil?
+      Output.stdout "Running #{command.bold}..." unless silent
+      @stdout, @stderr, status = Open3.capture3(command)
+      @exit_status = status.exitstatus
       self
     end
 
     def failure_message
-      Output.stderr "ERROR: There was a problem running '#{command}'"
+      message = "Error while running #{command.bold}"
+      Output.error message
+      Output.error stderr
+      message
     end
 
     def cleanup
@@ -36,7 +33,7 @@ module Papa
     end
 
     def failed?
-      @exit_status != 0
+      exit_status != 0
     end
 
     private

data/lib/papa/command_queue.rb

@@ -1,6 +1,6 @@
 module Papa
   class CommandQueue
-    attr_accessor :queue
+    attr_accessor :queue, :last_command, :success, :last_error
 
     def initialize
       @queue = []
@@ -10,25 +10,18 @@ module Papa
       @queue.push command
     end
 
-    def list_queue
-      Output.stdout 'Running:'
-      @queue.each do |command|
-        Output.stdout "  #{command.command}"
-      end
-    end
-
     def run
-      success = true
-      list_queue
+      @success = true
+      message = nil
       @queue.each do |command|
         if command.run.failed?
-          success = false
+          @success = false
           command.cleanup
-          command.failure_message
+          @last_error = command.failure_message
           break
         end
       end
-      success
+      @success
     end
   end
 end

data/lib/papa/common/add.rb

@@ -1,12 +1,18 @@
 module Papa
   class Common::Add
     def run
+      check_branches
+
       @build_branch ||= "#{@build_type}/#{@version}"
 
       success = true
       @success_branches = []
+      @failed_branches = []
+
+      Output.stdout "Started adding branches to #{@build_branch.bold}."
 
-      @branches.each do |branch|
+      @branches.each_with_index do |branch, index|
+        Output.stdout "Adding branch #{branch.bold} (#{index + 1} of #{@branches.count})..."
         queue = CommandQueue.new
         queue.add Git.fetch(remote: 'origin')
         queue.add Git.checkout(branch_name: @build_branch)
@@ -17,47 +23,79 @@ module Papa
         queue.add Git.checkout(branch_name: @build_branch)
         queue.add Git.merge(branch_name: branch)
         queue.add Git.push(remote: 'origin', branch_name: @build_branch)
+
         if queue.run
           @success_branches << branch
         else
+          failed_branch = {
+            branch: branch,
+            message: queue.last_error
+          }
+          @failed_branches << failed_branch
           success = false
         end
       end
 
-      cleanup
+      success_message
+      failure_message
 
-      success_message if !@success_branches.empty?
-
-      if !success
-        failure_message
+      if success
+        success_cleanup
+      else
+        failure_cleanup
         exit 1
       end
     end
 
     private
 
-    def success_message
-      Output.stdout "Successfully added these branches to #{@build_branch}:"
-      @success_branches.each do |branch|
-        Output.stdout "  #{branch}"
-      end
+    def check_branches
+      return unless @branches.empty?
+      require 'papa/helpers/vi'
+      vi_file_helper = Helpers::Vi.new
+      @branches = vi_file_helper.run
     end
 
-    def cleanup
+    def success_cleanup
       queue = CommandQueue.new
       @branches.each { |branch| queue.add Git.delete_branch(branch_name: branch) }
       queue.run
     end
 
+    def success_message
+      return if @success_branches.empty?
+      output = ''
+      output << "Successfully added these branches to #{@build_branch}:\n"
+      @success_branches.each_with_index do |branch, index|
+        output << "  #{index + 1}.) #{branch}\n"
+      end
+      Output.success output
+    end
+
+    def failure_cleanup
+    end
+
     def failure_message
-      failed_branches = @branches - @success_branches
+      return if @failed_branches.empty?
+
+      output = ''
 
-      Output.stderr "Failed to add these branches to #{@build_branch}:"
-      failed_branches.each do |branch|
-        Output.stderr "  #{branch}"
+      output << "Failed to add these branches to #{@build_branch}:\n"
+      @failed_branches.each_with_index do |failed_branch, index|
+        branch = failed_branch[:branch]
+        message = failed_branch[:message]
+        output << "  #{index + 1}.) #{branch}\n"
+        output << "      - #{message}\n"
       end
-      Output.stderr 'When the above problems are resolved, you can re-run this with:'
-      Output.stderr "  papa #{@build_type} add -v #{@version} -b #{failed_branches.join(' ')}"
+
+      output << "\n"
+
+      branch_names = @failed_branches.map { |f| f[:branch] }
+
+      output << "When the above problems are resolved, you can re-run this with:\n"
+      output << "  papa #{@build_type} add -v #{@version} -b #{branch_names.join(' ')}"
+
+      Output.failure output
     end
   end
 end

data/lib/papa/common/start.rb

@@ -3,13 +3,14 @@ module Papa
     def run
       @build_branch ||= "#{@build_type}/#{@version}"
 
-      queue = CommandQueue.new
-      queue.add Git.fetch(remote: 'origin')
-      queue.add Git.checkout(branch_name: @base_branch)
-      queue.add Git.branch(branch_name: @build_branch)
-      queue.add Git.checkout(branch_name: @build_branch)
-      queue.add Git.push(remote: 'origin', branch_name: @build_branch)
-      if queue.run
+      @queue = CommandQueue.new
+      @queue.add Git.fetch(remote: 'origin')
+      @queue.add Git.checkout(branch_name: @base_branch)
+      @queue.add Git.branch(branch_name: @build_branch)
+      @queue.add Git.checkout(branch_name: @build_branch)
+      @queue.add Git.push(remote: 'origin', branch_name: @build_branch)
+
+      if @queue.run
         success_message
       else
         failure_message
@@ -20,11 +21,11 @@ module Papa
     private
 
     def success_message
-      Output.stdout "Successfully started new #{@build_type} branch #{@build_branch}"
+      Output.success "Successfully started new #{@build_type} branch #{@build_branch}"
     end
 
     def failure_message
-      Output.stderr "There was a problem starting #{@build_type} branch: #{@build_branch}"
+      Output.failure "There was a problem starting #{@build_type} branch: #{@build_branch}"
     end
   end
 end

data/lib/papa/git/checkout.rb

@@ -8,7 +8,9 @@ module Papa
 
     def failure_message
       super
-      Output.stderr "ERROR: Branch #{@branch_name} doesn't exist."
+      message = "Failed to checkout #{@branch_name.bold}. Check whether this branch exists."
+      Output.error message
+      message
     end
   end
 end

data/lib/papa/git/fetch.rb

@@ -1,13 +1,16 @@
 module Papa
   class Git::Fetch < Command
     def initialize(remote)
+      @remote = remote
       command = "git fetch #{remote}"
       super(command)
     end
 
     def failure_message
       super
-      Output.stderr 'ERROR: Make sure origin exists and you have a working Internet connection'
+      message = "Failed to fetch from #{@remote}. Please check your internet connection and try again."
+      Output.stderr message
+      message
     end
   end
 end

data/lib/papa/git/merge.rb

@@ -21,7 +21,9 @@ module Papa
 
     def failure_message
       super
-      Output.stderr "ERROR: A merge conflict occurred while merging #{@branch_name} into #{current_branch}"
+      message = "Failed to merge #{@branch_name} into #{current_branch}. Merge conflict?"
+      Output.error message
+      message
     end
   end
 end

data/lib/papa/git/rebase.rb

@@ -21,7 +21,9 @@ module Papa
 
     def failure_message
       super
-      Output.stderr "ERROR: There was a problem rebasing #{current_branch} from #{@base_branch_name}"
+      message = "Failed to rebase #{current_branch} from #{@base_branch_name}. Merge conflict?"
+      Output.error message
+      message
     end
   end
 end

data/lib/papa/helpers.rb

@@ -0,0 +1,4 @@
+module Papa
+  class Helpers
+  end
+end

data/lib/papa/helpers/path.rb

@@ -0,0 +1,27 @@
+require 'securerandom'
+
+module Papa
+  class Helpers::Path
+    TMP_PATH = '/tmp/'
+    VI_PREFIX = 'papa-vi-'
+    SANDBOX_PREFIX = 'papa-sandbox-'
+
+    def self.generate_vi_file_path
+      File.join(TMP_PATH, VI_PREFIX + uuid_gen + '.txt')
+    end
+
+    def self.generate_sandbox_path(type, options = {})
+      path =
+        if options.has_key?('override_path_prefix')
+          options[:override_path_prefix] + '-' + type
+        else
+          SANDBOX_PREFIX + type + '-' +  uuid_gen
+        end
+      File.join(TMP_PATH, path)
+    end
+
+    def self.uuid_gen
+      SecureRandom.uuid
+    end
+  end
+end

data/lib/papa/helpers/vi.rb

@@ -0,0 +1,60 @@
+require 'papa/helpers/path'
+
+module Papa
+  class Helpers::Vi
+    attr_accessor :path, :branches
+
+    def initialize
+      @path = Helpers::Path.generate_vi_file_path
+      @branches = []
+    end
+
+    def run
+      initialize_file
+      prompt_vi
+      read_from_file
+      delete_file
+      validate_branches
+      branches
+    end
+
+    private
+
+    def initialize_file
+      content = <<-CONTENT
+# Add your branches here. One branch name per line.
+# Lines starting in pound (#) will be ignored
+# Sample:
+# feature/1-add-butterfree-gem
+# feature/2-add-beedrill-gem
+      CONTENT
+      File.open(path, 'w') { |file| file.write(content) }
+    end
+
+    def prompt_vi
+      system('vi', path)
+    end
+
+    def read_from_file
+      @branches = File.read(path).chomp.split("\n").map do |branch|
+        branch.strip!
+        if branch.empty? || branch[0] == '#'
+          nil
+        else
+          branch
+        end
+      end.compact
+    end
+
+    def delete_file
+      Command.new("rm #{path}", silent: true).run
+    end
+
+    def validate_branches
+      if @branches.empty?
+        Output.failure 'No branches specified.'
+        exit 1
+      end
+    end
+  end
+end

data/lib/papa/output.rb

@@ -1,13 +1,43 @@
+require 'date'
+
 module Papa
   class Output
     REDIRECT_TO_NULL = '> /dev/null 2>&1'
 
     def self.stdout(message, options = {})
-      puts message
+      puts build_output(message)
     end
 
     def self.stderr(message, options = {})
-      STDERR.puts message
+      STDERR.puts build_output(message)
+    end
+
+    def self.error(message)
+      stderr("ERROR: #{message}")
+    end
+
+    def self.success(message)
+      puts
+      puts message.strip.green
+    end
+
+    def self.failure(message)
+      STDERR.puts
+      STDERR.puts message.strip.red
+    end
+
+    def self.failure_reason(messages)
+      messages.each do |message|
+        STDERR.puts "  #{message}"
+      end
+    end
+
+    def self.build_output(message)
+      "[#{timestamp}] - #{message}"
+    end
+
+    def self.timestamp
+      DateTime.now.strftime('%H:%M:%S')
     end
   end
 end

data/lib/papa/sandbox/clean.rb

@@ -0,0 +1,17 @@
+require 'papa/helpers/path'
+
+module Papa
+  class Sandbox::Clean
+    attr_accessor :options
+
+    def initialize(options = {})
+      @options = options
+    end
+
+    def run
+      Output.stdout('Started cleaning sandbox directories...') unless options[:silent]
+      Command.new("rm -rf #{Helpers::Path::SANDBOX_PREFIX}*").run
+      Output.success('Successfully removed sandbox directories.')
+    end
+  end
+end

data/lib/papa/sandbox/generate.rb

@@ -1,11 +1,13 @@
+require 'papa/helpers/path'
+
 module Papa
   class Sandbox::Generate
-    attr_accessor :remote_repository_directory, :local_repository_directory, :git_details
+    attr_accessor :remote_path, :local_path, :git_details, :options
 
     def initialize(options = {})
       @options = options
-      @remote_repository_directory = '/tmp/papa_sandbox_remote_repository'
-      @local_repository_directory = '/tmp/papa_sandbox_local_repository'
+      @remote_path = Helpers::Path.generate_sandbox_path('remote', options)
+      @local_path = Helpers::Path.generate_sandbox_path('local', options)
       @git_details = [
         {
           commit: 'APP-1 - Add butterfree gem',
@@ -45,8 +47,8 @@ module Papa
       ]
     end
 
-    def run(options = {})
-      Output.stdout('Generating sandbox...') unless options[:silent]
+    def run
+      Output.stdout('Started generation of sandbox...') unless options[:silent]
       @project_directory = File.expand_path(File.dirname(__dir__))
       @branches_directory = File.join @project_directory, 'sandbox', 'branches'
       setup_remote_repository
@@ -61,46 +63,46 @@ module Papa
     end
 
     def temp_gemfile_path
-      File.join @local_repository_directory, 'Gemfile'
+      File.join @local_path, 'Gemfile'
     end
 
     def setup_remote_repository
-      if @options[:override_origin]
-        create_local_repository_directory
+      if options[:override_origin]
+        create_local_path
         initialize_local_repository
         remove_old_branches_from_origin
       else
-        create_remote_repository_directory
+        create_remote_path
         initialize_remote_repository
-        create_local_repository_directory
+        create_local_path
         clone_remote_repository
       end
     end
 
-    def create_local_repository_directory
-      Command.new("rm -rf #{@local_repository_directory}").run
-      Dir.mkdir @local_repository_directory
+    def create_local_path
+      Command.new("rm -rf #{@local_path}", options).run
+      Dir.mkdir @local_path
     end
 
     def initialize_local_repository
-      Dir.chdir @local_repository_directory
-      Command.new('git init').run
-      Command.new("git remote add origin #{@options[:override_origin]}").run
+      Dir.chdir @local_path
+      Command.new('git init', options).run
+      Command.new("git remote add origin #{options[:override_origin]}", options).run
     end
 
-    def create_remote_repository_directory
-      Command.new("rm -rf #{@remote_repository_directory}").run
-      Dir.mkdir @remote_repository_directory
+    def create_remote_path
+      Command.new("rm -rf #{@remote_path}", options).run
+      Dir.mkdir @remote_path
     end
 
     def initialize_remote_repository
-      Dir.chdir @remote_repository_directory
-      Command.new('git init --bare').run
+      Dir.chdir @remote_path
+      Command.new('git init --bare', options).run
     end
 
     def clone_remote_repository
-      Command.new("git clone #{@remote_repository_directory} #{@local_repository_directory}", silent: true).run
-      Dir.chdir @local_repository_directory
+      Command.new("git clone #{@remote_path} #{@local_path}", options).run
+      Dir.chdir @local_path
     end
 
     def setup_local_repository
@@ -121,7 +123,7 @@ module Papa
 
     def initialize_master_and_develop
       [
-        "cp #{gemfile_path('master')} #{@local_repository_directory}",
+        "cp #{gemfile_path('master')} #{@local_path}",
         'git add .',
         'git commit -m "Initial commit"',
         'git push origin master --force',
@@ -141,7 +143,7 @@ module Papa
           "git checkout #{base_branch}",
           "git checkout -b #{branch}",
           "rm #{temp_gemfile_path}",
-          "cp #{gemfile_path(branch)} #{@local_repository_directory}",
+          "cp #{gemfile_path(branch)} #{@local_path}",
           "git add .",
           "git commit -m \"#{commit}\"",
           "git push origin #{branch} --force"
@@ -159,10 +161,7 @@ module Papa
     end
 
     def success_message
-      Output.stdout <<-STDOUT
-Your sandbox is now available at:
-  #{@local_repository_directory}
-      STDOUT
+      Output.success "Your sandbox is now available at:\n  #{@local_path}"
     end
 
     def override_origin(origin)

data/lib/papa/string.rb

@@ -0,0 +1,27 @@
+# Color overrides for terminal output (ref: https://stackoverflow.com/a/16363159)
+
+class String
+  def black;          "\e[30m#{self}\e[0m" end
+  def red;            "\e[31m#{self}\e[0m" end
+  def green;          "\e[32m#{self}\e[0m" end
+  def brown;          "\e[33m#{self}\e[0m" end
+  def blue;           "\e[34m#{self}\e[0m" end
+  def magenta;        "\e[35m#{self}\e[0m" end
+  def cyan;           "\e[36m#{self}\e[0m" end
+  def gray;           "\e[37m#{self}\e[0m" end
+
+  def bg_black;       "\e[40m#{self}\e[0m" end
+  def bg_red;         "\e[41m#{self}\e[0m" end
+  def bg_green;       "\e[42m#{self}\e[0m" end
+  def bg_brown;       "\e[43m#{self}\e[0m" end
+  def bg_blue;        "\e[44m#{self}\e[0m" end
+  def bg_magenta;     "\e[45m#{self}\e[0m" end
+  def bg_cyan;        "\e[46m#{self}\e[0m" end
+  def bg_gray;        "\e[47m#{self}\e[0m" end
+
+  def bold;           "\e[1m#{self}\e[22m" end
+  def italic;         "\e[3m#{self}\e[23m" end
+  def underline;      "\e[4m#{self}\e[24m" end
+  def blink;          "\e[5m#{self}\e[25m" end
+  def reverse_color;  "\e[7m#{self}\e[27m" end
+end

data/lib/papa/version.rb

@@ -1,3 +1,3 @@
 module Papa
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: papa
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - boggs
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-09-11 00:00:00.000000000 Z
+date: 2017-11-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -101,6 +101,9 @@ files:
 - lib/papa/git/fetch.rb
 - lib/papa/git/merge.rb
 - lib/papa/git/rebase.rb
+- lib/papa/helpers.rb
+- lib/papa/helpers/path.rb
+- lib/papa/helpers/vi.rb
 - lib/papa/hotfix/add.rb
 - lib/papa/hotfix/finish.rb
 - lib/papa/hotfix/start.rb
@@ -121,7 +124,9 @@ files:
 - lib/papa/sandbox/branches/feature/7-add-pidgeot-gem/Gemfile
 - lib/papa/sandbox/branches/master/Gemfile
 - lib/papa/sandbox/branches/patch/17.8.0/3-add-pidgey-gem/Gemfile
+- lib/papa/sandbox/clean.rb
 - lib/papa/sandbox/generate.rb
+- lib/papa/string.rb
 - lib/papa/thor.rb
 - lib/papa/version.rb
 - papa.gemspec