🌐 AI搜索 & 代理 主页
Google Git
Sign in
chromium / external / github.com / git / git / refs/tags/v2.43.0 / . / refspec.h
blob: 8c0c44699335e65af07ee2ea3ebd4fb266db32a5 [file] [log] [blame]
Brandon Williamsec0cb492018-05-16 22:57:48[diff] [blame]1#ifndef REFSPEC_H
2#define REFSPEC_H
3
4#define TAG_REFSPEC "refs/tags/*:refs/tags/*"
Brandon Williams0ad4a5f2018-05-16 22:57:49[diff] [blame]5extern const struct refspec_item *tag_refspec;
Brandon Williamsec0cb492018-05-16 22:57:48[diff] [blame]6
Jacob Keller0becfec2020-08-15 00:25:07[diff] [blame]7/**
Jacob Kellerc0192df2020-09-30 21:25:29[diff] [blame]8 * A struct refspec_item holds the parsed interpretation of a refspec. If it
9 * will force updates (starts with a '+'), force is true. If it is a pattern
10 * (sides end with '*') pattern is true. If it is a negative refspec, (starts
11 * with '^'), negative is true. src and dest are the two sides (including '*'
12 * characters if present); if there is only one side, it is src, and dst is
13 * NULL; if sides exist but are empty (i.e., the refspec either starts or ends
14 * with ':'), the corresponding side is "".
Jacob Keller0becfec2020-08-15 00:25:07[diff] [blame]15 *
16 * remote_find_tracking(), given a remote and a struct refspec_item with either src
17 * or dst filled out, will fill out the other such that the result is in the
18 * "fetch" specification for the remote (note that this evaluates patterns and
19 * returns a single result).
20 */
Brandon Williams0ad4a5f2018-05-16 22:57:49[diff] [blame]21struct refspec_item {
Brandon Williamsec0cb492018-05-16 22:57:48[diff] [blame]22 unsigned force : 1;
23 unsigned pattern : 1;
24 unsigned matching : 1;
25 unsigned exact_sha1 : 1;
Jacob Kellerc0192df2020-09-30 21:25:29[diff] [blame]26 unsigned negative : 1;
Brandon Williamsec0cb492018-05-16 22:57:48[diff] [blame]27
28 char *src;
29 char *dst;
30};
31
Brandon Williams6d4c0572018-05-16 22:57:51[diff] [blame]32#define REFSPEC_FETCH 1
33#define REFSPEC_PUSH 0
34
35#define REFSPEC_INIT_FETCH { .fetch = REFSPEC_FETCH }
36#define REFSPEC_INIT_PUSH { .fetch = REFSPEC_PUSH }
37
Heba Walyd27eb352019-11-17 21:04:45[diff] [blame]38/**
Jacob Keller0becfec2020-08-15 00:25:07[diff] [blame]39 * An array of strings can be parsed into a struct refspec using
Heba Walyd27eb352019-11-17 21:04:45[diff] [blame]40 * parse_fetch_refspec() or parse_push_refspec().
Heba Walyd27eb352019-11-17 21:04:45[diff] [blame]41 */
Brandon Williams6d4c0572018-05-16 22:57:51[diff] [blame]42struct refspec {
43 struct refspec_item *items;
44 int alloc;
45 int nr;
46
47 const char **raw;
48 int raw_alloc;
49 int raw_nr;
50
51 int fetch;
52};
53
Ævar Arnfjörð Bjarmasonc495fd32018-06-05 19:54:39[diff] [blame]54int refspec_item_init(struct refspec_item *item, const char *refspec,
55 int fetch);
Ævar Arnfjörð Bjarmasondc064222018-06-05 19:54:38[diff] [blame]56void refspec_item_init_or_die(struct refspec_item *item, const char *refspec,
57 int fetch);
Brandon Williams6d4c0572018-05-16 22:57:51[diff] [blame]58void refspec_item_clear(struct refspec_item *item);
59void refspec_init(struct refspec *rs, int fetch);
60void refspec_append(struct refspec *rs, const char *refspec);
René Scharfe1af8b8c2020-09-05 14:49:30[diff] [blame]61__attribute__((format (printf,2,3)))
62void refspec_appendf(struct refspec *rs, const char *fmt, ...);
Brandon Williams6d4c0572018-05-16 22:57:51[diff] [blame]63void refspec_appendn(struct refspec *rs, const char **refspecs, int nr);
64void refspec_clear(struct refspec *rs);
65
Brandon Williamsc8fa9ef2018-05-16 22:57:52[diff] [blame]66int valid_fetch_refspec(const char *refspec);
Sean Baragf2c6fda2020-10-01 03:46:13[diff] [blame]67int valid_remote_name(const char *name);
Brandon Williamsc8fa9ef2018-05-16 22:57:52[diff] [blame]68
Jeff King873cd282020-07-28 20:23:25[diff] [blame]69struct strvec;
Jonathan Nieder6c301ad2018-05-31 07:23:39[diff] [blame]70/*
71 * Determine what <prefix> values to pass to the peer in ref-prefix lines
Ævar Arnfjörð Bjarmason5db92102022-08-04 16:28:36[diff] [blame]72 * (see linkgit:gitprotocol-v2[5]).
Jonathan Nieder6c301ad2018-05-31 07:23:39[diff] [blame]73 */
Brandon Williams6373cb52018-05-16 23:48:21[diff] [blame]74void refspec_ref_prefixes(const struct refspec *rs,
Jeff King873cd282020-07-28 20:23:25[diff] [blame]75 struct strvec *ref_prefixes);
Brandon Williams6373cb52018-05-16 23:48:21[diff] [blame]76
Brandon Williamsec0cb492018-05-16 22:57:48[diff] [blame]77#endif /* REFSPEC_H */