Implement task environment APIs

src/Framework.UnitTests/AbsolutePath_Tests.cs

@@ -0,0 +1,71 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.IO;
+using Microsoft.Build.Framework;
+using Shouldly;
+using Xunit;
+
+namespace Microsoft.Build.UnitTests
+{
+    public class AbsolutePath_Tests
+    {
+        [Fact]
+        public void AbsolutePath_FromAbsolutePath_ShouldPreservePath()
+        {
+            string absolutePathString = Path.GetTempPath();
+            var absolutePath = new AbsolutePath(absolutePathString);
+
+            absolutePath.Path.ShouldBe(absolutePathString);
+            Path.IsPathRooted(absolutePath.Path).ShouldBeTrue();
+        }
+
+        [Theory]
+        [InlineData("subfolder")]
+        [InlineData("deep/nested/path")]
+        [InlineData(".")]
+        [InlineData("")]
+        [InlineData("..")]
+        public void AbsolutePath_FromRelativePath_ShouldResolveAgainstBase(string relativePath)
+        {
+            string baseDirectory = Path.Combine(Path.GetTempPath(), "testfolder");
+            var basePath = new AbsolutePath(baseDirectory);
+            var absolutePath = new AbsolutePath(relativePath, basePath);
+
+            Path.IsPathRooted(absolutePath.Path).ShouldBeTrue();
+
+            string expectedPath = Path.Combine(baseDirectory, relativePath);
+            absolutePath.Path.ShouldBe(expectedPath);
+        }
+
+        [Fact]
+        public void AbsolutePath_Equality_ShouldWorkCorrectly()
+        {
+            string testPath = Path.GetTempPath();
+            var path1 = new AbsolutePath(testPath);
+            var path2 = new AbsolutePath(testPath);
+            var differentPath = new AbsolutePath(Path.Combine(testPath, "different"));
+
+            path1.ShouldBe(path2);
+            (path1 == path2).ShouldBeTrue();
+            path1.ShouldNotBe(differentPath);
+            (path1 == differentPath).ShouldBeFalse();
+        }
+
+        [Theory]
+        [InlineData("not/rooted/path", false, true)]
+        [InlineData("not/rooted/path", true, false)]
+        public void AbsolutePath_RootedValidation_ShouldBehaveProperly(string path, bool ignoreRootedCheck, bool shouldThrow)
+        {
+            if (shouldThrow)
+            {
+                Should.Throw<System.ArgumentException>(() => new AbsolutePath(path, ignoreRootedCheck: ignoreRootedCheck));
+            }
+            else
+            {
+                var absolutePath = new AbsolutePath(path, ignoreRootedCheck: ignoreRootedCheck);
+                absolutePath.Path.ShouldBe(path);
+            }
+        }
+    }
+}