diff mbox series

refs: exit early from the loop if it is not a main worktree

Message ID pull.1848.git.git.1734488445457.gitgitgadget@gmail.com (mailing list archive)
State New
Headers show
Series refs: exit early from the loop if it is not a main worktree | expand

Commit Message

Seija Kijin Dec. 18, 2024, 2:20 a.m. UTC
From: Seija Kijin <doremylover123@gmail.com>

The is_main_worktree function just checks for !wt->id,
but the compiler doesn't know this as it is in a different
file, so just exit out early.

Signed-off-by: Seija Kijin <doremylover123@gmail.com>
---
    refs: exit early from the loop if it is not a main worktree
    
    The is_main_worktree function just checks for !wt->id, but the compiler
    doesn't know this as it is in a different file, so just exit out early.

Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-1848%2FAreaZR%2Fexit-early-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-1848/AreaZR/exit-early-v1
Pull-Request: https://github.com/git/git/pull/1848

 refs.c | 1 +
 1 file changed, 1 insertion(+)


base-commit: 063bcebf0c917140ca0e705cbe0fdea127e90086

Comments

shejialuo Dec. 18, 2024, 1:31 p.m. UTC | #1
On Wed, Dec 18, 2024 at 02:20:45AM +0000, AreaZR via GitGitGadget wrote:
> From: Seija Kijin <doremylover123@gmail.com>
> 
> The is_main_worktree function just checks for !wt->id,
> but the compiler doesn't know this as it is in a different
> file, so just exit out early.
> 

I think maybe we should exit out the loop early. However, the above
statement is confusing. As you have said, `is_main_worktree` checks
whether the `wt->id` is NULL. Why compiler doesn't know this? And why we
need to exit out the loop due to above reason?

> Signed-off-by: Seija Kijin <doremylover123@gmail.com>
> ---
>     refs: exit early from the loop if it is not a main worktree
>     
>     The is_main_worktree function just checks for !wt->id, but the compiler
>     doesn't know this as it is in a different file, so just exit out early.
> 
> Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-git-1848%2FAreaZR%2Fexit-early-v1
> Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-git-1848/AreaZR/exit-early-v1
> Pull-Request: https://github.com/git/git/pull/1848
> 
>  refs.c | 1 +
>  1 file changed, 1 insertion(+)
> 
> diff --git a/refs.c b/refs.c
> index 8b713692359..cce63a618d7 100644
> --- a/refs.c
> +++ b/refs.c
> @@ -2791,6 +2791,7 @@ static int has_worktrees(void)
>  		if (is_main_worktree(worktrees[i]))
>  			continue;
>  		ret = 1;
> +		break;

So, when we find a linked worktree, we just return the value. From my
perspective, if we decide to optimize like this way, we could drop the
loop because the first element of the result of `get_worktrees` is the
main worktree. And we could just check whether the "worktrees[1]" is
NULL to do above.

However, I don't know whether it's a good idea to exit the loop early
in the first place. CC Patrick to help.

Thanks,
Jialuo
Eric Sunshine Dec. 18, 2024, 11:52 p.m. UTC | #2
On Wed, Dec 18, 2024 at 8:30 AM shejialuo <shejialuo@gmail.com> wrote:
> On Wed, Dec 18, 2024 at 02:20:45AM +0000, AreaZR via GitGitGadget wrote:
> >               if (is_main_worktree(worktrees[i]))
> >                       continue;
> >               ret = 1;
> > +             break;
>
> So, when we find a linked worktree, we just return the value. From my
> perspective, if we decide to optimize like this way, we could drop the
> loop because the first element of the result of `get_worktrees` is the
> main worktree. And we could just check whether the "worktrees[1]" is
> NULL to do above.

You're correct. get_worktrees() guarantees that the main worktree (or
bare repository) is the first item in the list, so merely checking
whether `worktrees[1]` is non-NULL would be sufficient to answer
whether linked worktrees are present; no looping is required.

> However, I don't know whether it's a good idea to exit the loop early
> in the first place. CC Patrick to help.

If the loop is retained for some reason (though it really isn't
needed), then exiting early is indeed desirable. I suspect that the
missing `break` was just a silly oversight on Patrick's part.
Junio C Hamano Dec. 19, 2024, 1:10 a.m. UTC | #3
Eric Sunshine <sunshine@sunshineco.com> writes:

