renames Refs to References

Replaces `Refs` with `References` across the codebase for better clarity and consistency. Updates all method calls, variable names, and interfaces to reflect this change.

Author: arturcic

src/GitVersion.Core.Tests/Core/RepositoryExtensionsTests.cs

@@ -43,7 +43,7 @@ private static IRemote MockRemote(IGitRepository repository)
         references["develop"].Returns(reference);
         references.MockCollectionReturn(reference);
 
-        repository.Refs.Returns(references);
+        repository.References.Returns(references);
         repository.Head.Returns(branch);
         repository.Branches.Returns(branches);
         return remote;

src/GitVersion.Core/Core/GitPreparer.cs

@@ -218,15 +218,15 @@ To disable this error set an environmental variable called IGNORE_NORMALISATION_
 
     private void EnsureHeadIsAttachedToBranch(string? currentBranchName, AuthenticationInfo authentication)
     {
-        var headSha = this.repository.Refs.Head?.TargetIdentifier;
+        var headSha = this.repository.References.Head?.TargetIdentifier;
         if (!this.repository.IsHeadDetached)
         {
             this.log.Info($"HEAD points at branch '{headSha}'.");
             return;
         }
 
         this.log.Info($"HEAD is detached and points at commit '{headSha}'.");
-        var localRefs = this.repository.Refs.FromGlob("*").Select(r => $"{r.Name.Canonical} ({r.TargetIdentifier})");
+        var localRefs = this.repository.References.FromGlob("*").Select(r => $"{r.Name.Canonical} ({r.TargetIdentifier})");
         this.log.Info($"Local Refs:{FileSystemHelper.Path.NewLine}" + string.Join(FileSystemHelper.Path.NewLine, localRefs));
 
         // In order to decide whether a fake branch is required or not, first check to see if any local branches have the same commit SHA of the head SHA.
@@ -331,7 +331,7 @@ private void CreateOrUpdateLocalBranchesFromRemoteTrackingOnes(string remoteName
         var prefix = $"refs/remotes/{remoteName}/";
         var remoteHeadCanonicalName = $"{prefix}HEAD";
         var headReferenceName = ReferenceName.Parse(remoteHeadCanonicalName);
-        var remoteTrackingReferences = this.repository.Refs
+        var remoteTrackingReferences = this.repository.References
             .FromGlob(prefix + "*")
             .Where(r => !r.Name.Equals(headReferenceName));
 
@@ -344,7 +344,7 @@ private void CreateOrUpdateLocalBranchesFromRemoteTrackingOnes(string remoteName
             // We do not want to touch our current branch
             if (this.repository.Head.Name.EquivalentTo(branchName)) continue;
 
-            var localRef = this.repository.Refs[localReferenceName];
+            var localRef = this.repository.References[localReferenceName];
             if (localRef != null)
             {
                 if (localRef.TargetIdentifier == remoteTrackingReference.TargetIdentifier)
@@ -356,13 +356,13 @@ private void CreateOrUpdateLocalBranchesFromRemoteTrackingOnes(string remoteName
                 if (remoteRefTipId != null)
                 {
                     this.log.Info($"Updating local ref '{localRef.Name.Canonical}' to point at {remoteRefTipId}.");
-                    this.retryAction.Execute(() => this.repository.Refs.UpdateTarget(localRef, remoteRefTipId));
+                    this.retryAction.Execute(() => this.repository.References.UpdateTarget(localRef, remoteRefTipId));
                 }
                 continue;
             }
 
             this.log.Info($"Creating local branch from remote tracking '{remoteTrackingReference.Name.Canonical}'.");
-            this.repository.Refs.Add(localReferenceName.Canonical, remoteTrackingReference.TargetIdentifier, true);
+            this.repository.References.Add(localReferenceName.Canonical, remoteTrackingReference.TargetIdentifier, true);
 
             var branch = this.repository.Branches[branchName];
             if (branch != null)
@@ -406,17 +406,17 @@ public void EnsureLocalBranchExistsForCurrentBranch(IRemote remote, string? curr
                 this.log.Info(isLocalBranch
                     ? $"Creating local branch {referenceName}"
                     : $"Creating local branch {referenceName} pointing at {repoTipId}");
-                this.repository.Refs.Add(localCanonicalName, repoTipId.Sha);
+                this.repository.References.Add(localCanonicalName, repoTipId.Sha);
             }
             else
             {
                 this.log.Info(isLocalBranch
                     ? $"Updating local branch {referenceName} to point at {repoTipId}"
                     : $"Updating local branch {referenceName} to match ref {currentBranch}");
-                var localRef = this.repository.Refs[localCanonicalName];
+                var localRef = this.repository.References[localCanonicalName];
                 if (localRef != null)
                 {
-                    this.retryAction.Execute(() => this.repository.Refs.UpdateTarget(localRef, repoTipId));
+                    this.retryAction.Execute(() => this.repository.References.UpdateTarget(localRef, repoTipId));
                 }
             }
         }

src/GitVersion.Core/Core/RepositoryStore.cs

@@ -111,7 +111,7 @@ public IEnumerable<IBranch> GetSourceBranches(
     {
         var returnedBranches = new HashSet<IBranch>();
 
-        var referenceLookup = this.repository.Refs.ToLookup(r => r.TargetIdentifier);
+        var referenceLookup = this.repository.References.ToLookup(r => r.TargetIdentifier);
 
         var commitBranches = FindCommitBranchesBranchedFrom(branch, configuration, excludedBranches).ToHashSet();
 

src/GitVersion.Core/Git/IGitRepository.cs

@@ -10,7 +10,7 @@ public interface IGitRepository : IDisposable
     IBranch Head { get; }
 
     ITagCollection Tags { get; }
-    IReferenceCollection Refs { get; }
+    IReferenceCollection References { get; }
     IBranchCollection Branches { get; }
     ICommitCollection Commits { get; }
     IRemoteCollection Remotes { get; }

src/GitVersion.Core/PublicAPI.Shipped.txt

@@ -235,7 +235,6 @@ GitVersion.Git.IGitRepository.Head.get -> GitVersion.Git.IBranch!
 GitVersion.Git.IGitRepository.IsHeadDetached.get -> bool
 GitVersion.Git.IGitRepository.IsShallow.get -> bool
 GitVersion.Git.IGitRepository.Path.get -> string!
-GitVersion.Git.IGitRepository.Refs.get -> GitVersion.Git.IReferenceCollection!
 GitVersion.Git.IGitRepository.Remotes.get -> GitVersion.Git.IRemoteCollection!
 GitVersion.Git.IGitRepository.Tags.get -> GitVersion.Git.ITagCollection!
 GitVersion.Git.IGitRepository.UncommittedChangesCount() -> int

src/GitVersion.Core/PublicAPI.Unshipped.txt

@@ -2,3 +2,4 @@
 GitVersion.Common.IRepositoryStore.GetCommitsReacheableFrom(GitVersion.Git.ICommit! commit, GitVersion.Git.IBranch! branch) -> System.Collections.Generic.IReadOnlyList<GitVersion.Git.ICommit!>!
 GitVersion.Git.ICommit.Id.get -> GitVersion.Git.IObjectId!
 GitVersion.Git.ICommit.Sha.get -> string!
+GitVersion.Git.IGitRepository.References.get -> GitVersion.Git.IReferenceCollection!

src/GitVersion.LibGit2Sharp/Git/GitRepository.cs

@@ -24,10 +24,10 @@ private IRepository RepositoryInstance
     public IBranch Head => this.repositoryCache.GetOrWrap(RepositoryInstance.Head, RepositoryInstance.Diff);
 
     public ITagCollection Tags => new TagCollection(RepositoryInstance.Tags, RepositoryInstance.Diff, this.repositoryCache);
-    public IReferenceCollection Refs => new ReferenceCollection(RepositoryInstance.Refs, this.repositoryCache);
     public IBranchCollection Branches => new BranchCollection(RepositoryInstance.Branches, RepositoryInstance.Diff, this.repositoryCache);
     public ICommitCollection Commits => new CommitCollection(RepositoryInstance.Commits, RepositoryInstance.Diff, this.repositoryCache);
     public IRemoteCollection Remotes => new RemoteCollection(RepositoryInstance.Network.Remotes, this.repositoryCache);
+    public IReferenceCollection References => new ReferenceCollection(RepositoryInstance.Refs, this.repositoryCache);
 
     public void DiscoverRepository(string? gitDirectory)
     {

src/GitVersion.LibGit2Sharp/Git/GitRepository.mutating.cs

@@ -73,7 +73,7 @@ public void CreateBranchForPullRequestBranch(AuthenticationInfo auth) => Reposit
             var fakeBranchName = canonicalName.Replace("refs/pull/", "refs/heads/pull/").Replace("refs/pull-requests/", "refs/heads/pull-requests/");
 
             this.log.Info($"Creating fake local branch '{fakeBranchName}'.");
-            Refs.Add(fakeBranchName, headTipSha);
+            References.Add(fakeBranchName, headTipSha);
 
             this.log.Info($"Checking local branch '{fakeBranchName}' out.");
             Checkout(fakeBranchName);