Skip to content

Commit

Permalink
[Issue reenhanced#149] Fix for PR ending as "Closed" instead of "Merg…
Browse files Browse the repository at this point in the history
…ed" - Calling Github API to Squash Merge the PR as opposed doing it manually
  • Loading branch information
simonzhu24 committed May 3, 2016
1 parent 7925721 commit 18d6d36
Show file tree
Hide file tree
Showing 11 changed files with 252 additions and 284 deletions.
119 changes: 62 additions & 57 deletions README.rdoc
Original file line number Diff line number Diff line change
Expand Up @@ -205,45 +205,32 @@ You kick butt. You've got your code reviewed and now you're ready to merge it do
Reflow's +deliver+ requires you to have a pull request, so you'll be protected on those mornings when the coffee isn't working yet.
We built this <b>to get in your way and make you follow the process</b>. If you don't like it, do it by hand. You already know what you're doing.

You'll be presented with a prefilled commit message based on the body of your pull request which includes the text <code>Closes #XX</code> that will automatically close the associated pull request on github when deliver completes.
You'll be presented with a prefilled commit message based on the body of your pull request with references to the pull request and reviewers.

Make a mistake and deliver too early? It happens. You'll be prompted after you edit your commit message if you want to push your updated +master+ to github. If you answer 'n', then you'll want to do <code>git reset --hard origin/master</code> and checkout your branch again.
Want to clean up your feature branch afterwards? You'll be prompted after you edit your commit message if you want to clean up your +feature_branch+ on github. If you answer 'n', then your feature_branch will exist for you to clean it up later.

This is what it looks like:

$ git reflow deliver
From github.com:reenhanced/gitreflow
* branch master -> FETCH_HEAD
Merging pull request #36: 'Enforce at least one LGTM before delivery', from 'reenhanced:nh-fail-without-lgtm' into 'reenhanced:master'
Switched to branch 'master'
From github.com:reenhanced/gitreflow
Merging pull request #36: 'test-a-a', from 'simonzhu24:test-a-a' into 'simonzhu24:master'
#<Net::HTTPOK 200 OK readbody=true>

[success] Pull Request successfully merged.
Would you like to cleanup your feature branch? Y
git pull origin master
remote: Counting objects: 1, done.
remote: Total 1 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (1/1), done.
From https://github.com/simonzhu24/test
* branch master -> FETCH_HEAD
Already up-to-date.
Switched to branch 'nh-fail-without-lgtm'
Switched to branch 'master'
Updating c2ec1b1..f90e111
Fast-forward
Squash commit -- not updating HEAD
lib/git_reflow.rb | 71 +++++++++++++++++++++++++++----------------------------
1 file changed, 35 insertions(+), 36 deletions(-)
[master d1b4dd5] Enforces LGTM before deliver, even with no comments.
1 file changed, 35 insertions(+), 36 deletions(-)
Merge complete!
Would you like to push this branch to your remote repo and cleanup your feature branch? y
Counting objects: 7, done.
Delta compression using up to 16 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (4/4), 1.38 KiB, done.
Total 4 (delta 2), reused 0 (delta 0)
To [email protected]:reenhanced/gitreflow.git
c2ec1b1..d1b4dd5 master -> master

To [email protected]:reenhanced/gitreflow.git
- [deleted] nh-fail-without-lgtm

Deleted branch nh-fail-without-lgtm (was f90e111).
a549abf..4f089a9 master -> origin/master
Merge made by the 'recursive' strategy.
git branch -D test-a-a
error: Cannot delete the branch 'test-a-a' which you are currently on.

Nice job buddy.
This is what the default commit message looks like:

This is what the default commit message looks like:
Enforces LGTM before deliver, even with no comments.
Removes the need to review the pull request yourself if you make a
comment.
Expand Down Expand Up @@ -274,29 +261,42 @@ This is what we do behind the scenes when you do +deliver+

If not, show a list of authors that need to provide a +LGTM+.

If the review is done, it's time to merge. Here's what happens:
* If the review is done, it's time to merge. Here's what happens:

First, update our local +master+ so we don't get conflicts
git checkout master
git pull origin master
First, we use the github_api gem to merge the pull request.

Next, squash merge our feature branch
git merge --squash nh-branch-name

Now, we'll apply a little magic so we have a great commit message by default. Your editor will open and you'll see a nice default for your commit message based on the pull request body.
We call the public API for:

Once you've saved the commit, prompt the user to see if we should continue
Merge complete!
Would you like to push this branch to your remote repo and cleanup your feature branch?
github.pull_requests.merge 'user-name', 'repo-name', 'number', payload

Please take a look at lib/git_reflow/git_server/git_hub/pull_request.rb:102-107 for an example of the call.
This call makes an HTTP request using the Github API to merge the available pull request passing in the user name, repository name, pull request number, and some additional data in the payload.

The payload contains data in the following format:

data = {
"commit_title",
"commit_message",
"sha",
"squash"
}

Notice "squash" is set to true, meaning that we will do a squash-merge for each pull request.

For more detailed documentation, please read: https://github.com/piotrmurach/github/blob/master/lib/github_api/client/pull_requests.rb#L197

* Next, we prompt you if you want to deploy and cleanup
Would you like cleanup your feature branch?

If 'y', then we'll push to +master+ and delete the feature branch
git push origin master
git push origin :nh-branch-name
git branch -D nh-branch-name
If 'y', then we'll update the +base+ and delete the feature branch

git pull origin #{base_branch}
git push origin :#{feature_branch}
git branch -D #{feature_branch}

If 'n', then just stop here. The user can reset his local +master+.
If 'n', then just stop here. The user can clean up his branch locally.

And we're done.
And we're done.

== Guiding principles:
* Your workflow should resemble the following:
Expand All @@ -321,22 +321,27 @@ http://reenhanced.com/images/reflow.png

* If you make a new commit in your branch, you require another review.

* All participants in a pull request must approve the pull request.
If 2 people comment, you need 2 'LGTM's before the code is ready to merge.
* Depending on the minimumApprovals that you specify in your ~/.gitconfig.reflow (created upon reflow setup), you can have the following:

"" : All participants in a pull request must approve the pull request.
"0": 0 approvals required for you to merge PR.
"1": You need a minimum of 1 LGTM and the last comment on your PR must be an LGTM.
"2": You need a minimum of 2 LGTM and the last comment on your PR must be an LGTM.
...

* Once approved, your feature branch is squash merged to master.
This makes the history of the master branch extremely clean and easy to follow.
* Once approved, your feature branch is squash merged to your base_branch.
This makes the history of the base_branch branch extremely clean and easy to follow.

* Git blame becomes your friend. You'll know who to blame and can see the full context of changes.
Squash commits to master mean every commit represents the whole feature, not a "typo fix".
Squash commits to base_branch mean every commit represents the whole feature, not a "typo fix".


== Configuration

In order to streamline delivery you can set the following git config to
always push the branch after merge and clean up the feature branch.
always clean up the feature branch after the PR is merged

git config --global --add "reflow.always-deploy-and-cleanup" "true"
git config --global --add "reflow.always-cleanup" "true"


---
Expand Down
39 changes: 13 additions & 26 deletions lib/git_reflow.rb
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@
require 'git_reflow/os_detector'
require 'git_reflow/sandbox'
require 'git_reflow/git_helpers'
require 'git_reflow/merge_error'

module GitReflow
include Sandbox
Expand Down Expand Up @@ -107,42 +108,28 @@ def deliver(options = {})
feature_branch = current_branch
base_branch = options['base'] || 'master'

update_current_branch
fetch_destination(base_branch)
update_destination(feature_branch)

begin
existing_pull_request = git_server.find_open_pull_request( :from => current_branch, :to => base_branch )

if existing_pull_request.nil?
say "No pull request exists for #{remote_user}:#{current_branch}\nPlease submit your branch for review first with \`git reflow review\`", :deliver_halted
else

commit_message = if "#{existing_pull_request.description}".length > 0
existing_pull_request.description
else
"#{get_first_commit_message}"
end

if existing_pull_request.good_to_merge?(force: options['skip_lgtm'])
puts "Merging pull request ##{existing_pull_request.number}: '#{existing_pull_request.title}', from '#{existing_pull_request.feature_branch_name}' into '#{existing_pull_request.base_branch_name}'"

update_destination(base_branch)
merge_feature_branch(feature_branch,
:destination_branch => base_branch,
:pull_request_number => existing_pull_request.number,
:lgtm_authors => existing_pull_request.approvals,
:message => commit_message)
committed = run_command_with_label 'git commit', with_system: true
begin
existing_pull_request.merge!(destination_branch: base_branch)

if committed
say "Merge complete!", :success
say "Pull Request successfully merged.", :success

# check if user always wants to push and cleanup, otherwise ask
always_deploy_and_cleanup = GitReflow::Config.get('reflow.always-deploy-and-cleanup') == "true"
deploy_and_cleanup = always_deploy_and_cleanup || (ask "Would you like to push this branch to your remote repo and cleanup your feature branch? ") =~ /^y/i
always_cleanup = GitReflow::Config.get('reflow.always-cleanup') == "true"
cleanup = always_cleanup || (ask "Would you like to cleanup your feature branch? ") =~ /^y/i

if deploy_and_cleanup
if cleanup
# Pulls merged changes from remote base_branch
run_command_with_label "git pull origin #{base_branch}"
run_command_with_label "git push origin #{base_branch}"
run_command_with_label "git push origin :#{feature_branch}"
run_command_with_label "git branch -D #{feature_branch}"
Expand All @@ -151,9 +138,9 @@ def deliver(options = {})
puts "Cleanup halted. Local changes were not pushed to remote repo.".colorize(:red)
puts "To reset and go back to your branch run \`git reset --hard origin/#{base_branch} && git checkout #{feature_branch}\`"
end
else
say "There were problems commiting your feature... please check the errors above and try again.", :error
end
rescue GitReflow::GitServer::MergeError => error
say error.inspect, :deliver_halted
end
else
say existing_pull_request.rejection_message, :deliver_halted
end
Expand Down Expand Up @@ -185,7 +172,7 @@ def deploy(destination_server)
end

def git_server
@git_server ||= GitServer.connect provider: GitReflow::Config.get('reflow.git-server').strip, silent: true
@git_server ||= GitServer.connect provider: "#{GitReflow::Config.get('reflow.git-server')}".strip, silent: true
end

end
4 changes: 4 additions & 0 deletions lib/git_reflow/commands/setup.rb
Original file line number Diff line number Diff line change
Expand Up @@ -25,5 +25,9 @@
GitReflow::Config.add "constants.minimumApprovals", ask("Set the minimum number of approvals (leaving blank will require approval from all commenters): "), local: reflow_options[:project_only]
GitReflow::Config.add "constants.approvalRegex", GitReflow::GitServer::PullRequest::DEFAULT_APPROVAL_REGEX, local: reflow_options[:project_only]

say("Enter the follow information associated with your remote repository: (The information is used to run 'git reflow deliver'.")
# Sets the user's github auth token
GitReflow::Config.set "github.oauth-token", ask("Set the your local github authorization token: (You cannot run 'git reflow deliver' without it!) "), local: reflow_options[:project_only]
say("Thanks! Your settings are saved to #{GitReflow::Config::CONFIG_FILE_PATH}.")
end
end
19 changes: 0 additions & 19 deletions lib/git_reflow/git_helpers.rb
Original file line number Diff line number Diff line change
Expand Up @@ -61,25 +61,6 @@ def update_feature_branch(options = {})
run_command_with_label "git merge #{base_branch}"
end

def merge_feature_branch(feature_branch_name, options = {})
options[:destination_branch] ||= 'master'

message = "#{options[:message]}"

if "#{options[:pull_request_number]}".length > 0
message << "\nCloses ##{options[:pull_request_number]}\n"
end

if lgtm_authors = Array(options[:lgtm_authors]) and lgtm_authors.any?
message << "\nLGTM given by: @#{lgtm_authors.join(', @')}\n"
end

run_command_with_label "git checkout #{options[:destination_branch]}"
run_command_with_label "git merge --squash #{feature_branch_name}"

append_to_squashed_commit_message(message) if message.length > 0
end

def append_to_squashed_commit_message(message = '')
tmp_squash_message_path = "#{git_root_dir}/.git/tmp_squash_msg"
squash_message_path = "#{git_root_dir}/.git/SQUASH_MSG"
Expand Down
2 changes: 1 addition & 1 deletion lib/git_reflow/git_server/bit_bucket/pull_request.rb
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ def approvals

approved
end

end
end
end
Expand Down
43 changes: 43 additions & 0 deletions lib/git_reflow/git_server/git_hub/pull_request.rb
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,49 @@ def approved?
end
end

def merge!(options = {})
options[:destination_branch] ||= 'master'
feature_branch_name = GitReflow.current_branch

commit_message = if "#{self.description}".length > 0
self.description
else
"#{GitReflow.get_first_commit_message}"
end

if "#{self.number}".length > 0
commit_message << "\nMerges ##{self.number}\n"
end

if lgtm_authors = Array(self.approvals) and lgtm_authors.any?
commit_message << "\nLGTM given by: @#{lgtm_authors.join(', @')}\n"
end

data = {
"commit_title" => "#{self.title}",
"commit_message" => "#{commit_message}",
"sha" => "#{self.head.sha}",
"squash" => true
}

merge_response = GitReflow::GitServer::GitHub.connection.pull_requests.merge(
"#{GitReflow.git_server.class.remote_user}",
"#{GitReflow.git_server.class.remote_repo_name}",
"#{self.number}",
data
)

if merge_response.success?
append_to_squashed_commit_message(commit_message) if commit_message.length > 0
else
if merge_response.has_key?(:message)
raise MergeError.new(merge_response.message)
else
raise MergeError.new(merge_response.to_s)
end
end
end

def build
github_build_status = GitReflow.git_server.get_build_status(self.head.sha)
build_status_object = Struct.new(:state, :description, :url)
Expand Down
30 changes: 30 additions & 0 deletions lib/git_reflow/git_server/pull_request.rb
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,36 @@ def method_missing(method_sym, *arguments, &block)
super
end
end

def merge!(options = {})

destination_branch = options[:destination_branch] || 'master'
feature_branch_name = GitReflow.current_branch

update_current_branch
fetch_destination(destination_branch)
update_destination(feature_branch_name)
update_destination(destination_branch)

commit_message = if "#{self.description}".length > 0
self.description
else
"#{get_first_commit_message}"
end

if "#{options[:pull_request_number]}".length > 0
commit_message << "\nMerges ##{options[:pull_request_number]}\n"
end

if lgtm_authors = Array(options[:lgtm_authors]) and lgtm_authors.any?
commit_message << "\nLGTM given by: @#{lgtm_authors.join(', @')}\n"
end

run_command_with_label "git checkout #{destination_branch}"
run_command_with_label "git merge --squash #{feature_branch_name}"

append_to_squashed_commit_message(commit_message) if commit_r.length > 0
end
end
end
end
9 changes: 9 additions & 0 deletions lib/git_reflow/merge_error.rb
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
module GitReflow
module GitServer
class MergeError < StandardError
def initialize(msg="My default message")
super(msg)
end
end
end
end
Loading

0 comments on commit 18d6d36

Please sign in to comment.