Merge branch 'jc/doc-maintainer'
[git.git] / builtin / add.c
1 /*
2  * "git add" builtin command
3  *
4  * Copyright (C) 2006 Linus Torvalds
5  */
6 #include "cache.h"
7 #include "builtin.h"
8 #include "dir.h"
9 #include "pathspec.h"
10 #include "exec_cmd.h"
11 #include "cache-tree.h"
12 #include "run-command.h"
13 #include "parse-options.h"
14 #include "diff.h"
15 #include "diffcore.h"
16 #include "revision.h"
17 #include "bulk-checkin.h"
18
19 static const char * const builtin_add_usage[] = {
20         N_("git add [options] [--] <filepattern>..."),
21         NULL
22 };
23 static int patch_interactive, add_interactive, edit_interactive;
24 static int take_worktree_changes;
25
26 struct update_callback_data {
27         int flags;
28         int add_errors;
29 };
30
31 static int fix_unmerged_status(struct diff_filepair *p,
32                                struct update_callback_data *data)
33 {
34         if (p->status != DIFF_STATUS_UNMERGED)
35                 return p->status;
36         if (!(data->flags & ADD_CACHE_IGNORE_REMOVAL) && !p->two->mode)
37                 /*
38                  * This is not an explicit add request, and the
39                  * path is missing from the working tree (deleted)
40                  */
41                 return DIFF_STATUS_DELETED;
42         else
43                 /*
44                  * Either an explicit add request, or path exists
45                  * in the working tree.  An attempt to explicitly
46                  * add a path that does not exist in the working tree
47                  * will be caught as an error by the caller immediately.
48                  */
49                 return DIFF_STATUS_MODIFIED;
50 }
51
52 static void update_callback(struct diff_queue_struct *q,
53                             struct diff_options *opt, void *cbdata)
54 {
55         int i;
56         struct update_callback_data *data = cbdata;
57
58         for (i = 0; i < q->nr; i++) {
59                 struct diff_filepair *p = q->queue[i];
60                 const char *path = p->one->path;
61                 switch (fix_unmerged_status(p, data)) {
62                 default:
63                         die(_("unexpected diff status %c"), p->status);
64                 case DIFF_STATUS_MODIFIED:
65                 case DIFF_STATUS_TYPE_CHANGED:
66                         if (add_file_to_index(&the_index, path, data->flags)) {
67                                 if (!(data->flags & ADD_CACHE_IGNORE_ERRORS))
68                                         die(_("updating files failed"));
69                                 data->add_errors++;
70                         }
71                         break;
72                 case DIFF_STATUS_DELETED:
73                         if (data->flags & ADD_CACHE_IGNORE_REMOVAL)
74                                 break;
75                         if (!(data->flags & ADD_CACHE_PRETEND))
76                                 remove_file_from_index(&the_index, path);
77                         if (data->flags & (ADD_CACHE_PRETEND|ADD_CACHE_VERBOSE))
78                                 printf(_("remove '%s'\n"), path);
79                         break;
80                 }
81         }
82 }
83
84 int add_files_to_cache(const char *prefix, const char **pathspec, int flags)
85 {
86         struct update_callback_data data;
87         struct rev_info rev;
88         init_revisions(&rev, prefix);
89         setup_revisions(0, NULL, &rev, NULL);
90         init_pathspec(&rev.prune_data, pathspec);
91         rev.diffopt.output_format = DIFF_FORMAT_CALLBACK;
92         rev.diffopt.format_callback = update_callback;
93         data.flags = flags;
94         data.add_errors = 0;
95         rev.diffopt.format_callback_data = &data;
96         rev.max_count = 0; /* do not compare unmerged paths with stage #2 */
97         run_diff_files(&rev, DIFF_RACY_IS_MODIFIED);
98         return !!data.add_errors;
99 }
100
101 static char *prune_directory(struct dir_struct *dir, const char **pathspec, int prefix)
102 {
103         char *seen;
104         int i, specs;
105         struct dir_entry **src, **dst;
106
107         for (specs = 0; pathspec[specs];  specs++)
108                 /* nothing */;
109         seen = xcalloc(specs, 1);
110
111         src = dst = dir->entries;
112         i = dir->nr;
113         while (--i >= 0) {
114                 struct dir_entry *entry = *src++;
115                 if (match_pathspec(pathspec, entry->name, entry->len,
116                                    prefix, seen))
117                         *dst++ = entry;
118         }
119         dir->nr = dst - dir->entries;
120         add_pathspec_matches_against_index(pathspec, seen, specs);
121         return seen;
122 }
123
124 /*
125  * Checks the index to see whether any path in pathspec refers to
126  * something inside a submodule.  If so, dies with an error message.
127  */
128 static void treat_gitlinks(const char **pathspec)
129 {
130         int i;
131
132         if (!pathspec || !*pathspec)
133                 return;
134
135         for (i = 0; pathspec[i]; i++)
136                 pathspec[i] = check_path_for_gitlink(pathspec[i]);
137 }
138
139 static void refresh(int verbose, const char **pathspec)
140 {
141         char *seen;
142         int i, specs;
143
144         for (specs = 0; pathspec[specs];  specs++)
145                 /* nothing */;
146         seen = xcalloc(specs, 1);
147         refresh_index(&the_index, verbose ? REFRESH_IN_PORCELAIN : REFRESH_QUIET,
148                       pathspec, seen, _("Unstaged changes after refreshing the index:"));
149         for (i = 0; i < specs; i++) {
150                 if (!seen[i])
151                         die(_("pathspec '%s' did not match any files"), pathspec[i]);
152         }
153         free(seen);
154 }
155
156 /*
157  * Normalizes argv relative to prefix, via get_pathspec(), and then
158  * runs die_if_path_beyond_symlink() on each path in the normalized
159  * list.
160  */
161 static const char **validate_pathspec(const char **argv, const char *prefix)
162 {
163         const char **pathspec = get_pathspec(prefix, argv);
164
165         if (pathspec) {
166                 const char **p;
167                 for (p = pathspec; *p; p++) {
168                         die_if_path_beyond_symlink(*p, prefix);
169                 }
170         }
171
172         return pathspec;
173 }
174
175 int run_add_interactive(const char *revision, const char *patch_mode,
176                         const char **pathspec)
177 {
178         int status, ac, pc = 0;
179         const char **args;
180
181         if (pathspec)
182                 while (pathspec[pc])
183                         pc++;
184
185         args = xcalloc(sizeof(const char *), (pc + 5));
186         ac = 0;
187         args[ac++] = "add--interactive";
188         if (patch_mode)
189                 args[ac++] = patch_mode;
190         if (revision)
191                 args[ac++] = revision;
192         args[ac++] = "--";
193         if (pc) {
194                 memcpy(&(args[ac]), pathspec, sizeof(const char *) * pc);
195                 ac += pc;
196         }
197         args[ac] = NULL;
198
199         status = run_command_v_opt(args, RUN_GIT_CMD);
200         free(args);
201         return status;
202 }
203
204 int interactive_add(int argc, const char **argv, const char *prefix, int patch)
205 {
206         const char **pathspec = NULL;
207
208         if (argc) {
209                 pathspec = validate_pathspec(argv, prefix);
210                 if (!pathspec)
211                         return -1;
212         }
213
214         return run_add_interactive(NULL,
215                                    patch ? "--patch" : NULL,
216                                    pathspec);
217 }
218
219 static int edit_patch(int argc, const char **argv, const char *prefix)
220 {
221         char *file = git_pathdup("ADD_EDIT.patch");
222         const char *apply_argv[] = { "apply", "--recount", "--cached",
223                 NULL, NULL };
224         struct child_process child;
225         struct rev_info rev;
226         int out;
227         struct stat st;
228
229         apply_argv[3] = file;
230
231         git_config(git_diff_basic_config, NULL); /* no "diff" UI options */
232
233         if (read_cache() < 0)
234                 die (_("Could not read the index"));
235
236         init_revisions(&rev, prefix);
237         rev.diffopt.context = 7;
238
239         argc = setup_revisions(argc, argv, &rev, NULL);
240         rev.diffopt.output_format = DIFF_FORMAT_PATCH;
241         DIFF_OPT_SET(&rev.diffopt, IGNORE_DIRTY_SUBMODULES);
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"));
249
250         launch_editor(file, NULL, NULL);
251
252         if (stat(file, &st))
253                 die_errno(_("Could not stat '%s'"), file);
254         if (!st.st_size)
255                 die(_("Empty patch. Aborted."));
256
257         memset(&child, 0, sizeof(child));
258         child.git_cmd = 1;
259         child.argv = apply_argv;
260         if (run_command(&child))
261                 die (_("Could not apply '%s'"), file);
262
263         unlink(file);
264         free(file);
265         return 0;
266 }
267
268 static struct lock_file lock_file;
269
270 static const char ignore_error[] =
271 N_("The following paths are ignored by one of your .gitignore files:\n");
272
273 static int verbose = 0, show_only = 0, ignored_too = 0, refresh_only = 0;
274 static int ignore_add_errors, addremove, intent_to_add, ignore_missing = 0;
275
276 static struct option builtin_add_options[] = {
277         OPT__DRY_RUN(&show_only, N_("dry run")),
278         OPT__VERBOSE(&verbose, N_("be verbose")),
279         OPT_GROUP(""),
280         OPT_BOOLEAN('i', "interactive", &add_interactive, N_("interactive picking")),
281         OPT_BOOLEAN('p', "patch", &patch_interactive, N_("select hunks interactively")),
282         OPT_BOOLEAN('e', "edit", &edit_interactive, N_("edit current diff and apply")),
283         OPT__FORCE(&ignored_too, N_("allow adding otherwise ignored files")),
284         OPT_BOOLEAN('u', "update", &take_worktree_changes, N_("update tracked files")),
285         OPT_BOOLEAN('N', "intent-to-add", &intent_to_add, N_("record only the fact that the path will be added later")),
286         OPT_BOOLEAN('A', "all", &addremove, N_("add changes from all tracked and untracked files")),
287         OPT_BOOLEAN( 0 , "refresh", &refresh_only, N_("don't add, only refresh the index")),
288         OPT_BOOLEAN( 0 , "ignore-errors", &ignore_add_errors, N_("just skip files which cannot be added because of errors")),
289         OPT_BOOLEAN( 0 , "ignore-missing", &ignore_missing, N_("check if - even missing - files are ignored in dry run")),
290         OPT_END(),
291 };
292
293 static int add_config(const char *var, const char *value, void *cb)
294 {
295         if (!strcmp(var, "add.ignoreerrors") ||
296             !strcmp(var, "add.ignore-errors")) {
297                 ignore_add_errors = git_config_bool(var, value);
298                 return 0;
299         }
300         return git_default_config(var, value, cb);
301 }
302
303 static int add_files(struct dir_struct *dir, int flags)
304 {
305         int i, exit_status = 0;
306
307         if (dir->ignored_nr) {
308                 fprintf(stderr, _(ignore_error));
309                 for (i = 0; i < dir->ignored_nr; i++)
310                         fprintf(stderr, "%s\n", dir->ignored[i]->name);
311                 fprintf(stderr, _("Use -f if you really want to add them.\n"));
312                 die(_("no files added"));
313         }
314
315         for (i = 0; i < dir->nr; i++)
316                 if (add_file_to_cache(dir->entries[i]->name, flags)) {
317                         if (!ignore_add_errors)
318                                 die(_("adding files failed"));
319                         exit_status = 1;
320                 }
321         return exit_status;
322 }
323
324 int cmd_add(int argc, const char **argv, const char *prefix)
325 {
326         int exit_status = 0;
327         int newfd;
328         const char **pathspec;
329         struct dir_struct dir;
330         int flags;
331         int add_new_files;
332         int require_pathspec;
333         char *seen = NULL;
334
335         git_config(add_config, NULL);
336
337         argc = parse_options(argc, argv, prefix, builtin_add_options,
338                           builtin_add_usage, PARSE_OPT_KEEP_ARGV0);
339         if (patch_interactive)
340                 add_interactive = 1;
341         if (add_interactive)
342                 exit(interactive_add(argc - 1, argv + 1, prefix, patch_interactive));
343
344         if (edit_interactive)
345                 return(edit_patch(argc, argv, prefix));
346         argc--;
347         argv++;
348
349         if (addremove && take_worktree_changes)
350                 die(_("-A and -u are mutually incompatible"));
351         if (!show_only && ignore_missing)
352                 die(_("Option --ignore-missing can only be used together with --dry-run"));
353         if ((addremove || take_worktree_changes) && !argc) {
354                 static const char *here[2] = { ".", NULL };
355                 argc = 1;
356                 argv = here;
357         }
358
359         add_new_files = !take_worktree_changes && !refresh_only;
360         require_pathspec = !take_worktree_changes;
361
362         newfd = hold_locked_index(&lock_file, 1);
363
364         flags = ((verbose ? ADD_CACHE_VERBOSE : 0) |
365                  (show_only ? ADD_CACHE_PRETEND : 0) |
366                  (intent_to_add ? ADD_CACHE_INTENT : 0) |
367                  (ignore_add_errors ? ADD_CACHE_IGNORE_ERRORS : 0) |
368                  (!(addremove || take_worktree_changes)
369                   ? ADD_CACHE_IGNORE_REMOVAL : 0));
370
371         if (require_pathspec && argc == 0) {
372                 fprintf(stderr, _("Nothing specified, nothing added.\n"));
373                 fprintf(stderr, _("Maybe you wanted to say 'git add .'?\n"));
374                 return 0;
375         }
376         pathspec = validate_pathspec(argv, prefix);
377
378         if (read_cache() < 0)
379                 die(_("index file corrupt"));
380         treat_gitlinks(pathspec);
381
382         if (add_new_files) {
383                 int baselen;
384
385                 /* Set up the default git porcelain excludes */
386                 memset(&dir, 0, sizeof(dir));
387                 if (!ignored_too) {
388                         dir.flags |= DIR_COLLECT_IGNORED;
389                         setup_standard_excludes(&dir);
390                 }
391
392                 /* This picks up the paths that are not tracked */
393                 baselen = fill_directory(&dir, pathspec);
394                 if (pathspec)
395                         seen = prune_directory(&dir, pathspec, baselen);
396         }
397
398         if (refresh_only) {
399                 refresh(verbose, pathspec);
400                 goto finish;
401         }
402
403         if (pathspec) {
404                 int i;
405                 struct path_exclude_check check;
406
407                 path_exclude_check_init(&check, &dir);
408                 if (!seen)
409                         seen = find_pathspecs_matching_against_index(pathspec);
410                 for (i = 0; pathspec[i]; i++) {
411                         if (!seen[i] && pathspec[i][0]
412                             && !file_exists(pathspec[i])) {
413                                 if (ignore_missing) {
414                                         int dtype = DT_UNKNOWN;
415                                         if (is_path_excluded(&check, pathspec[i], -1, &dtype))
416                                                 dir_add_ignored(&dir, pathspec[i], strlen(pathspec[i]));
417                                 } else
418                                         die(_("pathspec '%s' did not match any files"),
419                                             pathspec[i]);
420                         }
421                 }
422                 free(seen);
423                 path_exclude_check_clear(&check);
424         }
425
426         plug_bulk_checkin();
427
428         exit_status |= add_files_to_cache(prefix, pathspec, flags);
429
430         if (add_new_files)
431                 exit_status |= add_files(&dir, flags);
432
433         unplug_bulk_checkin();
434
435  finish:
436         if (active_cache_changed) {
437                 if (write_cache(newfd, active_cache, active_nr) ||
438                     commit_locked_index(&lock_file))
439                         die(_("Unable to write new index file"));
440         }
441
442         return exit_status;
443 }