> On Wed, Dec 18, 2024 at 8:30 AM shejialuo <shejialuo@gmail.com> wrote:
>> On Wed, Dec 18, 2024 at 02:20:45AM +0000, AreaZR via GitGitGadget wrote:
>> >               if (is_main_worktree(worktrees[i]))
>> >                       continue;
>> >               ret = 1;
>> > +             break;
>>
>> So, when we find a linked worktree, we just return the value. From my
>> perspective, if we decide to optimize like this way, we could drop the
>> loop because the first element of the result of `get_worktrees` is the
>> main worktree. And we could just check whether the "worktrees[1]" is
>> NULL to do above.
>
> You're correct. get_worktrees() guarantees that the main worktree (or
> bare repository) is the first item in the list, so merely checking
> whether `worktrees[1]` is non-NULL would be sufficient to answer
> whether linked worktrees are present; no looping is required.

Thanks for a well-reasoned write-up.

Would many other callers potentially want to know if the repository
has more than one worktree?  It looks to me that the has_worktrees()
helper function in refs.c is a sign that the worktree API is missing
a function.  Calling get_worktrees() to prepare a list of worktrees
and then counting the result, only to see if there are more than
one, sounds a bit wasteful if we need to do so too often.
Eric Sunshine Dec. 19, 2024, 5:54 a.m. UTC | #4
On Wed, Dec 18, 2024 at 8:10 PM Junio C Hamano <gitster@pobox.com> wrote:
> Eric Sunshine <sunshine@sunshineco.com> writes:
> > On Wed, Dec 18, 2024 at 8:30 AM shejialuo <shejialuo@gmail.com> wrote:
> >> On Wed, Dec 18, 2024 at 02:20:45AM +0000, AreaZR via GitGitGadget wrote:
> >> >               if (is_main_worktree(worktrees[i]))
> >> >                       continue;
> >> >               ret = 1;
> >> > +             break;
> >>
> >> So, when we find a linked worktree, we just return the value. From my
> >> perspective, if we decide to optimize like this way, we could drop the
> >> loop because the first element of the result of `get_worktrees` is the
> >> main worktree. And we could just check whether the "worktrees[1]" is
> >> NULL to do above.
> >
> > You're correct. get_worktrees() guarantees that the main worktree (or
> > bare repository) is the first item in the list, so merely checking
> > whether `worktrees[1]` is non-NULL would be sufficient to answer
> > whether linked worktrees are present; no looping is required.
>
> Would many other callers potentially want to know if the repository
> has more than one worktree?  It looks to me that the has_worktrees()
> helper function in refs.c is a sign that the worktree API is missing
> a function.  Calling get_worktrees() to prepare a list of worktrees
> and then counting the result, only to see if there are more than
> one, sounds a bit wasteful if we need to do so too often.

If the need to answer this question does become common, then I can
imagine a function being added to the worktree API which tries to be
smart about it by only calling readdir() -- and validating a
.git/worktrees/<id>/ metainformation -- enough times to be able to
answer the question.

However, although I haven't audited the code, I suspect the question
"are there any linked worktrees" is rare, possibly only asked by
`refs.c`. And in that case, it is asked only at the start of a
refs-migration operation. Moreover, it appears that even that case of
asking the question is probably temporary, existing only until someone
extends the migration logic to work correctly in the presence of
worktrees. (I'm sure Patrick can shed more light on this, though.)
Junio C Hamano Dec. 19, 2024, 6:12 a.m. UTC | #5
Eric Sunshine <sunshine@sunshineco.com> writes:

> However, although I haven't audited the code, I suspect the question
> "are there any linked worktrees" is rare, possibly only asked by
> `refs.c`. And in that case, it is asked only at the start of a
> refs-migration operation.

That matches my gut feeling.  Thanks.
diff mbox series

Patch

diff --git a/refs.c b/refs.c
index 8b713692359..cce63a618d7 100644
--- a/refs.c
+++ b/refs.c
@@ -2791,6 +2791,7 @@  static int has_worktrees(void)
 		if (is_main_worktree(worktrees[i]))
 			continue;
 		ret = 1;
+		break;
 	}
 
 	free_worktrees(worktrees);