]>
Commit | Line | Data |
---|---|---|
959b5455 HV |
1 | #ifndef SUBMODULE_CONFIG_CACHE_H |
2 | #define SUBMODULE_CONFIG_CACHE_H | |
3 | ||
34caab02 | 4 | #include "cache.h" |
ad136370 | 5 | #include "config.h" |
959b5455 | 6 | #include "hashmap.h" |
ea2fa5a3 | 7 | #include "submodule.h" |
959b5455 | 8 | #include "strbuf.h" |
961b130d | 9 | #include "tree-walk.h" |
959b5455 | 10 | |
d95a77d0 HW |
11 | /** |
12 | * The submodule config cache API allows to read submodule | |
13 | * configurations/information from specified revisions. Internally | |
14 | * information is lazily read into a cache that is used to avoid | |
15 | * unnecessary parsing of the same .gitmodules files. Lookups can be done by | |
16 | * submodule path or name. | |
17 | * | |
18 | * Usage | |
19 | * ----- | |
20 | * | |
21 | * The caller can look up information about submodules by using the | |
22 | * `submodule_from_path()` or `submodule_from_name()` functions. They return | |
23 | * a `struct submodule` which contains the values. The API automatically | |
24 | * initializes and allocates the needed infrastructure on-demand. If the | |
25 | * caller does only want to lookup values from revisions the initialization | |
26 | * can be skipped. | |
27 | * | |
28 | * If the internal cache might grow too big or when the caller is done with | |
29 | * the API, all internally cached values can be freed with submodule_free(). | |
30 | * | |
31 | */ | |
32 | ||
959b5455 HV |
33 | /* |
34 | * Submodule entry containing the information about a certain submodule | |
d95a77d0 | 35 | * in a certain revision. It is returned by the lookup functions. |
959b5455 HV |
36 | */ |
37 | struct submodule { | |
38 | const char *path; | |
39 | const char *name; | |
40 | const char *url; | |
465b30a9 | 41 | enum submodule_recurse_mode fetch_recurse; |
959b5455 | 42 | const char *ignore; |
b5944f34 | 43 | const char *branch; |
ea2fa5a3 | 44 | struct submodule_update_strategy update_strategy; |
34caab02 | 45 | /* the object id of the responsible .gitmodules file */ |
46 | struct object_id gitmodules_oid; | |
37f52e93 | 47 | int recommend_shallow; |
959b5455 | 48 | }; |
bf12fcdf BW |
49 | struct submodule_cache; |
50 | struct repository; | |
51 | ||
55454427 | 52 | void submodule_cache_free(struct submodule_cache *cache); |
bf12fcdf | 53 | |
55454427 DL |
54 | int parse_submodule_fetchjobs(const char *var, const char *value); |
55 | int parse_fetch_recurse_submodules_arg(const char *opt, const char *arg); | |
886dc154 | 56 | struct option; |
55454427 | 57 | int option_fetch_parse_recurse_submodules(const struct option *opt, |
ad6dad09 | 58 | const char *arg, int unset); |
55454427 DL |
59 | int parse_update_recurse_submodules_arg(const char *opt, const char *arg); |
60 | int parse_push_recurse_submodules_arg(const char *opt, const char *arg); | |
d7992421 | 61 | void repo_read_gitmodules(struct repository *repo, int skip_if_read); |
55454427 | 62 | void gitmodules_config_oid(const struct object_id *commit_oid); |
d95a77d0 HW |
63 | |
64 | /** | |
65 | * Same as submodule_from_path but lookup by name. | |
66 | */ | |
3b8fb393 SB |
67 | const struct submodule *submodule_from_name(struct repository *r, |
68 | const struct object_id *commit_or_tree, | |
69 | const char *name); | |
d95a77d0 HW |
70 | |
71 | /** | |
72 | * Given a tree-ish in the superproject and a path, return the submodule that | |
73 | * is bound at the path in the named tree. | |
74 | */ | |
3b8fb393 SB |
75 | const struct submodule *submodule_from_path(struct repository *r, |
76 | const struct object_id *commit_or_tree, | |
77 | const char *path); | |
d95a77d0 HW |
78 | |
79 | /** | |
80 | * Use these to free the internally cached values. | |
81 | */ | |
f793b895 | 82 | void submodule_free(struct repository *r); |
d95a77d0 | 83 | |
bcbc780d | 84 | int print_config_from_gitmodules(struct repository *repo, const char *key); |
45f5ef3d | 85 | int config_set_in_gitmodules_file_gently(const char *key, const char *value); |
959b5455 | 86 | |
0383bbb9 JK |
87 | /* |
88 | * Returns 0 if the name is syntactically acceptable as a submodule "name" | |
89 | * (e.g., that may be found in the subsection of a .gitmodules file) and -1 | |
90 | * otherwise. | |
91 | */ | |
92 | int check_submodule_name(const char *name); | |
93 | ||
ad136370 | 94 | /* |
588929d5 AO |
95 | * Note: these helper functions exist solely to maintain backward |
96 | * compatibility with 'fetch' and 'update_clone' storing configuration in | |
97 | * '.gitmodules'. | |
ad136370 | 98 | * |
588929d5 AO |
99 | * New helpers to retrieve arbitrary configuration from the '.gitmodules' file |
100 | * should NOT be added. | |
ad136370 | 101 | */ |
55454427 DL |
102 | void fetch_config_from_gitmodules(int *max_children, int *recurse_submodules); |
103 | void update_clone_config_from_gitmodules(int *max_jobs); | |
71a6953d | 104 | |
961b130d GC |
105 | /* |
106 | * Submodule entry that contains relevant information about a | |
107 | * submodule in a tree. | |
108 | */ | |
109 | struct submodule_tree_entry { | |
110 | /* The submodule's tree entry. */ | |
111 | struct name_entry *name_entry; | |
112 | /* | |
113 | * A struct repository corresponding to the submodule. May be | |
114 | * NULL if the submodule has not been updated. | |
115 | */ | |
116 | struct repository *repo; | |
117 | /* | |
118 | * A struct submodule containing the submodule config in the | |
119 | * tree's .gitmodules. | |
120 | */ | |
121 | const struct submodule *submodule; | |
122 | }; | |
123 | ||
124 | struct submodule_entry_list { | |
125 | struct submodule_tree_entry *entries; | |
126 | int entry_nr; | |
127 | int entry_alloc; | |
128 | }; | |
129 | ||
130 | /** | |
131 | * Given a treeish, return all submodules in the tree and its subtrees, | |
132 | * but excluding nested submodules. Callers that require nested | |
133 | * submodules are expected to recurse into the submodules themselves. | |
134 | */ | |
135 | void submodules_of_tree(struct repository *r, | |
136 | const struct object_id *treeish_name, | |
137 | struct submodule_entry_list *ret); | |
959b5455 | 138 | #endif /* SUBMODULE_CONFIG_H */ |