standardize usage info string format
[git/debian.git] / builtin / config.c
blobd32c5327e53e14a7af72e4ec91efc1b42a414659
1 #include "builtin.h"
2 #include "cache.h"
3 #include "color.h"
4 #include "parse-options.h"
5 #include "urlmatch.h"
7 static const char *const builtin_config_usage[] = {
8 N_("git config [<options>]"),
9 NULL
12 static char *key;
13 static regex_t *key_regexp;
14 static regex_t *regexp;
15 static int show_keys;
16 static int use_key_regexp;
17 static int do_all;
18 static int do_not_match;
19 static char delim = '=';
20 static char key_delim = ' ';
21 static char term = '\n';
23 static int use_global_config, use_system_config, use_local_config;
24 static struct git_config_source given_config_source;
25 static int actions, types;
26 static const char *get_color_slot, *get_colorbool_slot;
27 static int end_null;
28 static int respect_includes = -1;
30 #define ACTION_GET (1<<0)
31 #define ACTION_GET_ALL (1<<1)
32 #define ACTION_GET_REGEXP (1<<2)
33 #define ACTION_REPLACE_ALL (1<<3)
34 #define ACTION_ADD (1<<4)
35 #define ACTION_UNSET (1<<5)
36 #define ACTION_UNSET_ALL (1<<6)
37 #define ACTION_RENAME_SECTION (1<<7)
38 #define ACTION_REMOVE_SECTION (1<<8)
39 #define ACTION_LIST (1<<9)
40 #define ACTION_EDIT (1<<10)
41 #define ACTION_SET (1<<11)
42 #define ACTION_SET_ALL (1<<12)
43 #define ACTION_GET_COLOR (1<<13)
44 #define ACTION_GET_COLORBOOL (1<<14)
45 #define ACTION_GET_URLMATCH (1<<15)
47 #define TYPE_BOOL (1<<0)
48 #define TYPE_INT (1<<1)
49 #define TYPE_BOOL_OR_INT (1<<2)
50 #define TYPE_PATH (1<<3)
52 static struct option builtin_config_options[] = {
53 OPT_GROUP(N_("Config file location")),
54 OPT_BOOL(0, "global", &use_global_config, N_("use global config file")),
55 OPT_BOOL(0, "system", &use_system_config, N_("use system config file")),
56 OPT_BOOL(0, "local", &use_local_config, N_("use repository config file")),
57 OPT_STRING('f', "file", &given_config_source.file, N_("file"), N_("use given config file")),
58 OPT_STRING(0, "blob", &given_config_source.blob, N_("blob-id"), N_("read config from given blob object")),
59 OPT_GROUP(N_("Action")),
60 OPT_BIT(0, "get", &actions, N_("get value: name [value-regex]"), ACTION_GET),
61 OPT_BIT(0, "get-all", &actions, N_("get all values: key [value-regex]"), ACTION_GET_ALL),
62 OPT_BIT(0, "get-regexp", &actions, N_("get values for regexp: name-regex [value-regex]"), ACTION_GET_REGEXP),
63 OPT_BIT(0, "get-urlmatch", &actions, N_("get value specific for the URL: section[.var] URL"), ACTION_GET_URLMATCH),
64 OPT_BIT(0, "replace-all", &actions, N_("replace all matching variables: name value [value_regex]"), ACTION_REPLACE_ALL),
65 OPT_BIT(0, "add", &actions, N_("add a new variable: name value"), ACTION_ADD),
66 OPT_BIT(0, "unset", &actions, N_("remove a variable: name [value-regex]"), ACTION_UNSET),
67 OPT_BIT(0, "unset-all", &actions, N_("remove all matches: name [value-regex]"), ACTION_UNSET_ALL),
68 OPT_BIT(0, "rename-section", &actions, N_("rename section: old-name new-name"), ACTION_RENAME_SECTION),
69 OPT_BIT(0, "remove-section", &actions, N_("remove a section: name"), ACTION_REMOVE_SECTION),
70 OPT_BIT('l', "list", &actions, N_("list all"), ACTION_LIST),
71 OPT_BIT('e', "edit", &actions, N_("open an editor"), ACTION_EDIT),
72 OPT_BIT(0, "get-color", &actions, N_("find the color configured: slot [default]"), ACTION_GET_COLOR),
73 OPT_BIT(0, "get-colorbool", &actions, N_("find the color setting: slot [stdout-is-tty]"), ACTION_GET_COLORBOOL),
74 OPT_GROUP(N_("Type")),
75 OPT_BIT(0, "bool", &types, N_("value is \"true\" or \"false\""), TYPE_BOOL),
76 OPT_BIT(0, "int", &types, N_("value is decimal number"), TYPE_INT),
77 OPT_BIT(0, "bool-or-int", &types, N_("value is --bool or --int"), TYPE_BOOL_OR_INT),
78 OPT_BIT(0, "path", &types, N_("value is a path (file or directory name)"), TYPE_PATH),
79 OPT_GROUP(N_("Other")),
80 OPT_BOOL('z', "null", &end_null, N_("terminate values with NUL byte")),
81 OPT_BOOL(0, "includes", &respect_includes, N_("respect include directives on lookup")),
82 OPT_END(),
85 static void check_argc(int argc, int min, int max) {
86 if (argc >= min && argc <= max)
87 return;
88 error("wrong number of arguments");
89 usage_with_options(builtin_config_usage, builtin_config_options);
92 static int show_all_config(const char *key_, const char *value_, void *cb)
94 if (value_)
95 printf("%s%c%s%c", key_, delim, value_, term);
96 else
97 printf("%s%c", key_, term);
98 return 0;
101 struct strbuf_list {
102 struct strbuf *items;
103 int nr;
104 int alloc;
107 static int format_config(struct strbuf *buf, const char *key_, const char *value_)
109 int must_free_vptr = 0;
110 int must_print_delim = 0;
111 char value[256];
112 const char *vptr = value;
114 strbuf_init(buf, 0);
116 if (show_keys) {
117 strbuf_addstr(buf, key_);
118 must_print_delim = 1;
120 if (types == TYPE_INT)
121 sprintf(value, "%"PRId64,
122 git_config_int64(key_, value_ ? value_ : ""));
123 else if (types == TYPE_BOOL)
124 vptr = git_config_bool(key_, value_) ? "true" : "false";
125 else if (types == TYPE_BOOL_OR_INT) {
126 int is_bool, v;
127 v = git_config_bool_or_int(key_, value_, &is_bool);
128 if (is_bool)
129 vptr = v ? "true" : "false";
130 else
131 sprintf(value, "%d", v);
132 } else if (types == TYPE_PATH) {
133 if (git_config_pathname(&vptr, key_, value_) < 0)
134 return -1;
135 must_free_vptr = 1;
136 } else if (value_) {
137 vptr = value_;
138 } else {
139 /* Just show the key name */
140 vptr = "";
141 must_print_delim = 0;
144 if (must_print_delim)
145 strbuf_addch(buf, key_delim);
146 strbuf_addstr(buf, vptr);
147 strbuf_addch(buf, term);
149 if (must_free_vptr)
150 free((char *)vptr);
151 return 0;
154 static int collect_config(const char *key_, const char *value_, void *cb)
156 struct strbuf_list *values = cb;
158 if (!use_key_regexp && strcmp(key_, key))
159 return 0;
160 if (use_key_regexp && regexec(key_regexp, key_, 0, NULL, 0))
161 return 0;
162 if (regexp != NULL &&
163 (do_not_match ^ !!regexec(regexp, (value_?value_:""), 0, NULL, 0)))
164 return 0;
166 ALLOC_GROW(values->items, values->nr + 1, values->alloc);
168 return format_config(&values->items[values->nr++], key_, value_);
171 static int get_value(const char *key_, const char *regex_)
173 int ret = CONFIG_GENERIC_ERROR;
174 struct strbuf_list values = {NULL};
175 int i;
177 if (use_key_regexp) {
178 char *tl;
181 * NEEDSWORK: this naive pattern lowercasing obviously does not
182 * work for more complex patterns like "^[^.]*Foo.*bar".
183 * Perhaps we should deprecate this altogether someday.
186 key = xstrdup(key_);
187 for (tl = key + strlen(key) - 1;
188 tl >= key && *tl != '.';
189 tl--)
190 *tl = tolower(*tl);
191 for (tl = key; *tl && *tl != '.'; tl++)
192 *tl = tolower(*tl);
194 key_regexp = (regex_t*)xmalloc(sizeof(regex_t));
195 if (regcomp(key_regexp, key, REG_EXTENDED)) {
196 fprintf(stderr, "Invalid key pattern: %s\n", key_);
197 free(key_regexp);
198 key_regexp = NULL;
199 ret = CONFIG_INVALID_PATTERN;
200 goto free_strings;
202 } else {
203 if (git_config_parse_key(key_, &key, NULL)) {
204 ret = CONFIG_INVALID_KEY;
205 goto free_strings;
209 if (regex_) {
210 if (regex_[0] == '!') {
211 do_not_match = 1;
212 regex_++;
215 regexp = (regex_t*)xmalloc(sizeof(regex_t));
216 if (regcomp(regexp, regex_, REG_EXTENDED)) {
217 fprintf(stderr, "Invalid pattern: %s\n", regex_);
218 free(regexp);
219 regexp = NULL;
220 ret = CONFIG_INVALID_PATTERN;
221 goto free_strings;
225 git_config_with_options(collect_config, &values,
226 &given_config_source, respect_includes);
228 ret = !values.nr;
230 for (i = 0; i < values.nr; i++) {
231 struct strbuf *buf = values.items + i;
232 if (do_all || i == values.nr - 1)
233 fwrite(buf->buf, 1, buf->len, stdout);
234 strbuf_release(buf);
236 free(values.items);
238 free_strings:
239 free(key);
240 if (key_regexp) {
241 regfree(key_regexp);
242 free(key_regexp);
244 if (regexp) {
245 regfree(regexp);
246 free(regexp);
249 return ret;
252 static char *normalize_value(const char *key, const char *value)
254 char *normalized;
256 if (!value)
257 return NULL;
259 if (types == 0 || types == TYPE_PATH)
261 * We don't do normalization for TYPE_PATH here: If
262 * the path is like ~/foobar/, we prefer to store
263 * "~/foobar/" in the config file, and to expand the ~
264 * when retrieving the value.
266 normalized = xstrdup(value);
267 else {
268 normalized = xmalloc(64);
269 if (types == TYPE_INT) {
270 int64_t v = git_config_int64(key, value);
271 sprintf(normalized, "%"PRId64, v);
273 else if (types == TYPE_BOOL)
274 sprintf(normalized, "%s",
275 git_config_bool(key, value) ? "true" : "false");
276 else if (types == TYPE_BOOL_OR_INT) {
277 int is_bool, v;
278 v = git_config_bool_or_int(key, value, &is_bool);
279 if (!is_bool)
280 sprintf(normalized, "%d", v);
281 else
282 sprintf(normalized, "%s", v ? "true" : "false");
286 return normalized;
289 static int get_color_found;
290 static const char *get_color_slot;
291 static const char *get_colorbool_slot;
292 static char parsed_color[COLOR_MAXLEN];
294 static int git_get_color_config(const char *var, const char *value, void *cb)
296 if (!strcmp(var, get_color_slot)) {
297 if (!value)
298 config_error_nonbool(var);
299 if (color_parse(value, parsed_color) < 0)
300 return -1;
301 get_color_found = 1;
303 return 0;
306 static void get_color(const char *var, const char *def_color)
308 get_color_slot = var;
309 get_color_found = 0;
310 parsed_color[0] = '\0';
311 git_config_with_options(git_get_color_config, NULL,
312 &given_config_source, respect_includes);
314 if (!get_color_found && def_color) {
315 if (color_parse(def_color, parsed_color) < 0)
316 die(_("unable to parse default color value"));
319 fputs(parsed_color, stdout);
322 static int get_colorbool_found;
323 static int get_diff_color_found;
324 static int get_color_ui_found;
325 static int git_get_colorbool_config(const char *var, const char *value,
326 void *cb)
328 if (!strcmp(var, get_colorbool_slot))
329 get_colorbool_found = git_config_colorbool(var, value);
330 else if (!strcmp(var, "diff.color"))
331 get_diff_color_found = git_config_colorbool(var, value);
332 else if (!strcmp(var, "color.ui"))
333 get_color_ui_found = git_config_colorbool(var, value);
334 return 0;
337 static int get_colorbool(const char *var, int print)
339 get_colorbool_slot = var;
340 get_colorbool_found = -1;
341 get_diff_color_found = -1;
342 get_color_ui_found = -1;
343 git_config_with_options(git_get_colorbool_config, NULL,
344 &given_config_source, respect_includes);
346 if (get_colorbool_found < 0) {
347 if (!strcmp(get_colorbool_slot, "color.diff"))
348 get_colorbool_found = get_diff_color_found;
349 if (get_colorbool_found < 0)
350 get_colorbool_found = get_color_ui_found;
353 if (get_colorbool_found < 0)
354 /* default value if none found in config */
355 get_colorbool_found = GIT_COLOR_AUTO;
357 get_colorbool_found = want_color(get_colorbool_found);
359 if (print) {
360 printf("%s\n", get_colorbool_found ? "true" : "false");
361 return 0;
362 } else
363 return get_colorbool_found ? 0 : 1;
366 static void check_write(void)
368 if (given_config_source.use_stdin)
369 die("writing to stdin is not supported");
371 if (given_config_source.blob)
372 die("writing config blobs is not supported");
375 struct urlmatch_current_candidate_value {
376 char value_is_null;
377 struct strbuf value;
380 static int urlmatch_collect_fn(const char *var, const char *value, void *cb)
382 struct string_list *values = cb;
383 struct string_list_item *item = string_list_insert(values, var);
384 struct urlmatch_current_candidate_value *matched = item->util;
386 if (!matched) {
387 matched = xmalloc(sizeof(*matched));
388 strbuf_init(&matched->value, 0);
389 item->util = matched;
390 } else {
391 strbuf_reset(&matched->value);
394 if (value) {
395 strbuf_addstr(&matched->value, value);
396 matched->value_is_null = 0;
397 } else {
398 matched->value_is_null = 1;
400 return 0;
403 static int get_urlmatch(const char *var, const char *url)
405 char *section_tail;
406 struct string_list_item *item;
407 struct urlmatch_config config = { STRING_LIST_INIT_DUP };
408 struct string_list values = STRING_LIST_INIT_DUP;
410 config.collect_fn = urlmatch_collect_fn;
411 config.cascade_fn = NULL;
412 config.cb = &values;
414 if (!url_normalize(url, &config.url))
415 die("%s", config.url.err);
417 config.section = xstrdup_tolower(var);
418 section_tail = strchr(config.section, '.');
419 if (section_tail) {
420 *section_tail = '\0';
421 config.key = section_tail + 1;
422 show_keys = 0;
423 } else {
424 config.key = NULL;
425 show_keys = 1;
428 git_config_with_options(urlmatch_config_entry, &config,
429 &given_config_source, respect_includes);
431 for_each_string_list_item(item, &values) {
432 struct urlmatch_current_candidate_value *matched = item->util;
433 struct strbuf key = STRBUF_INIT;
434 struct strbuf buf = STRBUF_INIT;
436 strbuf_addstr(&key, item->string);
437 format_config(&buf, key.buf,
438 matched->value_is_null ? NULL : matched->value.buf);
439 fwrite(buf.buf, 1, buf.len, stdout);
440 strbuf_release(&key);
441 strbuf_release(&buf);
443 strbuf_release(&matched->value);
445 string_list_clear(&config.vars, 1);
446 string_list_clear(&values, 1);
447 free(config.url.url);
449 free((void *)config.section);
450 return 0;
453 static char *default_user_config(void)
455 struct strbuf buf = STRBUF_INIT;
456 strbuf_addf(&buf,
457 _("# This is Git's per-user configuration file.\n"
458 "[core]\n"
459 "# Please adapt and uncomment the following lines:\n"
460 "# user = %s\n"
461 "# email = %s\n"),
462 ident_default_name(),
463 ident_default_email());
464 return strbuf_detach(&buf, NULL);
467 int cmd_config(int argc, const char **argv, const char *prefix)
469 int nongit = !startup_info->have_repository;
470 char *value;
472 given_config_source.file = getenv(CONFIG_ENVIRONMENT);
474 argc = parse_options(argc, argv, prefix, builtin_config_options,
475 builtin_config_usage,
476 PARSE_OPT_STOP_AT_NON_OPTION);
478 if (use_global_config + use_system_config + use_local_config +
479 !!given_config_source.file + !!given_config_source.blob > 1) {
480 error("only one config file at a time.");
481 usage_with_options(builtin_config_usage, builtin_config_options);
484 if (given_config_source.file &&
485 !strcmp(given_config_source.file, "-")) {
486 given_config_source.file = NULL;
487 given_config_source.use_stdin = 1;
490 if (use_global_config) {
491 char *user_config = NULL;
492 char *xdg_config = NULL;
494 home_config_paths(&user_config, &xdg_config, "config");
496 if (!user_config)
498 * It is unknown if HOME/.gitconfig exists, so
499 * we do not know if we should write to XDG
500 * location; error out even if XDG_CONFIG_HOME
501 * is set and points at a sane location.
503 die("$HOME not set");
505 if (access_or_warn(user_config, R_OK, 0) &&
506 xdg_config && !access_or_warn(xdg_config, R_OK, 0))
507 given_config_source.file = xdg_config;
508 else
509 given_config_source.file = user_config;
511 else if (use_system_config)
512 given_config_source.file = git_etc_gitconfig();
513 else if (use_local_config)
514 given_config_source.file = git_pathdup("config");
515 else if (given_config_source.file) {
516 if (!is_absolute_path(given_config_source.file) && prefix)
517 given_config_source.file =
518 xstrdup(prefix_filename(prefix,
519 strlen(prefix),
520 given_config_source.file));
523 if (respect_includes == -1)
524 respect_includes = !given_config_source.file;
526 if (end_null) {
527 term = '\0';
528 delim = '\n';
529 key_delim = '\n';
532 if (HAS_MULTI_BITS(types)) {
533 error("only one type at a time.");
534 usage_with_options(builtin_config_usage, builtin_config_options);
537 if ((actions & (ACTION_GET_COLOR|ACTION_GET_COLORBOOL)) && types) {
538 error("--get-color and variable type are incoherent");
539 usage_with_options(builtin_config_usage, builtin_config_options);
542 if (HAS_MULTI_BITS(actions)) {
543 error("only one action at a time.");
544 usage_with_options(builtin_config_usage, builtin_config_options);
546 if (actions == 0)
547 switch (argc) {
548 case 1: actions = ACTION_GET; break;
549 case 2: actions = ACTION_SET; break;
550 case 3: actions = ACTION_SET_ALL; break;
551 default:
552 usage_with_options(builtin_config_usage, builtin_config_options);
555 if (actions == ACTION_LIST) {
556 check_argc(argc, 0, 0);
557 if (git_config_with_options(show_all_config, NULL,
558 &given_config_source,
559 respect_includes) < 0) {
560 if (given_config_source.file)
561 die_errno("unable to read config file '%s'",
562 given_config_source.file);
563 else
564 die("error processing config file(s)");
567 else if (actions == ACTION_EDIT) {
568 char *config_file;
570 check_argc(argc, 0, 0);
571 if (!given_config_source.file && nongit)
572 die("not in a git directory");
573 if (given_config_source.use_stdin)
574 die("editing stdin is not supported");
575 if (given_config_source.blob)
576 die("editing blobs is not supported");
577 git_config(git_default_config, NULL);
578 config_file = xstrdup(given_config_source.file ?
579 given_config_source.file : git_path("config"));
580 if (use_global_config) {
581 int fd = open(config_file, O_CREAT | O_EXCL | O_WRONLY, 0666);
582 if (fd) {
583 char *content = default_user_config();
584 write_str_in_full(fd, content);
585 free(content);
586 close(fd);
588 else if (errno != EEXIST)
589 die_errno(_("cannot create configuration file %s"), config_file);
591 launch_editor(config_file, NULL, NULL);
592 free(config_file);
594 else if (actions == ACTION_SET) {
595 int ret;
596 check_write();
597 check_argc(argc, 2, 2);
598 value = normalize_value(argv[0], argv[1]);
599 ret = git_config_set_in_file(given_config_source.file, argv[0], value);
600 if (ret == CONFIG_NOTHING_SET)
601 error("cannot overwrite multiple values with a single value\n"
602 " Use a regexp, --add or --replace-all to change %s.", argv[0]);
603 return ret;
605 else if (actions == ACTION_SET_ALL) {
606 check_write();
607 check_argc(argc, 2, 3);
608 value = normalize_value(argv[0], argv[1]);
609 return git_config_set_multivar_in_file(given_config_source.file,
610 argv[0], value, argv[2], 0);
612 else if (actions == ACTION_ADD) {
613 check_write();
614 check_argc(argc, 2, 2);
615 value = normalize_value(argv[0], argv[1]);
616 return git_config_set_multivar_in_file(given_config_source.file,
617 argv[0], value,
618 CONFIG_REGEX_NONE, 0);
620 else if (actions == ACTION_REPLACE_ALL) {
621 check_write();
622 check_argc(argc, 2, 3);
623 value = normalize_value(argv[0], argv[1]);
624 return git_config_set_multivar_in_file(given_config_source.file,
625 argv[0], value, argv[2], 1);
627 else if (actions == ACTION_GET) {
628 check_argc(argc, 1, 2);
629 return get_value(argv[0], argv[1]);
631 else if (actions == ACTION_GET_ALL) {
632 do_all = 1;
633 check_argc(argc, 1, 2);
634 return get_value(argv[0], argv[1]);
636 else if (actions == ACTION_GET_REGEXP) {
637 show_keys = 1;
638 use_key_regexp = 1;
639 do_all = 1;
640 check_argc(argc, 1, 2);
641 return get_value(argv[0], argv[1]);
643 else if (actions == ACTION_GET_URLMATCH) {
644 check_argc(argc, 2, 2);
645 return get_urlmatch(argv[0], argv[1]);
647 else if (actions == ACTION_UNSET) {
648 check_write();
649 check_argc(argc, 1, 2);
650 if (argc == 2)
651 return git_config_set_multivar_in_file(given_config_source.file,
652 argv[0], NULL, argv[1], 0);
653 else
654 return git_config_set_in_file(given_config_source.file,
655 argv[0], NULL);
657 else if (actions == ACTION_UNSET_ALL) {
658 check_write();
659 check_argc(argc, 1, 2);
660 return git_config_set_multivar_in_file(given_config_source.file,
661 argv[0], NULL, argv[1], 1);
663 else if (actions == ACTION_RENAME_SECTION) {
664 int ret;
665 check_write();
666 check_argc(argc, 2, 2);
667 ret = git_config_rename_section_in_file(given_config_source.file,
668 argv[0], argv[1]);
669 if (ret < 0)
670 return ret;
671 if (ret == 0)
672 die("No such section!");
674 else if (actions == ACTION_REMOVE_SECTION) {
675 int ret;
676 check_write();
677 check_argc(argc, 1, 1);
678 ret = git_config_rename_section_in_file(given_config_source.file,
679 argv[0], NULL);
680 if (ret < 0)
681 return ret;
682 if (ret == 0)
683 die("No such section!");
685 else if (actions == ACTION_GET_COLOR) {
686 check_argc(argc, 1, 2);
687 get_color(argv[0], argv[1]);
689 else if (actions == ACTION_GET_COLORBOOL) {
690 check_argc(argc, 1, 2);
691 if (argc == 2)
692 color_stdout_is_tty = git_config_bool("command line", argv[1]);
693 return get_colorbool(argv[0], argc == 2);
696 return 0;