parse-options: automatically infer PARSE_OPT_LITERAL_ARGHELP
[git.git] / builtin / add.c
blob8352bdf71f3838968a4e9e3ecaae80a702d01786
1 /*
2 * "git add" builtin command
4 * Copyright (C) 2006 Linus Torvalds
5 */
6 #include "cache.h"
7 #include "config.h"
8 #include "builtin.h"
9 #include "lockfile.h"
10 #include "dir.h"
11 #include "pathspec.h"
12 #include "exec_cmd.h"
13 #include "cache-tree.h"
14 #include "run-command.h"
15 #include "parse-options.h"
16 #include "diff.h"
17 #include "diffcore.h"
18 #include "revision.h"
19 #include "bulk-checkin.h"
20 #include "argv-array.h"
21 #include "submodule.h"
23 static const char * const builtin_add_usage[] = {
24 N_("git add [<options>] [--] <pathspec>..."),
25 NULL
27 static int patch_interactive, add_interactive, edit_interactive;
28 static int take_worktree_changes;
29 static int add_renormalize;
31 struct update_callback_data {
32 int flags;
33 int add_errors;
36 static void chmod_pathspec(struct pathspec *pathspec, char flip)
38 int i;
40 for (i = 0; i < active_nr; i++) {
41 struct cache_entry *ce = active_cache[i];
43 if (pathspec && !ce_path_match(ce, pathspec, NULL))
44 continue;
46 if (chmod_cache_entry(ce, flip) < 0)
47 fprintf(stderr, "cannot chmod %cx '%s'\n", flip, ce->name);
51 static int fix_unmerged_status(struct diff_filepair *p,
52 struct update_callback_data *data)
54 if (p->status != DIFF_STATUS_UNMERGED)
55 return p->status;
56 if (!(data->flags & ADD_CACHE_IGNORE_REMOVAL) && !p->two->mode)
58 * This is not an explicit add request, and the
59 * path is missing from the working tree (deleted)
61 return DIFF_STATUS_DELETED;
62 else
64 * Either an explicit add request, or path exists
65 * in the working tree. An attempt to explicitly
66 * add a path that does not exist in the working tree
67 * will be caught as an error by the caller immediately.
69 return DIFF_STATUS_MODIFIED;
72 static void update_callback(struct diff_queue_struct *q,
73 struct diff_options *opt, void *cbdata)
75 int i;
76 struct update_callback_data *data = cbdata;
78 for (i = 0; i < q->nr; i++) {
79 struct diff_filepair *p = q->queue[i];
80 const char *path = p->one->path;
81 switch (fix_unmerged_status(p, data)) {
82 default:
83 die(_("unexpected diff status %c"), p->status);
84 case DIFF_STATUS_MODIFIED:
85 case DIFF_STATUS_TYPE_CHANGED:
86 if (add_file_to_index(&the_index, path, data->flags)) {
87 if (!(data->flags & ADD_CACHE_IGNORE_ERRORS))
88 die(_("updating files failed"));
89 data->add_errors++;
91 break;
92 case DIFF_STATUS_DELETED:
93 if (data->flags & ADD_CACHE_IGNORE_REMOVAL)
94 break;
95 if (!(data->flags & ADD_CACHE_PRETEND))
96 remove_file_from_index(&the_index, path);
97 if (data->flags & (ADD_CACHE_PRETEND|ADD_CACHE_VERBOSE))
98 printf(_("remove '%s'\n"), path);
99 break;
104 int add_files_to_cache(const char *prefix,
105 const struct pathspec *pathspec, int flags)
107 struct update_callback_data data;
108 struct rev_info rev;
110 memset(&data, 0, sizeof(data));
111 data.flags = flags;
113 init_revisions(&rev, prefix);
114 setup_revisions(0, NULL, &rev, NULL);
115 if (pathspec)
116 copy_pathspec(&rev.prune_data, pathspec);
117 rev.diffopt.output_format = DIFF_FORMAT_CALLBACK;
118 rev.diffopt.format_callback = update_callback;
119 rev.diffopt.format_callback_data = &data;
120 rev.diffopt.flags.override_submodule_config = 1;
121 rev.max_count = 0; /* do not compare unmerged paths with stage #2 */
122 run_diff_files(&rev, DIFF_RACY_IS_MODIFIED);
123 clear_pathspec(&rev.prune_data);
124 return !!data.add_errors;
127 static int renormalize_tracked_files(const struct pathspec *pathspec, int flags)
129 int i, retval = 0;
131 for (i = 0; i < active_nr; i++) {
132 struct cache_entry *ce = active_cache[i];
134 if (ce_stage(ce))
135 continue; /* do not touch unmerged paths */
136 if (!S_ISREG(ce->ce_mode) && !S_ISLNK(ce->ce_mode))
137 continue; /* do not touch non blobs */
138 if (pathspec && !ce_path_match(ce, pathspec, NULL))
139 continue;
140 retval |= add_file_to_cache(ce->name, flags | HASH_RENORMALIZE);
143 return retval;
146 static char *prune_directory(struct dir_struct *dir, struct pathspec *pathspec, int prefix)
148 char *seen;
149 int i;
150 struct dir_entry **src, **dst;
152 seen = xcalloc(pathspec->nr, 1);
154 src = dst = dir->entries;
155 i = dir->nr;
156 while (--i >= 0) {
157 struct dir_entry *entry = *src++;
158 if (dir_path_match(entry, pathspec, prefix, seen))
159 *dst++ = entry;
161 dir->nr = dst - dir->entries;
162 add_pathspec_matches_against_index(pathspec, &the_index, seen);
163 return seen;
166 static void refresh(int verbose, const struct pathspec *pathspec)
168 char *seen;
169 int i;
171 seen = xcalloc(pathspec->nr, 1);
172 refresh_index(&the_index, verbose ? REFRESH_IN_PORCELAIN : REFRESH_QUIET,
173 pathspec, seen, _("Unstaged changes after refreshing the index:"));
174 for (i = 0; i < pathspec->nr; i++) {
175 if (!seen[i])
176 die(_("pathspec '%s' did not match any files"),
177 pathspec->items[i].match);
179 free(seen);
182 int run_add_interactive(const char *revision, const char *patch_mode,
183 const struct pathspec *pathspec)
185 int status, i;
186 struct argv_array argv = ARGV_ARRAY_INIT;
188 argv_array_push(&argv, "add--interactive");
189 if (patch_mode)
190 argv_array_push(&argv, patch_mode);
191 if (revision)
192 argv_array_push(&argv, revision);
193 argv_array_push(&argv, "--");
194 for (i = 0; i < pathspec->nr; i++)
195 /* pass original pathspec, to be re-parsed */
196 argv_array_push(&argv, pathspec->items[i].original);
198 status = run_command_v_opt(argv.argv, RUN_GIT_CMD);
199 argv_array_clear(&argv);
200 return status;
203 int interactive_add(int argc, const char **argv, const char *prefix, int patch)
205 struct pathspec pathspec;
207 parse_pathspec(&pathspec, 0,
208 PATHSPEC_PREFER_FULL |
209 PATHSPEC_SYMLINK_LEADING_PATH |
210 PATHSPEC_PREFIX_ORIGIN,
211 prefix, argv);
213 return run_add_interactive(NULL,
214 patch ? "--patch" : NULL,
215 &pathspec);
218 static int edit_patch(int argc, const char **argv, const char *prefix)
220 char *file = git_pathdup("ADD_EDIT.patch");
221 const char *apply_argv[] = { "apply", "--recount", "--cached",
222 NULL, NULL };
223 struct child_process child = CHILD_PROCESS_INIT;
224 struct rev_info rev;
225 int out;
226 struct stat st;
228 apply_argv[3] = file;
230 git_config(git_diff_basic_config, NULL); /* no "diff" UI options */
232 if (read_cache() < 0)
233 die(_("Could not read the index"));
235 init_revisions(&rev, prefix);
236 rev.diffopt.context = 7;
238 argc = setup_revisions(argc, argv, &rev, NULL);
239 rev.diffopt.output_format = DIFF_FORMAT_PATCH;
240 rev.diffopt.use_color = 0;
241 rev.diffopt.flags.ignore_dirty_submodules = 1;
242 out = open(file, O_CREAT | O_WRONLY, 0666);
243 if (out < 0)
244 die(_("Could not open '%s' for writing."), file);
245 rev.diffopt.file = xfdopen(out, "w");
246 rev.diffopt.close_file = 1;
247 if (run_diff_files(&rev, 0))
248 die(_("Could not write patch"));
250 if (launch_editor(file, NULL, NULL))
251 die(_("editing patch failed"));
253 if (stat(file, &st))
254 die_errno(_("Could not stat '%s'"), file);
255 if (!st.st_size)
256 die(_("Empty patch. Aborted."));
258 child.git_cmd = 1;
259 child.argv = apply_argv;
260 if (run_command(&child))
261 die(_("Could not apply '%s'"), file);
263 unlink(file);
264 free(file);
265 return 0;
268 static struct lock_file lock_file;
270 static const char ignore_error[] =
271 N_("The following paths are ignored by one of your .gitignore files:\n");
273 static int verbose, show_only, ignored_too, refresh_only;
274 static int ignore_add_errors, intent_to_add, ignore_missing;
275 static int warn_on_embedded_repo = 1;
277 #define ADDREMOVE_DEFAULT 1
278 static int addremove = ADDREMOVE_DEFAULT;
279 static int addremove_explicit = -1; /* unspecified */
281 static char *chmod_arg;
283 static int ignore_removal_cb(const struct option *opt, const char *arg, int unset)
285 /* if we are told to ignore, we are not adding removals */
286 *(int *)opt->value = !unset ? 0 : 1;
287 return 0;
290 static struct option builtin_add_options[] = {
291 OPT__DRY_RUN(&show_only, N_("dry run")),
292 OPT__VERBOSE(&verbose, N_("be verbose")),
293 OPT_GROUP(""),
294 OPT_BOOL('i', "interactive", &add_interactive, N_("interactive picking")),
295 OPT_BOOL('p', "patch", &patch_interactive, N_("select hunks interactively")),
296 OPT_BOOL('e', "edit", &edit_interactive, N_("edit current diff and apply")),
297 OPT__FORCE(&ignored_too, N_("allow adding otherwise ignored files")),
298 OPT_BOOL('u', "update", &take_worktree_changes, N_("update tracked files")),
299 OPT_BOOL(0, "renormalize", &add_renormalize, N_("renormalize EOL of tracked files (implies -u)")),
300 OPT_BOOL('N', "intent-to-add", &intent_to_add, N_("record only the fact that the path will be added later")),
301 OPT_BOOL('A', "all", &addremove_explicit, N_("add changes from all tracked and untracked files")),
302 { OPTION_CALLBACK, 0, "ignore-removal", &addremove_explicit,
303 NULL /* takes no arguments */,
304 N_("ignore paths removed in the working tree (same as --no-all)"),
305 PARSE_OPT_NOARG, ignore_removal_cb },
306 OPT_BOOL( 0 , "refresh", &refresh_only, N_("don't add, only refresh the index")),
307 OPT_BOOL( 0 , "ignore-errors", &ignore_add_errors, N_("just skip files which cannot be added because of errors")),
308 OPT_BOOL( 0 , "ignore-missing", &ignore_missing, N_("check if - even missing - files are ignored in dry run")),
309 OPT_STRING(0, "chmod", &chmod_arg, "(+|-)x",
310 N_("override the executable bit of the listed files")),
311 OPT_HIDDEN_BOOL(0, "warn-embedded-repo", &warn_on_embedded_repo,
312 N_("warn when adding an embedded repository")),
313 OPT_END(),
316 static int add_config(const char *var, const char *value, void *cb)
318 if (!strcmp(var, "add.ignoreerrors") ||
319 !strcmp(var, "add.ignore-errors")) {
320 ignore_add_errors = git_config_bool(var, value);
321 return 0;
323 return git_default_config(var, value, cb);
326 static const char embedded_advice[] = N_(
327 "You've added another git repository inside your current repository.\n"
328 "Clones of the outer repository will not contain the contents of\n"
329 "the embedded repository and will not know how to obtain it.\n"
330 "If you meant to add a submodule, use:\n"
331 "\n"
332 " git submodule add <url> %s\n"
333 "\n"
334 "If you added this path by mistake, you can remove it from the\n"
335 "index with:\n"
336 "\n"
337 " git rm --cached %s\n"
338 "\n"
339 "See \"git help submodule\" for more information."
342 static void check_embedded_repo(const char *path)
344 struct strbuf name = STRBUF_INIT;
346 if (!warn_on_embedded_repo)
347 return;
348 if (!ends_with(path, "/"))
349 return;
351 /* Drop trailing slash for aesthetics */
352 strbuf_addstr(&name, path);
353 strbuf_strip_suffix(&name, "/");
355 warning(_("adding embedded git repository: %s"), name.buf);
356 if (advice_add_embedded_repo) {
357 advise(embedded_advice, name.buf, name.buf);
358 /* there may be multiple entries; advise only once */
359 advice_add_embedded_repo = 0;
362 strbuf_release(&name);
365 static int add_files(struct dir_struct *dir, int flags)
367 int i, exit_status = 0;
369 if (dir->ignored_nr) {
370 fprintf(stderr, _(ignore_error));
371 for (i = 0; i < dir->ignored_nr; i++)
372 fprintf(stderr, "%s\n", dir->ignored[i]->name);
373 fprintf(stderr, _("Use -f if you really want to add them.\n"));
374 exit_status = 1;
377 for (i = 0; i < dir->nr; i++) {
378 check_embedded_repo(dir->entries[i]->name);
379 if (add_file_to_index(&the_index, dir->entries[i]->name, flags)) {
380 if (!ignore_add_errors)
381 die(_("adding files failed"));
382 exit_status = 1;
385 return exit_status;
388 int cmd_add(int argc, const char **argv, const char *prefix)
390 int exit_status = 0;
391 struct pathspec pathspec;
392 struct dir_struct dir;
393 int flags;
394 int add_new_files;
395 int require_pathspec;
396 char *seen = NULL;
398 git_config(add_config, NULL);
400 argc = parse_options(argc, argv, prefix, builtin_add_options,
401 builtin_add_usage, PARSE_OPT_KEEP_ARGV0);
402 if (patch_interactive)
403 add_interactive = 1;
404 if (add_interactive)
405 exit(interactive_add(argc - 1, argv + 1, prefix, patch_interactive));
407 if (edit_interactive)
408 return(edit_patch(argc, argv, prefix));
409 argc--;
410 argv++;
412 if (0 <= addremove_explicit)
413 addremove = addremove_explicit;
414 else if (take_worktree_changes && ADDREMOVE_DEFAULT)
415 addremove = 0; /* "-u" was given but not "-A" */
417 if (addremove && take_worktree_changes)
418 die(_("-A and -u are mutually incompatible"));
420 if (!take_worktree_changes && addremove_explicit < 0 && argc)
421 /* Turn "git add pathspec..." to "git add -A pathspec..." */
422 addremove = 1;
424 if (!show_only && ignore_missing)
425 die(_("Option --ignore-missing can only be used together with --dry-run"));
427 if (chmod_arg && ((chmod_arg[0] != '-' && chmod_arg[0] != '+') ||
428 chmod_arg[1] != 'x' || chmod_arg[2]))
429 die(_("--chmod param '%s' must be either -x or +x"), chmod_arg);
431 add_new_files = !take_worktree_changes && !refresh_only && !add_renormalize;
432 require_pathspec = !(take_worktree_changes || (0 < addremove_explicit));
434 hold_locked_index(&lock_file, LOCK_DIE_ON_ERROR);
436 flags = ((verbose ? ADD_CACHE_VERBOSE : 0) |
437 (show_only ? ADD_CACHE_PRETEND : 0) |
438 (intent_to_add ? ADD_CACHE_INTENT : 0) |
439 (ignore_add_errors ? ADD_CACHE_IGNORE_ERRORS : 0) |
440 (!(addremove || take_worktree_changes)
441 ? ADD_CACHE_IGNORE_REMOVAL : 0));
443 if (require_pathspec && argc == 0) {
444 fprintf(stderr, _("Nothing specified, nothing added.\n"));
445 fprintf(stderr, _("Maybe you wanted to say 'git add .'?\n"));
446 return 0;
449 if (read_cache() < 0)
450 die(_("index file corrupt"));
452 die_in_unpopulated_submodule(&the_index, prefix);
455 * Check the "pathspec '%s' did not match any files" block
456 * below before enabling new magic.
458 parse_pathspec(&pathspec, 0,
459 PATHSPEC_PREFER_FULL |
460 PATHSPEC_SYMLINK_LEADING_PATH,
461 prefix, argv);
463 die_path_inside_submodule(&the_index, &pathspec);
465 if (add_new_files) {
466 int baselen;
468 /* Set up the default git porcelain excludes */
469 memset(&dir, 0, sizeof(dir));
470 if (!ignored_too) {
471 dir.flags |= DIR_COLLECT_IGNORED;
472 setup_standard_excludes(&dir);
475 /* This picks up the paths that are not tracked */
476 baselen = fill_directory(&dir, &the_index, &pathspec);
477 if (pathspec.nr)
478 seen = prune_directory(&dir, &pathspec, baselen);
481 if (refresh_only) {
482 refresh(verbose, &pathspec);
483 goto finish;
486 if (pathspec.nr) {
487 int i;
489 if (!seen)
490 seen = find_pathspecs_matching_against_index(&pathspec, &the_index);
493 * file_exists() assumes exact match
495 GUARD_PATHSPEC(&pathspec,
496 PATHSPEC_FROMTOP |
497 PATHSPEC_LITERAL |
498 PATHSPEC_GLOB |
499 PATHSPEC_ICASE |
500 PATHSPEC_EXCLUDE);
502 for (i = 0; i < pathspec.nr; i++) {
503 const char *path = pathspec.items[i].match;
504 if (pathspec.items[i].magic & PATHSPEC_EXCLUDE)
505 continue;
506 if (!seen[i] && path[0] &&
507 ((pathspec.items[i].magic &
508 (PATHSPEC_GLOB | PATHSPEC_ICASE)) ||
509 !file_exists(path))) {
510 if (ignore_missing) {
511 int dtype = DT_UNKNOWN;
512 if (is_excluded(&dir, &the_index, path, &dtype))
513 dir_add_ignored(&dir, &the_index,
514 path, pathspec.items[i].len);
515 } else
516 die(_("pathspec '%s' did not match any files"),
517 pathspec.items[i].original);
520 free(seen);
523 plug_bulk_checkin();
525 if (add_renormalize)
526 exit_status |= renormalize_tracked_files(&pathspec, flags);
527 else
528 exit_status |= add_files_to_cache(prefix, &pathspec, flags);
530 if (add_new_files)
531 exit_status |= add_files(&dir, flags);
533 if (chmod_arg && pathspec.nr)
534 chmod_pathspec(&pathspec, chmod_arg[0]);
535 unplug_bulk_checkin();
537 finish:
538 if (active_cache_changed) {
539 if (write_locked_index(&the_index, &lock_file, COMMIT_LOCK))
540 die(_("Unable to write new index file"));
543 UNLEAK(pathspec);
544 UNLEAK(dir);
545 return exit_status;