threads / bug / 63530

[BUG]: Non-matching exclude pathspec causes an error in empty repository when the flag "--update" is present

Subject: [BUG]: Non-matching exclude pathspec causes an error in empty repository when the flag "--update" is present

## tl;dr

5 messages between May 27, 2025 and Jun 10, 2025.

replies: 4people: 3as markdown or json

Piotr Siupa· May 27, 2025, 08:14 UTC · lore

I found a regression in version 2.45.0. (It's still present in the current next - 2.49.0.1266.g31b7d2e469; earlier versions work fine.)

When you run "git add --update" with an exclude pathspec on an empty repository, the command fails, showing an error about not being able to find the specified files. This happens only if the repository contains no files. Adding any files (even with "git add -N") or making a non-empty commit fixes the issue, regardless of whether the added files match the exclude pathspec or not.

Way to reproduce: git init git add --update -- ':(exclude)foo'

This results in: error: pathspec ':(exclude)foo' did not match any file(s) known to git error: pathspec '.' did not match any file(s) known to git

Phillip Wood· Jun 2, 2025, 10:07 UTC · re: Piotr Siupa · lore

Re: [BUG]: Non-matching exclude pathspec causes an error in empty repository when the flag "--update" is present

Hi Piotr
On 27/05/2025 09:14, Piotr Siupa wrote:
> I found a regression in version 2.45.0. (It's still present in the
> current next - 2.49.0.1266.g31b7d2e469; earlier versions work fine.)
So it 2.44.0 there is no error message?
Show 15 quoted lines
> When you run "git add --update" with an exclude pathspec on an empty
> repository, the command fails, showing an error about not being able
> to find the specified files.
> This happens only if the repository contains no files. Adding any
> files (even with "git add -N") or making a non-empty commit fixes the
> issue, regardless of whether the added files match the exclude
> pathspec or not.
> 
> Way to reproduce:
> git init
> git add --update -- ':(exclude)foo'
> 
> This results in:
> error: pathspec ':(exclude)foo' did not match any file(s) known to git
> error: pathspec '.' did not match any file(s) known to git

I agree this is inconsistent with what happens if there are tracked files but I wonder if it is actually better to print an error message when an exclude pattern excludes all the files. We do print an error for

git add -u does-not-exist
because it does not match any file but not with
git add -u ':(exclude)*'
or
git add -u builtin ':(exclude)*.[ch]'

which will never add any files (the builtin directory only contains '.c' and '.h' files). So I think maybe the bug is that we don't print an error when there are tracked files and an exclude pattern matches everything

Best Wishes
Phillip
Junio C Hamano· Jun 2, 2025, 15:31 UTC · re: Phillip Wood · lore

Re: [BUG]: Non-matching exclude pathspec causes an error in empty repository when the flag "--update" is present

Phillip Wood <phillip.wood123@gmail.com> writes:
Show 11 quoted lines
>> git add --update -- ':(exclude)foo'
>> This results in:
>> error: pathspec ':(exclude)foo' did not match any file(s) known to git
>> error: pathspec '.' did not match any file(s) known to git
> ...
> git add -u builtin ':(exclude)*.[ch]'
>
> which will never add any files (the builtin directory only contains
> '.c' and '.h' files). So I think maybe the bug is that we don't print
> an error when there are tracked files and an exclude pattern matches
> everything

I have to disagree here. The "did not match" error is telling you this:

    You tried to tell me that you wanted to add something, but you
    didn't enumerate what to add in concrete terms.  You instead
    gave me pathspec, so I tried to see if there are paths that
    match these patterns.  This pattern did not produce any match
    so out of this pattern came no additions (even though other
    patterns may have contributed to other additions).

I think the "'.' did not match any file(s)" in the first example makes perfect sense, but complaining about negative patterns that did not match does not make much sense to me. If I said

	git add -- \*.c ':!auto-generated.c'

and there is no auto-generated.c file (yet) in this working tree, that is a happy outcome. I didn't want to add it, even if it existed, and it turned out to be missing. It would become annoying pretty quickly if we started complaining a pattern in .gitignore that did not match anything, and complaining against "you gave me an exclude pathspec pattern that matched nothing" feels pretty similar to me.

Thanks.
Piotr Siupa· Jun 10, 2025, 09:41 UTC · re: Junio C Hamano · lore

Re: [BUG]: Non-matching exclude pathspec causes an error in empty repository when the flag "--update" is present

On Mon, Jun 2, 2025 at 5:31 PM Junio C Hamano <gitster@pobox.com> wrote:
Show 13 quoted lines
> I have to disagree here.  The "did not match" error is telling you
> this:
>
>     You tried to tell me that you wanted to add something, but you
>     didn't enumerate what to add in concrete terms.  You instead
>     gave me pathspec, so I tried to see if there are paths that
>     match these patterns.  This pattern did not produce any match
>     so out of this pattern came no additions (even though other
>     patterns may have contributed to other additions).
>
> I think the "'.' did not match any file(s)" in the first example
> makes perfect sense, but complaining about negative patterns that
> did not match does not make much sense to me. [...]
That would be my interpretation too.

I mostly use the negative patterns for scripting. In scripts, unmatched negative patterns are more the rule than an exception, since you have to take into account all possible exclusions, without the foreknowledge of what will actually be present in the repository. From my experience, a failing command is never what you want in such situations. (For now, I added "--ignore-errors" to the script I'm writing and I hope this won't cause any bugs related to positive patterns.)

Another thing to consider is that if the behavior of non-matching exclude patterns was changed now, it would break a lot of existing scripts that rely on the current behavior. <br><div class="gmail_quote gmail_quote_container"><div dir="ltr" class="gmail_attr">On Mon, Jun 2, 2025 at 5:31 PM Junio C Hamano &lt;gitster@pobox.com&gt; wrote:<br></div><blockquote class="gmail_quote" style="margin: 0px 0px 0px 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">Phillip Wood &lt;<a href="mailto:phillip.wood123@gmail.com" target="_blank">phillip.wood123@gmail.com</a>&gt; writes:<br> <br> &gt;&gt; git add --update -- ':(exclude)foo'<br> &gt;&gt; This results in:<br> &gt;&gt; error: pathspec ':(exclude)foo' did not match any file(s) known to git<br> &gt;&gt; error: pathspec '.' did not match any file(s) known to git<br> &gt; ...<br> &gt; git add -u builtin ':(exclude)*.[ch]'<br> &gt;<br> &gt; which will never add any files (the builtin directory only contains<br> &gt; '.c' and '.h' files). So I think maybe the bug is that we don't print<br> &gt; an error when there are tracked files and an exclude pattern matches<br> &gt; everything<br> <br> I have to disagree here.&nbsp; The "did not match" error is telling you<br> this:<br> <br> &nbsp; &nbsp; You tried to tell me that you wanted to add something, but you<br> &nbsp; &nbsp; didn't enumerate what to add in concrete terms.&nbsp; You instead<br> &nbsp; &nbsp; gave me pathspec, so I tried to see if there are paths that<br> &nbsp; &nbsp; match these patterns.&nbsp; This pattern did not produce any match<br> &nbsp; &nbsp; so out of this pattern came no additions (even though other<br> &nbsp; &nbsp; patterns may have contributed to other additions).<br> <br> I think the "'.' did not match any file(s)" in the first example<br> makes perfect sense, but complaining about negative patterns that<br> did not match does not make much sense to me.&nbsp; If I said<br> <br> &nbsp; &nbsp; &nbsp; &nbsp; git add -- \*.c ':!auto-generated.c'<br> <br> and there is no auto-generated.c file (yet) in this working tree,<br> that is a happy outcome.&nbsp; I didn't want to add it, even if it<br> existed, and it turned out to be missing.&nbsp; It would become annoying<br> pretty quickly if we started complaining a pattern in .gitignore<br> that did not match anything, and complaining against "you gave me an<br> exclude pathspec pattern that matched nothing" feels pretty similar<br> to me.<br> <br> Thanks.<br> <br> </blockquote></div>

Piotr Siupa· Jun 10, 2025, 09:45 UTC · re: Piotr Siupa · lore

Re: [BUG]: Non-matching exclude pathspec causes an error in empty repository when the flag "--update" is present

I'm sorry. I don't know what happened in the previous message. I've explicitly chosen the plain text mode and removed the unnecessary quoted text. I hope this mail will be normal.

← back to recent threads