Re: [PATCH v2 2/3] sparse-index: add ensure_correct_sparsity function
- From
Victoria Dye <vdye@github.com>
- Date
- Oct 27, 2021, 17:21 UTC
- Message-ID
- <a9ce8fa1-287e-56ef-4096-1492cceff3fc@github.com>
- In-Reply-To
- <xmqqy26mhvel.fsf@gitster.g>
Junio C Hamano wrote:
Show 37 quoted lines
> "Victoria Dye via GitGitGadget" <gitgitgadget@gmail.com> writes:
> >> @@ -313,6 +336,19 @@ void ensure_full_index(struct index_state *istate)
>> trace2_region_leave("index", "ensure_full_index", istate->repo);
>> }
>>
>> +void ensure_correct_sparsity(struct index_state *istate)
>> +{
>> + /*
>> + * First check whether the index can be converted to sparse by attempting
>> + * to convert it with the SPARSE_INDEX_VERIFY_ALLOWED flag. If the
>> + * SPARSE_INDEX_VERIFY_ALLOWED checks indicate that the index cannot
>> + * be converted because repository settings and/or index properties
>> + * do not allow it, expand the index to full.
>> + */
>
> The logic may be OK, but the need to give this long description is a
> sign that the meaning of the value returned from the function is not
> clear from the name of the function.
>
>> + if (convert_to_sparse(istate, SPARSE_INDEX_VERIFY_ALLOWED))
>> + ensure_full_index(istate);
>
> It might make it more straight-forward to
>
> (1) drop the "if (verify)" part in convert_to_sparse(), which would
> mean that for all callers convert_to_sparse() will retain the
> same behaviour as before;
>
> (2) make a call to can_convert_to_sparse() here, and if that
> returns true, make a call to ensure_full_index(); this would
> behave identically to what this patch does when can_convert is
> false; and
>
> (3) correct the can_convert_to_sparse() function to not blow away
> the cache_tree unconditionally and recompute, so that calling
> it twice in a row will not be costly.
> Agreed, this approach is a lot easier to follow. I went a bit overboard trying to handle *all* possible cases where `convert_to_sparse` returns before converting, but the primary goal of this series is updating the behavior when config settings change. I'll include the suggested restructuring in my next re-roll. Thanks!