refspec: add back a refspec_item_init() function
[git] / refspec.c
1 #include "cache.h"
2 #include "argv-array.h"
3 #include "refs.h"
4 #include "refspec.h"
5
6 static 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 */
16 const 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  */
22 static 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
125 int 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
131 void 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
138 void 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
148 void refspec_init(struct refspec *rs, int fetch)
149 {
150         memset(rs, 0, sizeof(*rs));
151         rs->fetch = fetch;
152 }
153
154 void 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
167 void 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
174 void 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
194 int 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
202 void 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 }