git-mergetool.sh

   1 #!/bin/sh
   2 #
   3 # This program resolves merge conflicts in git
   4 #
   5 # Copyright (c) 2006 Theodore Y. Ts'o
   6 # Copyright (c) 2009-2016 David Aguilar
   7 #
   8 # This file is licensed under the GPL v2, or a later version
   9 # at the discretion of Junio C Hamano.
  10 #
  11
  12 USAGE='[--tool=tool] [--tool-help] [-y|--no-prompt|--prompt] [file to merge] ...'
  13 SUBDIRECTORY_OK=Yes
  14 NONGIT_OK=Yes
  15 OPTIONS_SPEC=
  16 TOOL_MODE=merge
  17 . git-sh-setup
  18 . git-mergetool--lib
  19
  20 # Returns true if the mode reflects a symlink
  21 is_symlink () {
  22         test "$1" = 120000
  23 }
  24
  25 is_submodule () {
  26         test "$1" = 160000
  27 }
  28
  29 local_present () {
  30         test -n "$local_mode"
  31 }
  32
  33 remote_present () {
  34         test -n "$remote_mode"
  35 }
  36
  37 base_present () {
  38         test -n "$base_mode"
  39 }
  40
  41 mergetool_tmpdir_init () {
  42         if test "$(git config --bool mergetool.writeToTemp)" != true
  43         then
  44                 MERGETOOL_TMPDIR=.
  45                 return 0
  46         fi
  47         if MERGETOOL_TMPDIR=$(mktemp -d -t "git-mergetool-XXXXXX" 2>/dev/null)
  48         then
  49                 return 0
  50         fi
  51         die "error: mktemp is needed when 'mergetool.writeToTemp' is true"
  52 }
  53
  54 cleanup_temp_files () {
  55         if test "$1" = --save-backup
  56         then
  57                 rm -rf -- "$MERGED.orig"
  58                 test -e "$BACKUP" && mv -- "$BACKUP" "$MERGED.orig"
  59                 rm -f -- "$LOCAL" "$REMOTE" "$BASE"
  60         else
  61                 rm -f -- "$LOCAL" "$REMOTE" "$BASE" "$BACKUP"
  62         fi
  63         if test "$MERGETOOL_TMPDIR" != "."
  64         then
  65                 rmdir "$MERGETOOL_TMPDIR"
  66         fi
  67 }
  68
  69 describe_file () {
  70         mode="$1"
  71         branch="$2"
  72         file="$3"
  73
  74         printf "  {%s}: " "$branch"
  75         if test -z "$mode"
  76         then
  77                 echo "deleted"
  78         elif is_symlink "$mode"
  79         then
  80                 echo "a symbolic link -> '$(cat "$file")'"
  81         elif is_submodule "$mode"
  82         then
  83                 echo "submodule commit $file"
  84         elif base_present
  85         then
  86                 echo "modified file"
  87         else
  88                 echo "created file"
  89         fi
  90 }
  91
  92 resolve_symlink_merge () {
  93         while true
  94         do
  95                 printf "Use (l)ocal or (r)emote, or (a)bort? "
  96                 read ans || return 1
  97                 case "$ans" in
  98                 [lL]*)
  99                         git checkout-index -f --stage=2 -- "$MERGED"
 100                         git add -- "$MERGED"
 101                         cleanup_temp_files --save-backup
 102                         return 0
 103                         ;;
 104                 [rR]*)
 105                         git checkout-index -f --stage=3 -- "$MERGED"
 106                         git add -- "$MERGED"
 107                         cleanup_temp_files --save-backup
 108                         return 0
 109                         ;;
 110                 [aA]*)
 111                         return 1
 112                         ;;
 113                 esac
 114         done
 115 }
 116
 117 resolve_deleted_merge () {
 118         while true
 119         do
 120                 if base_present
 121                 then
 122                         printf "Use (m)odified or (d)eleted file, or (a)bort? "
 123                 else
 124                         printf "Use (c)reated or (d)eleted file, or (a)bort? "
 125                 fi
 126                 read ans || return 1
 127                 case "$ans" in
 128                 [mMcC]*)
 129                         git add -- "$MERGED"
 130                         if test "$merge_keep_backup" = "true"
 131                         then
 132                                 cleanup_temp_files --save-backup
 133                         else
 134                                 cleanup_temp_files
 135                         fi
 136                         return 0
 137                         ;;
 138                 [dD]*)
 139                         git rm -- "$MERGED" > /dev/null
 140                         cleanup_temp_files
 141                         return 0
 142                         ;;
 143                 [aA]*)
 144                         if test "$merge_keep_temporaries" = "false"
 145                         then
 146                                 cleanup_temp_files
 147                         fi
 148                         return 1
 149                         ;;
 150                 esac
 151         done
 152 }
 153
 154 resolve_submodule_merge () {
 155         while true
 156         do
 157                 printf "Use (l)ocal or (r)emote, or (a)bort? "
 158                 read ans || return 1
 159                 case "$ans" in
 160                 [lL]*)
 161                         if ! local_present
 162                         then
 163                                 if test -n "$(git ls-tree HEAD -- "$MERGED")"
 164                                 then
 165                                         # Local isn't present, but it's a subdirectory
 166                                         git ls-tree --full-name -r HEAD -- "$MERGED" |
 167                                         git update-index --index-info || exit $?
 168                                 else
 169                                         test -e "$MERGED" && mv -- "$MERGED" "$BACKUP"
 170                                         git update-index --force-remove "$MERGED"
 171                                         cleanup_temp_files --save-backup
 172                                 fi
 173                         elif is_submodule "$local_mode"
 174                         then
 175                                 stage_submodule "$MERGED" "$local_sha1"
 176                         else
 177                                 git checkout-index -f --stage=2 -- "$MERGED"
 178                                 git add -- "$MERGED"
 179                         fi
 180                         return 0
 181                         ;;
 182                 [rR]*)
 183                         if ! remote_present
 184                         then
 185                                 if test -n "$(git ls-tree MERGE_HEAD -- "$MERGED")"
 186                                 then
 187                                         # Remote isn't present, but it's a subdirectory
 188                                         git ls-tree --full-name -r MERGE_HEAD -- "$MERGED" |
 189                                         git update-index --index-info || exit $?
 190                                 else
 191                                         test -e "$MERGED" && mv -- "$MERGED" "$BACKUP"
 192                                         git update-index --force-remove "$MERGED"
 193                                 fi
 194                         elif is_submodule "$remote_mode"
 195                         then
 196                                 ! is_submodule "$local_mode" &&
 197                                 test -e "$MERGED" &&
 198                                 mv -- "$MERGED" "$BACKUP"
 199                                 stage_submodule "$MERGED" "$remote_sha1"
 200                         else
 201                                 test -e "$MERGED" && mv -- "$MERGED" "$BACKUP"
 202                                 git checkout-index -f --stage=3 -- "$MERGED"
 203                                 git add -- "$MERGED"
 204                         fi
 205                         cleanup_temp_files --save-backup
 206                         return 0
 207                         ;;
 208                 [aA]*)
 209                         return 1
 210                         ;;
 211                 esac
 212         done
 213 }
 214
 215 stage_submodule () {
 216         path="$1"
 217         submodule_sha1="$2"
 218         mkdir -p "$path" ||
 219         die "fatal: unable to create directory for module at $path"
 220         # Find $path relative to work tree
 221         work_tree_root=$(cd_to_toplevel && pwd)
 222         work_rel_path=$(cd "$path" &&
 223                 GIT_WORK_TREE="${work_tree_root}" git rev-parse --show-prefix
 224         )
 225         test -n "$work_rel_path" ||
 226         die "fatal: unable to get path of module $path relative to work tree"
 227         git update-index --add --replace --cacheinfo 160000 "$submodule_sha1" "${work_rel_path%/}" || die
 228 }
 229
 230 checkout_staged_file () {
 231         tmpfile=$(expr \
 232                 "$(git checkout-index --temp --stage="$1" "$2" 2>/dev/null)" \
 233                 : '\([^ ]*\)    ')
 234
 235         if test $? -eq 0 && test -n "$tmpfile"
 236         then
 237                 mv -- "$(git rev-parse --show-cdup)$tmpfile" "$3"
 238         else
 239                 >"$3"
 240         fi
 241 }
 242
 243 merge_file () {
 244         MERGED="$1"
 245
 246         f=$(git ls-files -u -- "$MERGED")
 247         if test -z "$f"
 248         then
 249                 if test ! -f "$MERGED"
 250                 then
 251                         echo "$MERGED: file not found"
 252                 else
 253                         echo "$MERGED: file does not need merging"
 254                 fi
 255                 return 1
 256         fi
 257
 258         if BASE=$(expr "$MERGED" : '\(.*\)\.[^/]*$')
 259         then
 260                 ext=$(expr "$MERGED" : '.*\(\.[^/]*\)$')
 261         else
 262                 BASE=$MERGED
 263                 ext=
 264         fi
 265
 266         mergetool_tmpdir_init
 267
 268         if test "$MERGETOOL_TMPDIR" != "."
 269         then
 270                 # If we're using a temporary directory then write to the
 271                 # top-level of that directory.
 272                 BASE=${BASE##*/}
 273         fi
 274
 275         BACKUP="$MERGETOOL_TMPDIR/${BASE}_BACKUP_$$$ext"
 276         LOCAL="$MERGETOOL_TMPDIR/${BASE}_LOCAL_$$$ext"
 277         REMOTE="$MERGETOOL_TMPDIR/${BASE}_REMOTE_$$$ext"
 278         BASE="$MERGETOOL_TMPDIR/${BASE}_BASE_$$$ext"
 279
 280         base_mode=$(git ls-files -u -- "$MERGED" | awk '{if ($3==1) print $1;}')
 281         local_mode=$(git ls-files -u -- "$MERGED" | awk '{if ($3==2) print $1;}')
 282         remote_mode=$(git ls-files -u -- "$MERGED" | awk '{if ($3==3) print $1;}')
 283
 284         if is_submodule "$local_mode" || is_submodule "$remote_mode"
 285         then
 286                 echo "Submodule merge conflict for '$MERGED':"
 287                 local_sha1=$(git ls-files -u -- "$MERGED" | awk '{if ($3==2) print $2;}')
 288                 remote_sha1=$(git ls-files -u -- "$MERGED" | awk '{if ($3==3) print $2;}')
 289                 describe_file "$local_mode" "local" "$local_sha1"
 290                 describe_file "$remote_mode" "remote" "$remote_sha1"
 291                 resolve_submodule_merge
 292                 return
 293         fi
 294
 295         if test -f "$MERGED"
 296         then
 297                 mv -- "$MERGED" "$BACKUP"
 298                 cp -- "$BACKUP" "$MERGED"
 299         fi
 300         # Create a parent directory to handle delete/delete conflicts
 301         # where the base's directory no longer exists.
 302         mkdir -p "$(dirname "$MERGED")"
 303
 304         checkout_staged_file 1 "$MERGED" "$BASE"
 305         checkout_staged_file 2 "$MERGED" "$LOCAL"
 306         checkout_staged_file 3 "$MERGED" "$REMOTE"
 307
 308         if test -z "$local_mode" || test -z "$remote_mode"
 309         then
 310                 echo "Deleted merge conflict for '$MERGED':"
 311                 describe_file "$local_mode" "local" "$LOCAL"
 312                 describe_file "$remote_mode" "remote" "$REMOTE"
 313                 resolve_deleted_merge
 314                 status=$?
 315                 rmdir -p "$(dirname "$MERGED")" 2>/dev/null
 316                 return $status
 317         fi
 318
 319         if is_symlink "$local_mode" || is_symlink "$remote_mode"
 320         then
 321                 echo "Symbolic link merge conflict for '$MERGED':"
 322                 describe_file "$local_mode" "local" "$LOCAL"
 323                 describe_file "$remote_mode" "remote" "$REMOTE"
 324                 resolve_symlink_merge
 325                 return
 326         fi
 327
 328         echo "Normal merge conflict for '$MERGED':"
 329         describe_file "$local_mode" "local" "$LOCAL"
 330         describe_file "$remote_mode" "remote" "$REMOTE"
 331         if test "$guessed_merge_tool" = true || test "$prompt" = true
 332         then
 333                 printf "Hit return to start merge resolution tool (%s): " "$merge_tool"
 334                 read ans || return 1
 335         fi
 336
 337         if base_present
 338         then
 339                 present=true
 340         else
 341                 present=false
 342         fi
 343
 344         if ! run_merge_tool "$merge_tool" "$present"
 345         then
 346                 echo "merge of $MERGED failed" 1>&2
 347                 mv -- "$BACKUP" "$MERGED"
 348
 349                 if test "$merge_keep_temporaries" = "false"
 350                 then
 351                         cleanup_temp_files
 352                 fi
 353
 354                 return 1
 355         fi
 356
 357         if test "$merge_keep_backup" = "true"
 358         then
 359                 mv -- "$BACKUP" "$MERGED.orig"
 360         else
 361                 rm -- "$BACKUP"
 362         fi
 363
 364         git add -- "$MERGED"
 365         cleanup_temp_files
 366         return 0
 367 }
 368
 369 prompt_after_failed_merge () {
 370         while true
 371         do
 372                 printf "Continue merging other unresolved paths [y/n]? "
 373                 read ans || return 1
 374                 case "$ans" in
 375                 [yY]*)
 376                         return 0
 377                         ;;
 378                 [nN]*)
 379                         return 1
 380                         ;;
 381                 esac
 382         done
 383 }
 384
 385 main () {
 386         prompt=$(git config --bool mergetool.prompt)
 387         guessed_merge_tool=false
 388
 389         while test $# != 0
 390         do
 391                 case "$1" in
 392                 --tool-help=*)
 393                         TOOL_MODE=${1#--tool-help=}
 394                         show_tool_help
 395                         ;;
 396                 --tool-help)
 397                         show_tool_help
 398                         ;;
 399                 -t|--tool*)
 400                         case "$#,$1" in
 401                         *,*=*)
 402                                 merge_tool=$(expr "z$1" : 'z-[^=]*=\(.*\)')
 403                                 ;;
 404                         1,*)
 405                                 usage ;;
 406                         *)
 407                                 merge_tool="$2"
 408                                 shift ;;
 409                         esac
 410                         ;;
 411                 -y|--no-prompt)
 412                         prompt=false
 413                         ;;
 414                 --prompt)
 415                         prompt=true
 416                         ;;
 417                 --)
 418                         shift
 419                         break
 420                         ;;
 421                 -*)
 422                         usage
 423                         ;;
 424                 *)
 425                         break
 426                         ;;
 427                 esac
 428                 shift
 429         done
 430
 431         git_dir_init
 432         require_work_tree
 433
 434         if test -z "$merge_tool"
 435         then
 436                 # Check if a merge tool has been configured
 437                 merge_tool=$(get_configured_merge_tool)
 438                 # Try to guess an appropriate merge tool if no tool has been set.
 439                 if test -z "$merge_tool"
 440                 then
 441                         merge_tool=$(guess_merge_tool) || exit
 442                         guessed_merge_tool=true
 443                 fi
 444         fi
 445         merge_keep_backup="$(git config --bool mergetool.keepBackup || echo true)"
 446         merge_keep_temporaries="$(git config --bool mergetool.keepTemporaries || echo false)"
 447
 448         files=
 449
 450         if test $# -eq 0
 451         then
 452                 cd_to_toplevel
 453
 454                 if test -e "$GIT_DIR/MERGE_RR"
 455                 then
 456                         files=$(git rerere remaining)
 457                 else
 458                         files=$(git ls-files -u |
 459                                 sed -e 's/^[^   ]*      //' | sort -u)
 460                 fi
 461         else
 462                 files=$(git ls-files -u -- "$@" |
 463                         sed -e 's/^[^   ]*      //' | sort -u)
 464         fi
 465
 466         if test -z "$files"
 467         then
 468                 echo "No files need merging"
 469                 exit 0
 470         fi
 471
 472         printf "Merging:\n"
 473         printf "%s\n" "$files"
 474
 475         rc=0
 476         for i in $files
 477         do
 478                 printf "\n"
 479                 if ! merge_file "$i"
 480                 then
 481                         rc=1
 482                         prompt_after_failed_merge || exit 1
 483                 fi
 484         done
 485
 486         exit $rc
 487 }
 488
 489 main "$@"