Add optional GitRelativeProjectPath parameter to GetBuildVersion for the case where Project Path may not be in the same tree folder as Git Repo

Author: benmerms

src/NerdBank.GitVersioning.Tests/VersionOracleTests.cs

@@ -242,4 +242,41 @@ public void CanSetSemVer2ForNuGetPackageVersionNonPublicRelease()
         oracle.PublicRelease = false;
         Assert.Equal($"7.8.9-foo.25.g{this.CommitIdShort}", oracle.NuGetPackageVersion);
     }
+
+    [Fact]
+    public void CanUseGitProjectRelativePathWithGitRepoRoot()
+    {
+        VersionOptions rootVersion = new VersionOptions
+        {
+            Version = SemanticVersion.Parse("1.1"),
+        };
+
+        VersionOptions projectVersion = new VersionOptions
+        {
+            Version = SemanticVersion.Parse("2.2"),
+        };
+
+        string childProjectRelativeDir = "ChildProject1";
+        string childProjectAbsoluteDir = string.Format(@"{0}\{1}", this.RepoPath, childProjectRelativeDir);
+        this.WriteVersionFile(rootVersion);
+        this.WriteVersionFile(projectVersion, childProjectRelativeDir);
+
+        this.InitializeSourceControl();
+
+        // Check Root Version. Root version will be used
+        var oracle = VersionOracle.Create(this.RepoPath, this.RepoPath, null, null);
+        Assert.Equal("1.1", oracle.MajorMinorVersion.ToString());
+
+        // Check ChildProject with projectRelativeDir , with Version file. Child Project version will be used.
+        oracle = VersionOracle.Create(childProjectAbsoluteDir, this.RepoPath, null, null, childProjectRelativeDir);
+        Assert.Equal("2.2", oracle.MajorMinorVersion.ToString());
+
+        // Check ChildProject withOUT projectRelativeDir , with Version file. Child Project version will be used.
+        oracle = VersionOracle.Create(childProjectAbsoluteDir, this.RepoPath);
+        Assert.Equal("2.2", oracle.MajorMinorVersion.ToString());
+
+        // Check ChildProject withOUT Version file. Root version will be used.
+        oracle = VersionOracle.Create(string.Format(@"{0}\{1}", this.RepoPath, "otherChildProject"), this.RepoPath, null, null, "otherChildProject");
+        Assert.Equal("1.1", oracle.MajorMinorVersion.ToString());
+    }
 }

src/NerdBank.GitVersioning/VersionOracle.cs

@@ -31,8 +31,9 @@ public class VersionOracle
         /// <param name="gitRepoDirectory"></param>
         /// <param name="cloudBuild"></param>
         /// <param name="overrideBuildNumberOffset"></param>
+        /// <param name="gitProjectRelativePath"></param>
         /// <returns></returns>
-        public static VersionOracle Create(string projectDirectory, string gitRepoDirectory = null, ICloudBuild cloudBuild = null, int? overrideBuildNumberOffset = null)
+        public static VersionOracle Create(string projectDirectory, string gitRepoDirectory = null, ICloudBuild cloudBuild = null, int? overrideBuildNumberOffset = null, string gitProjectRelativePath = null)
         {
             Requires.NotNull(projectDirectory, nameof(projectDirectory));
             if (string.IsNullOrEmpty(gitRepoDirectory))
@@ -42,18 +43,20 @@ public static VersionOracle Create(string projectDirectory, string gitRepoDirect
 
             using (var git = OpenGitRepo(gitRepoDirectory))
             {
-                return new VersionOracle(projectDirectory, git, cloudBuild, overrideBuildNumberOffset);
+                return new VersionOracle(projectDirectory, git, cloudBuild, overrideBuildNumberOffset, gitProjectRelativePath);
             }
         }
 
         /// <summary>
         /// Initializes a new instance of the <see cref="VersionOracle"/> class.
         /// </summary>
-        public VersionOracle(string projectDirectory, LibGit2Sharp.Repository repo, ICloudBuild cloudBuild, int? overrideBuildNumberOffset = null)
+        public VersionOracle(string projectDirectory, LibGit2Sharp.Repository repo, ICloudBuild cloudBuild, int? overrideBuildNumberOffset = null, string gitProjectRelativePath = null)
         {
             var repoRoot = repo?.Info?.WorkingDirectory?.TrimEnd(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar);
             var relativeRepoProjectDirectory = !string.IsNullOrWhiteSpace(repoRoot)
-                ? projectDirectory.Substring(repoRoot.Length).TrimStart(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar)
+                ? ( !string.IsNullOrEmpty(gitProjectRelativePath) 
+                    ? gitProjectRelativePath.TrimStart(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar)
+                    : projectDirectory.Substring(repoRoot.Length).TrimStart(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar) )
                 : null;
 
             var commit = repo?.Head.Commits.FirstOrDefault();

src/Nerdbank.GitVersioning.NuGet/build/Nerdbank.GitVersioning.targets

@@ -65,6 +65,7 @@
       BuildMetadata="@(BuildMetadata)"
       DefaultPublicRelease="$(PublicRelease)"
       GitRepoRoot="$(GitRepoRoot)"
+      GitProjectRelativePath="$(GitProjectRelativePath)"
       OverrideBuildNumberOffset="$(OverrideBuildNumberOffset)"
       TargetsPath="$(MSBuildThisFileDirectory)">
 

src/Nerdbank.GitVersioning.Tasks/GetBuildVersion.cs

@@ -40,6 +40,12 @@ public GetBuildVersion()
         /// </summary>
         public string GitRepoRoot { get; set; }
 
+        /// <summary>
+        /// Gets or sets the project path relative to Git Root. This is the case where GitRepoRoot might be different from where project folder is getting built
+        /// If null or empty, default behavior will be to use Environment.CurrentDirectory and substring GitRepoRoot to search the GIT Tree for version.json
+        /// </summary>
+        public string GitProjectRelativePath { get; set; }
+
         /// <summary>
         /// Gets or sets the optional override build number offset.
         /// </summary>
@@ -162,7 +168,7 @@ protected override bool ExecuteInner()
             {
                 var cloudBuild = CloudBuild.Active;
                 var overrideBuildNumberOffset = (this.OverrideBuildNumberOffset == int.MaxValue) ? (int?)null : this.OverrideBuildNumberOffset;
-                var oracle = VersionOracle.Create(Directory.GetCurrentDirectory(), this.GitRepoRoot, cloudBuild, overrideBuildNumberOffset);
+                var oracle = VersionOracle.Create(Directory.GetCurrentDirectory(), this.GitRepoRoot, cloudBuild, overrideBuildNumberOffset, this.GitProjectRelativePath);
                 if (!string.IsNullOrEmpty(this.DefaultPublicRelease))
                 {
                     oracle.PublicRelease = string.Equals(this.DefaultPublicRelease, "true", StringComparison.OrdinalIgnoreCase);