# [Outreachy] Question about check-ref-format test coverage

5 messages from 2026-10-23 to 2026-10-24. Participants: Fien Dora, Harald Nordgren, Phillip Wood.
Thread: https://gitlist.dev/t/66645

## Fien Dora, 2026-10-23 15:29

Subject: [Outreachy] Question about check-ref-format test coverage
Message-ID: <CACWAS-X4BqnMa8iJKTakF5E=zYkkyr=qsQ-=c3bxoAJ+Kpcfiw@mail.gmail.com>
URL: https://gitlist.dev/e/CACWAS-X4BqnMa8iJKTakF5E%3DzYkkyr%3DqsQ-%3Dc3bxoAJ%2BKpcfiw%40mail.gmail.com

```
Hello Everyone,
I'm called Fien Dora and outreachy applicant for the December 2026
Cohort. I'm interested in the git project "Improve how command
arguments and options are scanned and parsed."
I'm new to open source generally but i'm ready to learn and contribute

I've been getting familiar with the git codebase, I've successfully
cloned and built Git from the source on my Mac, ran the
parse-options(96 test) and check-ref-format tests (107 tests), all
passed.

While I was exploring builtin/check-ref-format.c, I noticed that Git
supports --allow-onelevel and --no-allow-onelevel, but I couldn't find
any tests of --no-allow-onelevel in the t/ directory.

i tried running

./git check-ref-format --allow-onelevel foo

./git check-ref-format --allow-onelevel --no-allow-onelevel foo


it returned with an exit code of 0 and 1 respectively.


I've also gone through the list archives and saw an earlier outreachy
work converting check-ref-format to use parse-options.


Would adding tests for --allow-onelevel, particularly how it works
with --no-allow-onelevel be a good contribution for my Outreachy
microproject?

I look forward for any guidance


```

## Harald Nordgren, 2026-10-23 15:53

Subject: Re: [Outreachy] Question about check-ref-format test coverage
Message-ID: <CAHwyqnXEC7cFijGWATqfA+fBcn09UoNPBDA17GYEY4P8mS0fWA@mail.gmail.com>
URL: https://gitlist.dev/e/CAHwyqnXEC7cFijGWATqfA%2BfBcn09UoNPBDA17GYEY4P8mS0fWA%40mail.gmail.com
In-Reply-To: <CACWAS-X4BqnMa8iJKTakF5E=zYkkyr=qsQ-=c3bxoAJ+Kpcfiw@mail.gmail.com>

```
> i tried running
>
> ./git check-ref-format --allow-onelevel foo
>
> ./git check-ref-format --allow-onelevel --no-allow-onelevel foo
>
>
> it returned with an exit code of 0 and 1 respectively.

`--allow-onelevel´ and ´--no-allow-onelevel´ are contradictory
options, and shouldn't be run together, so that's likely why it failed
with exit code 1.

This is true for any `--xyz´ and ´--no-xyz´ options.


Harald


```

## Phillip Wood, 2026-10-24 09:48

Subject: Re: [Outreachy] Question about check-ref-format test coverage
Message-ID: <2907524c-4869-4280-949b-e6fb930e57b2@gmail.com>
URL: https://gitlist.dev/e/2907524c-4869-4280-949b-e6fb930e57b2%40gmail.com
In-Reply-To: <CACWAS-X4BqnMa8iJKTakF5E=zYkkyr=qsQ-=c3bxoAJ+Kpcfiw@mail.gmail.com>

```
Hi Fien

On 23/10/2026 16:29, Fien Dora wrote:
> Hello Everyone,
> I'm called Fien Dora and outreachy applicant for the December 2026
> Cohort. I'm interested in the git project "Improve how command
> arguments and options are scanned and parsed."
> I'm new to open source generally but i'm ready to learn and contribute
> > I've been getting familiar with the git codebase, I've successfully
> cloned and built Git from the source on my Mac, ran the
> parse-options(96 test) and check-ref-format tests (107 tests), all
> passed.

That's good

> While I was exploring builtin/check-ref-format.c, I noticed that Git
> supports --allow-onelevel and --no-allow-onelevel, but I couldn't find
> any tests of --no-allow-onelevel in the t/ directory.

Yes, "git grep -e --no-allow-onelevel" shows we don't have any tests for that, adding one would be useful.

> i tried running
> > ./git check-ref-format --allow-onelevel foo
> > ./git check-ref-format --allow-onelevel --no-allow-onelevel foo
> > it returned with an exit code of 0 and 1 respectively.

That's expected because --no-allow-onelevel comes later on the command line it overrides --allow-onelevel and so we exit 1 because the ref does not contain a '/' character.

> I've also gone through the list archives and saw an earlier outreachy
> work converting check-ref-format to use parse-options.

It's great that you've checked the archives, be sure to bear in mind the feedback that was given when you're writing your patch.
> Would adding tests for --allow-onelevel, particularly how it works
> with --no-allow-onelevel be a good contribution for my Outreachy
> microproject?

It sounds like a useful project to me, it is small and self contained and improves our codebase.

Thanks

Phillip



```

## Phillip Wood, 2026-10-24 09:52

Subject: Re: [Outreachy] Question about check-ref-format test coverage
Message-ID: <bd00b525-6e05-4c17-91ef-3d9c80ff2784@gmail.com>
URL: https://gitlist.dev/e/bd00b525-6e05-4c17-91ef-3d9c80ff2784%40gmail.com
In-Reply-To: <CAHwyqnXEC7cFijGWATqfA+fBcn09UoNPBDA17GYEY4P8mS0fWA@mail.gmail.com>

```
On 23/10/2026 16:53, Harald Nordgren wrote:
>>
>> ./git check-ref-format --allow-onelevel foo
>>
>> ./git check-ref-format --allow-onelevel --no-allow-onelevel foo
>>
>> it returned with an exit code of 0 and 1 respectively.
> > `--allow-onelevel´ and ´--no-allow-onelevel´ are contradictory
> options, and shouldn't be run together, so that's likely why it failed
> with exit code 1.
>
> This is true for any `--xyz´ and ´--no-xyz´ options.

Our commands allow "--no-xyz" to override "--xyz" which is useful when an alias includes "--xyz" and you want to use the alias without that option. The second command above exits 1 because "foo" is a one-level ref and we've passed "--no-allow-onelevel" which overrides the earlier "--allow-onelevel"

Thanks

Phillip



```

## Fien Dora, 2026-10-24 18:37

Subject: Re: [Outreachy] Question about check-ref-format test coverage
Message-ID: <CACWAS-U6OUMcmhLK_aRTc8jt1DXk6eNAs9xz1xmmHDM8L_73Uw@mail.gmail.com>
URL: https://gitlist.dev/e/CACWAS-U6OUMcmhLK_aRTc8jt1DXk6eNAs9xz1xmmHDM8L_73Uw%40mail.gmail.com
In-Reply-To: <bd00b525-6e05-4c17-91ef-3d9c80ff2784@gmail.com>

```
Hi Phillip,

> It sounds like a useful project to me, it is small and self contained
> and improves our codebase.

>> Our commands allow "--no-xyz" to override "--xyz" which is useful
>> when
>> an alias includes "--xyz" and you want to use the alias without that
>> option. The second command above exits 1 because "foo" is a one-level
>> ref and we've passed "--no-allow-onelevel" which overrides the earlier
>> "--allow-onelevel"

Thank you for the feedback and for clarifying how the options override
each other.

I'll work on adding the tests and share the patch for review.


```
