1#!/bin/sh 2# Copyright (c) 2007, Nanako Shiraishi 3 4dashless=$(basename "$0" | sed -e 's/-/ /') 5USAGE="list [<options>] 6 or:$dashlessshow [<stash>] 7 or:$dashlessdrop [-q|--quiet] [<stash>] 8 or:$dashless( pop | apply ) [--index] [-q|--quiet] [<stash>] 9 or:$dashlessbranch <branchname> [<stash>] 10 or:$dashless[save [--patch] [-k|--[no-]keep-index] [-q|--quiet] 11 [-u|--include-untracked] [-a|--all] [<message>]] 12 or:$dashlessclear" 13 14SUBDIRECTORY_OK=Yes 15OPTIONS_SPEC= 16START_DIR=$(pwd) 17. git-sh-setup 18. git-sh-i18n 19require_work_tree 20cd_to_toplevel 21 22TMP="$GIT_DIR/.git-stash.$$" 23TMPindex=${GIT_INDEX_FILE-"$GIT_DIR/index"}.stash.$$ 24trap'rm -f "$TMP-"* "$TMPindex"'0 25 26ref_stash=refs/stash 27 28if git config --get-colorbool color.interactive;then 29 help_color="$(git config --get-color color.interactive.help 'red bold')" 30 reset_color="$(git config --get-color '' reset)" 31else 32 help_color= 33 reset_color= 34fi 35 36no_changes () { 37 git diff-index --quiet --cached HEAD --ignore-submodules --&& 38 git diff-files --quiet --ignore-submodules&& 39(test -z"$untracked"||test -z"$(untracked_files)") 40} 41 42untracked_files () { 43 excl_opt=--exclude-standard 44test"$untracked"="all"&& excl_opt= 45 git ls-files -o -z$excl_opt 46} 47 48clear_stash () { 49iftest$#!=0 50then 51 die "$(gettext "git stash clear with parameters is unimplemented")" 52fi 53if current=$(git rev-parse --verify --quiet $ref_stash) 54then 55 git update-ref -d$ref_stash $current 56fi 57} 58 59create_stash () { 60 stash_msg="$1" 61 untracked="$2" 62 63 git update-index -q --refresh 64if no_changes 65then 66exit0 67fi 68 69# state of the base commit 70if b_commit=$(git rev-parse --verify HEAD) 71then 72head=$(git rev-list --oneline -n 1 HEAD --) 73else 74 die "$(gettext "You do not have the initial commit yet")" 75fi 76 77if branch=$(git symbolic-ref -q HEAD) 78then 79 branch=${branch#refs/heads/} 80else 81 branch='(no branch)' 82fi 83 msg=$(printf '%s: %s' "$branch" "$head") 84 85# state of the index 86 i_tree=$(git write-tree)&& 87 i_commit=$(printf'index on %s\n'"$msg"| 88 git commit-tree$i_tree-p$b_commit) || 89 die "$(gettext "Cannot save the current index state")" 90 91iftest -n"$untracked" 92then 93# Untracked files are stored by themselves in a parentless commit, for 94# ease of unpacking later. 95 u_commit=$( 96 untracked_files | ( 97 GIT_INDEX_FILE="$TMPindex"&& 98export GIT_INDEX_FILE && 99rm-f"$TMPindex"&& 100 git update-index -z --add --remove --stdin&& 101 u_tree=$(git write-tree)&& 102printf'untracked files on %s\n'"$msg"| git commit-tree$u_tree&& 103rm-f"$TMPindex" 104) ) || die "Cannot save the untracked files" 105 106 untracked_commit_option="-p$u_commit"; 107else 108 untracked_commit_option= 109fi 110 111iftest -z"$patch_mode" 112then 113 114# state of the working tree 115 w_tree=$( ( 116 git read-tree --index-output="$TMPindex"-m$i_tree&& 117 GIT_INDEX_FILE="$TMPindex"&& 118export GIT_INDEX_FILE && 119 git diff--name-only -z HEAD -->"$TMP-stagenames"&& 120 git update-index -z --add --remove --stdin<"$TMP-stagenames"&& 121 git write-tree&& 122rm-f"$TMPindex" 123) ) || 124 die "$(gettext "Cannot save the current worktree state")" 125 126else 127 128rm-f"$TMP-index"&& 129 GIT_INDEX_FILE="$TMP-index" git read-tree HEAD && 130 131# find out what the user wants 132 GIT_INDEX_FILE="$TMP-index" \ 133 git add--interactive --patch=stash --&& 134 135# state of the working tree 136 w_tree=$(GIT_INDEX_FILE="$TMP-index" git write-tree)|| 137 die "$(gettext "Cannot save the current worktree state")" 138 139 git diff-tree -p HEAD $w_tree-->"$TMP-patch"&& 140test -s"$TMP-patch"|| 141 die "$(gettext "No changes selected")" 142 143rm-f"$TMP-index"|| 144 die "$(gettext "Cannot remove temporary index (can't happen)")" 145 146 fi 147 148 # create the stash 149 if test -z "$stash_msg" 150 then 151 stash_msg=$(printf 'WIP on %s' "$msg") 152 else 153 stash_msg=$(printf 'On %s: %s' "$branch" "$stash_msg") 154 fi 155 w_commit=$(printf '%s\n' "$stash_msg" | 156 git commit-tree$w_tree-p$b_commit-p$i_commit$untracked_commit_option) || 157 die "$(gettext "Cannot record working tree state")" 158} 159 160store_stash () { 161 while test$#!= 0 162 do 163 case "$1" in 164 -m|--message) 165 shift 166 stash_msg="$1" 167 ;; 168 -q|--quiet) 169 quiet=t 170 ;; 171 *) 172 break 173 ;; 174 esac 175 shift 176 done 177 test$#= 1 || 178 die "$(eval_gettext "\"$dashless store\" requires one <commit> argument")" 179 180 w_commit="$1" 181 if test -z "$stash_msg" 182 then 183 stash_msg="Created via \"git stash store\"." 184 fi 185 186 # Make sure the reflog for stash is kept. 187 : >>"$GIT_DIR/logs/$ref_stash" 188 git update-ref -m "$stash_msg"$ref_stash$w_commit 189 ret=$? 190 test$ret!= 0 && test -z$quiet&& 191 die "$(eval_gettext "Cannot update \$ref_stash with \$w_commit")" 192 return$ret 193} 194 195save_stash () { 196 keep_index= 197 patch_mode= 198 untracked= 199 while test$#!= 0 200 do 201 case "$1" in 202 -k|--keep-index) 203 keep_index=t 204 ;; 205 --no-keep-index) 206 keep_index=n 207 ;; 208 -p|--patch) 209 patch_mode=t 210 # only default to keep if we don't already have an override 211 test -z "$keep_index" && keep_index=t 212 ;; 213 -q|--quiet) 214 GIT_QUIET=t 215 ;; 216 -u|--include-untracked) 217 untracked=untracked 218 ;; 219 -a|--all) 220 untracked=all 221 ;; 222 --) 223 shift 224 break 225 ;; 226 -*) 227 option="$1" 228 # TRANSLATORS:$optionis an invalid option, like 229 # `--blah-blah'. The 7 spaces at the beginning of the 230 # second line correspond to "error:". So you should line 231 # up the second line with however many characters the 232 # translation of "error:" takes in your language. E.g. in 233 # English this is: 234 # 235 # $ git stash save --blah-blah 2>&1 | head -n 2 236 # error: unknown option for 'stash save': --blah-blah 237 # To provide a message, use git stash save -- '--blah-blah' 238 eval_gettextln "error: unknown option for'stash save': \$option 239 To provide a message, use git stash save --'\$option'" 240 usage 241 ;; 242 *) 243 break 244 ;; 245 esac 246 shift 247 done 248 249 if test -n "$patch_mode" && test -n "$untracked" 250 then 251 die "Can't use --patch and --include-untracked or --all at the same time" 252 fi 253 254 stash_msg="$*" 255 256 git update-index -q --refresh 257 if no_changes 258 then 259 say "$(gettext "No local changes to save")" 260 exit 0 261 fi 262 test -f "$GIT_DIR/logs/$ref_stash" || 263 clear_stash || die "$(gettext "Cannot initialize stash")" 264 265 create_stash "$stash_msg"$untracked 266 store_stash -m "$stash_msg" -q$w_commit|| 267 die "$(gettext "Cannot save the current status")" 268 say Saved working directory and index state "$stash_msg" 269 270 if test -z "$patch_mode" 271 then 272 git reset --hard${GIT_QUIET:+-q} 273 test "$untracked" = "all" && CLEAN_X_OPTION=-x || CLEAN_X_OPTION= 274 if test -n "$untracked" 275 then 276 git clean --force --quiet -d$CLEAN_X_OPTION 277 fi 278 279 if test "$keep_index" = "t" && test -n$i_tree 280 then 281 git read-tree --reset -u$i_tree 282 fi 283 else 284 git apply -R < "$TMP-patch" || 285 die "$(gettext "Cannot remove worktree changes")" 286 287 if test "$keep_index" != "t" 288 then 289 git reset 290 fi 291 fi 292} 293 294have_stash () { 295 git rev-parse --verify --quiet$ref_stash>/dev/null 296} 297 298list_stash () { 299 have_stash || return 0 300 git log --format="%gd: %gs" -g --first-parent -m "$@"$ref_stash-- 301} 302 303show_stash () { 304 assert_stash_like "$@" 305 306 git diff${FLAGS:---stat}$b_commit$w_commit 307} 308 309# 310# Parses the remaining options looking for flags and 311# at most one revision defaulting to${ref_stash}@{0} 312# if none found. 313# 314# Derives related tree and commit objects from the 315# revision, if one is found. 316# 317# stash records the work tree, and is a merge between the 318# base commit (first parent) and the index tree (second parent). 319# 320# REV is set to the symbolic version of the specified stash-like commit 321# IS_STASH_LIKE is non-blank if${REV}looks like a stash 322# IS_STASH_REF is non-blank if the${REV}looks like a stash ref 323# s is set to the SHA1 of the stash commit 324# w_commit is set to the commit containing the working tree 325# b_commit is set to the base commit 326# i_commit is set to the commit containing the index tree 327# u_commit is set to the commit containing the untracked files tree 328# w_tree is set to the working tree 329# b_tree is set to the base tree 330# i_tree is set to the index tree 331# u_tree is set to the untracked files tree 332# 333# GIT_QUIET is set to t if -q is specified 334# INDEX_OPTION is set to --index if --index is specified. 335# FLAGS is set to the remaining flags 336# 337# dies if: 338# * too many revisions specified 339# * no revision is specified and there is no stash stack 340# * a revision is specified which cannot be resolve to a SHA1 341# * a non-existent stash reference is specified 342# 343 344parse_flags_and_rev() 345{ 346 test "$PARSE_CACHE" = "$*" && return 0 # optimisation 347 PARSE_CACHE="$*" 348 349 IS_STASH_LIKE= 350 IS_STASH_REF= 351 INDEX_OPTION= 352 s= 353 w_commit= 354 b_commit= 355 i_commit= 356 u_commit= 357 w_tree= 358 b_tree= 359 i_tree= 360 u_tree= 361 362 REV=$(git rev-parse --no-flags --symbolic --sq "$@")|| exit 1 363 364 FLAGS= 365 for opt 366 do 367 case "$opt" in 368 -q|--quiet) 369 GIT_QUIET=-t 370 ;; 371 --index) 372 INDEX_OPTION=--index 373 ;; 374 -*) 375 FLAGS="${FLAGS}${FLAGS:+ }$opt" 376 ;; 377 esac 378 done 379 380 eval set --$REV 381 382 case$#in 383 0) 384 have_stash || die "$(gettext "No stash found.")" 385 set --${ref_stash}@{0} 386 ;; 387 1) 388 : 389 ;; 390 *) 391 die "$(eval_gettext "Too many revisions specified: \$REV")" 392 ;; 393 esac 394 395 REV=$(git rev-parse --symbolic --verify --quiet "$1")|| { 396 reference="$1" 397 die "$(eval_gettext "\$reference is not a valid reference")" 398 } 399 400 i_commit=$(git rev-parse --verify --quiet "$REV^2")&& 401 set --$(git rev-parse "$REV" "$REV^1" "$REV:" "$REV^1:" "$REV^2:" 2>/dev/null)&& 402 s=$1&& 403 w_commit=$1&& 404 b_commit=$2&& 405 w_tree=$3&& 406 b_tree=$4&& 407 i_tree=$5&& 408 IS_STASH_LIKE=t && 409 test "$ref_stash" = "$(git rev-parse --symbolic-full-name "${REV%@*}")" && 410 IS_STASH_REF=t 411 412 u_commit=$(git rev-parse --verify --quiet "$REV^3")&& 413 u_tree=$(git rev-parse "$REV^3:" 2>/dev/null) 414} 415 416is_stash_like() 417{ 418 parse_flags_and_rev "$@" 419 test -n "$IS_STASH_LIKE" 420} 421 422assert_stash_like() { 423 is_stash_like "$@" || { 424 args="$*" 425 die "$(eval_gettext "'\$args' is not a stash-like commit")" 426 } 427} 428 429is_stash_ref() { 430 is_stash_like "$@" && test -n "$IS_STASH_REF" 431} 432 433assert_stash_ref() { 434 is_stash_ref "$@" || { 435 args="$*" 436 die "$(eval_gettext "'\$args' is not a stash reference")" 437 } 438} 439 440apply_stash () { 441 442 assert_stash_like "$@" 443 444 git update-index -q --refresh || die "$(gettext "unable to refresh index")" 445 446 # current index state 447 c_tree=$(git write-tree)|| 448 die "$(gettext "Cannot apply a stash in the middle of a merge")" 449 450 unstashed_index_tree= 451 if test -n "$INDEX_OPTION" && test "$b_tree" != "$i_tree" && 452 test "$c_tree" != "$i_tree" 453 then 454 git diff-tree --binary$s^2^..$s^2 | git apply --cached 455 test $? -ne 0 && 456 die "$(gettext "Conflicts in index. Try without --index.")" 457 unstashed_index_tree=$(git write-tree)|| 458 die "$(gettext "Could not save index tree")" 459 git reset 460 fi 461 462 if test -n "$u_tree" 463 then 464 GIT_INDEX_FILE="$TMPindex" git-read-tree "$u_tree" && 465 GIT_INDEX_FILE="$TMPindex" git checkout-index --all && 466 rm -f "$TMPindex" || 467 die 'Could not restore untracked files from stash' 468 fi 469 470 eval " 471 GITHEAD_$w_tree='Stashed changes' && 472 GITHEAD_$c_tree='Updated upstream' && 473 GITHEAD_$b_tree='Version stash was based on' && 474 export GITHEAD_$w_treeGITHEAD_$c_treeGITHEAD_$b_tree 475 " 476 477 if test -n "$GIT_QUIET" 478 then 479 GIT_MERGE_VERBOSITY=0 && export GIT_MERGE_VERBOSITY 480 fi 481 if git merge-recursive$b_tree--$c_tree$w_tree 482 then 483 # No conflict 484 if test -n "$unstashed_index_tree" 485 then 486 git read-tree "$unstashed_index_tree" 487 else 488 a="$TMP-added" && 489 git diff-index --cached --name-only --diff-filter=A$c_tree>"$a" && 490 git read-tree --reset$c_tree&& 491 git update-index --add --stdin <"$a" || 492 die "$(gettext "Cannot unstage modified files")" 493 rm -f "$a" 494 fi 495 squelch= 496 if test -n "$GIT_QUIET" 497 then 498 squelch='>/dev/null 2>&1' 499 fi 500 (cd "$START_DIR" && eval "git status$squelch") || : 501 else 502 # Merge conflict; keep the exit status from merge-recursive 503 status=$? 504 git rerere 505 if test -n "$INDEX_OPTION" 506 then 507 gettextln "Index was not unstashed." >&2 508 fi 509 exit$status 510 fi 511} 512 513pop_stash() { 514 assert_stash_ref "$@" 515 516 if apply_stash "$@" 517 then 518 drop_stash "$@" 519 else 520 status=$? 521 say "The stash is kept in case you need it again." 522 exit$status 523 fi 524} 525 526drop_stash () { 527 assert_stash_ref "$@" 528 529 git reflog delete --updateref --rewrite "${REV}" && 530 say "$(eval_gettext "Dropped \${REV} (\$s)")" || 531 die "$(eval_gettext "\${REV}: Could not drop stash entry")" 532 533 # clear_stash if we just dropped the last stash entry 534 git rev-parse --verify --quiet "$ref_stash@{0}" >/dev/null || 535 clear_stash 536} 537 538apply_to_branch () { 539 test -n "$1" || die "$(gettext "No branch name specified")" 540 branch=$1 541 shift 1 542 543 set -- --index "$@" 544 assert_stash_like "$@" 545 546 git checkout -b$branch$REV^ && 547 apply_stash "$@" && { 548 test -z "$IS_STASH_REF" || drop_stash "$@" 549 } 550} 551 552PARSE_CACHE='--not-parsed' 553# The default command is "save" if nothing but options are given 554seen_non_option= 555for opt 556do 557 case "$opt" in 558 -*) ;; 559 *) seen_non_option=t; break ;; 560 esac 561done 562 563test -n "$seen_non_option" || set "save" "$@" 564 565# Main command set 566case "$1" in 567list) 568 shift 569 list_stash "$@" 570 ;; 571show) 572 shift 573 show_stash "$@" 574 ;; 575save) 576 shift 577 save_stash "$@" 578 ;; 579apply) 580 shift 581 apply_stash "$@" 582 ;; 583clear) 584 shift 585 clear_stash "$@" 586 ;; 587create) 588 shift 589 create_stash "$*" && echo "$w_commit" 590 ;; 591store) 592 shift 593 store_stash "$@" 594 ;; 595drop) 596 shift 597 drop_stash "$@" 598 ;; 599pop) 600 shift 601 pop_stash "$@" 602 ;; 603branch) 604 shift 605 apply_to_branch "$@" 606 ;; 607*) 608 case$#in 609 0) 610 save_stash && 611 say "$(gettext "(To restore them type \"git stash apply\")")" 612 ;; 613 *) 614 usage 615 esac 616 ;; 617esac