]> git.ipfire.org Git - thirdparty/git.git/blame - builtin/show-ref.c
The ninth batch
[thirdparty/git.git] / builtin / show-ref.c
CommitLineData
03eae9af 1#define USE_THE_REPOSITORY_VARIABLE
baffc0e7 2#include "builtin.h"
8e712ef6 3#include "config.h"
08b77586 4#include "environment.h"
f394e093 5#include "gettext.h"
41771fa4 6#include "hex.h"
9080a7f1 7#include "refs/refs-internal.h"
dabab1d6 8#include "object-name.h"
8f491517 9#include "odb.h"
358ddb62 10#include "object.h"
c455c87c 11#include "string-list.h"
69932bc6 12#include "parse-options.h"
358ddb62 13
69932bc6 14static const char * const show_ref_usage[] = {
1307d5e8 15 N_("git show-ref [--head] [-d | --dereference]\n"
607c3d37
JH
16 " [-s | --hash[=<n>]] [--abbrev[=<n>]] [--branches] [--tags]\n"
17 " [--] [<pattern>...]"),
1307d5e8
PS
18 N_("git show-ref --verify [-q | --quiet] [-d | --dereference]\n"
19 " [-s | --hash[=<n>]] [--abbrev[=<n>]]\n"
20 " [--] [<ref>...]"),
33e8fc87 21 N_("git show-ref --exclude-existing[=<pattern>]"),
9080a7f1 22 N_("git show-ref --exists <ref>"),
69932bc6
SB
23 NULL
24};
358ddb62 25
b0f0be93
PS
26struct show_one_options {
27 int quiet;
28 int hash_only;
29 int abbrev;
30 int deref_tags;
31};
32
33static void show_one(const struct show_one_options *opts,
34 const char *refname, const struct object_id *oid)
64fe031a 35{
f1627040
VP
36 const char *hex;
37 struct object_id peeled;
38
fcf8e3e1
PS
39 if (!odb_has_object(the_repository->objects, oid,
40 HAS_OBJECT_RECHECK_PACKED | HAS_OBJECT_FETCH_PROMISOR))
d01b8203
VP
41 die("git show-ref: bad ref %s (%s)", refname,
42 oid_to_hex(oid));
43
b0f0be93 44 if (opts->quiet)
14144d3b
VP
45 return;
46
b0f0be93
PS
47 hex = repo_find_unique_abbrev(the_repository, oid, opts->abbrev);
48 if (opts->hash_only)
64fe031a
JH
49 printf("%s\n", hex);
50 else
51 printf("%s %s\n", hex, refname);
f1627040 52
b0f0be93 53 if (!opts->deref_tags)
f1627040
VP
54 return;
55
30aaff43 56 if (!peel_iterated_oid(the_repository, oid, &peeled)) {
b0f0be93 57 hex = repo_find_unique_abbrev(the_repository, &peeled, opts->abbrev);
f1627040
VP
58 printf("%s %s^{}\n", hex, refname);
59 }
64fe031a
JH
60}
61
ff546ebb 62struct show_ref_data {
b0f0be93 63 const struct show_one_options *show_one_opts;
ff546ebb 64 const char **patterns;
84650989 65 int found_match;
ee26f1e2 66 int show_head;
ff546ebb
PS
67};
68
e8207717 69static int show_ref(const char *refname, const char *referent UNUSED, const struct object_id *oid,
ff546ebb 70 int flag UNUSED, void *cbdata)
358ddb62 71{
ff546ebb
PS
72 struct show_ref_data *data = cbdata;
73
ee26f1e2 74 if (data->show_head && !strcmp(refname, "HEAD"))
3f3d0cea
DB
75 goto match;
76
ff546ebb 77 if (data->patterns) {
358ddb62 78 int reflen = strlen(refname);
ff546ebb 79 const char **p = data->patterns, *m;
358ddb62
LT
80 while ((m = *p++) != NULL) {
81 int len = strlen(m);
82 if (len > reflen)
83 continue;
84 if (memcmp(m, refname + reflen - len, len))
85 continue;
86 if (len == reflen)
87 goto match;
358ddb62
LT
88 if (refname[reflen - len - 1] == '/')
89 goto match;
90 }
91 return 0;
92 }
93
94match:
84650989 95 data->found_match++;
cf0adba7 96
b0f0be93 97 show_one(data->show_one_opts, refname, oid);
cf0adba7 98
358ddb62
LT
99 return 0;
100}
101
63e14ee2 102static int add_existing(const char *refname,
e8207717 103 const char *referent UNUSED,
5cf88fd8
ÆAB
104 const struct object_id *oid UNUSED,
105 int flag UNUSED, void *cbdata)
ed9f7c95 106{
c455c87c 107 struct string_list *list = (struct string_list *)cbdata;
78a395d3 108 string_list_insert(list, refname);
ed9f7c95
JH
109 return 0;
110}
111
7907fb0c
PS
112struct exclude_existing_options {
113 /*
114 * We need an explicit `enabled` field because it is perfectly valid
115 * for `pattern` to be `NULL` even if `--exclude-existing` was given.
116 */
117 int enabled;
118 const char *pattern;
119};
120
ed9f7c95
JH
121/*
122 * read "^(?:<anything>\s)?<refname>(?:\^\{\})?$" from the standard input,
123 * and
124 * (1) strip "^{}" at the end of line if any;
125 * (2) ignore if match is provided and does not head-match refname;
126 * (3) warn if refname is not a well-formed refname and skip;
127 * (4) ignore if refname is a ref that exists in the local repository;
128 * (5) otherwise output the line.
129 */
7907fb0c 130static int cmd_show_ref__exclude_existing(const struct exclude_existing_options *opts)
ed9f7c95 131{
dbabd0b0 132 struct string_list existing_refs = STRING_LIST_INIT_DUP;
ed9f7c95 133 char buf[1024];
7907fb0c 134 int patternlen = opts->pattern ? strlen(opts->pattern) : 0;
ed9f7c95 135
2e5c4758
PS
136 refs_for_each_ref(get_main_ref_store(the_repository), add_existing,
137 &existing_refs);
ed9f7c95 138 while (fgets(buf, sizeof(buf), stdin)) {
ed9f7c95 139 char *ref;
d8285af4
JH
140 int len = strlen(buf);
141
ed9f7c95
JH
142 if (len > 0 && buf[len - 1] == '\n')
143 buf[--len] = '\0';
d8285af4 144 if (3 <= len && !strcmp(buf + len - 3, "^{}")) {
ed9f7c95
JH
145 len -= 3;
146 buf[len] = '\0';
147 }
148 for (ref = buf + len; buf < ref; ref--)
149 if (isspace(ref[-1]))
150 break;
7907fb0c 151 if (opts->pattern) {
ed9f7c95 152 int reflen = buf + len - ref;
7907fb0c 153 if (reflen < patternlen)
ed9f7c95 154 continue;
7907fb0c 155 if (strncmp(ref, opts->pattern, patternlen))
ed9f7c95
JH
156 continue;
157 }
8d9c5010 158 if (check_refname_format(ref, 0)) {
5620e77e 159 warning("ref '%s' ignored", ref);
ed9f7c95
JH
160 continue;
161 }
c455c87c 162 if (!string_list_has_string(&existing_refs, ref)) {
ed9f7c95
JH
163 printf("%s\n", buf);
164 }
165 }
dbabd0b0
PS
166
167 string_list_clear(&existing_refs, 0);
ed9f7c95
JH
168 return 0;
169}
170
b0f0be93
PS
171static int cmd_show_ref__verify(const struct show_one_options *show_one_opts,
172 const char **refs)
b14cbae2
PS
173{
174 if (!refs || !*refs)
175 die("--verify requires a reference");
176
177 while (*refs) {
178 struct object_id oid;
179
1dbe4015 180 if ((starts_with(*refs, "refs/") || refname_is_safe(*refs)) &&
2e5c4758 181 !refs_read_ref(get_main_ref_store(the_repository), *refs, &oid)) {
b0f0be93 182 show_one(show_one_opts, *refs, &oid);
b14cbae2 183 }
b0f0be93 184 else if (!show_one_opts->quiet)
b14cbae2
PS
185 die("'%s' - not a valid ref", *refs);
186 else
187 return 1;
188 refs++;
189 }
190
191 return 0;
192}
193
ee26f1e2
PS
194struct patterns_options {
195 int show_head;
607c3d37 196 int branches_only;
ee26f1e2
PS
197 int tags_only;
198};
199
200static int cmd_show_ref__patterns(const struct patterns_options *opts,
201 const struct show_one_options *show_one_opts,
b0f0be93 202 const char **patterns)
b14cbae2 203{
b0f0be93
PS
204 struct show_ref_data show_ref_data = {
205 .show_one_opts = show_one_opts,
ee26f1e2 206 .show_head = opts->show_head,
b0f0be93 207 };
b14cbae2
PS
208
209 if (patterns && *patterns)
210 show_ref_data.patterns = patterns;
211
ee26f1e2 212 if (opts->show_head)
2e5c4758
PS
213 refs_head_ref(get_main_ref_store(the_repository), show_ref,
214 &show_ref_data);
607c3d37
JH
215 if (opts->branches_only || opts->tags_only) {
216 if (opts->branches_only)
2e5c4758
PS
217 refs_for_each_fullref_in(get_main_ref_store(the_repository),
218 "refs/heads/", NULL,
219 show_ref, &show_ref_data);
ee26f1e2 220 if (opts->tags_only)
2e5c4758
PS
221 refs_for_each_fullref_in(get_main_ref_store(the_repository),
222 "refs/tags/", NULL, show_ref,
223 &show_ref_data);
b14cbae2 224 } else {
2e5c4758
PS
225 refs_for_each_ref(get_main_ref_store(the_repository),
226 show_ref, &show_ref_data);
b14cbae2 227 }
84650989 228 if (!show_ref_data.found_match)
b14cbae2 229 return 1;
b14cbae2
PS
230
231 return 0;
232}
233
9080a7f1
PS
234static int cmd_show_ref__exists(const char **refs)
235{
236 struct strbuf unused_referent = STRBUF_INIT;
237 struct object_id unused_oid;
238 unsigned int unused_type;
239 int failure_errno = 0;
240 const char *ref;
241 int ret = 0;
242
243 if (!refs || !*refs)
244 die("--exists requires a reference");
245 ref = *refs++;
246 if (*refs)
247 die("--exists requires exactly one reference");
248
249 if (refs_read_raw_ref(get_main_ref_store(the_repository), ref,
250 &unused_oid, &unused_referent, &unused_type,
251 &failure_errno)) {
0aabeaa5 252 if (failure_errno == ENOENT || failure_errno == EISDIR) {
9080a7f1
PS
253 error(_("reference does not exist"));
254 ret = 2;
255 } else {
256 errno = failure_errno;
257 error_errno(_("failed to look up reference"));
258 ret = 1;
259 }
260
261 goto out;
262 }
263
264out:
265 strbuf_release(&unused_referent);
266 return ret;
267}
268
69932bc6
SB
269static int hash_callback(const struct option *opt, const char *arg, int unset)
270{
b0f0be93
PS
271 struct show_one_options *opts = opt->value;
272 struct option abbrev_opt = *opt;
273
274 opts->hash_only = 1;
69932bc6
SB
275 /* Use full length SHA1 if no argument */
276 if (!arg)
277 return 0;
b0f0be93
PS
278
279 abbrev_opt.value = &opts->abbrev;
280 return parse_opt_abbrev_cb(&abbrev_opt, arg, unset);
69932bc6
SB
281}
282
283static int exclude_existing_callback(const struct option *opt, const char *arg,
284 int unset)
285{
7907fb0c 286 struct exclude_existing_options *opts = opt->value;
517fe807 287 BUG_ON_OPT_NEG(unset);
7907fb0c
PS
288 opts->enabled = 1;
289 opts->pattern = arg;
69932bc6
SB
290 return 0;
291}
292
9b1cb507
JC
293int cmd_show_ref(int argc,
294const char **argv,
295const char *prefix,
296struct repository *repo UNUSED)
358ddb62 297{
7907fb0c 298 struct exclude_existing_options exclude_existing_opts = {0};
ee26f1e2 299 struct patterns_options patterns_opts = {0};
b0f0be93 300 struct show_one_options show_one_opts = {0};
9080a7f1 301 int verify = 0, exists = 0;
7907fb0c 302 const struct option show_ref_options[] = {
98858712
AS
303 OPT_BOOL(0, "tags", &patterns_opts.tags_only, N_("only show tags (can be combined with --branches)")),
304 OPT_BOOL(0, "branches", &patterns_opts.branches_only, N_("only show branches (can be combined with --tags)")),
607c3d37
JH
305 OPT_HIDDEN_BOOL(0, "heads", &patterns_opts.branches_only,
306 N_("deprecated synonym for --branches")),
9080a7f1 307 OPT_BOOL(0, "exists", &exists, N_("check for reference existence without resolving")),
7907fb0c
PS
308 OPT_BOOL(0, "verify", &verify, N_("stricter reference checking, "
309 "requires exact ref path")),
ee26f1e2 310 OPT_HIDDEN_BOOL('h', NULL, &patterns_opts.show_head,
7907fb0c 311 N_("show the HEAD reference, even if it would be filtered out")),
ee26f1e2 312 OPT_BOOL(0, "head", &patterns_opts.show_head,
7907fb0c 313 N_("show the HEAD reference, even if it would be filtered out")),
b0f0be93 314 OPT_BOOL('d', "dereference", &show_one_opts.deref_tags,
7907fb0c 315 N_("dereference tags into object IDs")),
b0f0be93 316 OPT_CALLBACK_F('s', "hash", &show_one_opts, N_("n"),
7907fb0c
PS
317 N_("only show SHA1 hash using <n> digits"),
318 PARSE_OPT_OPTARG, &hash_callback),
b0f0be93
PS
319 OPT__ABBREV(&show_one_opts.abbrev),
320 OPT__QUIET(&show_one_opts.quiet,
7907fb0c
PS
321 N_("do not print results to stdout (useful with --verify)")),
322 OPT_CALLBACK_F(0, "exclude-existing", &exclude_existing_opts,
323 N_("pattern"), N_("show refs from stdin that aren't in local repository"),
324 PARSE_OPT_OPTARG | PARSE_OPT_NONEG, exclude_existing_callback),
325 OPT_END()
326 };
327
9ce196e8 328 repo_config(the_repository, git_default_config, NULL);
8e712ef6 329
69932bc6 330 argc = parse_options(argc, argv, prefix, show_ref_options,
42fdf86e 331 show_ref_usage, 0);
358ddb62 332
73824973
RS
333 die_for_incompatible_opt3(exclude_existing_opts.enabled, "--exclude-existing",
334 verify, "--verify",
335 exists, "--exists");
199970e7 336
7907fb0c
PS
337 if (exclude_existing_opts.enabled)
338 return cmd_show_ref__exclude_existing(&exclude_existing_opts);
b14cbae2 339 else if (verify)
b0f0be93 340 return cmd_show_ref__verify(&show_one_opts, argv);
9080a7f1
PS
341 else if (exists)
342 return cmd_show_ref__exists(argv);
b14cbae2 343 else
ee26f1e2 344 return cmd_show_ref__patterns(&patterns_opts, &show_one_opts, argv);
358ddb62 345}