1 # This script can be run in two different contexts:
3 # - From git, when the user invokes the "vimdiff" merge tool. In this context
4 # this script expects the following environment variables (among others) to
5 # be defined (which is something "git" takes care of):
12 # In this mode, all this script does is to run the next command:
14 # vim -f -c ... $LOCAL $BASE $REMOTE $MERGED
16 # ...where the "..." string depends on the value of the
17 # "mergetool.vimdiff.layout" configuration variable and is used to open vim
18 # with a certain layout of buffers, windows and tabs.
20 # - From a script inside the unit tests framework folder ("t" folder) by
21 # sourcing this script and then manually calling "run_unit_tests", which
22 # will run a battery of unit tests to make sure nothing breaks.
23 # In this context this script does not expect any particular environment
27 ################################################################################
28 ## Internal functions (not meant to be used outside this script)
29 ################################################################################
32 # Send message to stderr if global variable GIT_MERGETOOL_VIMDIFF_DEBUG
35 if test -n "$GIT_MERGETOOL_VIMDIFF_DEBUG"
42 # Return a substring of $1 containing $3 characters starting at
43 # zero-based offset $2.
47 # substring "Hello world" 0 4 --> "Hell"
48 # substring "Hello world" 3 4 --> "lo w"
49 # substring "Hello world" 3 10 --> "lo world"
55 echo "$STRING" | cut -c$(( START + 1 ))-$(( START + $LEN ))
59 # Auxiliary function used from "gen_cmd()".
60 # Read that other function documentation for more details.
63 CMD=$2 # This is a second (hidden) argument used for recursion
66 debug_print "LAYOUT : $LAYOUT"
67 debug_print "CMD : $CMD"
77 # Increase/decrease "start"/"end" indices respectively to get rid of
82 # - BEFORE: (( LOCAL , BASE ) / MERGED )
83 # - AFTER : ( LOCAL , BASE ) / MERGED
87 for c in $(echo "$LAYOUT" | sed 's:.:&#:g')
89 if test -z "$c" || test "$c" = " "
96 nested=$(( nested + 1 ))
102 nested=$(( nested - 1 ))
106 if test "$nested" -lt "$nested_min"
113 debug_print "NESTED MIN: $nested_min"
115 while test "$nested_min" -gt "0"
117 start=$(( start + 1 ))
120 start_minus_one=$(( start - 1 ))
122 while ! test "$(substring "$LAYOUT" "$start_minus_one" 1)" = "("
124 start=$(( start + 1 ))
125 start_minus_one=$(( start_minus_one + 1 ))
128 while ! test "$(substring "$LAYOUT" "$end" 1)" = ")"
133 nested_min=$(( nested_min - 1 ))
136 debug_print "CLEAN : $(substring "$LAYOUT" "$start" "$(( end - start ))")"
141 # Search for all valid separators ("/" or ",") which are *not*
142 # inside parenthesis. Save the index at which each of them makes the
145 index_horizontal_split=""
146 index_vertical_split=""
153 for c in $(substring "$LAYOUT" "$start" "$(( end - start ))" | sed 's:.:&#:g');
164 nested=$(( nested + 1 ))
170 nested=$(( nested - 1 ))
174 if test "$nested" = 0
178 if test "$current" = "/"
180 if test -z "$index_horizontal_split"
182 index_horizontal_split=$i
185 elif test "$current" = ","
187 if test -z "$index_vertical_split"
189 index_vertical_split=$i
199 # Process the separator with the highest order of precedence
200 # (";" has the highest precedence and "|" the lowest one).
202 # By "process" I mean recursively call this function twice: the first
203 # one with the substring at the left of the separator and the second one
204 # with the one at its right.
208 if ! test -z "$index_horizontal_split"
210 before="leftabove split"
212 index=$index_horizontal_split
215 elif ! test -z "$index_vertical_split"
217 before="leftabove vertical split"
219 index=$index_vertical_split
223 if test "$terminate" = "true"
226 CMD=$(gen_cmd_aux "$(substring "$LAYOUT" "$start" "$(( index - start ))")" "$CMD")
228 CMD=$(gen_cmd_aux "$(substring "$LAYOUT" "$(( index + 1 ))" "$(( ${#LAYOUT} - index ))")" "$CMD")
236 # If we reach this point, it means there are no separators and we just
237 # need to print the command to display the specified buffer
239 target=$(substring "$LAYOUT" "$start" "$(( end - start ))" | sed 's:[ @();|-]::g')
241 if test "$target" = "LOCAL"
245 elif test "$target" = "BASE"
249 elif test "$target" = "REMOTE"
253 elif test "$target" = "MERGED"
258 CMD="$CMD | ERROR: >$target<"
267 # This function returns (in global variable FINAL_CMD) the string that
268 # you can use when invoking "vim" (as shown next) to obtain a given
271 # $ vim -f $FINAL_CMD "$LOCAL" "$BASE" "$REMOTE" "$MERGED"
273 # It takes one single argument: a string containing the desired layout
276 # The syntax of the "layout definitions" is explained in "Documentation/
277 # mergetools/vimdiff.txt" but you can already intuitively understand how
278 # it works by knowing that...
280 # * "+" means "a new vim tab"
281 # * "/" means "a new vim horizontal split"
282 # * "," means "a new vim vertical split"
284 # It also returns (in global variable FINAL_TARGET) the name ("LOCAL",
285 # "BASE", "REMOTE" or "MERGED") of the file that is marked with an "@",
286 # or "MERGED" if none of them is.
290 # gen_cmd "@LOCAL , REMOTE"
292 # `-> FINAL_CMD == "-c \"echo | leftabove vertical split | 1b | wincmd l | 3b | tabdo windo diffthis\" -c \"tabfirst\""
293 # FINAL_TARGET == "LOCAL"
298 # Search for a "@" in one of the files identifiers ("LOCAL", "BASE",
299 # "REMOTE", "MERGED"). If not found, use "MERGE" as the default file
300 # where changes will be saved.
302 if echo "$LAYOUT" | grep @LOCAL >/dev/null
305 elif echo "$LAYOUT" | grep @BASE >/dev/null
309 FINAL_TARGET="MERGED"
313 # Obtain the first part of vim "-c" option to obtain the desired layout
322 CMD="echo" # vim "nop" operator
327 # If this is a single window diff with all the buffers
328 if ! echo "$tab" | grep -E ",|/" >/dev/null
330 CMD="$CMD | silent execute 'bufdo diffthis'"
333 CMD=$(gen_cmd_aux "$tab" "$CMD")
337 CMD="$CMD | execute 'tabdo windo diffthis'"
339 FINAL_CMD="-c \"set hidden diffopt-=hiddenoff | $CMD | tabfirst\""
343 ################################################################################
344 ## API functions (called from "git-mergetool--lib.sh")
345 ################################################################################
348 "$merge_tool_path" -R -f -d \
349 -c 'wincmd l' -c 'cd $GIT_PREFIX' "$LOCAL" "$REMOTE"
361 printf "Use gVim (requires a graphical session)"
375 layout=$(git config "mergetool.$TOOL.layout")
377 # backward compatibility:
380 layout=$(git config mergetool.vimdiff.layout)
387 # Default layout when none is specified
388 layout="(LOCAL,BASE,REMOTE)/MERGED"
392 layout="@LOCAL,REMOTE"
395 layout="LOCAL,MERGED,REMOTE"
405 debug_print "FINAL CMD : $FINAL_CMD"
406 debug_print "FINAL TAR : $FINAL_TARGET"
410 eval '"$merge_tool_path"' \
411 -f "$FINAL_CMD" '"$LOCAL"' '"$BASE"' '"$REMOTE"' '"$MERGED"'
413 # If there is no BASE (example: a merge conflict in a new file
414 # with the same name created in both branches which didn't exist
415 # before), close all BASE windows using vim's "quit" command
417 FINAL_CMD=$(echo "$FINAL_CMD" | \
418 sed -e 's:2b:quit:g' -e 's:3b:2b:g' -e 's:4b:3b:g')
420 eval '"$merge_tool_path"' \
421 -f "$FINAL_CMD" '"$LOCAL"' '"$REMOTE"' '"$MERGED"'
428 case "$FINAL_TARGET" in
433 source_path="$REMOTE"
441 if test -n "$source_path"
443 cp "$source_path" "$MERGED"
459 printf "Use gVim (requires a graphical session) "
468 echo "with a 2 panes layout (LOCAL and REMOTE)"
471 echo "with a 3 panes layout (LOCAL, MERGED and REMOTE)"
474 echo "where only the MERGED file is shown"
477 echo "with a custom layout (see \`git help mergetool\`'s \`BACKEND SPECIFIC HINTS\` section)"
485 translate_merge_tool_path () {
500 exit_code_trustable () {
505 list_tool_variants () {
506 if test "$TOOL_MODE" = "diff"
510 echo "${prefix}vimdiff"
515 for suffix in '' 1 2 3
517 echo "${prefix}vimdiff${suffix}"
524 ################################################################################
525 ## Unit tests (called from scripts inside the "t" folder)
526 ################################################################################
529 # Function to make sure that we don't break anything when modifying this
532 NUMBER_OF_TEST_CASES=16
534 TEST_CASE_01="(LOCAL,BASE,REMOTE)/MERGED" # default behaviour
535 TEST_CASE_02="@LOCAL,REMOTE" # when using vimdiff1
536 TEST_CASE_03="LOCAL,MERGED,REMOTE" # when using vimdiff2
537 TEST_CASE_04="MERGED" # when using vimdiff3
538 TEST_CASE_05="LOCAL/MERGED/REMOTE"
539 TEST_CASE_06="(LOCAL/REMOTE),MERGED"
540 TEST_CASE_07="MERGED,(LOCAL/REMOTE)"
541 TEST_CASE_08="(LOCAL,REMOTE)/MERGED"
542 TEST_CASE_09="MERGED/(LOCAL,REMOTE)"
543 TEST_CASE_10="(LOCAL/BASE/REMOTE),MERGED"
544 TEST_CASE_11="(LOCAL,BASE,REMOTE)/MERGED+BASE,LOCAL+BASE,REMOTE+(LOCAL/BASE/REMOTE),MERGED"
545 TEST_CASE_12="((LOCAL,REMOTE)/BASE),MERGED"
546 TEST_CASE_13="((LOCAL,REMOTE)/BASE),((LOCAL/REMOTE),MERGED)"
547 TEST_CASE_14="BASE,REMOTE+BASE,LOCAL"
548 TEST_CASE_15=" (( (LOCAL , BASE , REMOTE) / MERGED)) +(BASE) , LOCAL+ BASE , REMOTE+ (((LOCAL / BASE / REMOTE)) , MERGED ) "
549 TEST_CASE_16="LOCAL,BASE,REMOTE / MERGED + BASE,LOCAL + BASE,REMOTE + (LOCAL / BASE / REMOTE),MERGED"
551 EXPECTED_CMD_01="-c \"set hidden diffopt-=hiddenoff | echo | leftabove split | leftabove vertical split | 1b | wincmd l | leftabove vertical split | 2b | wincmd l | 3b | wincmd j | 4b | execute 'tabdo windo diffthis' | tabfirst\""
552 EXPECTED_CMD_02="-c \"set hidden diffopt-=hiddenoff | echo | leftabove vertical split | 1b | wincmd l | 3b | execute 'tabdo windo diffthis' | tabfirst\""
553 EXPECTED_CMD_03="-c \"set hidden diffopt-=hiddenoff | echo | leftabove vertical split | 1b | wincmd l | leftabove vertical split | 4b | wincmd l | 3b | execute 'tabdo windo diffthis' | tabfirst\""
554 EXPECTED_CMD_04="-c \"set hidden diffopt-=hiddenoff | echo | silent execute 'bufdo diffthis' | 4b | execute 'tabdo windo diffthis' | tabfirst\""
555 EXPECTED_CMD_05="-c \"set hidden diffopt-=hiddenoff | echo | leftabove split | 1b | wincmd j | leftabove split | 4b | wincmd j | 3b | execute 'tabdo windo diffthis' | tabfirst\""
556 EXPECTED_CMD_06="-c \"set hidden diffopt-=hiddenoff | echo | leftabove vertical split | leftabove split | 1b | wincmd j | 3b | wincmd l | 4b | execute 'tabdo windo diffthis' | tabfirst\""
557 EXPECTED_CMD_07="-c \"set hidden diffopt-=hiddenoff | echo | leftabove vertical split | 4b | wincmd l | leftabove split | 1b | wincmd j | 3b | execute 'tabdo windo diffthis' | tabfirst\""
558 EXPECTED_CMD_08="-c \"set hidden diffopt-=hiddenoff | echo | leftabove split | leftabove vertical split | 1b | wincmd l | 3b | wincmd j | 4b | execute 'tabdo windo diffthis' | tabfirst\""
559 EXPECTED_CMD_09="-c \"set hidden diffopt-=hiddenoff | echo | leftabove split | 4b | wincmd j | leftabove vertical split | 1b | wincmd l | 3b | execute 'tabdo windo diffthis' | tabfirst\""
560 EXPECTED_CMD_10="-c \"set hidden diffopt-=hiddenoff | echo | leftabove vertical split | leftabove split | 1b | wincmd j | leftabove split | 2b | wincmd j | 3b | wincmd l | 4b | execute 'tabdo windo diffthis' | tabfirst\""
561 EXPECTED_CMD_11="-c \"set hidden diffopt-=hiddenoff | echo | leftabove split | leftabove vertical split | 1b | wincmd l | leftabove vertical split | 2b | wincmd l | 3b | wincmd j | 4b | tabnew | leftabove vertical split | 2b | wincmd l | 1b | tabnew | leftabove vertical split | 2b | wincmd l | 3b | tabnew | leftabove vertical split | leftabove split | 1b | wincmd j | leftabove split | 2b | wincmd j | 3b | wincmd l | 4b | execute 'tabdo windo diffthis' | tabfirst\""
562 EXPECTED_CMD_12="-c \"set hidden diffopt-=hiddenoff | echo | leftabove vertical split | leftabove split | leftabove vertical split | 1b | wincmd l | 3b | wincmd j | 2b | wincmd l | 4b | execute 'tabdo windo diffthis' | tabfirst\""
563 EXPECTED_CMD_13="-c \"set hidden diffopt-=hiddenoff | echo | leftabove vertical split | leftabove split | leftabove vertical split | 1b | wincmd l | 3b | wincmd j | 2b | wincmd l | leftabove vertical split | leftabove split | 1b | wincmd j | 3b | wincmd l | 4b | execute 'tabdo windo diffthis' | tabfirst\""
564 EXPECTED_CMD_14="-c \"set hidden diffopt-=hiddenoff | echo | leftabove vertical split | 2b | wincmd l | 3b | tabnew | leftabove vertical split | 2b | wincmd l | 1b | execute 'tabdo windo diffthis' | tabfirst\""
565 EXPECTED_CMD_15="-c \"set hidden diffopt-=hiddenoff | echo | leftabove split | leftabove vertical split | 1b | wincmd l | leftabove vertical split | 2b | wincmd l | 3b | wincmd j | 4b | tabnew | leftabove vertical split | 2b | wincmd l | 1b | tabnew | leftabove vertical split | 2b | wincmd l | 3b | tabnew | leftabove vertical split | leftabove split | 1b | wincmd j | leftabove split | 2b | wincmd j | 3b | wincmd l | 4b | execute 'tabdo windo diffthis' | tabfirst\""
566 EXPECTED_CMD_16="-c \"set hidden diffopt-=hiddenoff | echo | leftabove split | leftabove vertical split | 1b | wincmd l | leftabove vertical split | 2b | wincmd l | 3b | wincmd j | 4b | tabnew | leftabove vertical split | 2b | wincmd l | 1b | tabnew | leftabove vertical split | 2b | wincmd l | 3b | tabnew | leftabove vertical split | leftabove split | 1b | wincmd j | leftabove split | 2b | wincmd j | 3b | wincmd l | 4b | execute 'tabdo windo diffthis' | tabfirst\""
568 EXPECTED_TARGET_01="MERGED"
569 EXPECTED_TARGET_02="LOCAL"
570 EXPECTED_TARGET_03="MERGED"
571 EXPECTED_TARGET_04="MERGED"
572 EXPECTED_TARGET_05="MERGED"
573 EXPECTED_TARGET_06="MERGED"
574 EXPECTED_TARGET_07="MERGED"
575 EXPECTED_TARGET_08="MERGED"
576 EXPECTED_TARGET_09="MERGED"
577 EXPECTED_TARGET_10="MERGED"
578 EXPECTED_TARGET_11="MERGED"
579 EXPECTED_TARGET_12="MERGED"
580 EXPECTED_TARGET_13="MERGED"
581 EXPECTED_TARGET_14="MERGED"
582 EXPECTED_TARGET_15="MERGED"
583 EXPECTED_TARGET_16="MERGED"
585 at_least_one_ko="false"
587 for i in $(seq -w 1 99)
589 if test "$i" -gt $NUMBER_OF_TEST_CASES
594 gen_cmd "$(eval echo \${TEST_CASE_"$i"})"
596 if test "$FINAL_CMD" = "$(eval echo \${EXPECTED_CMD_"$i"})" \
597 && test "$FINAL_TARGET" = "$(eval echo \${EXPECTED_TARGET_"$i"})"
599 printf "Test Case #%02d: OK\n" "$(echo "$i" | sed 's/^0*//')"
601 printf "Test Case #%02d: KO !!!!\n" "$(echo "$i" | sed 's/^0*//')"
602 echo " FINAL_CMD : $FINAL_CMD"
603 echo " FINAL_CMD (expected) : $(eval echo \${EXPECTED_CMD_"$i"})"
604 echo " FINAL_TARGET : $FINAL_TARGET"
605 echo " FINAL_TARGET (expected): $(eval echo \${EXPECTED_TARGET_"$i"})"
606 at_least_one_ko="true"
610 # verify that `merge_cmd` handles paths with spaces
611 record_parameters () {
624 merge_tool_path=record_parameters
626 merge_cmd vimdiff || at_least_one_ko=true
631 set hidden diffopt-=hiddenoff | echo | leftabove split | leftabove vertical split | 1b | wincmd l | leftabove vertical split | quit | wincmd l | 2b | wincmd j | 3b | execute 'tabdo windo diffthis' | tabfirst
637 diff -u expect actual || at_least_one_ko=true
639 if test "$at_least_one_ko" = "true"