From: Felipe Contreras <felipe.contreras@gmail.com> To: git@vger.kernel.org Cc: Junio C Hamano <gitster@pobox.com>, Jeff King <peff@peff.net>, Jonathan Nieder <jrnieder@gmail.com>, Dominik Salvet <dominik.salvet@gmail.com>, Felipe Contreras <felipe.contreras@gmail.com> Subject: [RFC/PATCH] Add fetch.updateHead option Date: Wed, 18 Nov 2020 03:12:19 -0600 Message-ID: <20201118091219.3341585-1-felipe.contreras@gmail.com> (raw) Users might change the behavior when running "git fetch" so that the remote's HEAD symbolic ref is updated at certain point. For example after running "git remote add" the remote HEAD is not set like it is with "git clone". Setting "fetch.updatehead = missing" would probably be a sensible default that everyone would want, but for now the default behavior is to never update HEAD, so there shouldn't be any functional changes. For the next major version of Git, we might want to change this default. Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com> --- This is just a RFC, the tests are missing. Documentation/config/fetch.txt | 4 +++ Documentation/config/remote.txt | 3 ++ builtin/fetch.c | 53 ++++++++++++++++++++++++++++++++- remote.c | 21 +++++++++++++ remote.h | 11 +++++++ 5 files changed, 91 insertions(+), 1 deletion(-) diff --git a/Documentation/config/fetch.txt b/Documentation/config/fetch.txt index 6af6f5edb2..93d6c59fac 100644 --- a/Documentation/config/fetch.txt +++ b/Documentation/config/fetch.txt @@ -94,3 +94,7 @@ fetch.writeCommitGraph:: merge and the write may take longer. Having an updated commit-graph file helps performance of many Git commands, including `git merge-base`, `git push -f`, and `git log --graph`. Defaults to false. + +fetch.updateHead:: + Defines when to update the remote HEAD symbolic ref. Values are 'never', + 'missing' (update only when HEAD is missing), and 'always'. diff --git a/Documentation/config/remote.txt b/Documentation/config/remote.txt index a8e6437a90..905661c7f7 100644 --- a/Documentation/config/remote.txt +++ b/Documentation/config/remote.txt @@ -84,3 +84,6 @@ remote.<name>.promisor:: remote.<name>.partialclonefilter:: The filter that will be applied when fetching from this promisor remote. + +remote.<name>.updateHead:: + Defines when to update the remote HEAD symbolic ref. See `fetch.updateHead`. diff --git a/builtin/fetch.c b/builtin/fetch.c index f9c3c49f14..b47b06f001 100644 --- a/builtin/fetch.c +++ b/builtin/fetch.c @@ -55,6 +55,8 @@ static int fetch_prune_tags_config = -1; /* unspecified */ static int prune_tags = -1; /* unspecified */ #define PRUNE_TAGS_BY_DEFAULT 0 /* do we prune tags by default? */ +static int fetch_update_head = FETCH_UPDATE_HEAD_DEFAULT; + static int all, append, dry_run, force, keep, multiple, update_head_ok; static int write_fetch_head = 1; static int verbosity, deepen_relative, set_upstream; @@ -120,6 +122,9 @@ static int git_fetch_config(const char *k, const char *v, void *cb) return 0; } + if (!strcmp(k, "fetch.updatehead")) + return parse_update_head(&fetch_update_head, k, v); + return git_default_config(k, v, cb); } @@ -1342,6 +1347,38 @@ static void backfill_tags(struct transport *transport, struct ref *ref_map) } } +static void update_head(int config, const struct ref *head, const struct remote *remote) +{ + struct strbuf ref = STRBUF_INIT, target = STRBUF_INIT; + const char *r, *head_name = NULL; + + if (!head || !head->symref || !remote) + return; + + strbuf_addf(&ref, "refs/remotes/%s/HEAD", remote->name); + skip_prefix(head->symref, "refs/heads/", &head_name); + strbuf_addf(&target, "refs/remotes/%s/%s", remote->name, head_name); + + r = refs_resolve_ref_unsafe(get_main_ref_store(the_repository), + ref.buf, RESOLVE_REF_READING, + NULL, NULL); + + if (r) { + if (config == FETCH_UPDATE_HEAD_MISSING) + /* already present */ + return; + else if (config == FETCH_UPDATE_HEAD_ALWAYS && !strcmp(r, target.buf)) + /* already up-to-date */ + return; + else + /* should never happen */ + return; + } + + if (create_symref(ref.buf, target.buf, "remote update head")) + warning(_("could not set remote head")); +} + static int do_fetch(struct transport *transport, struct refspec *rs) { @@ -1351,6 +1388,7 @@ static int do_fetch(struct transport *transport, const struct ref *remote_refs; struct strvec ref_prefixes = STRVEC_INIT; int must_list_refs = 1; + int need_update_head = 0, update_head_config = 0; if (tags == TAGS_DEFAULT) { if (transport->remote->fetch_tags == 2) @@ -1382,8 +1420,18 @@ static int do_fetch(struct transport *transport, break; } } - } else if (transport->remote && transport->remote->fetch.nr) + } else if (transport->remote && transport->remote->fetch.nr) { + if (transport->remote->update_head) + update_head_config = transport->remote->update_head; + else + update_head_config = fetch_update_head; + + need_update_head = update_head_config && update_head_config != FETCH_UPDATE_HEAD_NEVER; + + if (need_update_head) + strvec_push(&ref_prefixes, "HEAD"); refspec_ref_prefixes(&transport->remote->fetch, &ref_prefixes); + } if (tags == TAGS_SET || tags == TAGS_DEFAULT) { must_list_refs = 1; @@ -1427,6 +1475,9 @@ static int do_fetch(struct transport *transport, goto cleanup; } + if (need_update_head) + update_head(update_head_config, find_ref_by_name(remote_refs, "HEAD"), transport->remote); + if (set_upstream) { struct branch *branch = branch_get("HEAD"); struct ref *rm; diff --git a/remote.c b/remote.c index 8a6dbbb903..dad8062561 100644 --- a/remote.c +++ b/remote.c @@ -298,6 +298,25 @@ static void read_branches_file(struct remote *remote) remote->fetch_tags = 1; /* always auto-follow */ } +int parse_update_head(int *r, const char *var, const char *value) +{ + if (!r) + return -1; + else if (!value) + return config_error_nonbool(var); + else if (!strcmp(value, "never")) + *r = FETCH_UPDATE_HEAD_NEVER; + else if (!strcmp(value, "missing")) + *r = FETCH_UPDATE_HEAD_MISSING; + else if (!strcmp(value, "always")) + *r = FETCH_UPDATE_HEAD_ALWAYS; + else { + error(_("malformed value for %s: %s"), var, value); + return error(_("must be one of never, missing, or always")); + } + return 0; +} + static int handle_config(const char *key, const char *value, void *cb) { const char *name; @@ -418,6 +437,8 @@ static int handle_config(const char *key, const char *value, void *cb) key, value); } else if (!strcmp(subkey, "vcs")) { return git_config_string(&remote->foreign_vcs, key, value); + } else if (!strcmp(subkey, "updatehead")) { + return parse_update_head(&remote->update_head, key, value); } return 0; } diff --git a/remote.h b/remote.h index 3211abdf05..c16a2d7b2e 100644 --- a/remote.h +++ b/remote.h @@ -21,6 +21,13 @@ enum { REMOTE_BRANCHES }; +enum { + FETCH_UPDATE_HEAD_DEFAULT = 0, + FETCH_UPDATE_HEAD_NEVER, + FETCH_UPDATE_HEAD_MISSING, + FETCH_UPDATE_HEAD_ALWAYS, +}; + struct remote { struct hashmap_entry ent; @@ -62,6 +69,8 @@ struct remote { int prune; int prune_tags; + int update_head; + /** * The configured helper programs to run on the remote side, for * Git-native protocols. @@ -372,4 +381,6 @@ int parseopt_push_cas_option(const struct option *, const char *arg, int unset); int is_empty_cas(const struct push_cas_option *); void apply_push_cas(struct push_cas_option *, struct remote *, struct ref *); +int parse_update_head(int *r, const char *var, const char *value); + #endif -- 2.29.2
next reply other threads:[~2020-11-18 9:15 UTC|newest] Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top 2020-11-18 9:12 Felipe Contreras [this message] 2020-11-18 9:30 ` Ævar Arnfjörð Bjarmason 2020-11-18 9:43 ` Felipe Contreras 2020-11-18 15:53 ` Junio C Hamano 2020-11-18 19:04 ` Felipe Contreras 2020-11-20 23:52 ` Jeff King 2020-11-21 0:28 ` Junio C Hamano 2020-11-21 0:40 ` Jeff King 2020-11-21 1:18 ` Felipe Contreras 2020-11-24 6:58 ` Jeff King 2020-11-21 1:53 ` Felipe Contreras 2020-11-21 1:41 ` Felipe Contreras 2020-11-24 7:09 ` Jeff King
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style List information: http://vger.kernel.org/majordomo-info.html * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20201118091219.3341585-1-felipe.contreras@gmail.com \ --to=felipe.contreras@gmail.com \ --cc=dominik.salvet@gmail.com \ --cc=git@vger.kernel.org \ --cc=gitster@pobox.com \ --cc=jrnieder@gmail.com \ --cc=peff@peff.net \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: link
git@vger.kernel.org list mirror (unofficial, one of many) This inbox may be cloned and mirrored by anyone: git clone --mirror https://public-inbox.org/git git clone --mirror http://ou63pmih66umazou.onion/git git clone --mirror http://czquwvybam4bgbro.onion/git git clone --mirror http://hjrcffqmbrq6wope.onion/git # If you have public-inbox 1.1+ installed, you may # initialize and index your mirror using the following commands: public-inbox-init -V1 git git/ https://public-inbox.org/git \ git@vger.kernel.org public-inbox-index git Example config snippet for mirrors. Newsgroups are available over NNTP: nntp://news.public-inbox.org/inbox.comp.version-control.git nntp://ou63pmih66umazou.onion/inbox.comp.version-control.git nntp://czquwvybam4bgbro.onion/inbox.comp.version-control.git nntp://hjrcffqmbrq6wope.onion/inbox.comp.version-control.git nntp://news.gmane.io/gmane.comp.version-control.git note: .onion URLs require Tor: https://www.torproject.org/ code repositories for the project(s) associated with this inbox: https://80x24.org/mirrors/git.git AGPL code for this site: git clone https://public-inbox.org/public-inbox.git