Merge branch 'yk/git-tag-remove-mention-of-old-layout-in-doc' into maint
[git] / builtin / for-each-ref.c
1 #include "builtin.h"
2 #include "cache.h"
3 #include "refs.h"
4 #include "object.h"
5 #include "parse-options.h"
6 #include "ref-filter.h"
7
8 static char const * const for_each_ref_usage[] = {
9         N_("git for-each-ref [<options>] [<pattern>]"),
10         N_("git for-each-ref [--points-at <object>]"),
11         N_("git for-each-ref [(--merged | --no-merged) [<object>]]"),
12         N_("git for-each-ref [--contains [<object>]]"),
13         NULL
14 };
15
16 int cmd_for_each_ref(int argc, const char **argv, const char *prefix)
17 {
18         int i;
19         const char *format = "%(objectname) %(objecttype)\t%(refname)";
20         struct ref_sorting *sorting = NULL, **sorting_tail = &sorting;
21         int maxcount = 0, quote_style = 0;
22         struct ref_array array;
23         struct ref_filter filter;
24
25         struct option opts[] = {
26                 OPT_BIT('s', "shell", &quote_style,
27                         N_("quote placeholders suitably for shells"), QUOTE_SHELL),
28                 OPT_BIT('p', "perl",  &quote_style,
29                         N_("quote placeholders suitably for perl"), QUOTE_PERL),
30                 OPT_BIT(0 , "python", &quote_style,
31                         N_("quote placeholders suitably for python"), QUOTE_PYTHON),
32                 OPT_BIT(0 , "tcl",  &quote_style,
33                         N_("quote placeholders suitably for Tcl"), QUOTE_TCL),
34
35                 OPT_GROUP(""),
36                 OPT_INTEGER( 0 , "count", &maxcount, N_("show only <n> matched refs")),
37                 OPT_STRING(  0 , "format", &format, N_("format"), N_("format to use for the output")),
38                 OPT_CALLBACK(0 , "sort", sorting_tail, N_("key"),
39                             N_("field name to sort on"), &parse_opt_ref_sorting),
40                 OPT_CALLBACK(0, "points-at", &filter.points_at,
41                              N_("object"), N_("print only refs which points at the given object"),
42                              parse_opt_object_name),
43                 OPT_MERGED(&filter, N_("print only refs that are merged")),
44                 OPT_NO_MERGED(&filter, N_("print only refs that are not merged")),
45                 OPT_CONTAINS(&filter.with_commit, N_("print only refs which contain the commit")),
46                 OPT_END(),
47         };
48
49         memset(&array, 0, sizeof(array));
50         memset(&filter, 0, sizeof(filter));
51
52         parse_options(argc, argv, prefix, opts, for_each_ref_usage, 0);
53         if (maxcount < 0) {
54                 error("invalid --count argument: `%d'", maxcount);
55                 usage_with_options(for_each_ref_usage, opts);
56         }
57         if (HAS_MULTI_BITS(quote_style)) {
58                 error("more than one quoting style?");
59                 usage_with_options(for_each_ref_usage, opts);
60         }
61         if (verify_ref_format(format))
62                 usage_with_options(for_each_ref_usage, opts);
63
64         if (!sorting)
65                 sorting = ref_default_sorting();
66
67         /* for warn_ambiguous_refs */
68         git_config(git_default_config, NULL);
69
70         filter.name_patterns = argv;
71         filter.match_as_path = 1;
72         filter_refs(&array, &filter, FILTER_REFS_ALL | FILTER_REFS_INCLUDE_BROKEN);
73         ref_array_sort(sorting, &array);
74
75         if (!maxcount || array.nr < maxcount)
76                 maxcount = array.nr;
77         for (i = 0; i < maxcount; i++)
78                 show_ref_array_item(array.items[i], format, quote_style);
79         ref_array_clear(&array);
80         return 0;
81 }