1 #define USE_THE_INDEX_COMPATIBILITY_MACROS
4 #include "parse-options.h"
7 #include "cache-tree.h"
8 #include "unpack-trees.h"
9 #include "merge-recursive.h"
11 #include "run-command.h"
21 #define INCLUDE_ALL_FILES 2
23 static const char * const git_stash_usage[] = {
24 N_("git stash list [<options>]"),
25 N_("git stash show [<options>] [<stash>]"),
26 N_("git stash drop [-q|--quiet] [<stash>]"),
27 N_("git stash ( pop | apply ) [--index] [-q|--quiet] [<stash>]"),
28 N_("git stash branch <branchname> [<stash>]"),
29 N_("git stash clear"),
30 N_("git stash [push [-p|--patch] [-k|--[no-]keep-index] [-q|--quiet]\n"
31 " [-u|--include-untracked] [-a|--all] [-m|--message <message>]\n"
32 " [--pathspec-from-file=<file> [--pathspec-file-nul]]\n"
33 " [--] [<pathspec>...]]"),
34 N_("git stash save [-p|--patch] [-k|--[no-]keep-index] [-q|--quiet]\n"
35 " [-u|--include-untracked] [-a|--all] [<message>]"),
39 static const char * const git_stash_list_usage[] = {
40 N_("git stash list [<options>]"),
44 static const char * const git_stash_show_usage[] = {
45 N_("git stash show [<options>] [<stash>]"),
49 static const char * const git_stash_drop_usage[] = {
50 N_("git stash drop [-q|--quiet] [<stash>]"),
54 static const char * const git_stash_pop_usage[] = {
55 N_("git stash pop [--index] [-q|--quiet] [<stash>]"),
59 static const char * const git_stash_apply_usage[] = {
60 N_("git stash apply [--index] [-q|--quiet] [<stash>]"),
64 static const char * const git_stash_branch_usage[] = {
65 N_("git stash branch <branchname> [<stash>]"),
69 static const char * const git_stash_clear_usage[] = {
70 N_("git stash clear"),
74 static const char * const git_stash_store_usage[] = {
75 N_("git stash store [-m|--message <message>] [-q|--quiet] <commit>"),
79 static const char * const git_stash_push_usage[] = {
80 N_("git stash [push [-p|--patch] [-k|--[no-]keep-index] [-q|--quiet]\n"
81 " [-u|--include-untracked] [-a|--all] [-m|--message <message>]\n"
82 " [--] [<pathspec>...]]"),
86 static const char * const git_stash_save_usage[] = {
87 N_("git stash save [-p|--patch] [-k|--[no-]keep-index] [-q|--quiet]\n"
88 " [-u|--include-untracked] [-a|--all] [<message>]"),
92 static const char ref_stash[] = "refs/stash";
93 static struct strbuf stash_index_path = STRBUF_INIT;
96 * w_commit is set to the commit containing the working tree
97 * b_commit is set to the base commit
98 * i_commit is set to the commit containing the index tree
99 * u_commit is set to the commit containing the untracked files tree
100 * w_tree is set to the working tree
101 * b_tree is set to the base tree
102 * i_tree is set to the index tree
103 * u_tree is set to the untracked files tree
106 struct object_id w_commit;
107 struct object_id b_commit;
108 struct object_id i_commit;
109 struct object_id u_commit;
110 struct object_id w_tree;
111 struct object_id b_tree;
112 struct object_id i_tree;
113 struct object_id u_tree;
114 struct strbuf revision;
119 static void free_stash_info(struct stash_info *info)
121 strbuf_release(&info->revision);
124 static void assert_stash_like(struct stash_info *info, const char *revision)
126 if (get_oidf(&info->b_commit, "%s^1", revision) ||
127 get_oidf(&info->w_tree, "%s:", revision) ||
128 get_oidf(&info->b_tree, "%s^1:", revision) ||
129 get_oidf(&info->i_tree, "%s^2:", revision))
130 die(_("'%s' is not a stash-like commit"), revision);
133 static int get_stash_info(struct stash_info *info, int argc, const char **argv)
138 const char *revision;
139 const char *commit = NULL;
140 struct object_id dummy;
141 struct strbuf symbolic = STRBUF_INIT;
145 struct strbuf refs_msg = STRBUF_INIT;
147 for (i = 0; i < argc; i++)
148 strbuf_addf(&refs_msg, " '%s'", argv[i]);
150 fprintf_ln(stderr, _("Too many revisions specified:%s"),
152 strbuf_release(&refs_msg);
160 strbuf_init(&info->revision, 0);
162 if (!ref_exists(ref_stash)) {
163 free_stash_info(info);
164 fprintf_ln(stderr, _("No stash entries found."));
168 strbuf_addf(&info->revision, "%s@{0}", ref_stash);
169 } else if (strspn(commit, "0123456789") == strlen(commit)) {
170 strbuf_addf(&info->revision, "%s@{%s}", ref_stash, commit);
172 strbuf_addstr(&info->revision, commit);
175 revision = info->revision.buf;
177 if (get_oid(revision, &info->w_commit)) {
178 error(_("%s is not a valid reference"), revision);
179 free_stash_info(info);
183 assert_stash_like(info, revision);
185 info->has_u = !get_oidf(&info->u_tree, "%s^3:", revision);
187 end_of_rev = strchrnul(revision, '@');
188 strbuf_add(&symbolic, revision, end_of_rev - revision);
190 ret = dwim_ref(symbolic.buf, symbolic.len, &dummy, &expanded_ref, 0);
191 strbuf_release(&symbolic);
193 case 0: /* Not found, but valid ref */
194 info->is_stash_ref = 0;
197 info->is_stash_ref = !strcmp(expanded_ref, ref_stash);
199 default: /* Invalid or ambiguous */
200 free_stash_info(info);
204 return !(ret == 0 || ret == 1);
207 static int do_clear_stash(void)
209 struct object_id obj;
210 if (get_oid(ref_stash, &obj))
213 return delete_ref(NULL, ref_stash, &obj, 0);
216 static int clear_stash(int argc, const char **argv, const char *prefix)
218 struct option options[] = {
222 argc = parse_options(argc, argv, prefix, options,
223 git_stash_clear_usage,
224 PARSE_OPT_STOP_AT_NON_OPTION);
227 return error(_("git stash clear with arguments is "
230 return do_clear_stash();
233 static int reset_tree(struct object_id *i_tree, int update, int reset)
236 struct unpack_trees_options opts;
237 struct tree_desc t[MAX_UNPACK_TREES];
239 struct lock_file lock_file = LOCK_INIT;
241 read_cache_preload(NULL);
242 if (refresh_cache(REFRESH_QUIET))
245 hold_locked_index(&lock_file, LOCK_DIE_ON_ERROR);
247 memset(&opts, 0, sizeof(opts));
249 tree = parse_tree_indirect(i_tree);
250 if (parse_tree(tree))
253 init_tree_desc(t, tree->buffer, tree->size);
256 opts.src_index = &the_index;
257 opts.dst_index = &the_index;
260 opts.update = update;
261 opts.fn = oneway_merge;
263 if (unpack_trees(nr_trees, t, &opts))
266 if (write_locked_index(&the_index, &lock_file, COMMIT_LOCK))
267 return error(_("unable to write new index file"));
272 static int diff_tree_binary(struct strbuf *out, struct object_id *w_commit)
274 struct child_process cp = CHILD_PROCESS_INIT;
275 const char *w_commit_hex = oid_to_hex(w_commit);
278 * Diff-tree would not be very hard to replace with a native function,
279 * however it should be done together with apply_cached.
282 strvec_pushl(&cp.args, "diff-tree", "--binary", NULL);
283 strvec_pushf(&cp.args, "%s^2^..%s^2", w_commit_hex, w_commit_hex);
285 return pipe_command(&cp, NULL, 0, out, 0, NULL, 0);
288 static int apply_cached(struct strbuf *out)
290 struct child_process cp = CHILD_PROCESS_INIT;
293 * Apply currently only reads either from stdin or a file, thus
294 * apply_all_patches would have to be updated to optionally take a
298 strvec_pushl(&cp.args, "apply", "--cached", NULL);
299 return pipe_command(&cp, out->buf, out->len, NULL, 0, NULL, 0);
302 static int reset_head(void)
304 struct child_process cp = CHILD_PROCESS_INIT;
307 * Reset is overall quite simple, however there is no current public
311 strvec_push(&cp.args, "reset");
313 return run_command(&cp);
316 static void add_diff_to_buf(struct diff_queue_struct *q,
317 struct diff_options *options,
322 for (i = 0; i < q->nr; i++) {
323 strbuf_addstr(data, q->queue[i]->one->path);
325 /* NUL-terminate: will be fed to update-index -z */
326 strbuf_addch(data, '\0');
330 static int restore_untracked(struct object_id *u_tree)
333 struct child_process cp = CHILD_PROCESS_INIT;
336 * We need to run restore files from a given index, but without
337 * affecting the current index, so we use GIT_INDEX_FILE with
338 * run_command to fork processes that will not interfere.
341 strvec_push(&cp.args, "read-tree");
342 strvec_push(&cp.args, oid_to_hex(u_tree));
343 strvec_pushf(&cp.env_array, "GIT_INDEX_FILE=%s",
344 stash_index_path.buf);
345 if (run_command(&cp)) {
346 remove_path(stash_index_path.buf);
350 child_process_init(&cp);
352 strvec_pushl(&cp.args, "checkout-index", "--all", NULL);
353 strvec_pushf(&cp.env_array, "GIT_INDEX_FILE=%s",
354 stash_index_path.buf);
356 res = run_command(&cp);
357 remove_path(stash_index_path.buf);
361 static void unstage_changes_unless_new(struct object_id *orig_tree)
364 * When we enter this function, there has been a clean merge of
365 * relevant trees, and the merge logic always stages whatever merges
366 * cleanly. We want to unstage those changes, unless it corresponds
367 * to a file that didn't exist as of orig_tree.
369 * However, if any SKIP_WORKTREE path is modified relative to
370 * orig_tree, then we want to clear the SKIP_WORKTREE bit and write
371 * it to the worktree before unstaging.
374 struct checkout state = CHECKOUT_INIT;
375 struct diff_options diff_opts;
376 struct lock_file lock = LOCK_INIT;
379 /* If any entries have skip_worktree set, we'll have to check 'em out */
382 state.refresh_cache = 1;
383 state.istate = &the_index;
386 * Step 1: get a difference between orig_tree (which corresponding
387 * to the index before a merge was run) and the current index
388 * (reflecting the changes brought in by the merge).
390 diff_setup(&diff_opts);
391 diff_opts.flags.recursive = 1;
392 diff_opts.detect_rename = 0;
393 diff_opts.output_format = DIFF_FORMAT_NO_OUTPUT;
394 diff_setup_done(&diff_opts);
396 do_diff_cache(orig_tree, &diff_opts);
397 diffcore_std(&diff_opts);
399 /* Iterate over the paths that changed due to the merge... */
400 for (i = 0; i < diff_queued_diff.nr; i++) {
401 struct diff_filepair *p;
402 struct cache_entry *ce;
405 /* Look up the path's position in the current index. */
406 p = diff_queued_diff.queue[i];
407 pos = index_name_pos(&the_index, p->two->path,
408 strlen(p->two->path));
411 * Step 2: Place changes in the working tree
413 * Stash is about restoring changes *to the working tree*.
414 * So if the merge successfully got a new version of some
415 * path, but left it out of the working tree, then clear the
416 * SKIP_WORKTREE bit and write it to the working tree.
418 if (pos >= 0 && ce_skip_worktree(active_cache[pos])) {
421 ce = active_cache[pos];
422 if (!lstat(ce->name, &st)) {
423 /* Conflicting path present; relocate it */
424 struct strbuf new_path = STRBUF_INIT;
427 strbuf_addf(&new_path,
428 "%s.stash.XXXXXX", ce->name);
429 fd = xmkstemp(new_path.buf);
431 printf(_("WARNING: Untracked file in way of "
432 "tracked file! Renaming\n "
435 ce->name, new_path.buf);
436 if (rename(ce->name, new_path.buf))
437 die("Failed to move %s to %s\n",
438 ce->name, new_path.buf);
439 strbuf_release(&new_path);
441 checkout_entry(ce, &state, NULL, NULL);
442 ce->ce_flags &= ~CE_SKIP_WORKTREE;
446 * Step 3: "unstage" changes, as long as they are still tracked
448 if (p->one->oid_valid) {
450 * Path existed in orig_tree; restore index entry
451 * from that tree in order to "unstage" the changes.
453 int option = ADD_CACHE_OK_TO_REPLACE;
455 option = ADD_CACHE_OK_TO_ADD;
457 ce = make_cache_entry(&the_index,
462 add_index_entry(&the_index, ce, option);
465 diff_flush(&diff_opts);
468 * Step 4: write the new index to disk
470 repo_hold_locked_index(the_repository, &lock, LOCK_DIE_ON_ERROR);
471 if (write_locked_index(&the_index, &lock,
472 COMMIT_LOCK | SKIP_IF_UNCHANGED))
473 die(_("Unable to write index."));
476 static int do_apply_stash(const char *prefix, struct stash_info *info,
477 int index, int quiet)
480 int has_index = index;
481 struct merge_options o;
482 struct object_id c_tree;
483 struct object_id index_tree;
484 struct commit *result;
485 const struct object_id *bases[1];
487 read_cache_preload(NULL);
488 if (refresh_and_write_cache(REFRESH_QUIET, 0, 0))
491 if (write_cache_as_tree(&c_tree, 0, NULL))
492 return error(_("cannot apply a stash in the middle of a merge"));
495 if (oideq(&info->b_tree, &info->i_tree) ||
496 oideq(&c_tree, &info->i_tree)) {
499 struct strbuf out = STRBUF_INIT;
501 if (diff_tree_binary(&out, &info->w_commit)) {
502 strbuf_release(&out);
503 return error(_("could not generate diff %s^!."),
504 oid_to_hex(&info->w_commit));
507 ret = apply_cached(&out);
508 strbuf_release(&out);
510 return error(_("conflicts in index. "
511 "Try without --index."));
515 if (write_cache_as_tree(&index_tree, 0, NULL))
516 return error(_("could not save index tree"));
524 if (info->has_u && restore_untracked(&info->u_tree))
525 return error(_("could not restore untracked files from stash"));
527 init_merge_options(&o, the_repository);
529 o.branch1 = "Updated upstream";
530 o.branch2 = "Stashed changes";
532 if (oideq(&info->b_tree, &c_tree))
533 o.branch1 = "Version stash was based on";
538 if (o.verbosity >= 3)
539 printf_ln(_("Merging %s with %s"), o.branch1, o.branch2);
541 bases[0] = &info->b_tree;
543 ret = merge_recursive_generic(&o, &c_tree, &info->w_tree, 1, bases,
549 fprintf_ln(stderr, _("Index was not unstashed."));
555 if (reset_tree(&index_tree, 0, 0))
558 unstage_changes_unless_new(&c_tree);
562 struct child_process cp = CHILD_PROCESS_INIT;
565 * Status is quite simple and could be replaced with calls to
566 * wt_status in the future, but it adds complexities which may
567 * require more tests.
571 strvec_pushf(&cp.env_array, GIT_WORK_TREE_ENVIRONMENT"=%s",
572 absolute_path(get_git_work_tree()));
573 strvec_pushf(&cp.env_array, GIT_DIR_ENVIRONMENT"=%s",
574 absolute_path(get_git_dir()));
575 strvec_push(&cp.args, "status");
582 static int apply_stash(int argc, const char **argv, const char *prefix)
587 struct stash_info info;
588 struct option options[] = {
589 OPT__QUIET(&quiet, N_("be quiet, only report errors")),
590 OPT_BOOL(0, "index", &index,
591 N_("attempt to recreate the index")),
595 argc = parse_options(argc, argv, prefix, options,
596 git_stash_apply_usage, 0);
598 if (get_stash_info(&info, argc, argv))
601 ret = do_apply_stash(prefix, &info, index, quiet);
602 free_stash_info(&info);
606 static int reject_reflog_ent(struct object_id *ooid, struct object_id *noid,
607 const char *email, timestamp_t timestamp, int tz,
608 const char *message, void *cb_data)
613 static int reflog_is_empty(const char *refname)
615 return !for_each_reflog_ent(refname, reject_reflog_ent, NULL);
618 static int do_drop_stash(struct stash_info *info, int quiet)
621 struct child_process cp_reflog = CHILD_PROCESS_INIT;
624 * reflog does not provide a simple function for deleting refs. One will
625 * need to be added to avoid implementing too much reflog code here
628 cp_reflog.git_cmd = 1;
629 strvec_pushl(&cp_reflog.args, "reflog", "delete", "--updateref",
631 strvec_push(&cp_reflog.args, info->revision.buf);
632 ret = run_command(&cp_reflog);
635 printf_ln(_("Dropped %s (%s)"), info->revision.buf,
636 oid_to_hex(&info->w_commit));
638 return error(_("%s: Could not drop stash entry"),
642 if (reflog_is_empty(ref_stash))
648 static void assert_stash_ref(struct stash_info *info)
650 if (!info->is_stash_ref) {
651 error(_("'%s' is not a stash reference"), info->revision.buf);
652 free_stash_info(info);
657 static int drop_stash(int argc, const char **argv, const char *prefix)
661 struct stash_info info;
662 struct option options[] = {
663 OPT__QUIET(&quiet, N_("be quiet, only report errors")),
667 argc = parse_options(argc, argv, prefix, options,
668 git_stash_drop_usage, 0);
670 if (get_stash_info(&info, argc, argv))
673 assert_stash_ref(&info);
675 ret = do_drop_stash(&info, quiet);
676 free_stash_info(&info);
680 static int pop_stash(int argc, const char **argv, const char *prefix)
685 struct stash_info info;
686 struct option options[] = {
687 OPT__QUIET(&quiet, N_("be quiet, only report errors")),
688 OPT_BOOL(0, "index", &index,
689 N_("attempt to recreate the index")),
693 argc = parse_options(argc, argv, prefix, options,
694 git_stash_pop_usage, 0);
696 if (get_stash_info(&info, argc, argv))
699 assert_stash_ref(&info);
700 if ((ret = do_apply_stash(prefix, &info, index, quiet)))
701 printf_ln(_("The stash entry is kept in case "
702 "you need it again."));
704 ret = do_drop_stash(&info, quiet);
706 free_stash_info(&info);
710 static int branch_stash(int argc, const char **argv, const char *prefix)
713 const char *branch = NULL;
714 struct stash_info info;
715 struct child_process cp = CHILD_PROCESS_INIT;
716 struct option options[] = {
720 argc = parse_options(argc, argv, prefix, options,
721 git_stash_branch_usage, 0);
724 fprintf_ln(stderr, _("No branch name specified"));
730 if (get_stash_info(&info, argc - 1, argv + 1))
734 strvec_pushl(&cp.args, "checkout", "-b", NULL);
735 strvec_push(&cp.args, branch);
736 strvec_push(&cp.args, oid_to_hex(&info.b_commit));
737 ret = run_command(&cp);
739 ret = do_apply_stash(prefix, &info, 1, 0);
740 if (!ret && info.is_stash_ref)
741 ret = do_drop_stash(&info, 0);
743 free_stash_info(&info);
748 static int list_stash(int argc, const char **argv, const char *prefix)
750 struct child_process cp = CHILD_PROCESS_INIT;
751 struct option options[] = {
755 argc = parse_options(argc, argv, prefix, options,
756 git_stash_list_usage,
757 PARSE_OPT_KEEP_UNKNOWN);
759 if (!ref_exists(ref_stash))
763 strvec_pushl(&cp.args, "log", "--format=%gd: %gs", "-g",
764 "--first-parent", "-m", NULL);
765 strvec_pushv(&cp.args, argv);
766 strvec_push(&cp.args, ref_stash);
767 strvec_push(&cp.args, "--");
768 return run_command(&cp);
771 static int show_stat = 1;
772 static int show_patch;
773 static int show_include_untracked;
774 static int use_legacy_stash;
776 static int git_stash_config(const char *var, const char *value, void *cb)
778 if (!strcmp(var, "stash.showstat")) {
779 show_stat = git_config_bool(var, value);
782 if (!strcmp(var, "stash.showpatch")) {
783 show_patch = git_config_bool(var, value);
786 if (!strcmp(var, "stash.showincludeuntracked")) {
787 show_include_untracked = git_config_bool(var, value);
790 if (!strcmp(var, "stash.usebuiltin")) {
791 use_legacy_stash = !git_config_bool(var, value);
794 return git_diff_basic_config(var, value, cb);
797 static void diff_include_untracked(const struct stash_info *info, struct diff_options *diff_opt)
799 const struct object_id *oid[] = { &info->w_commit, &info->u_tree };
800 struct tree *tree[ARRAY_SIZE(oid)];
801 struct tree_desc tree_desc[ARRAY_SIZE(oid)];
802 struct unpack_trees_options unpack_tree_opt = { 0 };
805 for (i = 0; i < ARRAY_SIZE(oid); i++) {
806 tree[i] = parse_tree_indirect(oid[i]);
807 if (parse_tree(tree[i]) < 0)
808 die(_("failed to parse tree"));
809 init_tree_desc(&tree_desc[i], tree[i]->buffer, tree[i]->size);
812 unpack_tree_opt.head_idx = -1;
813 unpack_tree_opt.src_index = &the_index;
814 unpack_tree_opt.dst_index = &the_index;
815 unpack_tree_opt.merge = 1;
816 unpack_tree_opt.fn = stash_worktree_untracked_merge;
818 if (unpack_trees(ARRAY_SIZE(tree_desc), tree_desc, &unpack_tree_opt))
819 die(_("failed to unpack trees"));
821 do_diff_cache(&info->b_commit, diff_opt);
824 static int show_stash(int argc, const char **argv, const char *prefix)
828 struct stash_info info;
830 struct strvec stash_args = STRVEC_INIT;
831 struct strvec revision_args = STRVEC_INIT;
836 } show_untracked = UNTRACKED_NONE;
837 struct option options[] = {
838 OPT_SET_INT('u', "include-untracked", &show_untracked,
839 N_("include untracked files in the stash"),
841 OPT_SET_INT_F(0, "only-untracked", &show_untracked,
842 N_("only show untracked files in the stash"),
843 UNTRACKED_ONLY, PARSE_OPT_NONEG),
847 init_diff_ui_defaults();
848 git_config(git_diff_ui_config, NULL);
849 init_revisions(&rev, prefix);
851 argc = parse_options(argc, argv, prefix, options, git_stash_show_usage,
852 PARSE_OPT_KEEP_ARGV0 | PARSE_OPT_KEEP_UNKNOWN |
853 PARSE_OPT_KEEP_DASHDASH);
855 strvec_push(&revision_args, argv[0]);
856 for (i = 1; i < argc; i++) {
857 if (argv[i][0] != '-')
858 strvec_push(&stash_args, argv[i]);
860 strvec_push(&revision_args, argv[i]);
863 ret = get_stash_info(&info, stash_args.nr, stash_args.v);
864 strvec_clear(&stash_args);
869 * The config settings are applied only if there are not passed
872 if (revision_args.nr == 1) {
874 rev.diffopt.output_format = DIFF_FORMAT_DIFFSTAT;
877 rev.diffopt.output_format |= DIFF_FORMAT_PATCH;
879 if (show_include_untracked)
880 show_untracked = UNTRACKED_INCLUDE;
882 if (!show_stat && !show_patch) {
883 free_stash_info(&info);
888 argc = setup_revisions(revision_args.nr, revision_args.v, &rev, NULL);
890 free_stash_info(&info);
891 usage_with_options(git_stash_show_usage, options);
893 if (!rev.diffopt.output_format) {
894 rev.diffopt.output_format = DIFF_FORMAT_PATCH;
895 diff_setup_done(&rev.diffopt);
898 rev.diffopt.flags.recursive = 1;
899 setup_diff_pager(&rev.diffopt);
900 switch (show_untracked) {
902 diff_tree_oid(&info.b_commit, &info.w_commit, "", &rev.diffopt);
906 diff_root_tree_oid(&info.u_tree, "", &rev.diffopt);
908 case UNTRACKED_INCLUDE:
910 diff_include_untracked(&info, &rev.diffopt);
912 diff_tree_oid(&info.b_commit, &info.w_commit, "", &rev.diffopt);
915 log_tree_diff_flush(&rev);
917 free_stash_info(&info);
918 return diff_result_code(&rev.diffopt, 0);
921 static int do_store_stash(const struct object_id *w_commit, const char *stash_msg,
925 stash_msg = "Created via \"git stash store\".";
927 if (update_ref(stash_msg, ref_stash, w_commit, NULL,
928 REF_FORCE_CREATE_REFLOG,
929 quiet ? UPDATE_REFS_QUIET_ON_ERR :
930 UPDATE_REFS_MSG_ON_ERR)) {
932 fprintf_ln(stderr, _("Cannot update %s with %s"),
933 ref_stash, oid_to_hex(w_commit));
941 static int store_stash(int argc, const char **argv, const char *prefix)
944 const char *stash_msg = NULL;
945 struct object_id obj;
946 struct object_context dummy;
947 struct option options[] = {
948 OPT__QUIET(&quiet, N_("be quiet")),
949 OPT_STRING('m', "message", &stash_msg, "message",
950 N_("stash message")),
954 argc = parse_options(argc, argv, prefix, options,
955 git_stash_store_usage,
956 PARSE_OPT_KEEP_UNKNOWN);
960 fprintf_ln(stderr, _("\"git stash store\" requires one "
961 "<commit> argument"));
965 if (get_oid_with_context(the_repository,
966 argv[0], quiet ? GET_OID_QUIETLY : 0, &obj,
969 fprintf_ln(stderr, _("Cannot update %s with %s"),
974 return do_store_stash(&obj, stash_msg, quiet);
977 static void add_pathspecs(struct strvec *args,
978 const struct pathspec *ps) {
981 for (i = 0; i < ps->nr; i++)
982 strvec_push(args, ps->items[i].original);
986 * `untracked_files` will be filled with the names of untracked files.
987 * The return value is:
989 * = 0 if there are not any untracked files
990 * > 0 if there are untracked files
992 static int get_untracked_files(const struct pathspec *ps, int include_untracked,
993 struct strbuf *untracked_files)
997 struct dir_struct dir;
1000 if (include_untracked != INCLUDE_ALL_FILES)
1001 setup_standard_excludes(&dir);
1003 fill_directory(&dir, the_repository->index, ps);
1004 for (i = 0; i < dir.nr; i++) {
1005 struct dir_entry *ent = dir.entries[i];
1007 strbuf_addstr(untracked_files, ent->name);
1008 /* NUL-terminate: will be fed to update-index -z */
1009 strbuf_addch(untracked_files, '\0');
1017 * The return value of `check_changes_tracked_files()` can be:
1019 * < 0 if there was an error
1020 * = 0 if there are no changes.
1021 * > 0 if there are changes.
1023 static int check_changes_tracked_files(const struct pathspec *ps)
1026 struct rev_info rev;
1027 struct object_id dummy;
1030 /* No initial commit. */
1031 if (get_oid("HEAD", &dummy))
1034 if (read_cache() < 0)
1037 init_revisions(&rev, NULL);
1038 copy_pathspec(&rev.prune_data, ps);
1040 rev.diffopt.flags.quick = 1;
1041 rev.diffopt.flags.ignore_submodules = 1;
1044 add_head_to_pending(&rev);
1045 diff_setup_done(&rev.diffopt);
1047 result = run_diff_index(&rev, 1);
1048 if (diff_result_code(&rev.diffopt, result)) {
1053 object_array_clear(&rev.pending);
1054 result = run_diff_files(&rev, 0);
1055 if (diff_result_code(&rev.diffopt, result)) {
1061 clear_pathspec(&rev.prune_data);
1066 * The function will fill `untracked_files` with the names of untracked files
1067 * It will return 1 if there were any changes and 0 if there were not.
1069 static int check_changes(const struct pathspec *ps, int include_untracked,
1070 struct strbuf *untracked_files)
1073 if (check_changes_tracked_files(ps))
1076 if (include_untracked && get_untracked_files(ps, include_untracked,
1083 static int save_untracked_files(struct stash_info *info, struct strbuf *msg,
1084 struct strbuf files)
1087 struct strbuf untracked_msg = STRBUF_INIT;
1088 struct child_process cp_upd_index = CHILD_PROCESS_INIT;
1089 struct index_state istate = { NULL };
1091 cp_upd_index.git_cmd = 1;
1092 strvec_pushl(&cp_upd_index.args, "update-index", "-z", "--add",
1093 "--remove", "--stdin", NULL);
1094 strvec_pushf(&cp_upd_index.env_array, "GIT_INDEX_FILE=%s",
1095 stash_index_path.buf);
1097 strbuf_addf(&untracked_msg, "untracked files on %s\n", msg->buf);
1098 if (pipe_command(&cp_upd_index, files.buf, files.len, NULL, 0,
1104 if (write_index_as_tree(&info->u_tree, &istate, stash_index_path.buf, 0,
1110 if (commit_tree(untracked_msg.buf, untracked_msg.len,
1111 &info->u_tree, NULL, &info->u_commit, NULL, NULL)) {
1117 discard_index(&istate);
1118 strbuf_release(&untracked_msg);
1119 remove_path(stash_index_path.buf);
1123 static int stash_patch(struct stash_info *info, const struct pathspec *ps,
1124 struct strbuf *out_patch, int quiet)
1127 struct child_process cp_read_tree = CHILD_PROCESS_INIT;
1128 struct child_process cp_diff_tree = CHILD_PROCESS_INIT;
1129 struct index_state istate = { NULL };
1130 char *old_index_env = NULL, *old_repo_index_file;
1132 remove_path(stash_index_path.buf);
1134 cp_read_tree.git_cmd = 1;
1135 strvec_pushl(&cp_read_tree.args, "read-tree", "HEAD", NULL);
1136 strvec_pushf(&cp_read_tree.env_array, "GIT_INDEX_FILE=%s",
1137 stash_index_path.buf);
1138 if (run_command(&cp_read_tree)) {
1143 /* Find out what the user wants. */
1144 old_repo_index_file = the_repository->index_file;
1145 the_repository->index_file = stash_index_path.buf;
1146 old_index_env = xstrdup_or_null(getenv(INDEX_ENVIRONMENT));
1147 setenv(INDEX_ENVIRONMENT, the_repository->index_file, 1);
1149 ret = run_add_interactive(NULL, "--patch=stash", ps);
1151 the_repository->index_file = old_repo_index_file;
1152 if (old_index_env && *old_index_env)
1153 setenv(INDEX_ENVIRONMENT, old_index_env, 1);
1155 unsetenv(INDEX_ENVIRONMENT);
1156 FREE_AND_NULL(old_index_env);
1158 /* State of the working tree. */
1159 if (write_index_as_tree(&info->w_tree, &istate, stash_index_path.buf, 0,
1165 cp_diff_tree.git_cmd = 1;
1166 strvec_pushl(&cp_diff_tree.args, "diff-tree", "-p", "-U1", "HEAD",
1167 oid_to_hex(&info->w_tree), "--", NULL);
1168 if (pipe_command(&cp_diff_tree, NULL, 0, out_patch, 0, NULL, 0)) {
1173 if (!out_patch->len) {
1175 fprintf_ln(stderr, _("No changes selected"));
1180 discard_index(&istate);
1181 remove_path(stash_index_path.buf);
1185 static int stash_working_tree(struct stash_info *info, const struct pathspec *ps)
1188 struct rev_info rev;
1189 struct child_process cp_upd_index = CHILD_PROCESS_INIT;
1190 struct strbuf diff_output = STRBUF_INIT;
1191 struct index_state istate = { NULL };
1193 init_revisions(&rev, NULL);
1194 copy_pathspec(&rev.prune_data, ps);
1196 set_alternate_index_output(stash_index_path.buf);
1197 if (reset_tree(&info->i_tree, 0, 0)) {
1201 set_alternate_index_output(NULL);
1203 rev.diffopt.output_format = DIFF_FORMAT_CALLBACK;
1204 rev.diffopt.format_callback = add_diff_to_buf;
1205 rev.diffopt.format_callback_data = &diff_output;
1207 if (read_cache_preload(&rev.diffopt.pathspec) < 0) {
1212 add_pending_object(&rev, parse_object(the_repository, &info->b_commit),
1214 if (run_diff_index(&rev, 0)) {
1219 cp_upd_index.git_cmd = 1;
1220 strvec_pushl(&cp_upd_index.args, "update-index",
1221 "--ignore-skip-worktree-entries",
1222 "-z", "--add", "--remove", "--stdin", NULL);
1223 strvec_pushf(&cp_upd_index.env_array, "GIT_INDEX_FILE=%s",
1224 stash_index_path.buf);
1226 if (pipe_command(&cp_upd_index, diff_output.buf, diff_output.len,
1227 NULL, 0, NULL, 0)) {
1232 if (write_index_as_tree(&info->w_tree, &istate, stash_index_path.buf, 0,
1239 discard_index(&istate);
1241 object_array_clear(&rev.pending);
1242 clear_pathspec(&rev.prune_data);
1243 strbuf_release(&diff_output);
1244 remove_path(stash_index_path.buf);
1248 static int do_create_stash(const struct pathspec *ps, struct strbuf *stash_msg_buf,
1249 int include_untracked, int patch_mode,
1250 struct stash_info *info, struct strbuf *patch,
1255 int untracked_commit_option = 0;
1256 const char *head_short_sha1 = NULL;
1257 const char *branch_ref = NULL;
1258 const char *branch_name = "(no branch)";
1259 struct commit *head_commit = NULL;
1260 struct commit_list *parents = NULL;
1261 struct strbuf msg = STRBUF_INIT;
1262 struct strbuf commit_tree_label = STRBUF_INIT;
1263 struct strbuf untracked_files = STRBUF_INIT;
1265 prepare_fallback_ident("git stash", "git@stash");
1267 read_cache_preload(NULL);
1268 if (refresh_and_write_cache(REFRESH_QUIET, 0, 0) < 0) {
1273 if (get_oid("HEAD", &info->b_commit)) {
1275 fprintf_ln(stderr, _("You do not have "
1276 "the initial commit yet"));
1280 head_commit = lookup_commit(the_repository, &info->b_commit);
1283 if (!check_changes(ps, include_untracked, &untracked_files)) {
1288 branch_ref = resolve_ref_unsafe("HEAD", 0, NULL, &flags);
1289 if (flags & REF_ISSYMREF)
1290 branch_name = strrchr(branch_ref, '/') + 1;
1291 head_short_sha1 = find_unique_abbrev(&head_commit->object.oid,
1293 strbuf_addf(&msg, "%s: %s ", branch_name, head_short_sha1);
1294 pp_commit_easy(CMIT_FMT_ONELINE, head_commit, &msg);
1296 strbuf_addf(&commit_tree_label, "index on %s\n", msg.buf);
1297 commit_list_insert(head_commit, &parents);
1298 if (write_cache_as_tree(&info->i_tree, 0, NULL) ||
1299 commit_tree(commit_tree_label.buf, commit_tree_label.len,
1300 &info->i_tree, parents, &info->i_commit, NULL, NULL)) {
1302 fprintf_ln(stderr, _("Cannot save the current "
1308 if (include_untracked) {
1309 if (save_untracked_files(info, &msg, untracked_files)) {
1311 fprintf_ln(stderr, _("Cannot save "
1312 "the untracked files"));
1316 untracked_commit_option = 1;
1319 ret = stash_patch(info, ps, patch, quiet);
1322 fprintf_ln(stderr, _("Cannot save the current "
1325 } else if (ret > 0) {
1329 if (stash_working_tree(info, ps)) {
1331 fprintf_ln(stderr, _("Cannot save the current "
1338 if (!stash_msg_buf->len)
1339 strbuf_addf(stash_msg_buf, "WIP on %s", msg.buf);
1341 strbuf_insertf(stash_msg_buf, 0, "On %s: ", branch_name);
1344 * `parents` will be empty after calling `commit_tree()`, so there is
1345 * no need to call `free_commit_list()`
1348 if (untracked_commit_option)
1349 commit_list_insert(lookup_commit(the_repository,
1352 commit_list_insert(lookup_commit(the_repository, &info->i_commit),
1354 commit_list_insert(head_commit, &parents);
1356 if (commit_tree(stash_msg_buf->buf, stash_msg_buf->len, &info->w_tree,
1357 parents, &info->w_commit, NULL, NULL)) {
1359 fprintf_ln(stderr, _("Cannot record "
1360 "working tree state"));
1366 strbuf_release(&commit_tree_label);
1367 strbuf_release(&msg);
1368 strbuf_release(&untracked_files);
1372 static int create_stash(int argc, const char **argv, const char *prefix)
1375 struct strbuf stash_msg_buf = STRBUF_INIT;
1376 struct stash_info info;
1379 /* Starting with argv[1], since argv[0] is "create" */
1380 strbuf_join_argv(&stash_msg_buf, argc - 1, ++argv, ' ');
1382 memset(&ps, 0, sizeof(ps));
1383 if (!check_changes_tracked_files(&ps))
1386 ret = do_create_stash(&ps, &stash_msg_buf, 0, 0, &info,
1389 printf_ln("%s", oid_to_hex(&info.w_commit));
1391 strbuf_release(&stash_msg_buf);
1395 static int do_push_stash(const struct pathspec *ps, const char *stash_msg, int quiet,
1396 int keep_index, int patch_mode, int include_untracked)
1399 struct stash_info info;
1400 struct strbuf patch = STRBUF_INIT;
1401 struct strbuf stash_msg_buf = STRBUF_INIT;
1402 struct strbuf untracked_files = STRBUF_INIT;
1404 if (patch_mode && keep_index == -1)
1407 if (patch_mode && include_untracked) {
1408 fprintf_ln(stderr, _("Can't use --patch and --include-untracked"
1409 " or --all at the same time"));
1414 read_cache_preload(NULL);
1415 if (!include_untracked && ps->nr) {
1417 char *ps_matched = xcalloc(ps->nr, 1);
1419 /* TODO: audit for interaction with sparse-index. */
1420 ensure_full_index(&the_index);
1421 for (i = 0; i < active_nr; i++)
1422 ce_path_match(&the_index, active_cache[i], ps,
1425 if (report_path_error(ps_matched, ps)) {
1426 fprintf_ln(stderr, _("Did you forget to 'git add'?"));
1434 if (refresh_and_write_cache(REFRESH_QUIET, 0, 0)) {
1439 if (!check_changes(ps, include_untracked, &untracked_files)) {
1441 printf_ln(_("No local changes to save"));
1445 if (!reflog_exists(ref_stash) && do_clear_stash()) {
1448 fprintf_ln(stderr, _("Cannot initialize stash"));
1453 strbuf_addstr(&stash_msg_buf, stash_msg);
1454 if (do_create_stash(ps, &stash_msg_buf, include_untracked, patch_mode,
1455 &info, &patch, quiet)) {
1460 if (do_store_stash(&info.w_commit, stash_msg_buf.buf, 1)) {
1463 fprintf_ln(stderr, _("Cannot save the current status"));
1468 printf_ln(_("Saved working directory and index state %s"),
1472 if (include_untracked && !ps->nr) {
1473 struct child_process cp = CHILD_PROCESS_INIT;
1476 strvec_pushl(&cp.args, "clean", "--force",
1477 "--quiet", "-d", NULL);
1478 if (include_untracked == INCLUDE_ALL_FILES)
1479 strvec_push(&cp.args, "-x");
1480 if (run_command(&cp)) {
1487 struct child_process cp_add = CHILD_PROCESS_INIT;
1488 struct child_process cp_diff = CHILD_PROCESS_INIT;
1489 struct child_process cp_apply = CHILD_PROCESS_INIT;
1490 struct strbuf out = STRBUF_INIT;
1493 strvec_push(&cp_add.args, "add");
1494 if (!include_untracked)
1495 strvec_push(&cp_add.args, "-u");
1496 if (include_untracked == INCLUDE_ALL_FILES)
1497 strvec_push(&cp_add.args, "--force");
1498 strvec_push(&cp_add.args, "--");
1499 add_pathspecs(&cp_add.args, ps);
1500 if (run_command(&cp_add)) {
1505 cp_diff.git_cmd = 1;
1506 strvec_pushl(&cp_diff.args, "diff-index", "-p",
1507 "--cached", "--binary", "HEAD", "--",
1509 add_pathspecs(&cp_diff.args, ps);
1510 if (pipe_command(&cp_diff, NULL, 0, &out, 0, NULL, 0)) {
1515 cp_apply.git_cmd = 1;
1516 strvec_pushl(&cp_apply.args, "apply", "--index",
1518 if (pipe_command(&cp_apply, out.buf, out.len, NULL, 0,
1524 struct child_process cp = CHILD_PROCESS_INIT;
1526 strvec_pushl(&cp.args, "reset", "--hard", "-q",
1527 "--no-recurse-submodules", NULL);
1528 if (run_command(&cp)) {
1534 if (keep_index == 1 && !is_null_oid(&info.i_tree)) {
1535 struct child_process cp = CHILD_PROCESS_INIT;
1538 strvec_pushl(&cp.args, "checkout", "--no-overlay",
1539 oid_to_hex(&info.i_tree), "--", NULL);
1541 strvec_push(&cp.args, ":/");
1543 add_pathspecs(&cp.args, ps);
1544 if (run_command(&cp)) {
1551 struct child_process cp = CHILD_PROCESS_INIT;
1554 strvec_pushl(&cp.args, "apply", "-R", NULL);
1556 if (pipe_command(&cp, patch.buf, patch.len, NULL, 0, NULL, 0)) {
1558 fprintf_ln(stderr, _("Cannot remove "
1559 "worktree changes"));
1564 if (keep_index < 1) {
1565 struct child_process cp = CHILD_PROCESS_INIT;
1568 strvec_pushl(&cp.args, "reset", "-q", "--", NULL);
1569 add_pathspecs(&cp.args, ps);
1570 if (run_command(&cp)) {
1579 strbuf_release(&stash_msg_buf);
1583 static int push_stash(int argc, const char **argv, const char *prefix,
1586 int force_assume = 0;
1587 int keep_index = -1;
1589 int include_untracked = 0;
1591 int pathspec_file_nul = 0;
1592 const char *stash_msg = NULL;
1593 const char *pathspec_from_file = NULL;
1595 struct option options[] = {
1596 OPT_BOOL('k', "keep-index", &keep_index,
1598 OPT_BOOL('p', "patch", &patch_mode,
1599 N_("stash in patch mode")),
1600 OPT__QUIET(&quiet, N_("quiet mode")),
1601 OPT_BOOL('u', "include-untracked", &include_untracked,
1602 N_("include untracked files in stash")),
1603 OPT_SET_INT('a', "all", &include_untracked,
1604 N_("include ignore files"), 2),
1605 OPT_STRING('m', "message", &stash_msg, N_("message"),
1606 N_("stash message")),
1607 OPT_PATHSPEC_FROM_FILE(&pathspec_from_file),
1608 OPT_PATHSPEC_FILE_NUL(&pathspec_file_nul),
1613 force_assume = !strcmp(argv[0], "-p");
1614 argc = parse_options(argc, argv, prefix, options,
1615 git_stash_push_usage,
1616 PARSE_OPT_KEEP_DASHDASH);
1620 if (!strcmp(argv[0], "--")) {
1623 } else if (push_assumed && !force_assume) {
1624 die("subcommand wasn't specified; 'push' can't be assumed due to unexpected token '%s'",
1629 parse_pathspec(&ps, 0, PATHSPEC_PREFER_FULL | PATHSPEC_PREFIX_ORIGIN,
1632 if (pathspec_from_file) {
1634 die(_("--pathspec-from-file is incompatible with --patch"));
1637 die(_("--pathspec-from-file is incompatible with pathspec arguments"));
1639 parse_pathspec_file(&ps, 0,
1640 PATHSPEC_PREFER_FULL | PATHSPEC_PREFIX_ORIGIN,
1641 prefix, pathspec_from_file, pathspec_file_nul);
1642 } else if (pathspec_file_nul) {
1643 die(_("--pathspec-file-nul requires --pathspec-from-file"));
1646 return do_push_stash(&ps, stash_msg, quiet, keep_index, patch_mode,
1650 static int save_stash(int argc, const char **argv, const char *prefix)
1652 int keep_index = -1;
1654 int include_untracked = 0;
1657 const char *stash_msg = NULL;
1659 struct strbuf stash_msg_buf = STRBUF_INIT;
1660 struct option options[] = {
1661 OPT_BOOL('k', "keep-index", &keep_index,
1663 OPT_BOOL('p', "patch", &patch_mode,
1664 N_("stash in patch mode")),
1665 OPT__QUIET(&quiet, N_("quiet mode")),
1666 OPT_BOOL('u', "include-untracked", &include_untracked,
1667 N_("include untracked files in stash")),
1668 OPT_SET_INT('a', "all", &include_untracked,
1669 N_("include ignore files"), 2),
1670 OPT_STRING('m', "message", &stash_msg, "message",
1671 N_("stash message")),
1675 argc = parse_options(argc, argv, prefix, options,
1676 git_stash_save_usage,
1677 PARSE_OPT_KEEP_DASHDASH);
1680 stash_msg = strbuf_join_argv(&stash_msg_buf, argc, argv, ' ');
1682 memset(&ps, 0, sizeof(ps));
1683 ret = do_push_stash(&ps, stash_msg, quiet, keep_index,
1684 patch_mode, include_untracked);
1686 strbuf_release(&stash_msg_buf);
1690 int cmd_stash(int argc, const char **argv, const char *prefix)
1692 pid_t pid = getpid();
1693 const char *index_file;
1694 struct strvec args = STRVEC_INIT;
1696 struct option options[] = {
1700 git_config(git_stash_config, NULL);
1702 if (use_legacy_stash ||
1703 !git_env_bool("GIT_TEST_STASH_USE_BUILTIN", -1))
1704 warning(_("the stash.useBuiltin support has been removed!\n"
1705 "See its entry in 'git help config' for details."));
1707 argc = parse_options(argc, argv, prefix, options, git_stash_usage,
1708 PARSE_OPT_KEEP_UNKNOWN | PARSE_OPT_KEEP_DASHDASH);
1710 index_file = get_index_file();
1711 strbuf_addf(&stash_index_path, "%s.stash.%" PRIuMAX, index_file,
1715 return !!push_stash(0, NULL, prefix, 0);
1716 else if (!strcmp(argv[0], "apply"))
1717 return !!apply_stash(argc, argv, prefix);
1718 else if (!strcmp(argv[0], "clear"))
1719 return !!clear_stash(argc, argv, prefix);
1720 else if (!strcmp(argv[0], "drop"))
1721 return !!drop_stash(argc, argv, prefix);
1722 else if (!strcmp(argv[0], "pop"))
1723 return !!pop_stash(argc, argv, prefix);
1724 else if (!strcmp(argv[0], "branch"))
1725 return !!branch_stash(argc, argv, prefix);
1726 else if (!strcmp(argv[0], "list"))
1727 return !!list_stash(argc, argv, prefix);
1728 else if (!strcmp(argv[0], "show"))
1729 return !!show_stash(argc, argv, prefix);
1730 else if (!strcmp(argv[0], "store"))
1731 return !!store_stash(argc, argv, prefix);
1732 else if (!strcmp(argv[0], "create"))
1733 return !!create_stash(argc, argv, prefix);
1734 else if (!strcmp(argv[0], "push"))
1735 return !!push_stash(argc, argv, prefix, 0);
1736 else if (!strcmp(argv[0], "save"))
1737 return !!save_stash(argc, argv, prefix);
1738 else if (*argv[0] != '-')
1739 usage_msg_opt(xstrfmt(_("unknown subcommand: %s"), argv[0]),
1740 git_stash_usage, options);
1742 /* Assume 'stash push' */
1743 strvec_push(&args, "push");
1744 strvec_pushv(&args, argv);
1745 return !!push_stash(args.nr, args.v, prefix, 1);