Add case-insensitive HasName() method (#76)

* Initial plan

* Add case-insensitive HasName() method with tests and documentation

Co-authored-by: dennisdoomen <572734+dennisdoomen@users.noreply.github.com>

* Update API snapshots to approve HasName() method

Co-authored-by: dennisdoomen <572734+dennisdoomen@users.noreply.github.com>

* Merge branch 'main' into copilot/add-case-insensitive-hasname-method

Co-authored-by: dennisdoomen <572734+dennisdoomen@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: dennisdoomen <572734+dennisdoomen@users.noreply.github.com>

Author: Copilot

Pathy.ApiVerificationTests/ApprovedApi/pathy.net47.verified.txt

@@ -24,6 +24,7 @@ namespace Pathy
         public static Pathy.ChainablePath Temp { get; }
         public Pathy.ChainablePath FindParentWithFileMatching(params string[] wildcards) { }
         public bool HasExtension(string extension) { }
+        public bool HasName(string name) { }
         public Pathy.ChainablePath ToAbsolute() { }
         public object ToAbsolute(Pathy.ChainablePath parentPath) { }
         public System.IO.DirectoryInfo ToDirectoryInfo() { }

Pathy.ApiVerificationTests/ApprovedApi/pathy.net8.0.verified.txt

@@ -25,6 +25,7 @@ namespace Pathy
         public Pathy.ChainablePath AsRelativeTo(Pathy.ChainablePath basePath) { }
         public Pathy.ChainablePath FindParentWithFileMatching(params string[] wildcards) { }
         public bool HasExtension(string extension) { }
+        public bool HasName(string name) { }
         public Pathy.ChainablePath ToAbsolute() { }
         public object ToAbsolute(Pathy.ChainablePath parentPath) { }
         public System.IO.DirectoryInfo ToDirectoryInfo() { }

Pathy.ApiVerificationTests/ApprovedApi/pathy.netstandard2.0.verified.txt

@@ -24,6 +24,7 @@ namespace Pathy
         public static Pathy.ChainablePath Temp { get; }
         public Pathy.ChainablePath FindParentWithFileMatching(params string[] wildcards) { }
         public bool HasExtension(string extension) { }
+        public bool HasName(string name) { }
         public Pathy.ChainablePath ToAbsolute() { }
         public object ToAbsolute(Pathy.ChainablePath parentPath) { }
         public System.IO.DirectoryInfo ToDirectoryInfo() { }

Pathy.ApiVerificationTests/ApprovedApi/pathy.netstandard2.1.verified.txt

@@ -25,6 +25,7 @@ namespace Pathy
         public Pathy.ChainablePath AsRelativeTo(Pathy.ChainablePath basePath) { }
         public Pathy.ChainablePath FindParentWithFileMatching(params string[] wildcards) { }
         public bool HasExtension(string extension) { }
+        public bool HasName(string name) { }
         public Pathy.ChainablePath ToAbsolute() { }
         public object ToAbsolute(Pathy.ChainablePath parentPath) { }
         public System.IO.DirectoryInfo ToDirectoryInfo() { }

Pathy.Specs/ChainablePathSpecs.cs

@@ -417,6 +417,36 @@ public void Checking_for_an_extension_requires_a_valid_extension(string extensio
         act.Should().Throw<ArgumentException>("*null*empty*");
     }
 
+    [Theory]
+    [InlineData("SomeFile.txt", true)]
+    [InlineData("somefile.txt", true)]
+    [InlineData("SOMEFILE.TXT", true)]
+    [InlineData("SomeFile", false)]
+    [InlineData("OtherFile.txt", false)]
+    public void Can_check_for_a_name(string name, bool shouldMatch)
+    {
+        // Act
+        var path = ChainablePath.Temp / "SomeFile.txt";
+
+        // Assert
+        path.HasName(name).Should().Be(shouldMatch);
+    }
+
+    [Theory]
+    [InlineData(null)]
+    [InlineData("")]
+    public void Checking_for_a_name_requires_a_valid_name(string name)
+    {
+        // Arrange
+        var path = ChainablePath.Temp / "SomeFile.txt";
+
+        // Act
+        Action act = () => path.HasName(name);
+
+        // Assert
+        act.Should().Throw<ArgumentException>("*null*empty*");
+    }
+
 #if NET6_0_OR_GREATER
     [Fact]
     public void Can_get_the_difference_as_a_relative_path()

Pathy/ChainablePath.cs

@@ -448,6 +448,22 @@ public bool HasExtension(string extension)
             return string.Equals(Extension, extension, StringComparison.OrdinalIgnoreCase);
         }
 
+        /// <summary>
+        /// Determines if the current path has the specified file or directory name (case-insensitive).
+        /// </summary>
+        /// <param name="name">
+        /// The name to check for (e.g., "MyFile.txt").
+        /// </param>
+        public bool HasName(string name)
+        {
+            if (string.IsNullOrEmpty(name))
+            {
+                throw new ArgumentException("Name cannot be null or empty", nameof(name));
+            }
+
+            return string.Equals(Name, name, StringComparison.OrdinalIgnoreCase);
+        }
+
         /// <summary>
         /// Converts the current <see cref="ChainablePath"/> to an absolute path using the current working directory.
         /// </summary>

README.md

@@ -118,6 +118,7 @@ Given an instance of `ChainablePath`, you can get a lot of useful information:
 * Not sure if a path points to an actual file system entry? Use `IsFile`, `IsDirectory` or `Exists`
 * Want to know the delta between two paths? Use `AsRelativeTo`.
 * To determine if a file has a case-insensitive extension, use `HasExtension(".txt")` or `HasExtension("txt")`.
+* To check if a path has a specific file or directory name (case-insensitive), use `HasName("MyFile.txt")`.
 * Get the last write time in UTC using `LastWriteTimeUtc` for both files and directories.
 
 And if the built-in functionality really isn't enough, you can always call `ToDirectoryInfo` or `ToFileInfo` to continue with an instance of `DirectoryInfo` and `FileInfo`.