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