1# git-mergetool--lib is a shell library for common merge tool functions
2
3: ${MERGE_TOOLS_DIR=$(git --exec-path)/mergetools}
4
5IFS='
6'
7
8mode_ok () {
9 if diff_mode
10 then
11 can_diff
12 elif merge_mode
13 then
14 can_merge
15 else
16 false
17 fi
18}
19
20is_available () {
21 merge_tool_path=$(translate_merge_tool_path "$1") &&
22 type "$merge_tool_path" >/dev/null 2>&1
23}
24
25list_config_tools () {
26 section=$1
27 line_prefix=${2:-}
28
29 git config --get-regexp $section'\..*\.cmd' |
30 while read -r key value
31 do
32 toolname=${key#$section.}
33 toolname=${toolname%.cmd}
34
35 printf "%s%s\n" "$line_prefix" "$toolname"
36 done
37}
38
39show_tool_names () {
40 condition=${1:-true} per_line_prefix=${2:-} preamble=${3:-}
41 not_found_msg=${4:-}
42 extra_content=${5:-}
43
44 shown_any=
45 ( cd "$MERGE_TOOLS_DIR" && ls ) | {
46 while read toolname
47 do
48 if setup_tool "$toolname" 2>/dev/null &&
49 (eval "$condition" "$toolname")
50 then
51 if test -n "$preamble"
52 then
53 printf "%s\n" "$preamble"
54 preamble=
55 fi
56 shown_any=yes
57 printf "%s%s\n" "$per_line_prefix" "$toolname"
58 fi
59 done
60
61 if test -n "$extra_content"
62 then
63 if test -n "$preamble"
64 then
65 # Note: no '\n' here since we don't want a
66 # blank line if there is no initial content.
67 printf "%s" "$preamble"
68 preamble=
69 fi
70 shown_any=yes
71 printf "\n%s\n" "$extra_content"
72 fi
73
74 if test -n "$preamble" && test -n "$not_found_msg"
75 then
76 printf "%s\n" "$not_found_msg"
77 fi
78
79 test -n "$shown_any"
80 }
81}
82
83diff_mode() {
84 test "$TOOL_MODE" = diff
85}
86
87merge_mode() {
88 test "$TOOL_MODE" = merge
89}
90
91translate_merge_tool_path () {
92 echo "$1"
93}
94
95check_unchanged () {
96 if test "$MERGED" -nt "$BACKUP"
97 then
98 return 0
99 else
100 while true
101 do
102 echo "$MERGED seems unchanged."
103 printf "Was the merge successful [y/n]? "
104 read answer || return 1
105 case "$answer" in
106 y*|Y*) return 0 ;;
107 n*|N*) return 1 ;;
108 esac
109 done
110 fi
111}
112
113valid_tool () {
114 setup_tool "$1" && return 0
115 cmd=$(get_merge_tool_cmd "$1")
116 test -n "$cmd"
117}
118
119setup_user_tool () {
120 merge_tool_cmd=$(get_merge_tool_cmd "$tool")
121 test -n "$merge_tool_cmd" || return 1
122
123 diff_cmd () {
124 ( eval $merge_tool_cmd )
125 }
126
127 merge_cmd () {
128 trust_exit_code=$(git config --bool \
129 "mergetool.$1.trustExitCode" || echo false)
130 if test "$trust_exit_code" = "false"
131 then
132 touch "$BACKUP"
133 ( eval $merge_tool_cmd )
134 check_unchanged
135 else
136 ( eval $merge_tool_cmd )
137 fi
138 }
139}
140
141setup_tool () {
142 tool="$1"
143
144 # Fallback definitions, to be overridden by tools.
145 can_merge () {
146 return 0
147 }
148
149 can_diff () {
150 return 0
151 }
152
153 diff_cmd () {
154 return 1
155 }
156
157 merge_cmd () {
158 return 1
159 }
160
161 translate_merge_tool_path () {
162 echo "$1"
163 }
164
165 if ! test -f "$MERGE_TOOLS_DIR/$tool"
166 then
167 setup_user_tool
168 return $?
169 fi
170
171 # Load the redefined functions
172 . "$MERGE_TOOLS_DIR/$tool"
173 # Now let the user override the default command for the tool. If
174 # they have not done so then this will return 1 which we ignore.
175 setup_user_tool
176
177 if merge_mode && ! can_merge
178 then
179 echo "error: '$tool' can not be used to resolve merges" >&2
180 return 1
181 elif diff_mode && ! can_diff
182 then
183 echo "error: '$tool' can only be used to resolve merges" >&2
184 return 1
185 fi
186 return 0
187}
188
189get_merge_tool_cmd () {
190 merge_tool="$1"
191 if diff_mode
192 then
193 git config "difftool.$merge_tool.cmd" ||
194 git config "mergetool.$merge_tool.cmd"
195 else
196 git config "mergetool.$merge_tool.cmd"
197 fi
198}
199
200# Entry point for running tools
201run_merge_tool () {
202 # If GIT_PREFIX is empty then we cannot use it in tools
203 # that expect to be able to chdir() to its value.
204 GIT_PREFIX=${GIT_PREFIX:-.}
205 export GIT_PREFIX
206
207 merge_tool_path=$(get_merge_tool_path "$1") || exit
208 base_present="$2"
209
210 # Bring tool-specific functions into scope
211 setup_tool "$1" || return 1
212
213 if merge_mode
214 then
215 run_merge_cmd "$1"
216 else
217 run_diff_cmd "$1"
218 fi
219}
220
221# Run a either a configured or built-in diff tool
222run_diff_cmd () {
223 diff_cmd "$1"
224}
225
226# Run a either a configured or built-in merge tool
227run_merge_cmd () {
228 merge_cmd "$1"
229}
230
231list_merge_tool_candidates () {
232 if merge_mode
233 then
234 tools="tortoisemerge"
235 else
236 tools="kompare"
237 fi
238 if test -n "$DISPLAY"
239 then
240 if test -n "$GNOME_DESKTOP_SESSION_ID"
241 then
242 tools="meld opendiff kdiff3 tkdiff xxdiff $tools"
243 else
244 tools="opendiff kdiff3 tkdiff xxdiff meld $tools"
245 fi
246 tools="$tools gvimdiff diffuse diffmerge ecmerge"
247 tools="$tools p4merge araxis bc codecompare"
248 fi
249 case "${VISUAL:-$EDITOR}" in
250 *vim*)
251 tools="$tools vimdiff emerge"
252 ;;
253 *)
254 tools="$tools emerge vimdiff"
255 ;;
256 esac
257}
258
259show_tool_help () {
260 tool_opt="'git ${TOOL_MODE}tool --tool=<tool>'"
261
262 tab=' '
263 LF='
264'
265 any_shown=no
266
267 cmd_name=${TOOL_MODE}tool
268 config_tools=$({
269 diff_mode && list_config_tools difftool "$tab$tab"
270 list_config_tools mergetool "$tab$tab"
271 } | sort)
272 extra_content=
273 if test -n "$config_tools"
274 then
275 extra_content="${tab}user-defined:${LF}$config_tools"
276 fi
277
278 show_tool_names 'mode_ok && is_available' "$tab$tab" \
279 "$tool_opt may be set to one of the following:" \
280 "No suitable tool for 'git $cmd_name --tool=<tool>' found." \
281 "$extra_content" &&
282 any_shown=yes
283
284 show_tool_names 'mode_ok && ! is_available' "$tab$tab" \
285 "${LF}The following tools are valid, but not currently available:" &&
286 any_shown=yes
287
288 if test "$any_shown" = yes
289 then
290 echo
291 echo "Some of the tools listed above only work in a windowed"
292 echo "environment. If run in a terminal-only session, they will fail."
293 fi
294 exit 0
295}
296
297guess_merge_tool () {
298 list_merge_tool_candidates
299 cat >&2 <<-EOF
300
301 This message is displayed because '$TOOL_MODE.tool' is not configured.
302 See 'git ${TOOL_MODE}tool --tool-help' or 'git help config' for more details.
303 'git ${TOOL_MODE}tool' will now attempt to use one of the following tools:
304 $tools
305 EOF
306
307 # Loop over each candidate and stop when a valid merge tool is found.
308 IFS=' '
309 for tool in $tools
310 do
311 is_available "$tool" && echo "$tool" && return 0
312 done
313
314 echo >&2 "No known ${TOOL_MODE} tool is available."
315 return 1
316}
317
318get_configured_merge_tool () {
319 # Diff mode first tries diff.tool and falls back to merge.tool.
320 # Merge mode only checks merge.tool
321 if diff_mode
322 then
323 merge_tool=$(git config diff.tool || git config merge.tool)
324 else
325 merge_tool=$(git config merge.tool)
326 fi
327 if test -n "$merge_tool" && ! valid_tool "$merge_tool"
328 then
329 echo >&2 "git config option $TOOL_MODE.tool set to unknown tool: $merge_tool"
330 echo >&2 "Resetting to default..."
331 return 1
332 fi
333 echo "$merge_tool"
334}
335
336get_merge_tool_path () {
337 # A merge tool has been set, so verify that it's valid.
338 merge_tool="$1"
339 if ! valid_tool "$merge_tool"
340 then
341 echo >&2 "Unknown merge tool $merge_tool"
342 exit 1
343 fi
344 if diff_mode
345 then
346 merge_tool_path=$(git config difftool."$merge_tool".path ||
347 git config mergetool."$merge_tool".path)
348 else
349 merge_tool_path=$(git config mergetool."$merge_tool".path)
350 fi
351 if test -z "$merge_tool_path"
352 then
353 merge_tool_path=$(translate_merge_tool_path "$merge_tool")
354 fi
355 if test -z "$(get_merge_tool_cmd "$merge_tool")" &&
356 ! type "$merge_tool_path" >/dev/null 2>&1
357 then
358 echo >&2 "The $TOOL_MODE tool $merge_tool is not available as"\
359 "'$merge_tool_path'"
360 exit 1
361 fi
362 echo "$merge_tool_path"
363}
364
365get_merge_tool () {
366 # Check if a merge tool has been configured
367 merge_tool=$(get_configured_merge_tool)
368 # Try to guess an appropriate merge tool if no tool has been set.
369 if test -z "$merge_tool"
370 then
371 merge_tool=$(guess_merge_tool) || exit
372 fi
373 echo "$merge_tool"
374}
375
376mergetool_find_win32_cmd () {
377 executable=$1
378 sub_directory=$2
379
380 # Use $executable if it exists in $PATH
381 if type -p "$executable" >/dev/null 2>&1
382 then
383 printf '%s' "$executable"
384 return
385 fi
386
387 # Look for executable in the typical locations
388 for directory in $(env | grep -Ei '^PROGRAM(FILES(\(X86\))?|W6432)=' |
389 cut -d '=' -f 2- | sort -u)
390 do
391 if test -n "$directory" && test -x "$directory/$sub_directory/$executable"
392 then
393 printf '%s' "$directory/$sub_directory/$executable"
394 return
395 fi
396 done
397
398 printf '%s' "$executable"
399}