d95a77d059
Move the documentation from Documentation/technical/api-submodule-config.txt to submodule-config.h as it's easier for the developers to find the usage information beside the code instead of looking for it in another doc file. Documentation/technical/api-submodule-config.txt is removed because the information it has is now redundant and it'll be hard to keep it up to date and synchronized with the documentation in the header file. The documentation of parse_submodule_config_option() is discarded as the function was removed 2 years ago. Signed-off-by: Heba Waly <heba.waly@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
109 lines
3.6 KiB
C
109 lines
3.6 KiB
C
#ifndef SUBMODULE_CONFIG_CACHE_H
|
|
#define SUBMODULE_CONFIG_CACHE_H
|
|
|
|
#include "cache.h"
|
|
#include "config.h"
|
|
#include "hashmap.h"
|
|
#include "submodule.h"
|
|
#include "strbuf.h"
|
|
|
|
/**
|
|
* The submodule config cache API allows to read submodule
|
|
* configurations/information from specified revisions. Internally
|
|
* information is lazily read into a cache that is used to avoid
|
|
* unnecessary parsing of the same .gitmodules files. Lookups can be done by
|
|
* submodule path or name.
|
|
*
|
|
* Usage
|
|
* -----
|
|
*
|
|
* The caller can look up information about submodules by using the
|
|
* `submodule_from_path()` or `submodule_from_name()` functions. They return
|
|
* a `struct submodule` which contains the values. The API automatically
|
|
* initializes and allocates the needed infrastructure on-demand. If the
|
|
* caller does only want to lookup values from revisions the initialization
|
|
* can be skipped.
|
|
*
|
|
* If the internal cache might grow too big or when the caller is done with
|
|
* the API, all internally cached values can be freed with submodule_free().
|
|
*
|
|
*/
|
|
|
|
/*
|
|
* Submodule entry containing the information about a certain submodule
|
|
* in a certain revision. It is returned by the lookup functions.
|
|
*/
|
|
struct submodule {
|
|
const char *path;
|
|
const char *name;
|
|
const char *url;
|
|
int fetch_recurse;
|
|
const char *ignore;
|
|
const char *branch;
|
|
struct submodule_update_strategy update_strategy;
|
|
/* the object id of the responsible .gitmodules file */
|
|
struct object_id gitmodules_oid;
|
|
int recommend_shallow;
|
|
};
|
|
|
|
#define SUBMODULE_INIT { NULL, NULL, NULL, RECURSE_SUBMODULES_NONE, \
|
|
NULL, NULL, SUBMODULE_UPDATE_STRATEGY_INIT, { { 0 } }, -1 };
|
|
|
|
struct submodule_cache;
|
|
struct repository;
|
|
|
|
void submodule_cache_free(struct submodule_cache *cache);
|
|
|
|
int parse_submodule_fetchjobs(const char *var, const char *value);
|
|
int parse_fetch_recurse_submodules_arg(const char *opt, const char *arg);
|
|
struct option;
|
|
int option_fetch_parse_recurse_submodules(const struct option *opt,
|
|
const char *arg, int unset);
|
|
int parse_update_recurse_submodules_arg(const char *opt, const char *arg);
|
|
int parse_push_recurse_submodules_arg(const char *opt, const char *arg);
|
|
void repo_read_gitmodules(struct repository *repo);
|
|
void gitmodules_config_oid(const struct object_id *commit_oid);
|
|
|
|
/**
|
|
* Same as submodule_from_path but lookup by name.
|
|
*/
|
|
const struct submodule *submodule_from_name(struct repository *r,
|
|
const struct object_id *commit_or_tree,
|
|
const char *name);
|
|
|
|
/**
|
|
* Given a tree-ish in the superproject and a path, return the submodule that
|
|
* is bound at the path in the named tree.
|
|
*/
|
|
const struct submodule *submodule_from_path(struct repository *r,
|
|
const struct object_id *commit_or_tree,
|
|
const char *path);
|
|
|
|
/**
|
|
* Use these to free the internally cached values.
|
|
*/
|
|
void submodule_free(struct repository *r);
|
|
|
|
int print_config_from_gitmodules(struct repository *repo, const char *key);
|
|
int config_set_in_gitmodules_file_gently(const char *key, const char *value);
|
|
|
|
/*
|
|
* Returns 0 if the name is syntactically acceptable as a submodule "name"
|
|
* (e.g., that may be found in the subsection of a .gitmodules file) and -1
|
|
* otherwise.
|
|
*/
|
|
int check_submodule_name(const char *name);
|
|
|
|
/*
|
|
* Note: these helper functions exist solely to maintain backward
|
|
* compatibility with 'fetch' and 'update_clone' storing configuration in
|
|
* '.gitmodules'.
|
|
*
|
|
* New helpers to retrieve arbitrary configuration from the '.gitmodules' file
|
|
* should NOT be added.
|
|
*/
|
|
void fetch_config_from_gitmodules(int *max_children, int *recurse_submodules);
|
|
void update_clone_config_from_gitmodules(int *max_jobs);
|
|
|
|
#endif /* SUBMODULE_CONFIG_H */
|