clone: set fetch.bundleURI if appropriate
commit4074d3c7e1a3b44c5c02235799d798f8b2613333
authorDerrick Stolee <derrickstolee@github.com>
Tue, 31 Jan 2023 13:29:15 +0000 (31 13:29 +0000)
committerJunio C Hamano <gitster@pobox.com>
Tue, 31 Jan 2023 16:57:48 +0000 (31 08:57 -0800)
treedf8df4a1fc8a615c77f6ee63d429973f572f7cfc
parent7903efb7170ca9704e80ef9188bef37ecf55f2d6
clone: set fetch.bundleURI if appropriate

Bundle providers may organize their bundle lists in a way that is
intended to improve incremental fetches, not just initial clones.
However, they do need to state that they have organized with that in
mind, or else the client will not expect to save time by downloading
bundles after the initial clone. This is done by specifying a
bundle.heuristic value.

There are two types of bundle lists: those at a static URI and those
that are advertised from a Git remote over protocol v2.

The new fetch.bundleURI config value applies for static bundle URIs that
are not advertised over protocol v2. If the user specifies a static URI
via 'git clone --bundle-uri', then Git can set this config as a reminder
for future 'git fetch' operations to check the bundle list before
connecting to the remote(s).

For lists provided over protocol v2, we will want to take a different
approach and create a property of the remote itself by creating a
remote.<id>.* type config key. That is not implemented in this change.

Later changes will update 'git fetch' to consume this option.

Signed-off-by: Derrick Stolee <derrickstolee@github.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/config/fetch.txt
builtin/clone.c
bundle-uri.c
bundle-uri.h
t/t5558-clone-bundle-uri.sh