threads / patch / 54662

patcht1309: use a non-loaded branch name in the `onbranch` test cases

Subject: [PATCH] t1309: use a non-loaded branch name in the `onbranch` test cases

## tl;dr

6 messages between Nov 18, 2020 and Nov 19, 2020. Diffs are folded; open one to read it.

replies: 5people: 2as markdown or json

Johannes Schindelin via GitGitGadget· Nov 18, 2020, 14:23 UTC · lore
From: Johannes Schindelin <johannes.schindelin@gmx.de>

The `onbranch` test cases in question do not actually want to include anything; Instead, they want to verify that the `onbranch` code path does not regress in the early-config case or in the non-Git case, where the `onbranch` include is actually ignored.

Therefore, the actual branch name does not matter at all. We might just as well avoid racially-charged names here.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
    t1309: use a non-loaded branch name in the onbranch test cases
    
    Just something I stumbled over while working on 
    https://github.com/gitgitgadget/git/pull/762.
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-791%2Fdscho%2Ft1309-onbranch-tests-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-791/dscho/t1309-onbranch-tests-v1
Pull-Request: https://github.com/gitgitgadget/git/pull/791
 t/t1309-early-config.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Show changes to t/t1309-early-config.sh +2 −2
diff --git a/t/t1309-early-config.sh b/t/t1309-early-config.sh
index ebb8e1aecb..b4a9158307 100755
--- a/t/t1309-early-config.sh
+++ b/t/t1309-early-config.sh
@@ -91,11 +91,11 @@ test_expect_failure 'ignore .git/ with invalid config' '
 
 test_expect_success 'early config and onbranch' '
 	echo "[broken" >broken &&
-	test_with_config "[includeif \"onbranch:master\"]path=../broken"
+	test_with_config "[includeif \"onbranch:topic\"]path=../broken"
 '
 
 test_expect_success 'onbranch config outside of git repo' '
-	test_config_global includeIf.onbranch:master.path non-existent &&
+	test_config_global includeIf.onbranch:topic.path non-existent &&
 	nongit git help
 '
 

base-commit: e31aba42fb12bdeb0f850829e008e1e3f43af500
-- 
gitgitgadget
Ævar Arnfjörð Bjarmason· Nov 18, 2020, 14:52 UTC · re: Johannes Schindelin via GitGitGadget · lore

Re: [PATCH] t1309: use a non-loaded branch name in the `onbranch` test cases

On Wed, Nov 18 2020, Johannes Schindelin via GitGitGadget wrote:
Show 6 quoted lines
> From: Johannes Schindelin <johannes.schindelin@gmx.de>
>
> The `onbranch` test cases in question do not actually want to include
> anything; Instead, they want to verify that the `onbranch` code path
> does not regress in the early-config case or in the non-Git case, where
> the `onbranch` include is actually ignored.
It's unclear to me what this patch is for & why it's needed.

Yesterday in your v2 27/27 series you sent a different one that changed this from s/master/main/g: https://lore.kernel.org/git/b8fa037791683b50c3efb01aa6ac0d3f7b888a2b.1605629548.git.gitgitgadget@gmail.com/

That's on top of "next", but this one is on "master", the two would conflict, and the 02/27 one seems like the right thing to do.

> Therefore, the actual branch name does not matter at all. We might just
> as well avoid racially-charged names here.

It seems to me the actual name matters a lot, and it must whatever the default branch name is.

I.e. what the test is doing is producing intentionally broken config, and asserting that we don't read it at an early stage.

Therefore if we regressed and started doing that the test wouldn't catch it, because the default branch name is "master", or "main" if/when that refs.c change lands, neither of which is "topic".

Maybe I'm missing something but it seems 58ebccb478 ("t1309: use short branch name in includeIf.onbranch test", 2019-08-06) and your own 85fe0e800c ("config: work around bug with includeif:onbranch and early config", 2019-07-31) which added the test support reading.

