Re: [PATCH 1/2] fetch-object: provide only one fetching function
- Date: Wed, 12 Sep 2018 14:50:38 -0700
- From: Junio C Hamano <gitster@xxxxxxxxx>
- Subject: Re: [PATCH 1/2] fetch-object: provide only one fetching function
Jonathan Tan <jonathantanmy@xxxxxxxxxx> writes:
> fetch-object.h currently provides two functions (fetch_object() and
> fetch_objects()) that could be replaced by a single, more flexible
> function. Replace those two functions with the more flexible function.
The latter half of the first sentence and the second sentence are
pretty-much repeating the same thing.
I think you wanted to justify two changes:
(1) There are two helpers. fetch_object() fetches a single object
from a given remote; fetch_objects() fetches a set of objects
from a given remote. It is not like the former is implemented
as a specialization of the latter (i.e. passing length=1
array), and it is not like the former is optimized specially
for a single object fetch that cannot be made into such a thin
wrapper. It is not like the latter is implemented as a
repeated call to the former in a loop, either. There is no
justification to keep two independent implementations, and
using a single helper that can be used by all the callers of
these two would make sense.
(2) The variant that fetches multiple objects takes oid_array. To
be used by all the existing callers of these two helpers, it is
better to use a different calling convention, namely, a array
and its length passed as separate parameters.
Instead of explaining why the new convention is better to justify
(2), the above three lines handwave by saying "more flexible"
twice. We should do better.
fetch-object: unify fetch_object[s] functions
There are fetch_object() and fetch_objects() helpers in
fetch-object.h; as the latter takes "struct oid_array",
the former cannot be made into a thin wrapper around the
latter without an extra allocation and set-up cost.
Update fetch_objects() to take an array of "struct
object_id" and number of elements in it as separate
parameters, remove fetch_object(), and adjust all existing
callers of these functions to use the new fetch_objects().
> diff --git a/sha1-file.c b/sha1-file.c
> index 97b742384..2edf4564f 100644
> --- a/sha1-file.c
> +++ b/sha1-file.c
> @@ -1317,7 +1317,7 @@ int oid_object_info_extended(struct repository *r, const struct object_id *oid,
> * TODO Pass a repository struct through fetch_object,
> * such that arbitrary repositories work.
> - fetch_object(repository_format_partial_clone, real->hash);
> + fetch_objects(repository_format_partial_clone, real, 1);
> already_retried = 1;
> diff --git a/unpack-trees.c b/unpack-trees.c
> index f25089b87..82a83dbc6 100644
> --- a/unpack-trees.c
> +++ b/unpack-trees.c
> @@ -392,7 +392,7 @@ static int check_updates(struct unpack_trees_options *o)
> if (to_fetch.nr)
> - &to_fetch);
> + to_fetch.oid, to_fetch.nr);
> fetch_if_missing = fetch_if_missing_store;
Changes to these two callers do explain why <ptr, nr> is an
interface that is easier to use. Those who already have an
oid_array can pass its fields as separate parameters without too
much trouble, and those who only have an oid (or an array of oid and
knows how many are in the array) do not have to wrap them into an