help: align the longest command in the command listing
[git.git] / builtin / show-ref.c
blobed888ffa48ce1d5ef80859b8f5b3bf1720e49abd
1 #include "builtin.h"
2 #include "cache.h"
3 #include "refs.h"
4 #include "object-store.h"
5 #include "object.h"
6 #include "tag.h"
7 #include "string-list.h"
8 #include "parse-options.h"
10 static const char * const show_ref_usage[] = {
11 N_("git show-ref [-q | --quiet] [--verify] [--head] [-d | --dereference] [-s | --hash[=<n>]] [--abbrev[=<n>]] [--tags] [--heads] [--] [<pattern>...]"),
12 N_("git show-ref --exclude-existing[=<pattern>]"),
13 NULL
16 static int deref_tags, show_head, tags_only, heads_only, found_match, verify,
17 quiet, hash_only, abbrev, exclude_arg;
18 static const char **pattern;
19 static const char *exclude_existing_arg;
21 static void show_one(const char *refname, const struct object_id *oid)
23 const char *hex;
24 struct object_id peeled;
26 if (!has_sha1_file(oid->hash))
27 die("git show-ref: bad ref %s (%s)", refname,
28 oid_to_hex(oid));
30 if (quiet)
31 return;
33 hex = find_unique_abbrev(oid, abbrev);
34 if (hash_only)
35 printf("%s\n", hex);
36 else
37 printf("%s %s\n", hex, refname);
39 if (!deref_tags)
40 return;
42 if (!peel_ref(refname, &peeled)) {
43 hex = find_unique_abbrev(&peeled, abbrev);
44 printf("%s %s^{}\n", hex, refname);
48 static int show_ref(const char *refname, const struct object_id *oid,
49 int flag, void *cbdata)
51 if (show_head && !strcmp(refname, "HEAD"))
52 goto match;
54 if (tags_only || heads_only) {
55 int match;
57 match = heads_only && starts_with(refname, "refs/heads/");
58 match |= tags_only && starts_with(refname, "refs/tags/");
59 if (!match)
60 return 0;
62 if (pattern) {
63 int reflen = strlen(refname);
64 const char **p = pattern, *m;
65 while ((m = *p++) != NULL) {
66 int len = strlen(m);
67 if (len > reflen)
68 continue;
69 if (memcmp(m, refname + reflen - len, len))
70 continue;
71 if (len == reflen)
72 goto match;
73 if (refname[reflen - len - 1] == '/')
74 goto match;
76 return 0;
79 match:
80 found_match++;
82 show_one(refname, oid);
84 return 0;
87 static int add_existing(const char *refname, const struct object_id *oid,
88 int flag, void *cbdata)
90 struct string_list *list = (struct string_list *)cbdata;
91 string_list_insert(list, refname);
92 return 0;
96 * read "^(?:<anything>\s)?<refname>(?:\^\{\})?$" from the standard input,
97 * and
98 * (1) strip "^{}" at the end of line if any;
99 * (2) ignore if match is provided and does not head-match refname;
100 * (3) warn if refname is not a well-formed refname and skip;
101 * (4) ignore if refname is a ref that exists in the local repository;
102 * (5) otherwise output the line.
104 static int exclude_existing(const char *match)
106 static struct string_list existing_refs = STRING_LIST_INIT_DUP;
107 char buf[1024];
108 int matchlen = match ? strlen(match) : 0;
110 for_each_ref(add_existing, &existing_refs);
111 while (fgets(buf, sizeof(buf), stdin)) {
112 char *ref;
113 int len = strlen(buf);
115 if (len > 0 && buf[len - 1] == '\n')
116 buf[--len] = '\0';
117 if (3 <= len && !strcmp(buf + len - 3, "^{}")) {
118 len -= 3;
119 buf[len] = '\0';
121 for (ref = buf + len; buf < ref; ref--)
122 if (isspace(ref[-1]))
123 break;
124 if (match) {
125 int reflen = buf + len - ref;
126 if (reflen < matchlen)
127 continue;
128 if (strncmp(ref, match, matchlen))
129 continue;
131 if (check_refname_format(ref, 0)) {
132 warning("ref '%s' ignored", ref);
133 continue;
135 if (!string_list_has_string(&existing_refs, ref)) {
136 printf("%s\n", buf);
139 return 0;
142 static int hash_callback(const struct option *opt, const char *arg, int unset)
144 hash_only = 1;
145 /* Use full length SHA1 if no argument */
146 if (!arg)
147 return 0;
148 return parse_opt_abbrev_cb(opt, arg, unset);
151 static int exclude_existing_callback(const struct option *opt, const char *arg,
152 int unset)
154 BUG_ON_OPT_NEG(unset);
155 exclude_arg = 1;
156 *(const char **)opt->value = arg;
157 return 0;
160 static const struct option show_ref_options[] = {
161 OPT_BOOL(0, "tags", &tags_only, N_("only show tags (can be combined with heads)")),
162 OPT_BOOL(0, "heads", &heads_only, N_("only show heads (can be combined with tags)")),
163 OPT_BOOL(0, "verify", &verify, N_("stricter reference checking, "
164 "requires exact ref path")),
165 OPT_HIDDEN_BOOL('h', NULL, &show_head,
166 N_("show the HEAD reference, even if it would be filtered out")),
167 OPT_BOOL(0, "head", &show_head,
168 N_("show the HEAD reference, even if it would be filtered out")),
169 OPT_BOOL('d', "dereference", &deref_tags,
170 N_("dereference tags into object IDs")),
171 { OPTION_CALLBACK, 's', "hash", &abbrev, N_("n"),
172 N_("only show SHA1 hash using <n> digits"),
173 PARSE_OPT_OPTARG, &hash_callback },
174 OPT__ABBREV(&abbrev),
175 OPT__QUIET(&quiet,
176 N_("do not print results to stdout (useful with --verify)")),
177 { OPTION_CALLBACK, 0, "exclude-existing", &exclude_existing_arg,
178 N_("pattern"), N_("show refs from stdin that aren't in local repository"),
179 PARSE_OPT_OPTARG | PARSE_OPT_NONEG, exclude_existing_callback },
180 OPT_END()
183 int cmd_show_ref(int argc, const char **argv, const char *prefix)
185 argc = parse_options(argc, argv, prefix, show_ref_options,
186 show_ref_usage, 0);
188 if (exclude_arg)
189 return exclude_existing(exclude_existing_arg);
191 pattern = argv;
192 if (!*pattern)
193 pattern = NULL;
195 if (verify) {
196 if (!pattern)
197 die("--verify requires a reference");
198 while (*pattern) {
199 struct object_id oid;
201 if ((starts_with(*pattern, "refs/") || !strcmp(*pattern, "HEAD")) &&
202 !read_ref(*pattern, &oid)) {
203 show_one(*pattern, &oid);
205 else if (!quiet)
206 die("'%s' - not a valid ref", *pattern);
207 else
208 return 1;
209 pattern++;
211 return 0;
214 if (show_head)
215 head_ref(show_ref, NULL);
216 for_each_ref(show_ref, NULL);
217 if (!found_match) {
218 if (verify && !quiet)
219 die("No match");
220 return 1;
222 return 0;