1#include "cache.h"
2#include "argv-array.h"
3#include "refs.h"
4#include "refspec.h"
5
6static struct refspec_item s_tag_refspec = {
7 0,
8 1,
9 0,
10 0,
11 "refs/tags/*",
12 "refs/tags/*"
13};
14
15/* See TAG_REFSPEC for the string version */
16const struct refspec_item *tag_refspec = &s_tag_refspec;
17
18/*
19 * Parses the provided refspec 'refspec' and populates the refspec_item 'item'.
20 * Returns 1 if successful and 0 if the refspec is invalid.
21 */
22static int parse_refspec(struct refspec_item *item, const char *refspec, int fetch)
23{
24 size_t llen;
25 int is_glob;
26 const char *lhs, *rhs;
27 int flags;
28
29 is_glob = 0;
30
31 lhs = refspec;
32 if (*lhs == '+') {
33 item->force = 1;
34 lhs++;
35 }
36
37 rhs = strrchr(lhs, ':');
38
39 /*
40 * Before going on, special case ":" (or "+:") as a refspec
41 * for pushing matching refs.
42 */
43 if (!fetch && rhs == lhs && rhs[1] == '\0') {
44 item->matching = 1;
45 return 1;
46 }
47
48 if (rhs) {
49 size_t rlen = strlen(++rhs);
50 is_glob = (1 <= rlen && strchr(rhs, '*'));
51 item->dst = xstrndup(rhs, rlen);
52 }
53
54 llen = (rhs ? (rhs - lhs - 1) : strlen(lhs));
55 if (1 <= llen && memchr(lhs, '*', llen)) {
56 if ((rhs && !is_glob) || (!rhs && fetch))
57 return 0;
58 is_glob = 1;
59 } else if (rhs && is_glob) {
60 return 0;
61 }
62
63 item->pattern = is_glob;
64 item->src = xstrndup(lhs, llen);
65 flags = REFNAME_ALLOW_ONELEVEL | (is_glob ? REFNAME_REFSPEC_PATTERN : 0);
66
67 if (fetch) {
68 struct object_id unused;
69
70 /* LHS */
71 if (!*item->src)
72 ; /* empty is ok; it means "HEAD" */
73 else if (llen == GIT_SHA1_HEXSZ && !get_oid_hex(item->src, &unused))
74 item->exact_sha1 = 1; /* ok */
75 else if (!check_refname_format(item->src, flags))
76 ; /* valid looking ref is ok */
77 else
78 return 0;
79 /* RHS */
80 if (!item->dst)
81 ; /* missing is ok; it is the same as empty */
82 else if (!*item->dst)
83 ; /* empty is ok; it means "do not store" */
84 else if (!check_refname_format(item->dst, flags))
85 ; /* valid looking ref is ok */
86 else
87 return 0;
88 } else {
89 /*
90 * LHS
91 * - empty is allowed; it means delete.
92 * - when wildcarded, it must be a valid looking ref.
93 * - otherwise, it must be an extended SHA-1, but
94 * there is no existing way to validate this.
95 */
96 if (!*item->src)
97 ; /* empty is ok */
98 else if (is_glob) {
99 if (check_refname_format(item->src, flags))
100 return 0;
101 }
102 else
103 ; /* anything goes, for now */
104 /*
105 * RHS
106 * - missing is allowed, but LHS then must be a
107 * valid looking ref.
108 * - empty is not allowed.
109 * - otherwise it must be a valid looking ref.
110 */
111 if (!item->dst) {
112 if (check_refname_format(item->src, flags))
113 return 0;
114 } else if (!*item->dst) {
115 return 0;
116 } else {
117 if (check_refname_format(item->dst, flags))
118 return 0;
119 }
120 }
121
122 return 1;
123}
124
125int refspec_item_init(struct refspec_item *item, const char *refspec, int fetch)
126{
127 memset(item, 0, sizeof(*item));
128 return parse_refspec(item, refspec, fetch);
129}
130
131void refspec_item_init_or_die(struct refspec_item *item, const char *refspec,
132 int fetch)
133{
134 if (!refspec_item_init(item, refspec, fetch))
135 die("Invalid refspec '%s'", refspec);
136}
137
138void refspec_item_clear(struct refspec_item *item)
139{
140 FREE_AND_NULL(item->src);
141 FREE_AND_NULL(item->dst);
142 item->force = 0;
143 item->pattern = 0;
144 item->matching = 0;
145 item->exact_sha1 = 0;
146}
147
148void refspec_init(struct refspec *rs, int fetch)
149{
150 memset(rs, 0, sizeof(*rs));
151 rs->fetch = fetch;
152}
153
154void refspec_append(struct refspec *rs, const char *refspec)
155{
156 struct refspec_item item;
157
158 refspec_item_init_or_die(&item, refspec, rs->fetch);
159
160 ALLOC_GROW(rs->items, rs->nr + 1, rs->alloc);
161 rs->items[rs->nr++] = item;
162
163 ALLOC_GROW(rs->raw, rs->raw_nr + 1, rs->raw_alloc);
164 rs->raw[rs->raw_nr++] = xstrdup(refspec);
165}
166
167void refspec_appendn(struct refspec *rs, const char **refspecs, int nr)
168{
169 int i;
170 for (i = 0; i < nr; i++)
171 refspec_append(rs, refspecs[i]);
172}
173
174void refspec_clear(struct refspec *rs)
175{
176 int i;
177
178 for (i = 0; i < rs->nr; i++)
179 refspec_item_clear(&rs->items[i]);
180
181 FREE_AND_NULL(rs->items);
182 rs->alloc = 0;
183 rs->nr = 0;
184
185 for (i = 0; i < rs->raw_nr; i++)
186 free((char *)rs->raw[i]);
187 FREE_AND_NULL(rs->raw);
188 rs->raw_alloc = 0;
189 rs->raw_nr = 0;
190
191 rs->fetch = 0;
192}
193
194int valid_fetch_refspec(const char *fetch_refspec_str)
195{
196 struct refspec_item refspec;
197 int ret = parse_refspec(&refspec, fetch_refspec_str, REFSPEC_FETCH);
198 refspec_item_clear(&refspec);
199 return ret;
200}
201
202void refspec_ref_prefixes(const struct refspec *rs,
203 struct argv_array *ref_prefixes)
204{
205 int i;
206 for (i = 0; i < rs->nr; i++) {
207 const struct refspec_item *item = &rs->items[i];
208 const char *prefix = NULL;
209
210 if (item->exact_sha1)
211 continue;
212 if (rs->fetch == REFSPEC_FETCH)
213 prefix = item->src;
214 else if (item->dst)
215 prefix = item->dst;
216 else if (item->src && !item->exact_sha1)
217 prefix = item->src;
218
219 if (prefix) {
220 if (item->pattern) {
221 const char *glob = strchr(prefix, '*');
222 argv_array_pushf(ref_prefixes, "%.*s",
223 (int)(glob - prefix),
224 prefix);
225 } else {
226 expand_ref_prefix(ref_prefixes, prefix);
227 }
228 }
229 }
230}