Show 34 quoted lines
> Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
> ---
>     t1309: use a non-loaded branch name in the onbranch test cases
>     
>     Just something I stumbled over while working on 
>     https://github.com/gitgitgadget/git/pull/762.
>
> Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-791%2Fdscho%2Ft1309-onbranch-tests-v1
> Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-791/dscho/t1309-onbranch-tests-v1
> Pull-Request: https://github.com/gitgitgadget/git/pull/791
>
>  t/t1309-early-config.sh | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/t/t1309-early-config.sh b/t/t1309-early-config.sh
> index ebb8e1aecb..b4a9158307 100755
> --- a/t/t1309-early-config.sh
> +++ b/t/t1309-early-config.sh
> @@ -91,11 +91,11 @@ test_expect_failure 'ignore .git/ with invalid config' '
>  
>  test_expect_success 'early config and onbranch' '
>  	echo "[broken" >broken &&
> -	test_with_config "[includeif \"onbranch:master\"]path=../broken"
> +	test_with_config "[includeif \"onbranch:topic\"]path=../broken"
>  '
>  
>  test_expect_success 'onbranch config outside of git repo' '
> -	test_config_global includeIf.onbranch:master.path non-existent &&
> +	test_config_global includeIf.onbranch:topic.path non-existent &&
>  	nongit git help
>  '
>  
>
> base-commit: e31aba42fb12bdeb0f850829e008e1e3f43af500
Johannes Schindelin· Nov 19, 2020, 00:24 UTC · re: Ævar Arnfjörð Bjarmason · lore

Re: [PATCH] t1309: use a non-loaded branch name in the `onbranch` test cases

Hi Ævar,
On Wed, 18 Nov 2020, Ævar Arnfjörð Bjarmason wrote:
Show 10 quoted lines
> On Wed, Nov 18 2020, Johannes Schindelin via GitGitGadget wrote:
>
> > From: Johannes Schindelin <johannes.schindelin@gmx.de>
> >
> > The `onbranch` test cases in question do not actually want to include
> > anything; Instead, they want to verify that the `onbranch` code path
> > does not regress in the early-config case or in the non-Git case, where
> > the `onbranch` include is actually ignored.
>
> It's unclear to me what this patch is for & why it's needed.

Well, the entire idea of switching to a new default branch name is to avoid using words that we know cause undue emotional harm. In the grand scheme, therefore, I want to avoid having any mention of such words in our test suite.

Show 6 quoted lines
> Yesterday in your v2 27/27 series you sent a different one that changed
> this from s/master/main/g:
> https://lore.kernel.org/git/b8fa037791683b50c3efb01aa6ac0d3f7b888a2b.1605629548.git.gitgitgadget@gmail.com/
>
> That's on top of "next", but this one is on "master", the two would
> conflict, and the 02/27 one seems like the right thing to do.

Yeah, I hadn't made it clear yet at the time you wrote this that my intention was to give in to your and Junio's suggestion to restrict the `GIT_TEST_DEFAULT_INITIAL_BRANCH_NAME` assignments to _just_ the test scripts that don't work with arbitrary default branch names.

I had hoped that mentioning gitgitgadget PR 762 (which is that 27-strong patch series) would be indicator enough that I was in the process of revamping it into a v3, and that this here patch is one part that I separated out into its own patch.

Show 5 quoted lines
> > Therefore, the actual branch name does not matter at all. We might just
> > as well avoid racially-charged names here.
>
> It seems to me the actual name matters a lot, and it must whatever the
> default branch name is.

Nope. Not at all. Because what we're exercising is the code paths when we _don't_ have a branch name to work with.

In the non-Git case, this is trivial to see. There is not even a repository! How can there be a branch?

In the early config case, it is too early to access the refs. I meant to reference (but forgot) the commit 85fe0e800ca (config: work around bug with includeif:onbranch and early config, 2019-07-31) because that commit's commit message describes the catch-22 that is the reason why the early config cannot see the current branch name (if any).

I should probably have thought of referencing 22932d9169f (config: stop checking whether the_repository is NULL, 2019-08-06) for the second test case, too.

So again, these two test cases do _not_ exercise the code path where another config file is included. To the contrary, they try to prevent a regression where `onbranch` would segfault in one case, and BUG in the other (in both cases because the now-fixed code used to try to look at the current branch name _anyway_).

Show 6 quoted lines
> I.e. what the test is doing is producing intentionally broken config,
> and asserting that we don't read it at an early stage.
>
> Therefore if we regressed and started doing that the test wouldn't catch
> it, because the default branch name is "master", or "main" if/when that
> refs.c change lands, neither of which is "topic".

No, if we regressed, the code would start to throw a BUG, or a segfault, respectively.

We never expect these two test cases to look at any branch name at all.

Ciao, Dscho

