doc: add verb in front of command to run
[git/git-svn.git] / t / lib-rebase.sh
blob9a96e1566d016e960f79875eb4edba2ffb7c5244
1 # Helper functions used by interactive rebase tests.
3 # After setting the fake editor with this function, you can
5 # - override the commit message with $FAKE_COMMIT_MESSAGE
6 # - amend the commit message with $FAKE_COMMIT_AMEND
7 # - check that non-commit messages have a certain line count with $EXPECT_COUNT
8 # - check the commit count in the commit message header with $EXPECT_HEADER_COUNT
9 # - rewrite a rebase -i script as directed by $FAKE_LINES.
10 # $FAKE_LINES consists of a sequence of words separated by spaces.
11 # The following word combinations are possible:
13 # "<lineno>" -- add a "pick" line with the SHA1 taken from the
14 # specified line.
16 # "<cmd> <lineno>" -- add a line with the specified command
17 # ("squash", "fixup", "edit", "reword" or "drop") and the SHA1 taken
18 # from the specified line.
20 # "exec_cmd_with_args" -- add an "exec cmd with args" line.
22 # "#" -- Add a comment line.
24 # ">" -- Add a blank line.
26 set_fake_editor () {
27 write_script fake-editor.sh <<-\EOF
28 case "$1" in
29 */COMMIT_EDITMSG)
30 test -z "$EXPECT_HEADER_COUNT" ||
31 test "$EXPECT_HEADER_COUNT" = "$(sed -n '1s/^# This is a combination of \(.*\) commits\./\1/p' < "$1")" ||
32 exit
33 test -z "$FAKE_COMMIT_MESSAGE" || echo "$FAKE_COMMIT_MESSAGE" > "$1"
34 test -z "$FAKE_COMMIT_AMEND" || echo "$FAKE_COMMIT_AMEND" >> "$1"
35 exit
37 esac
38 test -z "$EXPECT_COUNT" ||
39 test "$EXPECT_COUNT" = $(sed -e '/^#/d' -e '/^$/d' < "$1" | wc -l) ||
40 exit
41 test -z "$FAKE_LINES" && exit
42 grep -v '^#' < "$1" > "$1".tmp
43 rm -f "$1"
44 echo 'rebase -i script before editing:'
45 cat "$1".tmp
46 action=pick
47 for line in $FAKE_LINES; do
48 case $line in
49 squash|fixup|edit|reword|drop)
50 action="$line";;
51 exec*)
52 echo "$line" | sed 's/_/ /g' >> "$1";;
53 "#")
54 echo '# comment' >> "$1";;
55 ">")
56 echo >> "$1";;
57 bad)
58 action="badcmd";;
59 fakesha)
60 echo "$action XXXXXXX False commit" >> "$1"
61 action=pick;;
63 sed -n "${line}s/^pick/$action/p" < "$1".tmp >> "$1"
64 action=pick;;
65 esac
66 done
67 echo 'rebase -i script after editing:'
68 cat "$1"
69 EOF
71 test_set_editor "$(pwd)/fake-editor.sh"
74 # After set_cat_todo_editor, rebase -i will write the todo list (ignoring
75 # blank lines and comments) to stdout, and exit failure (so you should run
76 # it with test_must_fail). This can be used to verify the expected user
77 # experience, for todo list changes that do not affect the outcome of
78 # rebase; or as an extra check in addition to checking the outcome.
80 set_cat_todo_editor () {
81 write_script fake-editor.sh <<-\EOF
82 grep "^[^#]" "$1"
83 exit 1
84 EOF
85 test_set_editor "$(pwd)/fake-editor.sh"
88 # checks that the revisions in "$2" represent a linear range with the
89 # subjects in "$1"
90 test_linear_range () {
91 revlist_merges=$(git rev-list --merges "$2") &&
92 test -z "$revlist_merges" &&
93 expected=$1
94 set -- $(git log --reverse --format=%s "$2")
95 test "$expected" = "$*"
98 reset_rebase () {
99 test_might_fail git rebase --abort &&
100 git reset --hard &&
101 git clean -f
104 cherry_pick () {
105 git cherry-pick -n "$2" &&
106 git commit -m "$1" &&
107 git tag "$1"
110 revert () {
111 git revert -n "$2" &&
112 git commit -m "$1" &&
113 git tag "$1"
116 make_empty () {
117 git commit --allow-empty -m "$1" &&
118 git tag "$1"