Merge branch 'maint'
[git/jnareb-git.git] / git-mergetool--lib.sh
blob91f90acfba2a710644f4a076d27d50e0fbb33c2d
1 #!/bin/sh
2 # git-mergetool--lib is a library for common merge tool functions
3 diff_mode() {
4 test "$TOOL_MODE" = diff
7 merge_mode() {
8 test "$TOOL_MODE" = merge
11 translate_merge_tool_path () {
12 case "$1" in
13 araxis)
14 echo compare
16 bc3)
17 echo bcompare
19 emerge)
20 echo emacs
22 gvimdiff|gvimdiff2)
23 echo gvim
25 vimdiff|vimdiff2)
26 echo vim
29 echo "$1"
31 esac
34 check_unchanged () {
35 if test "$MERGED" -nt "$BACKUP"; then
36 status=0
37 else
38 while true; do
39 echo "$MERGED seems unchanged."
40 printf "Was the merge successful? [y/n] "
41 read answer
42 case "$answer" in
43 y*|Y*) status=0; break ;;
44 n*|N*) status=1; break ;;
45 esac
46 done
50 valid_tool () {
51 case "$1" in
52 araxis | bc3 | diffuse | ecmerge | emerge | gvimdiff | gvimdiff2 | \
53 kdiff3 | meld | opendiff | p4merge | tkdiff | vimdiff | vimdiff2 | xxdiff)
54 ;; # happy
55 kompare)
56 if ! diff_mode; then
57 return 1
60 tortoisemerge)
61 if ! merge_mode; then
62 return 1
66 if test -z "$(get_merge_tool_cmd "$1")"; then
67 return 1
70 esac
73 get_merge_tool_cmd () {
74 # Prints the custom command for a merge tool
75 if test -n "$1"; then
76 merge_tool="$1"
77 else
78 merge_tool="$(get_merge_tool)"
80 if diff_mode; then
81 echo "$(git config difftool.$merge_tool.cmd ||
82 git config mergetool.$merge_tool.cmd)"
83 else
84 echo "$(git config mergetool.$merge_tool.cmd)"
88 run_merge_tool () {
89 # If GIT_PREFIX is empty then we cannot use it in tools
90 # that expect to be able to chdir() to its value.
91 GIT_PREFIX=${GIT_PREFIX:-.}
92 export GIT_PREFIX
94 merge_tool_path="$(get_merge_tool_path "$1")" || exit
95 base_present="$2"
96 status=0
98 case "$1" in
99 araxis)
100 if merge_mode; then
101 touch "$BACKUP"
102 if $base_present; then
103 "$merge_tool_path" -wait -merge -3 -a1 \
104 "$BASE" "$LOCAL" "$REMOTE" "$MERGED" \
105 >/dev/null 2>&1
106 else
107 "$merge_tool_path" -wait -2 \
108 "$LOCAL" "$REMOTE" "$MERGED" \
109 >/dev/null 2>&1
111 check_unchanged
112 else
113 "$merge_tool_path" -wait -2 "$LOCAL" "$REMOTE" \
114 >/dev/null 2>&1
117 bc3)
118 if merge_mode; then
119 touch "$BACKUP"
120 if $base_present; then
121 "$merge_tool_path" "$LOCAL" "$REMOTE" "$BASE" \
122 -mergeoutput="$MERGED"
123 else
124 "$merge_tool_path" "$LOCAL" "$REMOTE" \
125 -mergeoutput="$MERGED"
127 check_unchanged
128 else
129 "$merge_tool_path" "$LOCAL" "$REMOTE"
132 diffuse)
133 if merge_mode; then
134 touch "$BACKUP"
135 if $base_present; then
136 "$merge_tool_path" \
137 "$LOCAL" "$MERGED" "$REMOTE" \
138 "$BASE" | cat
139 else
140 "$merge_tool_path" \
141 "$LOCAL" "$MERGED" "$REMOTE" | cat
143 check_unchanged
144 else
145 "$merge_tool_path" "$LOCAL" "$REMOTE" | cat
148 ecmerge)
149 if merge_mode; then
150 touch "$BACKUP"
151 if $base_present; then
152 "$merge_tool_path" "$BASE" "$LOCAL" "$REMOTE" \
153 --default --mode=merge3 --to="$MERGED"
154 else
155 "$merge_tool_path" "$LOCAL" "$REMOTE" \
156 --default --mode=merge2 --to="$MERGED"
158 check_unchanged
159 else
160 "$merge_tool_path" --default --mode=diff2 \
161 "$LOCAL" "$REMOTE"
164 emerge)
165 if merge_mode; then
166 if $base_present; then
167 "$merge_tool_path" \
168 -f emerge-files-with-ancestor-command \
169 "$LOCAL" "$REMOTE" "$BASE" \
170 "$(basename "$MERGED")"
171 else
172 "$merge_tool_path" \
173 -f emerge-files-command \
174 "$LOCAL" "$REMOTE" \
175 "$(basename "$MERGED")"
177 status=$?
178 else
179 "$merge_tool_path" -f emerge-files-command \
180 "$LOCAL" "$REMOTE"
183 gvimdiff|vimdiff)
184 if merge_mode; then
185 touch "$BACKUP"
186 if $base_present; then
187 "$merge_tool_path" -f -d -c "wincmd J" \
188 "$MERGED" "$LOCAL" "$BASE" "$REMOTE"
189 else
190 "$merge_tool_path" -f -d -c "wincmd l" \
191 "$LOCAL" "$MERGED" "$REMOTE"
193 check_unchanged
194 else
195 "$merge_tool_path" -R -f -d -c "wincmd l" \
196 -c 'cd $GIT_PREFIX' \
197 "$LOCAL" "$REMOTE"
200 gvimdiff2|vimdiff2)
201 if merge_mode; then
202 touch "$BACKUP"
203 "$merge_tool_path" -f -d -c "wincmd l" \
204 "$LOCAL" "$MERGED" "$REMOTE"
205 check_unchanged
206 else
207 "$merge_tool_path" -R -f -d -c "wincmd l" \
208 -c 'cd $GIT_PREFIX' \
209 "$LOCAL" "$REMOTE"
212 kdiff3)
213 if merge_mode; then
214 if $base_present; then
215 ("$merge_tool_path" --auto \
216 --L1 "$MERGED (Base)" \
217 --L2 "$MERGED (Local)" \
218 --L3 "$MERGED (Remote)" \
219 -o "$MERGED" \
220 "$BASE" "$LOCAL" "$REMOTE" \
221 > /dev/null 2>&1)
222 else
223 ("$merge_tool_path" --auto \
224 --L1 "$MERGED (Local)" \
225 --L2 "$MERGED (Remote)" \
226 -o "$MERGED" \
227 "$LOCAL" "$REMOTE" \
228 > /dev/null 2>&1)
230 status=$?
231 else
232 ("$merge_tool_path" --auto \
233 --L1 "$MERGED (A)" \
234 --L2 "$MERGED (B)" "$LOCAL" "$REMOTE" \
235 > /dev/null 2>&1)
238 kompare)
239 "$merge_tool_path" "$LOCAL" "$REMOTE"
241 meld)
242 if merge_mode; then
243 touch "$BACKUP"
244 "$merge_tool_path" "$LOCAL" "$MERGED" "$REMOTE"
245 check_unchanged
246 else
247 "$merge_tool_path" "$LOCAL" "$REMOTE"
250 opendiff)
251 if merge_mode; then
252 touch "$BACKUP"
253 if $base_present; then
254 "$merge_tool_path" "$LOCAL" "$REMOTE" \
255 -ancestor "$BASE" \
256 -merge "$MERGED" | cat
257 else
258 "$merge_tool_path" "$LOCAL" "$REMOTE" \
259 -merge "$MERGED" | cat
261 check_unchanged
262 else
263 "$merge_tool_path" "$LOCAL" "$REMOTE" | cat
266 p4merge)
267 if merge_mode; then
268 touch "$BACKUP"
269 $base_present || >"$BASE"
270 "$merge_tool_path" "$BASE" "$LOCAL" "$REMOTE" "$MERGED"
271 check_unchanged
272 else
273 "$merge_tool_path" "$LOCAL" "$REMOTE"
276 tkdiff)
277 if merge_mode; then
278 if $base_present; then
279 "$merge_tool_path" -a "$BASE" \
280 -o "$MERGED" "$LOCAL" "$REMOTE"
281 else
282 "$merge_tool_path" \
283 -o "$MERGED" "$LOCAL" "$REMOTE"
285 status=$?
286 else
287 "$merge_tool_path" "$LOCAL" "$REMOTE"
290 tortoisemerge)
291 if $base_present; then
292 touch "$BACKUP"
293 "$merge_tool_path" \
294 -base:"$BASE" -mine:"$LOCAL" \
295 -theirs:"$REMOTE" -merged:"$MERGED"
296 check_unchanged
297 else
298 echo "TortoiseMerge cannot be used without a base" 1>&2
299 status=1
302 xxdiff)
303 if merge_mode; then
304 touch "$BACKUP"
305 if $base_present; then
306 "$merge_tool_path" -X --show-merged-pane \
307 -R 'Accel.SaveAsMerged: "Ctrl-S"' \
308 -R 'Accel.Search: "Ctrl+F"' \
309 -R 'Accel.SearchForward: "Ctrl-G"' \
310 --merged-file "$MERGED" \
311 "$LOCAL" "$BASE" "$REMOTE"
312 else
313 "$merge_tool_path" -X $extra \
314 -R 'Accel.SaveAsMerged: "Ctrl-S"' \
315 -R 'Accel.Search: "Ctrl+F"' \
316 -R 'Accel.SearchForward: "Ctrl-G"' \
317 --merged-file "$MERGED" \
318 "$LOCAL" "$REMOTE"
320 check_unchanged
321 else
322 "$merge_tool_path" \
323 -R 'Accel.Search: "Ctrl+F"' \
324 -R 'Accel.SearchForward: "Ctrl-G"' \
325 "$LOCAL" "$REMOTE"
329 merge_tool_cmd="$(get_merge_tool_cmd "$1")"
330 if test -z "$merge_tool_cmd"; then
331 if merge_mode; then
332 status=1
334 break
336 if merge_mode; then
337 trust_exit_code="$(git config --bool \
338 mergetool."$1".trustExitCode || echo false)"
339 if test "$trust_exit_code" = "false"; then
340 touch "$BACKUP"
341 ( eval $merge_tool_cmd )
342 check_unchanged
343 else
344 ( eval $merge_tool_cmd )
345 status=$?
347 else
348 ( eval $merge_tool_cmd )
351 esac
352 return $status
355 guess_merge_tool () {
356 if merge_mode; then
357 tools="tortoisemerge"
358 else
359 tools="kompare"
361 if test -n "$DISPLAY"; then
362 if test -n "$GNOME_DESKTOP_SESSION_ID" ; then
363 tools="meld opendiff kdiff3 tkdiff xxdiff $tools"
364 else
365 tools="opendiff kdiff3 tkdiff xxdiff meld $tools"
367 tools="$tools gvimdiff diffuse ecmerge p4merge araxis bc3"
369 case "${VISUAL:-$EDITOR}" in
370 *vim*)
371 tools="$tools vimdiff emerge"
374 tools="$tools emerge vimdiff"
376 esac
377 echo >&2 "merge tool candidates: $tools"
379 # Loop over each candidate and stop when a valid merge tool is found.
380 for i in $tools
382 merge_tool_path="$(translate_merge_tool_path "$i")"
383 if type "$merge_tool_path" > /dev/null 2>&1; then
384 echo "$i"
385 return 0
387 done
389 echo >&2 "No known merge resolution program available."
390 return 1
393 get_configured_merge_tool () {
394 # Diff mode first tries diff.tool and falls back to merge.tool.
395 # Merge mode only checks merge.tool
396 if diff_mode; then
397 merge_tool=$(git config diff.tool || git config merge.tool)
398 else
399 merge_tool=$(git config merge.tool)
401 if test -n "$merge_tool" && ! valid_tool "$merge_tool"; then
402 echo >&2 "git config option $TOOL_MODE.tool set to unknown tool: $merge_tool"
403 echo >&2 "Resetting to default..."
404 return 1
406 echo "$merge_tool"
409 get_merge_tool_path () {
410 # A merge tool has been set, so verify that it's valid.
411 if test -n "$1"; then
412 merge_tool="$1"
413 else
414 merge_tool="$(get_merge_tool)"
416 if ! valid_tool "$merge_tool"; then
417 echo >&2 "Unknown merge tool $merge_tool"
418 exit 1
420 if diff_mode; then
421 merge_tool_path=$(git config difftool."$merge_tool".path ||
422 git config mergetool."$merge_tool".path)
423 else
424 merge_tool_path=$(git config mergetool."$merge_tool".path)
426 if test -z "$merge_tool_path"; then
427 merge_tool_path="$(translate_merge_tool_path "$merge_tool")"
429 if test -z "$(get_merge_tool_cmd "$merge_tool")" &&
430 ! type "$merge_tool_path" > /dev/null 2>&1; then
431 echo >&2 "The $TOOL_MODE tool $merge_tool is not available as"\
432 "'$merge_tool_path'"
433 exit 1
435 echo "$merge_tool_path"
438 get_merge_tool () {
439 # Check if a merge tool has been configured
440 merge_tool=$(get_configured_merge_tool)
441 # Try to guess an appropriate merge tool if no tool has been set.
442 if test -z "$merge_tool"; then
443 merge_tool="$(guess_merge_tool)" || exit
445 echo "$merge_tool"