Show 43 quoted lines
> Maybe I'm missing something but it seems 58ebccb478 ("t1309: use short
> branch name in includeIf.onbranch test", 2019-08-06) and your own
> 85fe0e800c ("config: work around bug with includeif:onbranch and early
> config", 2019-07-31) which added the test support reading.
>
>
> > Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
> > ---
> >     t1309: use a non-loaded branch name in the onbranch test cases
> >
> >     Just something I stumbled over while working on
> >     https://github.com/gitgitgadget/git/pull/762.
> >
> > Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-791%2Fdscho%2Ft1309-onbranch-tests-v1
> > Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-791/dscho/t1309-onbranch-tests-v1
> > Pull-Request: https://github.com/gitgitgadget/git/pull/791
> >
> >  t/t1309-early-config.sh | 4 ++--
> >  1 file changed, 2 insertions(+), 2 deletions(-)
> >
> > diff --git a/t/t1309-early-config.sh b/t/t1309-early-config.sh
> > index ebb8e1aecb..b4a9158307 100755
> > --- a/t/t1309-early-config.sh
> > +++ b/t/t1309-early-config.sh
> > @@ -91,11 +91,11 @@ test_expect_failure 'ignore .git/ with invalid config' '
> >
> >  test_expect_success 'early config and onbranch' '
> >  	echo "[broken" >broken &&
> > -	test_with_config "[includeif \"onbranch:master\"]path=../broken"
> > +	test_with_config "[includeif \"onbranch:topic\"]path=../broken"
> >  '
> >
> >  test_expect_success 'onbranch config outside of git repo' '
> > -	test_config_global includeIf.onbranch:master.path non-existent &&
> > +	test_config_global includeIf.onbranch:topic.path non-existent &&
> >  	nongit git help
> >  '
> >
> >
> > base-commit: e31aba42fb12bdeb0f850829e008e1e3f43af500
>
>
>
Ævar Arnfjörð Bjarmason· Nov 19, 2020, 07:35 UTC · re: Johannes Schindelin · lore

Re: [PATCH] t1309: use a non-loaded branch name in the `onbranch` test cases

On Thu, Nov 19 2020, Johannes Schindelin wrote:
Show 19 quoted lines
> Hi Ævar,
>
> On Wed, 18 Nov 2020, Ævar Arnfjörð Bjarmason wrote:
>
>> On Wed, Nov 18 2020, Johannes Schindelin via GitGitGadget wrote:
>>
>> > From: Johannes Schindelin <johannes.schindelin@gmx.de>
>> >
>> > The `onbranch` test cases in question do not actually want to include
>> > anything; Instead, they want to verify that the `onbranch` code path
>> > does not regress in the early-config case or in the non-Git case, where
>> > the `onbranch` include is actually ignored.
>>
>> It's unclear to me what this patch is for & why it's needed.
>
> Well, the entire idea of switching to a new default branch name is to
> avoid using words that we know cause undue emotional harm. In the grand
> scheme, therefore, I want to avoid having any mention of such words in our
> test suite.

I meant why there were two conflicting patches on-list that changed the same hunks in different ways, both of which resulted in passing tests and seemingly fulfilled the goal you're noting here.

Later you sent a v3 of the main series, which clarified this question: https://public-inbox.org/git/pull.762.v3.git.1605743086.gitgitgadget@gmail.com/

Show 56 quoted lines
>> Yesterday in your v2 27/27 series you sent a different one that changed
>> this from s/master/main/g:
>> https://lore.kernel.org/git/b8fa037791683b50c3efb01aa6ac0d3f7b888a2b.1605629548.git.gitgitgadget@gmail.com/
>>
>> That's on top of "next", but this one is on "master", the two would
>> conflict, and the 02/27 one seems like the right thing to do.
>
> Yeah, I hadn't made it clear yet at the time you wrote this that my
> intention was to give in to your and Junio's suggestion to restrict the
> `GIT_TEST_DEFAULT_INITIAL_BRANCH_NAME` assignments to _just_ the test
> scripts that don't work with arbitrary default branch names.
>
> I had hoped that mentioning gitgitgadget PR 762 (which is that 27-strong
> patch series) would be indicator enough that I was in the process of
> revamping it into a v3, and that this here patch is one part that I
> separated out into its own patch.
>
>> > Therefore, the actual branch name does not matter at all. We might just
>> > as well avoid racially-charged names here.
>>
>> It seems to me the actual name matters a lot, and it must whatever the
>> default branch name is.
>
> Nope. Not at all. Because what we're exercising is the code paths when we
> _don't_ have a branch name to work with.
>
> In the non-Git case, this is trivial to see. There is not even a
> repository! How can there be a branch?
>
> In the early config case, it is too early to access the refs. I meant to
> reference (but forgot) the commit 85fe0e800ca (config: work around bug
> with includeif:onbranch and early config, 2019-07-31) because that
> commit's commit message describes the catch-22 that is the reason why the
> early config cannot see the current branch name (if any).
>
> I should probably have thought of referencing 22932d9169f (config: stop
> checking whether the_repository is NULL, 2019-08-06) for the second test
> case, too.
>
> So again, these two test cases do _not_ exercise the code path where
> another config file is included. To the contrary, they try to prevent a
> regression where `onbranch` would segfault in one case, and BUG in the
> other (in both cases because the now-fixed code used to try to look at the
> current branch name _anyway_).
>
>> I.e. what the test is doing is producing intentionally broken config,
>> and asserting that we don't read it at an early stage.
>>
>> Therefore if we regressed and started doing that the test wouldn't catch
>> it, because the default branch name is "master", or "main" if/when that
>> refs.c change lands, neither of which is "topic".
>
> No, if we regressed, the code would start to throw a BUG, or a segfault,
> respectively.
>
> We never expect these two test cases to look at any branch name at all.
Thanks. I mis(understood|read) it.
Johannes Schindelin· Nov 19, 2020, 10:49 UTC · re: Ævar Arnfjörð Bjarmason · lore

Re: [PATCH] t1309: use a non-loaded branch name in the `onbranch` test cases

Hi Ævar,
On Thu, 19 Nov 2020, Ævar Arnfjörð Bjarmason wrote:
Show 50 quoted lines
> On Thu, Nov 19 2020, Johannes Schindelin wrote:
>
> > On Wed, 18 Nov 2020, Ævar Arnfjörð Bjarmason wrote:
> >
> >> On Wed, Nov 18 2020, Johannes Schindelin via GitGitGadget wrote:
> >>
> >> > From: Johannes Schindelin <johannes.schindelin@gmx.de>
> >> >
> >> > Therefore, the actual branch name does not matter at all. We might
> >> > just as well avoid racially-charged names here.
> >>
> >> It seems to me the actual name matters a lot, and it must whatever
> >> the default branch name is.
> >
> > Nope. Not at all. Because what we're exercising is the code paths when
> > we _don't_ have a branch name to work with.
> >
> > In the non-Git case, this is trivial to see. There is not even a
> > repository! How can there be a branch?
> >
> > In the early config case, it is too early to access the refs. I meant
> > to reference (but forgot) the commit 85fe0e800ca (config: work around
> > bug with includeif:onbranch and early config, 2019-07-31) because that
> > commit's commit message describes the catch-22 that is the reason why
> > the early config cannot see the current branch name (if any).
> >
> > I should probably have thought of referencing 22932d9169f (config:
> > stop checking whether the_repository is NULL, 2019-08-06) for the
> > second test case, too.
> >
> > So again, these two test cases do _not_ exercise the code path where
> > another config file is included. To the contrary, they try to prevent
> > a regression where `onbranch` would segfault in one case, and BUG in
> > the other (in both cases because the now-fixed code used to try to
> > look at the current branch name _anyway_).
> >
> >> I.e. what the test is doing is producing intentionally broken config,
> >> and asserting that we don't read it at an early stage.
> >>
> >> Therefore if we regressed and started doing that the test wouldn't
> >> catch it, because the default branch name is "master", or "main"
> >> if/when that refs.c change lands, neither of which is "topic".
> >
> > No, if we regressed, the code would start to throw a BUG, or a
> > segfault, respectively.
> >
> > We never expect these two test cases to look at any branch name at
> > all.
>
> Thanks. I mis(understood|read) it.
I guess the commit message could use an update.

Ciao, Dscho

Johannes Schindelin via GitGitGadget· Nov 19, 2020, 11:41 UTC · re: Johannes Schindelin via GitGitGadget · lore

[PATCH v2] t1309: use a neutral branch name in the `onbranch` test cases

From: Johannes Schindelin <johannes.schindelin@gmx.de>

The `onbranch` test cases touched by this patch do not actually try to include any other config. Their purpose is to avoid regressing on two bugs in the `include.onbranch:<name>.path` code that we fixed in the past, bugs that are actually unrelated to any concrete branch name.

The first bug was fixed in 85fe0e800ca (config: work around bug with includeif:onbranch and early config, 2019-07-31). Essentially, when reading early config, there would be a catch-22 trying to access the refs, and therefore we simply cannot evaluate the condition at that point. The test case ensures that we avoid emitting this bogus message:

	BUG: refs.c:1851: attempting to get main_ref_store outside of repository

The second test case concerns the non-Git scenario, where we simply do not have a current branch to begin with (because we don't have a repository in the first place), and the test case was introduced in 22932d9169f (config: stop checking whether the_repository is NULL, 2019-08-06) to ensure that we don't cause a segmentation fault should the code still incorrectly try to look at any ref.

In short, neither of these two test cases will ever look at a current branch name, even in case of regressions. Therefore, the actual branch name does not matter at all. We can therefore easily avoid racially-charged branch names here, and that's what this patch does.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
---
    t1309: use a non-loaded branch name in the onbranch test cases
    
    Just something I stumbled over while working on 
    https://github.com/gitgitgadget/git/pull/762.
    
    Changes since v1:
    
     * The commit message was obviously not clear at all, which has been
       addressed.
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-791%2Fdscho%2Ft1309-onbranch-tests-v2
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-791/dscho/t1309-onbranch-tests-v2
Pull-Request: https://github.com/gitgitgadget/git/pull/791
Range-diff vs v1:
 1:  c78ddaf9ad ! 1:  7897650556 t1309: use a non-loaded branch name in the `onbranch` test cases
     @@ Metadata
      Author: Johannes Schindelin <Johannes.Schindelin@gmx.de>
      
       ## Commit message ##
     -    t1309: use a non-loaded branch name in the `onbranch` test cases
     +    t1309: use a neutral branch name in the `onbranch` test cases
      
     -    The `onbranch` test cases in question do not actually want to include
     -    anything; Instead, they want to verify that the `onbranch` code path
     -    does not regress in the early-config case or in the non-Git case, where
     -    the `onbranch` include is actually ignored.
     +    The `onbranch` test cases touched by this patch do not actually try to
     +    include any other config. Their purpose is to avoid regressing on two
     +    bugs in the `include.onbranch:<name>.path` code that we fixed in the
     +    past, bugs that are actually unrelated to any concrete branch name.
      
     -    Therefore, the actual branch name does not matter at all. We might just
     -    as well avoid racially-charged names here.
     +    The first bug was fixed in 85fe0e800ca (config: work around bug with
     +    includeif:onbranch and early config, 2019-07-31). Essentially, when
     +    reading early config, there would be a catch-22 trying to access the
     +    refs, and therefore we simply cannot evaluate the condition at that
     +    point. The test case ensures that we avoid emitting this bogus message:
     +
     +            BUG: refs.c:1851: attempting to get main_ref_store outside of repository
     +
     +    The second test case concerns the non-Git scenario, where we simply do
     +    not have a current branch to begin with (because we don't have a
     +    repository in the first place), and the test case was introduced in
     +    22932d9169f (config: stop checking whether the_repository is NULL,
     +    2019-08-06) to ensure that we don't cause a segmentation fault should
     +    the code still incorrectly try to look at any ref.
     +
     +    In short, neither of these two test cases will ever look at a current
     +    branch name, even in case of regressions. Therefore, the actual branch
     +    name does not matter at all. We can therefore easily avoid
     +    racially-charged branch names here, and that's what this patch does.
      
          Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
      
 t/t1309-early-config.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Show changes to t/t1309-early-config.sh +2 −2
diff --git a/t/t1309-early-config.sh b/t/t1309-early-config.sh
index ebb8e1aecb..b4a9158307 100755
--- a/t/t1309-early-config.sh
+++ b/t/t1309-early-config.sh
@@ -91,11 +91,11 @@ test_expect_failure 'ignore .git/ with invalid config' '
 
 test_expect_success 'early config and onbranch' '
 	echo "[broken" >broken &&
-	test_with_config "[includeif \"onbranch:master\"]path=../broken"
+	test_with_config "[includeif \"onbranch:topic\"]path=../broken"
 '
 
 test_expect_success 'onbranch config outside of git repo' '
-	test_config_global includeIf.onbranch:master.path non-existent &&
+	test_config_global includeIf.onbranch:topic.path non-existent &&
 	nongit git help
 '
 

base-commit: e31aba42fb12bdeb0f850829e008e1e3f43af500
-- 
gitgitgadget

← back to recent threads