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 ALLOW_UNKNOWN_FLAGS=t 305 assert_stash_like "$@" 306 307 git diff${FLAGS:---stat}$b_commit$w_commit 308} 309 310# 311# Parses the remaining options looking for flags and 312# at most one revision defaulting to${ref_stash}@{0} 313# if none found. 314# 315# Derives related tree and commit objects from the 316# revision, if one is found. 317# 318# stash records the work tree, and is a merge between the 319# base commit (first parent) and the index tree (second parent). 320# 321# REV is set to the symbolic version of the specified stash-like commit 322# IS_STASH_LIKE is non-blank if${REV}looks like a stash 323# IS_STASH_REF is non-blank if the${REV}looks like a stash ref 324# s is set to the SHA1 of the stash commit 325# w_commit is set to the commit containing the working tree 326# b_commit is set to the base commit 327# i_commit is set to the commit containing the index tree 328# u_commit is set to the commit containing the untracked files tree 329# w_tree is set to the working tree 330# b_tree is set to the base tree 331# i_tree is set to the index tree 332# u_tree is set to the untracked files tree 333# 334# GIT_QUIET is set to t if -q is specified 335# INDEX_OPTION is set to --index if --index is specified. 336# FLAGS is set to the remaining flags (if allowed) 337# 338# dies if: 339# * too many revisions specified 340# * no revision is specified and there is no stash stack 341# * a revision is specified which cannot be resolve to a SHA1 342# * a non-existent stash reference is specified 343# * unknown flags were set and ALLOW_UNKNOWN_FLAGS is not "t" 344# 345 346parse_flags_and_rev() 347{ 348 test "$PARSE_CACHE" = "$*" && return 0 # optimisation 349 PARSE_CACHE="$*" 350 351 IS_STASH_LIKE= 352 IS_STASH_REF= 353 INDEX_OPTION= 354 s= 355 w_commit= 356 b_commit= 357 i_commit= 358 u_commit= 359 w_tree= 360 b_tree= 361 i_tree= 362 u_tree= 363 364 REV=$(git rev-parse --no-flags --symbolic --sq "$@")|| exit 1 365 366 FLAGS= 367 for opt 368 do 369 case "$opt" in 370 -q|--quiet) 371 GIT_QUIET=-t 372 ;; 373 --index) 374 INDEX_OPTION=--index 375 ;; 376 -*) 377 test "$ALLOW_UNKNOWN_FLAGS" = t || 378 die "$(eval_gettext "unknown option: \$opt")" 379 FLAGS="${FLAGS}${FLAGS:+ }$opt" 380 ;; 381 esac 382 done 383 384 eval set --$REV 385 386 case$#in 387 0) 388 have_stash || die "$(gettext "No stash found.")" 389 set --${ref_stash}@{0} 390 ;; 391 1) 392 : 393 ;; 394 *) 395 die "$(eval_gettext "Too many revisions specified: \$REV")" 396 ;; 397 esac 398 399 REV=$(git rev-parse --symbolic --verify --quiet "$1")|| { 400 reference="$1" 401 die "$(eval_gettext "\$reference is not a valid reference")" 402 } 403 404 i_commit=$(git rev-parse --verify --quiet "$REV^2")&& 405 set --$(git rev-parse "$REV" "$REV^1" "$REV:" "$REV^1:" "$REV^2:" 2>/dev/null)&& 406 s=$1&& 407 w_commit=$1&& 408 b_commit=$2&& 409 w_tree=$3&& 410 b_tree=$4&& 411 i_tree=$5&& 412 IS_STASH_LIKE=t && 413 test "$ref_stash" = "$(git rev-parse --symbolic-full-name "${REV%@*}")" && 414 IS_STASH_REF=t 415 416 u_commit=$(git rev-parse --verify --quiet "$REV^3")&& 417 u_tree=$(git rev-parse "$REV^3:" 2>/dev/null) 418} 419 420is_stash_like() 421{ 422 parse_flags_and_rev "$@" 423 test -n "$IS_STASH_LIKE" 424} 425 426assert_stash_like() { 427 is_stash_like "$@" || { 428 args="$*" 429 die "$(eval_gettext "'\$args' is not a stash-like commit")" 430 } 431} 432 433is_stash_ref() { 434 is_stash_like "$@" && test -n "$IS_STASH_REF" 435} 436 437assert_stash_ref() { 438 is_stash_ref "$@" || { 439 args="$*" 440 die "$(eval_gettext "'\$args' is not a stash reference")" 441 } 442} 443 444apply_stash () { 445 446 assert_stash_like "$@" 447 448 git update-index -q --refresh || die "$(gettext "unable to refresh index")" 449 450 # current index state 451 c_tree=$(git write-tree)|| 452 die "$(gettext "Cannot apply a stash in the middle of a merge")" 453 454 unstashed_index_tree= 455 if test -n "$INDEX_OPTION" && test "$b_tree" != "$i_tree" && 456 test "$c_tree" != "$i_tree" 457 then 458 git diff-tree --binary$s^2^..$s^2 | git apply --cached 459 test $? -ne 0 && 460 die "$(gettext "Conflicts in index. Try without --index.")" 461 unstashed_index_tree=$(git write-tree)|| 462 die "$(gettext "Could not save index tree")" 463 git reset 464 fi 465 466 if test -n "$u_tree" 467 then 468 GIT_INDEX_FILE="$TMPindex" git-read-tree "$u_tree" && 469 GIT_INDEX_FILE="$TMPindex" git checkout-index --all && 470 rm -f "$TMPindex" || 471 die 'Could not restore untracked files from stash' 472 fi 473 474 eval " 475 GITHEAD_$w_tree='Stashed changes' && 476 GITHEAD_$c_tree='Updated upstream' && 477 GITHEAD_$b_tree='Version stash was based on' && 478 export GITHEAD_$w_treeGITHEAD_$c_treeGITHEAD_$b_tree 479 " 480 481 if test -n "$GIT_QUIET" 482 then 483 GIT_MERGE_VERBOSITY=0 && export GIT_MERGE_VERBOSITY 484 fi 485 if git merge-recursive$b_tree--$c_tree$w_tree 486 then 487 # No conflict 488 if test -n "$unstashed_index_tree" 489 then 490 git read-tree "$unstashed_index_tree" 491 else 492 a="$TMP-added" && 493 git diff-index --cached --name-only --diff-filter=A$c_tree>"$a" && 494 git read-tree --reset$c_tree&& 495 git update-index --add --stdin <"$a" || 496 die "$(gettext "Cannot unstage modified files")" 497 rm -f "$a" 498 fi 499 squelch= 500 if test -n "$GIT_QUIET" 501 then 502 squelch='>/dev/null 2>&1' 503 fi 504 (cd "$START_DIR" && eval "git status$squelch") || : 505 else 506 # Merge conflict; keep the exit status from merge-recursive 507 status=$? 508 git rerere 509 if test -n "$INDEX_OPTION" 510 then 511 gettextln "Index was not unstashed." >&2 512 fi 513 exit$status 514 fi 515} 516 517pop_stash() { 518 assert_stash_ref "$@" 519 520 if apply_stash "$@" 521 then 522 drop_stash "$@" 523 else 524 status=$? 525 say "The stash is kept in case you need it again." 526 exit$status 527 fi 528} 529 530drop_stash () { 531 assert_stash_ref "$@" 532 533 git reflog delete --updateref --rewrite "${REV}" && 534 say "$(eval_gettext "Dropped \${REV} (\$s)")" || 535 die "$(eval_gettext "\${REV}: Could not drop stash entry")" 536 537 # clear_stash if we just dropped the last stash entry 538 git rev-parse --verify --quiet "$ref_stash@{0}" >/dev/null || 539 clear_stash 540} 541 542apply_to_branch () { 543 test -n "$1" || die "$(gettext "No branch name specified")" 544 branch=$1 545 shift 1 546 547 set -- --index "$@" 548 assert_stash_like "$@" 549 550 git checkout -b$branch$REV^ && 551 apply_stash "$@" && { 552 test -z "$IS_STASH_REF" || drop_stash "$@" 553 } 554} 555 556PARSE_CACHE='--not-parsed' 557# The default command is "save" if nothing but options are given 558seen_non_option= 559for opt 560do 561 case "$opt" in 562 -*) ;; 563 *) seen_non_option=t; break ;; 564 esac 565done 566 567test -n "$seen_non_option" || set "save" "$@" 568 569# Main command set 570case "$1" in 571list) 572 shift 573 list_stash "$@" 574 ;; 575show) 576 shift 577 show_stash "$@" 578 ;; 579save) 580 shift 581 save_stash "$@" 582 ;; 583apply) 584 shift 585 apply_stash "$@" 586 ;; 587clear) 588 shift 589 clear_stash "$@" 590 ;; 591create) 592 shift 593 create_stash "$*" && echo "$w_commit" 594 ;; 595store) 596 shift 597 store_stash "$@" 598 ;; 599drop) 600 shift 601 drop_stash "$@" 602 ;; 603pop) 604 shift 605 pop_stash "$@" 606 ;; 607branch) 608 shift 609 apply_to_branch "$@" 610 ;; 611*) 612 case$#in 613 0) 614 save_stash && 615 say "$(gettext "(To restore them type \"git stash apply\")")" 616 ;; 617 *) 618 usage 619 esac 620 ;; 621esac