refactor: use PathFilterMode to indicate explicitly the mode of path-based filtering

Author: roeil

new-cli/GitVersion.Core.Libgit2Sharp/GitVersion.Core.Libgit2Sharp.csproj

@@ -56,6 +56,9 @@
       </Compile>
       <Compile Include="..\..\src\GitVersion.LibGit2Sharp\Git\TagCollection.cs">
         <Link>Git\TagCollection.cs</Link>
+      </Compile>
+	  <Compile Include="..\..\src\GitVersion.LibGit2Sharp\Git\TreeChanges.cs">
+        <Link>Git\TreeChanges.cs</Link>
       </Compile>
     </ItemGroup>
 

src/GitVersion.Core/Git/ICommit.cs

@@ -7,5 +7,6 @@ public interface ICommit : IEquatable<ICommit?>, IComparable<ICommit>, IGitObjec
     DateTimeOffset When { get; }
 
     string Message { get; }
+
     IReadOnlyList<string> DiffPaths { get; }
 }

src/GitVersion.Core/VersionCalculation/PathFilter.cs

@@ -5,9 +5,15 @@
 
 namespace GitVersion.VersionCalculation;
 
-internal class PathFilter(IReadOnlyList<string> paths) : IVersionFilter
+internal enum PathFilterMode
 {
-    private readonly List<Regex> pathsRegexes = [.. paths.Select(path => new Regex(path, RegexOptions.Compiled))];
+    Inclusive,  // All commit paths must match for commit to be excluded
+    //Exclusive // Any commit path must match for commit to be excluded
+}
+
+internal class PathFilter(IReadOnlyList<string> paths, PathFilterMode mode = PathFilterMode.Inclusive) : IVersionFilter
+{
+    private readonly IReadOnlyList<Regex> pathsRegexes = [.. paths.Select(path => new Regex(path, RegexOptions.Compiled))];
     private readonly ConcurrentDictionary<string, bool> pathMatchCache = [];
 
     public bool Exclude(IBaseVersion baseVersion, [NotNullWhen(true)] out string? reason)
@@ -16,25 +22,33 @@ public bool Exclude(IBaseVersion baseVersion, [NotNullWhen(true)] out string? re
         return Exclude(baseVersion.BaseVersionSource, out reason);
     }
 
+    private bool IsMatch(string path)
+    {
+        if (!pathMatchCache.TryGetValue(path, out var isMatch))
+        {
+            isMatch = this.pathsRegexes.Any(regex => regex.IsMatch(path));
+            pathMatchCache[path] = isMatch;
+        }
+        return isMatch;
+    }
+
     public bool Exclude(ICommit? commit, [NotNullWhen(true)] out string? reason)
     {
         reason = null;
 
         if (commit != null)
         {
-            foreach (var path in commit.DiffPaths)
+            switch (mode)
             {
-                if (!pathMatchCache.TryGetValue(path, out var isMatch))
-                {
-                    isMatch = this.pathsRegexes.Any(regex => regex.IsMatch(path));
-                    pathMatchCache[path] = isMatch;
-                }
-
-                if (isMatch)
-                {
-                    reason = "Source was ignored due to commit path matching ignore regex";
-                    return true;
-                }
+                case PathFilterMode.Inclusive:
+                    {
+                        if (commit.DiffPaths.All(this.IsMatch))
+                        {
+                            reason = "Source was ignored due to all commit paths matching ignore regex";
+                            return true;
+                        }
+                        break;
+                    }
             }
         }
 

src/GitVersion.LibGit2Sharp/Git/BranchCollection.cs

@@ -12,7 +12,7 @@ internal sealed class BranchCollection : IBranchCollection
     internal BranchCollection(LibGit2Sharp.BranchCollection collection, LibGit2Sharp.Diff diff)
     {
         this.innerCollection = collection.NotNull();
-this.branches = new Lazy<IReadOnlyCollection<IBranch>>(() => [.. this.innerCollection.Select(branch => new Branch(branch, diff))]);
+        this.branches = new Lazy<IReadOnlyCollection<IBranch>>(() => [.. this.innerCollection.Select(branch => new Branch(branch, diff))]);
         this.diff = diff.NotNull();
     }
 

src/GitVersion.LibGit2Sharp/Git/Commit.cs

@@ -27,7 +27,6 @@ internal Commit(LibGit2Sharp.Commit innerCommit, LibGit2Sharp.Diff repoDiff) : b
     public IReadOnlyList<ICommit> Parents => this.parentsLazy.Value;
     public DateTimeOffset When { get; }
     public string Message => this.innerCommit.Message;
-    // TODO implement tag prefix filtering before returning the paths.
     public IReadOnlyList<string> DiffPaths
     {
         get