(#43) moved IsPrefixOf to IPath and added StartsWith to IPath

Author: sova

TruePath.Tests/AbsolutePathTests.cs

@@ -6,6 +6,27 @@ namespace TruePath.Tests;
 
 public class AbsolutePathTests
 {
+    [Theory]
+    [InlineData("/home/user", "/home/user/documents")]
+    [InlineData("/home/usEr", "/home/User/documents")]
+    [InlineData("/home/user/documents", "/home/user/documents")]
+    [InlineData("/home/user/documents", "/home/user")]
+    public void IsPrefixOfShouldBeEquivalentToStartsWith(string pathA, string pathB)
+    {
+        if (OperatingSystem.IsWindows()) return;
+
+        // Arrange
+        var a = new AbsolutePath(pathA);
+        var b = new AbsolutePath(pathB);
+
+        // Act
+        var isPrefix = a.IsPrefixOf(b);
+        var startsWith = b.Value.StartsWith(a.Value);
+
+        // Assert
+        Assert.Equal(isPrefix, startsWith);
+    }
+
     [Fact]
     public void CurrentWorkingDirectoryShouldReturnCorrectAbsolutePath()
     {

TruePath.Tests/LocalPathTests.cs

@@ -6,6 +6,25 @@ namespace TruePath.Tests;
 
 public class LocalPathTests
 {
+    [Theory]
+    [InlineData("user", "user/documents")]
+    [InlineData("usEr", "User/documents")]
+    [InlineData("user/documents", "user/documents")]
+    [InlineData("user/documents", "user")]
+    public void IsPrefixOfShouldBeEquivalentToStartsWith(string pathA, string pathB)
+    {
+        // Arrange
+        var a = new LocalPath(pathA);
+        var b = new LocalPath(pathB);
+
+        // Act
+        var isPrefix = a.IsPrefixOf(b);
+        var startsWith = b.Value.StartsWith(a.Value);
+
+        // Assert
+        Assert.Equal(isPrefix, startsWith);
+    }
+
     [Fact]
     public void AbsolutePathIsNormalizedOnCreation()
     {

TruePath/AbsolutePath.cs

@@ -54,6 +54,16 @@ public AbsolutePath(LocalPath localPath) : this(localPath.Value, checkAbsolutene
     /// <inheritdoc cref="IPath.FileName"/>
     public string FileName => Underlying.FileName;
 
+    /// <inheritdoc cref="IPath.StartsWith"/>
+    public bool StartsWith(AbsolutePath other) => Value.StartsWith(other.Value);
+
+    /// <inheritdoc cref="IPath.IsPrefixOf"/>
+    public bool IsPrefixOf(AbsolutePath other)
+    {
+        if (!(Value.Length <= other.Value.Length && other.Value.StartsWith(Value))) return false;
+        return other.Value.Length == Value.Length || other.Value[Value.Length] == Path.DirectorySeparatorChar;
+    }
+
     /// <summary>
     /// Gets the current working directory as an AbsolutePath instance.
     /// </summary>

TruePath/IPath.cs

@@ -34,4 +34,17 @@ public interface IPath<TPath> where TPath : IPath<TPath>
 
     /// <inheritdoc cref="op_Division(TPath,LocalPath)"/>
     static abstract TPath operator /(TPath basePath, string appended);
+
+    /// <remarks>
+    /// Checks for a non-strict prefix: if the paths are equal then they are still considered prefixes of each other.
+    /// </remarks>
+    /// <remarks>Note that currently this comparison is case-sensitive.</remarks>
+    bool IsPrefixOf(TPath other);
+
+    /// <summary>
+    /// Determines whether the current path starts with the specified path.
+    /// </summary>
+    /// <param name="other">The path to compare to the current path.</param>
+    /// <remarks>Note that currently this comparison is case-sensitive.</remarks>
+    bool StartsWith(TPath other);
 }

TruePath/LocalPath.cs

@@ -69,10 +69,10 @@ public override int GetHashCode()
         return !left.Equals(right);
     }
 
-    /// <remarks>
-    /// Checks for a non-strict prefix: if the paths are equal then they are still considered prefixes of each other.
-    /// </remarks>
-    /// <remarks>Note that currently this comparison is case-sensitive.</remarks>
+    /// <inheritdoc cref="IPath.StartsWith"/>
+    public bool StartsWith(LocalPath other) => Value.StartsWith(other.Value);
+
+    /// <inheritdoc cref="IPath.IsPrefixOf"/>
     public bool IsPrefixOf(LocalPath other)
     {
         if (!(Value.Length <= other.Value.Length && other.Value.StartsWith(Value))) return false;