3 # Copyright (c) 2006 Johannes E. Schindelin
7 # This script makes it easy to fix up commits in the middle of a series,
8 # and rearrange commits.
10 # The original idea comes from Eric W. Biederman, in
11 # http://article.gmane.org/gmane.comp.version-control.git/22407
13 # The file containing rebase commands, comments, and empty lines.
14 # This file is created by "git rebase -i" then edited by the user. As
15 # the lines are processed, they are removed from the front of this
16 # file and written to the tail of $done.
17 todo
="$state_dir"/git-rebase-todo
19 # The rebase command lines that have already been processed. A line
20 # is moved here when it is first handled, before any associated user
22 done="$state_dir"/done
24 # The commit message that is planned to be used for any changes that
25 # need to be committed following a user interaction.
26 msg
="$state_dir"/message
28 # The file into which is accumulated the suggested commit message for
29 # squash/fixup commands. When the first of a series of squash/fixups
30 # is seen, the file is created and the commit message from the
31 # previous commit and from the first squash/fixup commit are written
32 # to it. The commit message for each subsequent squash/fixup commit
33 # is appended to the file as it is processed.
35 # The first line of the file is of the form
36 # # This is a combination of $count commits.
37 # where $count is the number of commits whose messages have been
38 # written to the file so far (including the initial "pick" commit).
39 # Each time that a commit message is processed, this line is read and
40 # updated. It is deleted just before the combined commit is made.
41 squash_msg
="$state_dir"/message-squash
43 # If the current series of squash/fixups has not yet included a squash
44 # command, then this file exists and holds the commit message of the
45 # original "pick" commit. (If the series ends without a "squash"
46 # command, then this can be used as the commit message of the combined
47 # commit without opening the editor.)
48 fixup_msg
="$state_dir"/message-fixup
50 # $rewritten is the name of a directory containing files for each
51 # commit that is reachable by at least one merge base of $head and
52 # $upstream. They are not necessarily rewritten, but their children
53 # might be. This ensures that commits on merged, but otherwise
54 # unrelated side branches are left alone. (Think "X" in the man page's
56 rewritten
="$state_dir"/rewritten
58 dropped
="$state_dir"/dropped
60 # A script to set the GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, and
61 # GIT_AUTHOR_DATE that will be used for the commit that is currently
63 author_script
="$state_dir"/author-script
65 # When an "edit" rebase command is being processed, the SHA1 of the
66 # commit to be edited is recorded in this file. When "git rebase
67 # --continue" is executed, if there are any staged changes then they
68 # will be amended to the HEAD commit, but only provided the HEAD
69 # commit is still the commit to be edited. When any other rebase
70 # command is processed, this file is deleted.
71 amend
="$state_dir"/amend
73 # For the post-rewrite hook, we make a list of rewritten commits and
74 # their new sha1s. The rewritten-pending list keeps the sha1s of
75 # commits that have been processed, but not committed yet,
76 # e.g. because they are waiting for a 'squash' command.
77 rewritten_list
="$state_dir"/rewritten-list
78 rewritten_pending
="$state_dir"/rewritten-pending
80 GIT_CHERRY_PICK_HELP
="$resolvemsg"
81 export GIT_CHERRY_PICK_HELP
84 printf '%s\n' "$*" >&2
87 # Output the commit message for the specified commit.
89 git cat-file commit
"$1" |
sed "1,/^$/d"
92 orig_reflog_action
="$GIT_REFLOG_ACTION"
94 comment_for_reflog
() {
95 case "$orig_reflog_action" in
97 GIT_REFLOG_ACTION
="rebase -i ($1)"
98 export GIT_REFLOG_ACTION
104 mark_action_done
() {
105 sed -e 1q
< "$todo" >> "$done"
106 sed -e 1d
< "$todo" >> "$todo".new
107 mv -f "$todo".new
"$todo"
108 new_count
=$
(sane_grep
-c '^[^#]' < "$done")
109 total
=$
(($new_count+$
(sane_grep
-c '^[^#]' < "$todo")))
110 if test "$last_count" != "$new_count"
112 last_count
=$new_count
113 printf "Rebasing (%d/%d)\r" $new_count $total
114 test -z "$verbose" ||
echo
118 append_todo_help
() {
119 cat >> "$todo" << EOF
122 # p, pick = use commit
123 # r, reword = use commit, but edit the commit message
124 # e, edit = use commit, but stop for amending
125 # s, squash = use commit, but meld into previous commit
126 # f, fixup = like "squash", but discard this commit's log message
127 # x, exec = run command (the rest of the line) using shell
129 # These lines can be re-ordered; they are executed from top to bottom.
131 # If you remove a line here THAT COMMIT WILL BE LOST.
136 sha1_and_parents
="$(git rev-list --parents -1 "$1")"
137 case "$sha1_and_parents" in
139 git
diff --cc $sha1_and_parents
142 git diff-tree
-p "$1^!"
147 esac > "$state_dir"/patch
149 commit_message
"$1" > "$msg"
150 test -f "$author_script" ||
151 get_author_ident_from_commit
"$1" > "$author_script"
155 echo "$1" > "$state_dir"/stopped-sha
162 echo "$1" > "$state_dir"/stopped-sha
164 git rev-parse
--verify HEAD
> "$amend"
165 warn
"You can amend the commit now, with"
167 warn
" git commit --amend"
169 warn
"Once you are satisfied with your changes, run"
171 warn
" git rebase --continue"
182 sane_grep
'^[^#]' "$1" >/dev
/null
186 tree
=$
(git rev-parse
-q --verify "$1"^
{tree
} 2>/dev
/null ||
187 die
"$1: not a commit that can be picked")
188 ptree
=$
(git rev-parse
-q --verify "$1"^^
{tree
} 2>/dev
/null ||
189 ptree
=4b825dc642cb6eb9a060e54bf8d69288fbee4904
)
190 test "$tree" = "$ptree"
193 # Run command with GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, and
194 # GIT_AUTHOR_DATE exported from the current environment.
197 export GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_AUTHOR_DATE
202 git_sequence_editor
() {
203 if test -z "$GIT_SEQUENCE_EDITOR"
205 GIT_SEQUENCE_EDITOR
="$(git config sequence.editor)"
206 if [ -z "$GIT_SEQUENCE_EDITOR" ]
208 GIT_SEQUENCE_EDITOR
="$(git var GIT_EDITOR)" ||
return $?
212 eval "$GIT_SEQUENCE_EDITOR" '"$@"'
218 case "$1" in -n) sha1
=$2; ff
= ;; *) sha1
=$1 ;; esac
219 case "$force_rebase" in '') ;; ?
*) ff
= ;; esac
220 output git rev-parse
--verify $sha1 || die
"Invalid commit name: $sha1"
222 if is_empty_commit
"$sha1"
224 empty_args
="--allow-empty"
227 test -d "$rewritten" &&
228 pick_one_preserving_merges
"$@" && return
229 output git cherry-pick
$empty_args $ff "$@"
232 pick_one_preserving_merges
() {
243 sha1
=$
(git rev-parse
$sha1)
245 if test -f "$state_dir"/current-commit
247 if test "$fast_forward" = t
249 while read current_commit
251 git rev-parse HEAD
> "$rewritten"/$current_commit
252 done <"$state_dir"/current-commit
253 rm "$state_dir"/current-commit ||
254 die
"Cannot write current commit's replacement sha1"
258 echo $sha1 >> "$state_dir"/current-commit
260 # rewrite parents; if none were rewritten, we can fast-forward.
262 pend
=" $(git rev-list --parents -1 $sha1 | cut -d' ' -s -f2-)"
263 if test "$pend" = " "
267 while [ "$pend" != "" ]
269 p
=$
(expr "$pend" : ' \([^ ]*\)')
272 if test -f "$rewritten"/$p
274 new_p
=$
(cat "$rewritten"/$p)
276 # If the todo reordered commits, and our parent is marked for
277 # rewriting, but hasn't been gotten to yet, assume the user meant to
278 # drop it on top of the current HEAD
281 new_p
=$
(git rev-parse HEAD
)
284 test $p != $new_p && fast_forward
=f
285 case "$new_parents" in
287 ;; # do nothing; that parent is already there
289 new_parents
="$new_parents $new_p"
293 if test -f "$dropped"/$p
296 replacement
="$(cat "$dropped"/$p)"
297 test -z "$replacement" && replacement
=root
298 pend
=" $replacement$pend"
300 new_parents
="$new_parents $p"
304 case $fast_forward in
306 output warn
"Fast-forward to $sha1"
307 output git
reset --hard $sha1 ||
308 die
"Cannot fast-forward to $sha1"
311 first_parent
=$
(expr "$new_parents" : ' \([^ ]*\)')
315 # detach HEAD to current parent
316 output git checkout
$first_parent 2> /dev
/null ||
317 die
"Cannot move HEAD to $first_parent"
320 case "$new_parents" in
322 test "a$1" = a-n
&& die
"Refusing to squash a merge: $sha1"
325 author_script_content
=$
(get_author_ident_from_commit
$sha1)
326 eval "$author_script_content"
327 msg_content
="$(commit_message $sha1)"
328 # No point in merging the first parent, that's HEAD
329 new_parents
=${new_parents# $first_parent}
330 if ! do_with_author output \
331 git merge
--no-ff ${strategy:+-s $strategy} -m \
332 "$msg_content" $new_parents
334 printf "%s\n" "$msg_content" > "$GIT_DIR"/MERGE_MSG
335 die_with_patch
$sha1 "Error redoing merge $sha1"
337 echo "$sha1 $(git rev-parse HEAD^0)" >> "$rewritten_list"
340 output git cherry-pick
"$@" ||
341 die_with_patch
$sha1 "Could not pick $sha1"
350 *1[0-9]|
*[04-9]) echo "$1"th
;;
357 update_squash_messages
() {
358 if test -f "$squash_msg"; then
359 mv "$squash_msg" "$squash_msg".bak ||
exit
361 -e "1s/^# This is a combination of \(.*\) commits\./\1/p" \
362 -e "q" < "$squash_msg".bak
)+1))
364 echo "# This is a combination of $count commits."
365 sed -e 1d
-e '2,/^./{
367 }' <"$squash_msg".bak
370 commit_message HEAD
> "$fixup_msg" || die
"Cannot write $fixup_msg"
373 echo "# This is a combination of 2 commits."
374 echo "# The first commit's message is:"
383 echo "# This is the $(nth_string $count) commit message:"
389 echo "# The $(nth_string $count) commit message will be skipped:"
391 commit_message
$2 |
sed -e 's/^/# /'
396 peek_next_command
() {
397 sed -n -e "/^#/d" -e '/^$/d' -e "s/ .*//p" -e "q" < "$todo"
400 # A squash/fixup has failed. Prepare the long version of the squash
401 # commit message, then die_with_patch. This code path requires the
402 # user to edit the combined commit message for all commits that have
403 # been squashed/fixedup so far. So also erase the old squash
404 # messages, effectively causing the combined commit to be used as the
405 # new basis for any further squash/fixups. Args: sha1 rest
406 die_failed_squash
() {
407 mv "$squash_msg" "$msg" ||
exit
409 cp "$msg" "$GIT_DIR"/MERGE_MSG ||
exit
411 warn
"Could not apply $1... $2"
415 flush_rewritten_pending
() {
416 test -s "$rewritten_pending" ||
return
417 newsha1
="$(git rev-parse HEAD^0)"
418 sed "s/$/ $newsha1/" < "$rewritten_pending" >> "$rewritten_list"
419 rm -f "$rewritten_pending"
422 record_in_rewritten
() {
423 oldsha1
="$(git rev-parse $1)"
424 echo "$oldsha1" >> "$rewritten_pending"
426 case "$(peek_next_command)" in
430 flush_rewritten_pending
436 if test "$(git rev-parse HEAD)" = "$squash_onto"
438 # Set the correct commit message and author info on the
439 # sentinel root before cherry-picking the original changes
440 # without committing (-n). Finally, update the sentinel again
441 # to include these changes. If the cherry-pick results in a
442 # conflict, this means our behaviour is similar to a standard
443 # failed cherry-pick during rebase, with a dirty index to
444 # resolve before manually running git commit --amend then git
446 git commit
--allow-empty --allow-empty-message --amend \
447 --no-post-rewrite -n -q -C $1 &&
449 git commit
--allow-empty --allow-empty-message \
450 --amend --no-post-rewrite -n -q -C $1 ||
451 die_with_patch
$1 "Could not apply $1... $2"
454 die_with_patch
$1 "Could not apply $1... $2"
459 rm -f "$msg" "$author_script" "$amend" ||
exit
460 read -r command sha1 rest
< "$todo"
466 comment_for_reflog pick
469 do_pick
$sha1 "$rest"
470 record_in_rewritten
$sha1
473 comment_for_reflog reword
476 do_pick
$sha1 "$rest"
477 git commit
--amend --no-post-rewrite ||
{
478 warn
"Could not amend commit after successfully picking $sha1... $rest"
479 warn
"This is most likely due to an empty commit message, or the pre-commit hook"
480 warn
"failed. If the pre-commit hook failed, you may need to resolve the issue before"
481 warn
"you are able to reword the commit."
482 exit_with_patch
$sha1 1
484 record_in_rewritten
$sha1
487 comment_for_reflog edit
490 do_pick
$sha1 "$rest"
491 warn
"Stopped at $sha1... $rest"
492 exit_with_patch
$sha1 0
503 comment_for_reflog
$squash_style
505 test -f "$done" && has_action
"$done" ||
506 die
"Cannot '$squash_style' without a previous commit"
509 update_squash_messages
$squash_style $sha1
510 author_script_content
=$
(get_author_ident_from_commit HEAD
)
511 echo "$author_script_content" > "$author_script"
512 eval "$author_script_content"
513 if ! pick_one
-n $sha1
515 git rev-parse
--verify HEAD
>"$amend"
516 die_failed_squash
$sha1 "$rest"
518 case "$(peek_next_command)" in
520 # This is an intermediate commit; its message will only be
521 # used in case of trouble. So use the long version:
522 do_with_author output git commit
--amend --no-verify -F "$squash_msg" ||
523 die_failed_squash
$sha1 "$rest"
526 # This is the final command of this squash/fixup group
527 if test -f "$fixup_msg"
529 do_with_author git commit
--amend --no-verify -F "$fixup_msg" ||
530 die_failed_squash
$sha1 "$rest"
532 cp "$squash_msg" "$GIT_DIR"/SQUASH_MSG ||
exit
533 rm -f "$GIT_DIR"/MERGE_MSG
534 do_with_author git commit
--amend --no-verify -F "$GIT_DIR"/SQUASH_MSG
-e ||
535 die_failed_squash
$sha1 "$rest"
537 rm -f "$squash_msg" "$fixup_msg"
540 record_in_rewritten
$sha1
543 read -r command rest
< "$todo"
545 printf 'Executing: %s\n' "$rest"
546 # "exec" command doesn't take a sha1 in the todo-list.
547 # => can't just use $sha1 here.
548 git rev-parse
--verify HEAD
> "$state_dir"/stopped-sha
549 ${SHELL:-@SHELL_PATH@} -c "$rest" # Actual execution
551 # Run in subshell because require_clean_work_tree can die.
553 (require_clean_work_tree
"rebase" 2>/dev
/null
) || dirty
=t
554 if test "$status" -ne 0
556 warn
"Execution failed: $rest"
558 warn
"and made changes to the index and/or the working tree"
560 warn
"You can fix the problem, and then run"
562 warn
" git rebase --continue"
565 elif test "$dirty" = t
567 warn
"Execution succeeded: $rest"
568 warn
"but left changes to the index and/or the working tree"
569 warn
"Commit or stash your changes, and then run"
571 warn
" git rebase --continue"
577 warn
"Unknown command: $command $sha1 $rest"
578 if git rev-parse
--verify -q "$sha1" >/dev
/null
580 die_with_patch
$sha1 "Please fix this in the file $todo."
582 die
"Please fix this in the file $todo."
586 test -s "$todo" && return
588 comment_for_reflog finish
&&
589 newhead
=$
(git rev-parse HEAD
) &&
592 message
="$GIT_REFLOG_ACTION: $head_name onto $onto" &&
593 git update-ref
-m "$message" $head_name $newhead $orig_head &&
595 -m "$GIT_REFLOG_ACTION: returning to $head_name" \
599 test ! -f "$state_dir"/verbose ||
600 git diff-tree
--stat $orig_head..HEAD
603 test -s "$rewritten_list" &&
604 git notes copy
--for-rewrite=rebase
< "$rewritten_list" ||
605 true
# we don't care if this copying failed
607 if test -x "$GIT_DIR"/hooks
/post-rewrite
&&
608 test -s "$rewritten_list"; then
609 "$GIT_DIR"/hooks
/post-rewrite rebase
< "$rewritten_list"
610 true
# we don't care if this hook failed
612 rm -rf "$state_dir" &&
614 warn
"Successfully rebased and updated $head_name."
626 # skip picking commits whose parents are unchanged
627 skip_unnecessary_picks
() {
629 while read -r command rest
631 # fd=3 means we skip the command
632 case "$fd,$command" in
634 # pick a commit whose parent is current $onto -> skip
636 case "$(git rev-parse --verify --quiet "$sha1"^)" in
652 printf '%s\n' "$command${rest:+ }$rest" >&$fd
653 done <"$todo" >"$todo.new" 3>>"$done" &&
654 mv -f "$todo".new
"$todo" &&
655 case "$(peek_next_command)" in
657 record_in_rewritten
"$onto"
660 die
"Could not skip unnecessary pick commands"
663 # Rearrange the todo list that has both "pick sha1 msg" and
664 # "pick sha1 fixup!/squash! msg" appears in it so that the latter
665 # comes immediately after the former, and change "pick" to
667 rearrange_squash
() {
668 # extract fixup!/squash! lines and resolve any referenced sha1's
669 while read -r pick sha1 message
672 "squash! "*|
"fixup! "*)
673 action
="${message%%!*}"
674 rest
="${message#*! }"
675 echo "$sha1 $action $rest"
676 # if it's a single word, try to resolve to a full sha1 and
677 # emit a second copy. This allows us to match on both message
679 if test "${rest#* }" = "$rest"; then
680 fullsha
="$(git rev-parse -q --verify "$rest" 2>/dev/null)"
681 if test -n "$fullsha"; then
682 # prefix the action to uniquely identify this line as
683 # intended for full sha1 match
684 echo "$sha1 +$action $fullsha"
689 test -s "$1.sq" ||
return
692 while read -r pick sha1 message
695 *" $sha1 "*) continue ;;
697 printf '%s\n' "$pick $sha1 $message"
699 while read -r squash action msg_content
702 *" $squash "*) continue ;;
708 # full sha1 prefix test
709 case "$msg_content" in "$sha1"*) emit
=1;; esac ;;
711 # message prefix test
712 case "$message" in "$msg_content"*) emit
=1;; esac ;;
714 if test $emit = 1; then
715 printf '%s\n' "$action $squash $action! $msg_content"
719 done >"$1.rearranged" <"$1"
720 cat "$1.rearranged" >"$1"
721 rm -f "$1.sq" "$1.rearranged"
724 # Add commands after a pick or after a squash/fixup serie
726 add_exec_commands
() {
729 while read -r insn rest
737 printf "%s %s\n" "$insn" "$rest"
747 # do we have anything to commit?
748 if git diff-index
--cached --quiet HEAD
--
750 : Nothing to commit
-- skip this
752 if ! test -f "$author_script"
754 die
"You have staged changes in your working tree. If these changes are meant to be
755 squashed into the previous commit, run:
759 If they are meant to go into a new commit, run:
763 In both case, once you're done, continue with:
765 git rebase --continue
768 .
"$author_script" ||
769 die
"Error trying to find the author identity to amend commit"
772 current_head
=$
(git rev-parse
--verify HEAD
)
773 test "$current_head" = $
(cat "$amend") ||
775 You have uncommitted changes in your working tree. Please, commit them
776 first and then run 'git rebase --continue' again."
777 do_with_author git commit
--amend --no-verify -F "$msg" -e ||
778 die
"Could not commit staged changes."
780 do_with_author git commit
--no-verify -F "$msg" -e ||
781 die
"Could not commit staged changes."
785 record_in_rewritten
"$(cat "$state_dir"/stopped-sha)"
787 require_clean_work_tree
"rebase"
797 git var GIT_COMMITTER_IDENT
>/dev
/null ||
798 die
"You need to set your committer info first"
800 comment_for_reflog start
802 if test ! -z "$switch_to"
804 output git checkout
"$switch_to" -- ||
805 die
"Could not checkout $switch_to"
808 orig_head
=$
(git rev-parse
--verify HEAD
) || die
"No HEAD?"
809 mkdir
"$state_dir" || die
"Could not create temporary $state_dir"
811 : > "$state_dir"/interactive || die
"Could not mark as interactive"
813 if test t
= "$preserve_merges"
815 if test -z "$rebase_root"
817 mkdir
"$rewritten" &&
818 for c
in $
(git merge-base
--all $orig_head $upstream)
820 echo $onto > "$rewritten"/$c ||
821 die
"Could not init rewritten commits"
824 mkdir
"$rewritten" &&
825 echo $onto > "$rewritten"/root ||
826 die
"Could not init rewritten commits"
828 # No cherry-pick because our first pass is to determine
829 # parents to rewrite and skipping dropped commits would
830 # prematurely end our probe
833 merges_option
="--no-merges --cherry-pick"
836 shorthead
=$
(git rev-parse
--short $orig_head)
837 shortonto
=$
(git rev-parse
--short $onto)
838 if test -z "$rebase_root"
839 # this is now equivalent to ! -z "$upstream"
841 shortupstream
=$
(git rev-parse
--short $upstream)
842 revisions
=$upstream...
$orig_head
843 shortrevisions
=$shortupstream..
$shorthead
845 revisions
=$onto...
$orig_head
846 shortrevisions
=$shorthead
848 git rev-list
$merges_option --pretty=oneline
--abbrev-commit \
849 --abbrev=7 --reverse --left-right --topo-order \
852 while read -r shortsha1 rest
855 if test -z "$keep_empty" && is_empty_commit
$shortsha1
862 if test t
!= "$preserve_merges"
864 printf '%s\n' "${comment_out}pick $shortsha1 $rest" >>"$todo"
866 sha1
=$
(git rev-parse
$shortsha1)
867 if test -z "$rebase_root"
870 for p
in $
(git rev-list
--parents -1 $sha1 | cut
-d' ' -s -f2-)
872 if test -f "$rewritten"/$p
880 if test f
= "$preserve"
882 touch "$rewritten"/$sha1
883 printf '%s\n' "${comment_out}pick $shortsha1 $rest" >>"$todo"
888 # Watch for commits that been dropped by --cherry-pick
889 if test t
= "$preserve_merges"
892 # Save all non-cherry-picked changes
893 git rev-list
$revisions --left-right --cherry-pick | \
894 sed -n "s/^>//p" > "$state_dir"/not-cherry-picks
895 # Now all commits and note which ones are missing in
896 # not-cherry-picks and hence being dropped
897 git rev-list
$revisions |
900 if test -f "$rewritten"/$rev -a "$(sane_grep "$rev" "$state_dir"/not-cherry-picks)" = ""
902 # Use -f2 because if rev-list is telling us this commit is
903 # not worthwhile, we don't want to track its multiple heads,
904 # just the history of its first-parent for others that will
905 # be rebasing on top of it
906 git rev-list
--parents -1 $rev | cut
-d' ' -s -f2 > "$dropped"/$rev
907 short
=$
(git rev-list
-1 --abbrev-commit --abbrev=7 $rev)
908 sane_grep
-v "^[a-z][a-z]* $short" <"$todo" > "${todo}2" ; mv "${todo}2" "$todo"
914 test -s "$todo" ||
echo noop
>> "$todo"
915 test -n "$autosquash" && rearrange_squash
"$todo"
916 test -n "$cmd" && add_exec_commands
"$todo"
918 cat >> "$todo" << EOF
920 # Rebase $shortrevisions onto $shortonto
923 cat >> "$todo" << EOF
925 # However, if you remove everything, the rebase will be aborted.
929 if test -z "$keep_empty"
931 echo "# Note that empty commits are commented out" >>"$todo"
935 has_action
"$todo" ||
936 die_abort
"Nothing to do"
938 cp "$todo" "$todo".backup
939 git_sequence_editor
"$todo" ||
940 die_abort
"Could not execute editor"
942 has_action
"$todo" ||
943 die_abort
"Nothing to do"
945 test -d "$rewritten" ||
test -n "$force_rebase" || skip_unnecessary_picks
947 output git checkout
$onto || die_abort
"could not detach HEAD"
948 git update-ref ORIG_HEAD
$orig_head