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
83 comment_char=$(git config --get core.commentchar 2>/dev/null | cut -c1)
87 printf '%s\n' "$*" >&2
90 # Output the commit message for the specified commit.
92 git cat-file commit "$1" | sed "1,/^$/d"
95 orig_reflog_action="$GIT_REFLOG_ACTION"
97 comment_for_reflog () {
98 case "$orig_reflog_action" in
100 GIT_REFLOG_ACTION="rebase -i ($1)"
101 export GIT_REFLOG_ACTION
107 mark_action_done () {
108 sed -e 1q < "$todo" >> "$done"
109 sed -e 1d < "$todo" >> "$todo".new
110 mv -f "$todo".new "$todo"
111 new_count=$(git stripspace --strip-comments <"$done" | wc -l)
112 total=$(($new_count + $(git stripspace --strip-comments <"$todo" | wc -l)))
113 if test "$last_count" != "$new_count"
115 last_count=$new_count
116 printf "Rebasing (%d/%d)\r" $new_count $total
117 test -z "$verbose" || echo
121 append_todo_help () {
122 git stripspace --comment-lines >>"$todo" <<\EOF
126 r, reword = use commit, but edit the commit message
127 e, edit = use commit, but stop for amending
128 s, squash = use commit, but meld into previous commit
129 f, fixup = like "squash", but discard this commit's log message
130 x, exec = run command (the rest of the line) using shell
132 These lines can be re-ordered; they are executed from top to bottom.
134 If you remove a line here THAT COMMIT WILL BE LOST.
139 sha1_and_parents="$(git rev-list --parents -1 "$1")"
140 case "$sha1_and_parents" in
142 git diff --cc $sha1_and_parents
145 git diff-tree -p "$1^!"
150 esac > "$state_dir"/patch
152 commit_message "$1" > "$msg"
153 test -f "$author_script" ||
154 get_author_ident_from_commit "$1" > "$author_script"
158 echo "$1" > "$state_dir"/stopped-sha
165 echo "$1" > "$state_dir"/stopped-sha
167 git rev-parse --verify HEAD > "$amend"
168 warn "You can amend the commit now, with"
170 warn " git commit --amend"
172 warn "Once you are satisfied with your changes, run"
174 warn " git rebase --continue"
185 test -n "$(git stripspace --strip-comments <"$1")"
189 tree=$(git rev-parse -q --verify "$1"^{tree} 2>/dev/null ||
190 die "$1: not a commit that can be picked")
191 ptree=$(git rev-parse -q --verify "$1"^^{tree} 2>/dev/null ||
192 ptree=4b825dc642cb6eb9a060e54bf8d69288fbee4904)
193 test "$tree" = "$ptree"
196 # Run command with GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, and
197 # GIT_AUTHOR_DATE exported from the current environment.
200 export GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL GIT_AUTHOR_DATE
205 git_sequence_editor () {
206 if test -z "$GIT_SEQUENCE_EDITOR"
208 GIT_SEQUENCE_EDITOR="$(git config sequence.editor)"
209 if [ -z "$GIT_SEQUENCE_EDITOR" ]
211 GIT_SEQUENCE_EDITOR="$(git var GIT_EDITOR)" || return $?
215 eval "$GIT_SEQUENCE_EDITOR" '"$@"'
221 case "$1" in -n) sha1=$2; ff= ;; *) sha1=$1 ;; esac
222 case "$force_rebase" in '') ;; ?*) ff= ;; esac
223 output git rev-parse --verify $sha1 || die "Invalid commit name: $sha1"
225 if is_empty_commit "$sha1"
227 empty_args="--allow-empty"
230 test -d "$rewritten" &&
231 pick_one_preserving_merges "$@" && return
232 output git cherry-pick $empty_args $ff "$@"
235 pick_one_preserving_merges () {
246 sha1=$(git rev-parse $sha1)
248 if test -f "$state_dir"/current-commit
250 if test "$fast_forward" = t
252 while read current_commit
254 git rev-parse HEAD > "$rewritten"/$current_commit
255 done <"$state_dir"/current-commit
256 rm "$state_dir"/current-commit ||
257 die "Cannot write current commit's replacement sha1"
261 echo $sha1 >> "$state_dir"/current-commit
263 # rewrite parents; if none were rewritten, we can fast-forward.
265 pend=" $(git rev-list --parents -1 $sha1 | cut -d' ' -s -f2-)"
266 if test "$pend" = " "
270 while [ "$pend" != "" ]
272 p=$(expr "$pend" : ' \([^ ]*\)')
275 if test -f "$rewritten"/$p
277 new_p=$(cat "$rewritten"/$p)
279 # If the todo reordered commits, and our parent is marked for
280 # rewriting, but hasn't been gotten to yet, assume the user meant to
281 # drop it on top of the current HEAD
284 new_p=$(git rev-parse HEAD)
287 test $p != $new_p && fast_forward=f
288 case "$new_parents" in
290 ;; # do nothing; that parent is already there
292 new_parents="$new_parents $new_p"
296 if test -f "$dropped"/$p
299 replacement="$(cat "$dropped"/$p)"
300 test -z "$replacement" && replacement=root
301 pend=" $replacement$pend"
303 new_parents="$new_parents $p"
307 case $fast_forward in
309 output warn "Fast-forward to $sha1"
310 output git reset --hard $sha1 ||
311 die "Cannot fast-forward to $sha1"
314 first_parent=$(expr "$new_parents" : ' \([^ ]*\)')
318 # detach HEAD to current parent
319 output git checkout $first_parent 2> /dev/null ||
320 die "Cannot move HEAD to $first_parent"
323 case "$new_parents" in
325 test "a$1" = a-n && die "Refusing to squash a merge: $sha1"
328 author_script_content=$(get_author_ident_from_commit $sha1)
329 eval "$author_script_content"
330 msg_content="$(commit_message $sha1)"
331 # No point in merging the first parent, that's HEAD
332 new_parents=${new_parents# $first_parent}
333 if ! do_with_author output \
334 git merge --no-ff ${strategy:+-s $strategy} -m \
335 "$msg_content" $new_parents
337 printf "%s\n" "$msg_content" > "$GIT_DIR"/MERGE_MSG
338 die_with_patch $sha1 "Error redoing merge $sha1"
340 echo "$sha1 $(git rev-parse HEAD^0)" >> "$rewritten_list"
343 output git cherry-pick "$@" ||
344 die_with_patch $sha1 "Could not pick $sha1"
353 *1[0-9]|*[04-9]) echo "$1"th;;
360 update_squash_messages () {
361 if test -f "$squash_msg"; then
362 mv "$squash_msg" "$squash_msg".bak || exit
364 -e "1s/^. This is a combination of \(.*\) commits\./\1/p" \
365 -e "q" < "$squash_msg".bak)+1))
367 printf '%s\n' "$comment_char This is a combination of $count commits."
368 sed -e 1d -e '2,/^./{
370 }' <"$squash_msg".bak
373 commit_message HEAD > "$fixup_msg" || die "Cannot write $fixup_msg"
376 printf '%s\n' "$comment_char This is a combination of 2 commits."
377 printf '%s\n' "$comment_char The first commit's message is:"
386 printf '%s\n' "$comment_char This is the $(nth_string $count) commit message:"
392 printf '%s\n' "$comment_char The $(nth_string $count) commit message will be skipped:"
394 # Change the space after the comment character to TAB:
395 commit_message $2 | git stripspace --comment-lines | sed -e 's/ / /'
400 peek_next_command () {
401 git stripspace --strip-comments <"$todo" | sed -n -e 's/ .*//p' -e q
404 # A squash/fixup has failed. Prepare the long version of the squash
405 # commit message, then die_with_patch. This code path requires the
406 # user to edit the combined commit message for all commits that have
407 # been squashed/fixedup so far. So also erase the old squash
408 # messages, effectively causing the combined commit to be used as the
409 # new basis for any further squash/fixups. Args: sha1 rest
410 die_failed_squash() {
411 mv "$squash_msg" "$msg" || exit
413 cp "$msg" "$GIT_DIR"/MERGE_MSG || exit
415 warn "Could not apply $1... $2"
419 flush_rewritten_pending() {
420 test -s "$rewritten_pending" || return
421 newsha1="$(git rev-parse HEAD^0)"
422 sed "s/$/ $newsha1/" < "$rewritten_pending" >> "$rewritten_list"
423 rm -f "$rewritten_pending"
426 record_in_rewritten() {
427 oldsha1="$(git rev-parse $1)"
428 echo "$oldsha1" >> "$rewritten_pending"
430 case "$(peek_next_command)" in
434 flush_rewritten_pending
440 if test "$(git rev-parse HEAD)" = "$squash_onto"
442 # Set the correct commit message and author info on the
443 # sentinel root before cherry-picking the original changes
444 # without committing (-n). Finally, update the sentinel again
445 # to include these changes. If the cherry-pick results in a
446 # conflict, this means our behaviour is similar to a standard
447 # failed cherry-pick during rebase, with a dirty index to
448 # resolve before manually running git commit --amend then git
450 git commit --allow-empty --allow-empty-message --amend \
451 --no-post-rewrite -n -q -C $1 &&
453 git commit --allow-empty --allow-empty-message \
454 --amend --no-post-rewrite -n -q -C $1 ||
455 die_with_patch $1 "Could not apply $1... $2"
458 die_with_patch $1 "Could not apply $1... $2"
463 rm -f "$msg" "$author_script" "$amend" || exit
464 read -r command sha1 rest < "$todo"
466 "$comment_char"*|''|noop)
470 comment_for_reflog pick
473 do_pick $sha1 "$rest"
474 record_in_rewritten $sha1
477 comment_for_reflog reword
480 do_pick $sha1 "$rest"
481 git commit --amend --no-post-rewrite || {
482 warn "Could not amend commit after successfully picking $sha1... $rest"
483 warn "This is most likely due to an empty commit message, or the pre-commit hook"
484 warn "failed. If the pre-commit hook failed, you may need to resolve the issue before"
485 warn "you are able to reword the commit."
486 exit_with_patch $sha1 1
488 record_in_rewritten $sha1
491 comment_for_reflog edit
494 do_pick $sha1 "$rest"
495 warn "Stopped at $sha1... $rest"
496 exit_with_patch $sha1 0
507 comment_for_reflog $squash_style
509 test -f "$done" && has_action "$done" ||
510 die "Cannot '$squash_style' without a previous commit"
513 update_squash_messages $squash_style $sha1
514 author_script_content=$(get_author_ident_from_commit HEAD)
515 echo "$author_script_content" > "$author_script"
516 eval "$author_script_content"
517 if ! pick_one -n $sha1
519 git rev-parse --verify HEAD >"$amend"
520 die_failed_squash $sha1 "$rest"
522 case "$(peek_next_command)" in
524 # This is an intermediate commit; its message will only be
525 # used in case of trouble. So use the long version:
526 do_with_author output git commit --amend --no-verify -F "$squash_msg" ||
527 die_failed_squash $sha1 "$rest"
530 # This is the final command of this squash/fixup group
531 if test -f "$fixup_msg"
533 do_with_author git commit --amend --no-verify -F "$fixup_msg" ||
534 die_failed_squash $sha1 "$rest"
536 cp "$squash_msg" "$GIT_DIR"/SQUASH_MSG || exit
537 rm -f "$GIT_DIR"/MERGE_MSG
538 do_with_author git commit --amend --no-verify -F "$GIT_DIR"/SQUASH_MSG -e ||
539 die_failed_squash $sha1 "$rest"
541 rm -f "$squash_msg" "$fixup_msg"
544 record_in_rewritten $sha1
547 read -r command rest < "$todo"
549 printf 'Executing: %s\n' "$rest"
550 # "exec" command doesn't take a sha1 in the todo-list.
551 # => can't just use $sha1 here.
552 git rev-parse --verify HEAD > "$state_dir"/stopped-sha
553 ${SHELL:-@SHELL_PATH@} -c "$rest" # Actual execution
555 # Run in subshell because require_clean_work_tree can die.
557 (require_clean_work_tree "rebase" 2>/dev/null) || dirty=t
558 if test "$status" -ne 0
560 warn "Execution failed: $rest"
562 warn "and made changes to the index and/or the working tree"
564 warn "You can fix the problem, and then run"
566 warn " git rebase --continue"
568 if test $status -eq 127 # command not found
573 elif test "$dirty" = t
575 warn "Execution succeeded: $rest"
576 warn "but left changes to the index and/or the working tree"
577 warn "Commit or stash your changes, and then run"
579 warn " git rebase --continue"
585 warn "Unknown command: $command $sha1 $rest"
586 fixtodo="Please fix this using 'git rebase --edit-todo'."
587 if git rev-parse --verify -q "$sha1" >/dev/null
589 die_with_patch $sha1 "$fixtodo"
595 test -s "$todo" && return
597 comment_for_reflog finish &&
598 newhead=$(git rev-parse HEAD) &&
601 message="$GIT_REFLOG_ACTION: $head_name onto $onto" &&
602 git update-ref -m "$message" $head_name $newhead $orig_head &&
604 -m "$GIT_REFLOG_ACTION: returning to $head_name" \
608 test ! -f "$state_dir"/verbose ||
609 git diff-tree --stat $orig_head..HEAD
612 test -s "$rewritten_list" &&
613 git notes copy --for-rewrite=rebase < "$rewritten_list" ||
614 true # we don't care if this copying failed
616 if test -x "$GIT_DIR"/hooks/post-rewrite &&
617 test -s "$rewritten_list"; then
618 "$GIT_DIR"/hooks/post-rewrite rebase < "$rewritten_list"
619 true # we don't care if this hook failed
621 rm -rf "$state_dir" &&
623 warn "Successfully rebased and updated $head_name."
635 # skip picking commits whose parents are unchanged
636 skip_unnecessary_picks () {
638 while read -r command rest
640 # fd=3 means we skip the command
641 case "$fd,$command" in
643 # pick a commit whose parent is current $onto -> skip
645 case "$(git rev-parse --verify --quiet "$sha1"^)" in
661 printf '%s\n' "$command${rest:+ }$rest" >&$fd
662 done <"$todo" >"$todo.new" 3>>"$done" &&
663 mv -f "$todo".new "$todo" &&
664 case "$(peek_next_command)" in
666 record_in_rewritten "$onto"
669 die "Could not skip unnecessary pick commands"
672 # Rearrange the todo list that has both "pick sha1 msg" and
673 # "pick sha1 fixup!/squash! msg" appears in it so that the latter
674 # comes immediately after the former, and change "pick" to
676 rearrange_squash () {
677 # extract fixup!/squash! lines and resolve any referenced sha1's
678 while read -r pick sha1 message
681 "squash! "*|"fixup! "*)
682 action="${message%%!*}"
683 rest="${message#*! }"
684 echo "$sha1 $action $rest"
685 # if it's a single word, try to resolve to a full sha1 and
686 # emit a second copy. This allows us to match on both message
688 if test "${rest#* }" = "$rest"; then
689 fullsha="$(git rev-parse -q --verify "$rest" 2>/dev/null)"
690 if test -n "$fullsha"; then
691 # prefix the action to uniquely identify this line as
692 # intended for full sha1 match
693 echo "$sha1 +$action $fullsha"
698 test -s "$1.sq" || return
701 while read -r pick sha1 message
704 *" $sha1 "*) continue ;;
706 printf '%s\n' "$pick $sha1 $message"
708 while read -r squash action msg_content
711 *" $squash "*) continue ;;
717 # full sha1 prefix test
718 case "$msg_content" in "$sha1"*) emit=1;; esac ;;
720 # message prefix test
721 case "$message" in "$msg_content"*) emit=1;; esac ;;
723 if test $emit = 1; then
724 printf '%s\n' "$action $squash $action! $msg_content"
728 done >"$1.rearranged" <"$1"
729 cat "$1.rearranged" >"$1"
730 rm -f "$1.sq" "$1.rearranged"
733 # Add commands after a pick or after a squash/fixup serie
735 add_exec_commands () {
738 while read -r insn rest
746 printf "%s %s\n" "$insn" "$rest"
756 # do we have anything to commit?
757 if git diff-index --cached --quiet HEAD --
759 : Nothing to commit -- skip this
761 if ! test -f "$author_script"
763 die "You have staged changes in your working tree. If these changes are meant to be
764 squashed into the previous commit, run:
768 If they are meant to go into a new commit, run:
772 In both case, once you're done, continue with:
774 git rebase --continue
777 . "$author_script" ||
778 die "Error trying to find the author identity to amend commit"
781 current_head=$(git rev-parse --verify HEAD)
782 test "$current_head" = $(cat "$amend") ||
784 You have uncommitted changes in your working tree. Please, commit them
785 first and then run 'git rebase --continue' again."
786 do_with_author git commit --amend --no-verify -F "$msg" -e ||
787 die "Could not commit staged changes."
789 do_with_author git commit --no-verify -F "$msg" -e ||
790 die "Could not commit staged changes."
794 record_in_rewritten "$(cat "$state_dir"/stopped-sha)"
796 require_clean_work_tree "rebase"
805 git stripspace --strip-comments <"$todo" >"$todo".new
806 mv -f "$todo".new "$todo"
808 git stripspace --comment-lines >>"$todo" <<\EOF
810 You are editing the todo file of an ongoing interactive rebase.
811 To continue rebase after editing, run:
812 git rebase --continue
816 git_sequence_editor "$todo" ||
817 die "Could not execute editor"
823 git var GIT_COMMITTER_IDENT >/dev/null ||
824 die "You need to set your committer info first"
826 comment_for_reflog start
828 if test ! -z "$switch_to"
830 output git checkout "$switch_to" -- ||
831 die "Could not checkout $switch_to"
834 orig_head=$(git rev-parse --verify HEAD) || die "No HEAD?"
835 mkdir "$state_dir" || die "Could not create temporary $state_dir"
837 : > "$state_dir"/interactive || die "Could not mark as interactive"
839 if test t = "$preserve_merges"
841 if test -z "$rebase_root"
843 mkdir "$rewritten" &&
844 for c in $(git merge-base --all $orig_head $upstream)
846 echo $onto > "$rewritten"/$c ||
847 die "Could not init rewritten commits"
850 mkdir "$rewritten" &&
851 echo $onto > "$rewritten"/root ||
852 die "Could not init rewritten commits"
854 # No cherry-pick because our first pass is to determine
855 # parents to rewrite and skipping dropped commits would
856 # prematurely end our probe
859 merges_option="--no-merges --cherry-pick"
862 shorthead=$(git rev-parse --short $orig_head)
863 shortonto=$(git rev-parse --short $onto)
864 if test -z "$rebase_root"
865 # this is now equivalent to ! -z "$upstream"
867 shortupstream=$(git rev-parse --short $upstream)
868 revisions=$upstream...$orig_head
869 shortrevisions=$shortupstream..$shorthead
871 revisions=$onto...$orig_head
872 shortrevisions=$shorthead
874 git rev-list $merges_option --pretty=oneline --abbrev-commit \
875 --abbrev=7 --reverse --left-right --topo-order \
878 while read -r shortsha1 rest
881 if test -z "$keep_empty" && is_empty_commit $shortsha1
883 comment_out="$comment_char "
888 if test t != "$preserve_merges"
890 printf '%s\n' "${comment_out}pick $shortsha1 $rest" >>"$todo"
892 sha1=$(git rev-parse $shortsha1)
893 if test -z "$rebase_root"
896 for p in $(git rev-list --parents -1 $sha1 | cut -d' ' -s -f2-)
898 if test -f "$rewritten"/$p
906 if test f = "$preserve"
908 touch "$rewritten"/$sha1
909 printf '%s\n' "${comment_out}pick $shortsha1 $rest" >>"$todo"
914 # Watch for commits that been dropped by --cherry-pick
915 if test t = "$preserve_merges"
918 # Save all non-cherry-picked changes
919 git rev-list $revisions --left-right --cherry-pick | \
920 sed -n "s/^>//p" > "$state_dir"/not-cherry-picks
921 # Now all commits and note which ones are missing in
922 # not-cherry-picks and hence being dropped
923 git rev-list $revisions |
926 if test -f "$rewritten"/$rev -a "$(sane_grep "$rev" "$state_dir"/not-cherry-picks)" = ""
928 # Use -f2 because if rev-list is telling us this commit is
929 # not worthwhile, we don't want to track its multiple heads,
930 # just the history of its first-parent for others that will
931 # be rebasing on top of it
932 git rev-list --parents -1 $rev | cut -d' ' -s -f2 > "$dropped"/$rev
933 short=$(git rev-list -1 --abbrev-commit --abbrev=7 $rev)
934 sane_grep -v "^[a-z][a-z]* $short" <"$todo" > "${todo}2" ; mv "${todo}2" "$todo"
940 test -s "$todo" || echo noop >> "$todo"
941 test -n "$autosquash" && rearrange_squash "$todo"
942 test -n "$cmd" && add_exec_commands "$todo"
946 $comment_char Rebase $shortrevisions onto $shortonto
949 git stripspace --comment-lines >>"$todo" <<\EOF
951 However, if you remove everything, the rebase will be aborted.
955 if test -z "$keep_empty"
957 printf '%s\n' "$comment_char Note that empty commits are commented out" >>"$todo"
961 has_action "$todo" ||
962 die_abort "Nothing to do"
964 cp "$todo" "$todo".backup
965 git_sequence_editor "$todo" ||
966 die_abort "Could not execute editor"
968 has_action "$todo" ||
969 die_abort "Nothing to do"
971 test -d "$rewritten" || test -n "$force_rebase" || skip_unnecessary_picks
973 output git checkout $onto || die_abort "could not detach HEAD"
974 git update-ref ORIG_HEAD $orig_head