]> git.ipfire.org Git - thirdparty/git.git/blob - add-interactive.c
Documentation/RelNotes/2.45.0.txt: fix typo
[thirdparty/git.git] / add-interactive.c
1 #include "cache.h"
2 #include "add-interactive.h"
3 #include "color.h"
4 #include "config.h"
5 #include "diffcore.h"
6 #include "revision.h"
7 #include "refs.h"
8 #include "string-list.h"
9
10 struct add_i_state {
11 struct repository *r;
12 int use_color;
13 char header_color[COLOR_MAXLEN];
14 char help_color[COLOR_MAXLEN];
15 char prompt_color[COLOR_MAXLEN];
16 char error_color[COLOR_MAXLEN];
17 char reset_color[COLOR_MAXLEN];
18 };
19
20 static void init_color(struct repository *r, struct add_i_state *s,
21 const char *slot_name, char *dst,
22 const char *default_color)
23 {
24 char *key = xstrfmt("color.interactive.%s", slot_name);
25 const char *value;
26
27 if (!s->use_color)
28 dst[0] = '\0';
29 else if (repo_config_get_value(r, key, &value) ||
30 color_parse(value, dst))
31 strlcpy(dst, default_color, COLOR_MAXLEN);
32
33 free(key);
34 }
35
36 static void init_add_i_state(struct add_i_state *s, struct repository *r)
37 {
38 const char *value;
39
40 s->r = r;
41
42 if (repo_config_get_value(r, "color.interactive", &value))
43 s->use_color = -1;
44 else
45 s->use_color =
46 git_config_colorbool("color.interactive", value);
47 s->use_color = want_color(s->use_color);
48
49 init_color(r, s, "header", s->header_color, GIT_COLOR_BOLD);
50 init_color(r, s, "help", s->help_color, GIT_COLOR_BOLD_RED);
51 init_color(r, s, "prompt", s->prompt_color, GIT_COLOR_BOLD_BLUE);
52 init_color(r, s, "error", s->error_color, GIT_COLOR_BOLD_RED);
53 init_color(r, s, "reset", s->reset_color, GIT_COLOR_RESET);
54 }
55
56 /*
57 * A "prefix item list" is a list of items that are identified by a string, and
58 * a unique prefix (if any) is determined for each item.
59 *
60 * It is implemented in the form of a pair of `string_list`s, the first one
61 * duplicating the strings, with the `util` field pointing at a structure whose
62 * first field must be `size_t prefix_length`.
63 *
64 * That `prefix_length` field will be computed by `find_unique_prefixes()`; It
65 * will be set to zero if no valid, unique prefix could be found.
66 *
67 * The second `string_list` is called `sorted` and does _not_ duplicate the
68 * strings but simply reuses the first one's, with the `util` field pointing at
69 * the `string_item_list` of the first `string_list`. It will be populated and
70 * sorted by `find_unique_prefixes()`.
71 */
72 struct prefix_item_list {
73 struct string_list items;
74 struct string_list sorted;
75 size_t min_length, max_length;
76 };
77 #define PREFIX_ITEM_LIST_INIT \
78 { STRING_LIST_INIT_DUP, STRING_LIST_INIT_NODUP, 1, 4 }
79
80 static void prefix_item_list_clear(struct prefix_item_list *list)
81 {
82 string_list_clear(&list->items, 1);
83 string_list_clear(&list->sorted, 0);
84 }
85
86 static void extend_prefix_length(struct string_list_item *p,
87 const char *other_string, size_t max_length)
88 {
89 size_t *len = p->util;
90
91 if (!*len || memcmp(p->string, other_string, *len))
92 return;
93
94 for (;;) {
95 char c = p->string[*len];
96
97 /*
98 * Is `p` a strict prefix of `other`? Or have we exhausted the
99 * maximal length of the prefix? Or is the current character a
100 * multi-byte UTF-8 one? If so, there is no valid, unique
101 * prefix.
102 */
103 if (!c || ++*len > max_length || !isascii(c)) {
104 *len = 0;
105 break;
106 }
107
108 if (c != other_string[*len - 1])
109 break;
110 }
111 }
112
113 static void find_unique_prefixes(struct prefix_item_list *list)
114 {
115 size_t i;
116
117 if (list->sorted.nr == list->items.nr)
118 return;
119
120 string_list_clear(&list->sorted, 0);
121 /* Avoid reallocating incrementally */
122 list->sorted.items = xmalloc(st_mult(sizeof(*list->sorted.items),
123 list->items.nr));
124 list->sorted.nr = list->sorted.alloc = list->items.nr;
125
126 for (i = 0; i < list->items.nr; i++) {
127 list->sorted.items[i].string = list->items.items[i].string;
128 list->sorted.items[i].util = list->items.items + i;
129 }
130
131 string_list_sort(&list->sorted);
132
133 for (i = 0; i < list->sorted.nr; i++) {
134 struct string_list_item *sorted_item = list->sorted.items + i;
135 struct string_list_item *item = sorted_item->util;
136 size_t *len = item->util;
137
138 *len = 0;
139 while (*len < list->min_length) {
140 char c = item->string[(*len)++];
141
142 if (!c || !isascii(c)) {
143 *len = 0;
144 break;
145 }
146 }
147
148 if (i > 0)
149 extend_prefix_length(item, sorted_item[-1].string,
150 list->max_length);
151 if (i + 1 < list->sorted.nr)
152 extend_prefix_length(item, sorted_item[1].string,
153 list->max_length);
154 }
155 }
156
157 static ssize_t find_unique(const char *string, struct prefix_item_list *list)
158 {
159 int index = string_list_find_insert_index(&list->sorted, string, 1);
160 struct string_list_item *item;
161
162 if (list->items.nr != list->sorted.nr)
163 BUG("prefix_item_list in inconsistent state (%"PRIuMAX
164 " vs %"PRIuMAX")",
165 (uintmax_t)list->items.nr, (uintmax_t)list->sorted.nr);
166
167 if (index < 0)
168 item = list->sorted.items[-1 - index].util;
169 else if (index > 0 &&
170 starts_with(list->sorted.items[index - 1].string, string))
171 return -1;
172 else if (index + 1 < list->sorted.nr &&
173 starts_with(list->sorted.items[index + 1].string, string))
174 return -1;
175 else if (index < list->sorted.nr)
176 item = list->sorted.items[index].util;
177 else
178 return -1;
179 return item - list->items.items;
180 }
181
182 struct list_options {
183 int columns;
184 const char *header;
185 void (*print_item)(int i, struct string_list_item *item, void *print_item_data);
186 void *print_item_data;
187 };
188
189 static void list(struct add_i_state *s, struct string_list *list,
190 struct list_options *opts)
191 {
192 int i, last_lf = 0;
193
194 if (!list->nr)
195 return;
196
197 if (opts->header)
198 color_fprintf_ln(stdout, s->header_color,
199 "%s", opts->header);
200
201 for (i = 0; i < list->nr; i++) {
202 opts->print_item(i, list->items + i, opts->print_item_data);
203
204 if ((opts->columns) && ((i + 1) % (opts->columns))) {
205 putchar('\t');
206 last_lf = 0;
207 }
208 else {
209 putchar('\n');
210 last_lf = 1;
211 }
212 }
213
214 if (!last_lf)
215 putchar('\n');
216 }
217 struct list_and_choose_options {
218 struct list_options list_opts;
219
220 const char *prompt;
221 void (*print_help)(struct add_i_state *s);
222 };
223
224 #define LIST_AND_CHOOSE_ERROR (-1)
225 #define LIST_AND_CHOOSE_QUIT (-2)
226
227 /*
228 * Returns the selected index.
229 *
230 * If an error occurred, returns `LIST_AND_CHOOSE_ERROR`. Upon EOF,
231 * `LIST_AND_CHOOSE_QUIT` is returned.
232 */
233 static ssize_t list_and_choose(struct add_i_state *s,
234 struct prefix_item_list *items,
235 struct list_and_choose_options *opts)
236 {
237 struct strbuf input = STRBUF_INIT;
238 ssize_t res = LIST_AND_CHOOSE_ERROR;
239
240 find_unique_prefixes(items);
241
242 for (;;) {
243 char *p;
244
245 strbuf_reset(&input);
246
247 list(s, &items->items, &opts->list_opts);
248
249 color_fprintf(stdout, s->prompt_color, "%s", opts->prompt);
250 fputs("> ", stdout);
251 fflush(stdout);
252
253 if (strbuf_getline(&input, stdin) == EOF) {
254 putchar('\n');
255 res = LIST_AND_CHOOSE_QUIT;
256 break;
257 }
258 strbuf_trim(&input);
259
260 if (!input.len)
261 break;
262
263 if (!strcmp(input.buf, "?")) {
264 opts->print_help(s);
265 continue;
266 }
267
268 p = input.buf;
269 for (;;) {
270 size_t sep = strcspn(p, " \t\r\n,");
271 ssize_t index = -1;
272
273 if (!sep) {
274 if (!*p)
275 break;
276 p++;
277 continue;
278 }
279
280 if (isdigit(*p)) {
281 char *endp;
282 index = strtoul(p, &endp, 10) - 1;
283 if (endp != p + sep)
284 index = -1;
285 }
286
287 if (p[sep])
288 p[sep++] = '\0';
289 if (index < 0)
290 index = find_unique(p, items);
291
292 if (index < 0 || index >= items->items.nr)
293 color_fprintf_ln(stdout, s->error_color,
294 _("Huh (%s)?"), p);
295 else {
296 res = index;
297 break;
298 }
299
300 p += sep;
301 }
302
303 if (res != LIST_AND_CHOOSE_ERROR)
304 break;
305 }
306
307 strbuf_release(&input);
308 return res;
309 }
310
311 struct adddel {
312 uintmax_t add, del;
313 unsigned seen:1, binary:1;
314 };
315
316 struct file_item {
317 struct adddel index, worktree;
318 };
319
320 static void add_file_item(struct string_list *files, const char *name)
321 {
322 struct file_item *item = xcalloc(sizeof(*item), 1);
323
324 string_list_append(files, name)->util = item;
325 }
326
327 struct pathname_entry {
328 struct hashmap_entry ent;
329 const char *name;
330 struct file_item *item;
331 };
332
333 static int pathname_entry_cmp(const void *unused_cmp_data,
334 const struct hashmap_entry *he1,
335 const struct hashmap_entry *he2,
336 const void *name)
337 {
338 const struct pathname_entry *e1 =
339 container_of(he1, const struct pathname_entry, ent);
340 const struct pathname_entry *e2 =
341 container_of(he2, const struct pathname_entry, ent);
342
343 return strcmp(e1->name, name ? (const char *)name : e2->name);
344 }
345
346 struct collection_status {
347 enum { FROM_WORKTREE = 0, FROM_INDEX = 1 } phase;
348
349 const char *reference;
350
351 struct string_list *files;
352 struct hashmap file_map;
353 };
354
355 static void collect_changes_cb(struct diff_queue_struct *q,
356 struct diff_options *options,
357 void *data)
358 {
359 struct collection_status *s = data;
360 struct diffstat_t stat = { 0 };
361 int i;
362
363 if (!q->nr)
364 return;
365
366 compute_diffstat(options, &stat, q);
367
368 for (i = 0; i < stat.nr; i++) {
369 const char *name = stat.files[i]->name;
370 int hash = strhash(name);
371 struct pathname_entry *entry;
372 struct file_item *file_item;
373 struct adddel *adddel;
374
375 entry = hashmap_get_entry_from_hash(&s->file_map, hash, name,
376 struct pathname_entry, ent);
377 if (!entry) {
378 add_file_item(s->files, name);
379
380 entry = xcalloc(sizeof(*entry), 1);
381 hashmap_entry_init(&entry->ent, hash);
382 entry->name = s->files->items[s->files->nr - 1].string;
383 entry->item = s->files->items[s->files->nr - 1].util;
384 hashmap_add(&s->file_map, &entry->ent);
385 }
386
387 file_item = entry->item;
388 adddel = s->phase == FROM_INDEX ?
389 &file_item->index : &file_item->worktree;
390 adddel->seen = 1;
391 adddel->add = stat.files[i]->added;
392 adddel->del = stat.files[i]->deleted;
393 if (stat.files[i]->is_binary)
394 adddel->binary = 1;
395 }
396 free_diffstat_info(&stat);
397 }
398
399 static int get_modified_files(struct repository *r, struct string_list *files,
400 const struct pathspec *ps)
401 {
402 struct object_id head_oid;
403 int is_initial = !resolve_ref_unsafe("HEAD", RESOLVE_REF_READING,
404 &head_oid, NULL);
405 struct collection_status s = { FROM_WORKTREE };
406
407 if (discard_index(r->index) < 0 ||
408 repo_read_index_preload(r, ps, 0) < 0)
409 return error(_("could not read index"));
410
411 string_list_clear(files, 1);
412 s.files = files;
413 hashmap_init(&s.file_map, pathname_entry_cmp, NULL, 0);
414
415 for (s.phase = FROM_WORKTREE; s.phase <= FROM_INDEX; s.phase++) {
416 struct rev_info rev;
417 struct setup_revision_opt opt = { 0 };
418
419 opt.def = is_initial ?
420 empty_tree_oid_hex() : oid_to_hex(&head_oid);
421
422 init_revisions(&rev, NULL);
423 setup_revisions(0, NULL, &rev, &opt);
424
425 rev.diffopt.output_format = DIFF_FORMAT_CALLBACK;
426 rev.diffopt.format_callback = collect_changes_cb;
427 rev.diffopt.format_callback_data = &s;
428
429 if (ps)
430 copy_pathspec(&rev.prune_data, ps);
431
432 if (s.phase == FROM_INDEX)
433 run_diff_index(&rev, 1);
434 else {
435 rev.diffopt.flags.ignore_dirty_submodules = 1;
436 run_diff_files(&rev, 0);
437 }
438 }
439 hashmap_free_entries(&s.file_map, struct pathname_entry, ent);
440
441 /* While the diffs are ordered already, we ran *two* diffs... */
442 string_list_sort(files);
443
444 return 0;
445 }
446
447 static void render_adddel(struct strbuf *buf,
448 struct adddel *ad, const char *no_changes)
449 {
450 if (ad->binary)
451 strbuf_addstr(buf, _("binary"));
452 else if (ad->seen)
453 strbuf_addf(buf, "+%"PRIuMAX"/-%"PRIuMAX,
454 (uintmax_t)ad->add, (uintmax_t)ad->del);
455 else
456 strbuf_addstr(buf, no_changes);
457 }
458
459 /* filters out prefixes which have special meaning to list_and_choose() */
460 static int is_valid_prefix(const char *prefix, size_t prefix_len)
461 {
462 return prefix_len && prefix &&
463 /*
464 * We expect `prefix` to be NUL terminated, therefore this
465 * `strcspn()` call is okay, even if it might do much more
466 * work than strictly necessary.
467 */
468 strcspn(prefix, " \t\r\n,") >= prefix_len && /* separators */
469 *prefix != '-' && /* deselection */
470 !isdigit(*prefix) && /* selection */
471 (prefix_len != 1 ||
472 (*prefix != '*' && /* "all" wildcard */
473 *prefix != '?')); /* prompt help */
474 }
475
476 struct print_file_item_data {
477 const char *modified_fmt;
478 struct strbuf buf, index, worktree;
479 };
480
481 static void print_file_item(int i, struct string_list_item *item,
482 void *print_file_item_data)
483 {
484 struct file_item *c = item->util;
485 struct print_file_item_data *d = print_file_item_data;
486
487 strbuf_reset(&d->index);
488 strbuf_reset(&d->worktree);
489 strbuf_reset(&d->buf);
490
491 render_adddel(&d->worktree, &c->worktree, _("nothing"));
492 render_adddel(&d->index, &c->index, _("unchanged"));
493 strbuf_addf(&d->buf, d->modified_fmt,
494 d->index.buf, d->worktree.buf, item->string);
495
496 printf(" %2d: %s", i + 1, d->buf.buf);
497 }
498
499 static int run_status(struct add_i_state *s, const struct pathspec *ps,
500 struct string_list *files, struct list_options *opts)
501 {
502 if (get_modified_files(s->r, files, ps) < 0)
503 return -1;
504
505 list(s, files, opts);
506 putchar('\n');
507
508 return 0;
509 }
510
511 static int run_help(struct add_i_state *s, const struct pathspec *unused_ps,
512 struct string_list *unused_files,
513 struct list_options *unused_opts)
514 {
515 color_fprintf_ln(stdout, s->help_color, "status - %s",
516 _("show paths with changes"));
517 color_fprintf_ln(stdout, s->help_color, "update - %s",
518 _("add working tree state to the staged set of changes"));
519 color_fprintf_ln(stdout, s->help_color, "revert - %s",
520 _("revert staged set of changes back to the HEAD version"));
521 color_fprintf_ln(stdout, s->help_color, "patch - %s",
522 _("pick hunks and update selectively"));
523 color_fprintf_ln(stdout, s->help_color, "diff - %s",
524 _("view diff between HEAD and index"));
525 color_fprintf_ln(stdout, s->help_color, "add untracked - %s",
526 _("add contents of untracked files to the staged set of changes"));
527
528 return 0;
529 }
530
531 typedef int (*command_t)(struct add_i_state *s, const struct pathspec *ps,
532 struct string_list *files,
533 struct list_options *opts);
534
535 struct command_item {
536 size_t prefix_length;
537 command_t command;
538 };
539
540 struct print_command_item_data {
541 const char *color, *reset;
542 };
543
544 static void print_command_item(int i, struct string_list_item *item,
545 void *print_command_item_data)
546 {
547 struct print_command_item_data *d = print_command_item_data;
548 struct command_item *util = item->util;
549
550 if (!util->prefix_length ||
551 !is_valid_prefix(item->string, util->prefix_length))
552 printf(" %2d: %s", i + 1, item->string);
553 else
554 printf(" %2d: %s%.*s%s%s", i + 1,
555 d->color, (int)util->prefix_length, item->string,
556 d->reset, item->string + util->prefix_length);
557 }
558
559 static void command_prompt_help(struct add_i_state *s)
560 {
561 const char *help_color = s->help_color;
562 color_fprintf_ln(stdout, help_color, "%s", _("Prompt help:"));
563 color_fprintf_ln(stdout, help_color, "1 - %s",
564 _("select a numbered item"));
565 color_fprintf_ln(stdout, help_color, "foo - %s",
566 _("select item based on unique prefix"));
567 color_fprintf_ln(stdout, help_color, " - %s",
568 _("(empty) select nothing"));
569 }
570
571 int run_add_i(struct repository *r, const struct pathspec *ps)
572 {
573 struct add_i_state s = { NULL };
574 struct print_command_item_data data = { "[", "]" };
575 struct list_and_choose_options main_loop_opts = {
576 { 4, N_("*** Commands ***"), print_command_item, &data },
577 N_("What now"), command_prompt_help
578 };
579 struct {
580 const char *string;
581 command_t command;
582 } command_list[] = {
583 { "status", run_status },
584 { "help", run_help },
585 };
586 struct prefix_item_list commands = PREFIX_ITEM_LIST_INIT;
587
588 struct print_file_item_data print_file_item_data = {
589 "%12s %12s %s", STRBUF_INIT, STRBUF_INIT, STRBUF_INIT
590 };
591 struct list_options opts = {
592 0, NULL, print_file_item, &print_file_item_data
593 };
594 struct strbuf header = STRBUF_INIT;
595 struct string_list files = STRING_LIST_INIT_DUP;
596 ssize_t i;
597 int res = 0;
598
599 for (i = 0; i < ARRAY_SIZE(command_list); i++) {
600 struct command_item *util = xcalloc(sizeof(*util), 1);
601 util->command = command_list[i].command;
602 string_list_append(&commands.items, command_list[i].string)
603 ->util = util;
604 }
605
606 init_add_i_state(&s, r);
607
608 /*
609 * When color was asked for, use the prompt color for
610 * highlighting, otherwise use square brackets.
611 */
612 if (s.use_color) {
613 data.color = s.prompt_color;
614 data.reset = s.reset_color;
615 }
616
617 strbuf_addstr(&header, " ");
618 strbuf_addf(&header, print_file_item_data.modified_fmt,
619 _("staged"), _("unstaged"), _("path"));
620 opts.header = header.buf;
621
622 if (discard_index(r->index) < 0 ||
623 repo_read_index(r) < 0 ||
624 repo_refresh_and_write_index(r, REFRESH_QUIET, 0, 1,
625 NULL, NULL, NULL) < 0)
626 warning(_("could not refresh index"));
627
628 res = run_status(&s, ps, &files, &opts);
629
630 for (;;) {
631 i = list_and_choose(&s, &commands, &main_loop_opts);
632 if (i == LIST_AND_CHOOSE_QUIT) {
633 printf(_("Bye.\n"));
634 res = 0;
635 break;
636 }
637 if (i != LIST_AND_CHOOSE_ERROR) {
638 struct command_item *util =
639 commands.items.items[i].util;
640 res = util->command(&s, ps, &files, &opts);
641 }
642 }
643
644 string_list_clear(&files, 1);
645 strbuf_release(&print_file_item_data.buf);
646 strbuf_release(&print_file_item_data.index);
647 strbuf_release(&print_file_item_data.worktree);
648 strbuf_release(&header);
649 prefix_item_list_clear(&commands);
650
651 return res;
652 }