Michael Haggerty <mhagger@xxxxxxxxxxxx> writes:
> There are two meanings of the concept of a "ref store", and I think this
> change muddles them:
>
> 1. The references that happen to be *physically* stored in a particular
> location, for example the `refs/bisect/*` references in a worktree.
>
> 2. The references that *logically* should be considered part of a
> particular repository. This might require stitching together
> references from multiple sources, for example `HEAD` and
> `refs/bisect` from a worktree's own directory with other
> references from the main repository.
>
> Either of these concepts can be implemented via the `ref_store` abstraction.
> ...
> The `ref_store` that you want here for a worktree is not the worktree's
> *logical* `ref_store`. You want the worktree's *physical* `ref_store`.
> Mixing logical and physical reference stores together is a bad idea
> (even if we were willing to ignore the fact that worktrees are not
> submodules in the accepted sense of the word).
I am not quite sure what mental model you are suggesting as a
preferred solution. We can
- represent a set of refs stored for a particular worktree
(i.e. HEAD, refs/bisect, and refs/worktree/<name>, iirc), as
bunch of ref_stores;
- represent a set of refs shared across a set of worktrees that
share the primary one, as another ref_store;
- a caller who wants to get a "logical" view of a single worktree
user can pick one of the first kind and union that with the
second one, and represent the result as a (synthetic) ref_store.
The third one is "stitching together from multiple sources". By
"mixing logical and physical is a bad idea", do you mean that the
same abstraction "ref_store" should not be used for the first two
(which are physical) and the third one (which is logical)? Do you
want to call the first two "physical_ref_store"and the last one
"ref_store" and keep them distinct?
For the purpose of anchoring objects in the object store shared by
multiple worktrees, we can either iterate over all the ref_stores
of the first two kind, or iterate over all the ref_stores of the
third kind for all worktrees. The latter of course is less
efficient as the enumeration
for worktree in all worktrees:
for ref in get_ref_store(worktree)
mark tip of ref reachable
will work on all the shared refs multiple times, but as an
abstraction that may be simpler. The alternative of working at the
physical level would be more efficient
for worktree in all worktrees:
for ref in get_ref_store_specific_to_worktree(worktree):
mark tip of ref reachable
for ref in get_ref_store_shared_across_worktrees():
mark tip of ref reachable
but this consumer now _knows_ how the logical ref_store of a
worktree is constructed (i.e. by combining the two ref_stores),
which appears as a layering violation.
I am however not sure if these issues are what you are driving at,
and what exact design you are suggesting.