Add GameObjectNameComparer

README.md

@@ -4,7 +4,7 @@
 [![Test](https://github.com/nowsprinting/test-helper/actions/workflows/test.yml/badge.svg)](https://github.com/nowsprinting/test-helper/actions/workflows/test.yml)
 [![openupm](https://img.shields.io/npm/v/com.nowsprinting.test-helper?label=openupm&registry_uri=https://package.openupm.com)](https://openupm.com/packages/com.nowsprinting.test-helper/)
 
-Provides attributes and constraints useful for testing.
+Provides custom attributes, comparers, and constraints useful for testing with Unity Test Framework.
 
 Required Unity 2019 LTS or later.
 
@@ -207,6 +207,32 @@ public class MyTestClass
 > - Scene file path is starts with `Assets/` or `Packages/`. And package name using `name` instead of `displayName`, when scenes in the package. (e.g., `Packages/com.nowsprinting.test-helper/Tests/Scenes/Scene.unity`)
 
 
+### Comparers
+
+#### GameObjectNameComparer
+
+`GameObjectNameComparer` is an NUnit test comparer class to compare GameObjects by name.
+
+Usage:
+
+```csharp
+using NUnit.Framework;
+using TestHelper.Comparers;
+using UnityEngine;
+
+[TestFixture]
+public class GameObjectNameComparerTest
+{
+    [Test]
+    public void UsingGameObjectNameComparer_CompareGameObjectsByName()
+    {
+        var actual = Object.FindObjectsOfType<GameObject>();
+        Assert.That(actual, Does.Contain(new GameObject("test")).Using(new GameObjectNameComparer()));
+    }
+}
+```
+
+
 ### Constraints
 
 #### Destroyed

Runtime/Comparers/GameObjectNameComparer.cs

@@ -0,0 +1,23 @@
+// Copyright (c) 2023 Koji Hasegawa.
+// This software is released under the MIT License.
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using UnityEngine;
+
+namespace TestHelper.Comparers
+{
+    /// <summary>
+    /// Compare GameObjects by name.
+    /// </summary>
+    public class GameObjectNameComparer : IComparer<GameObject>
+    {
+        /// <inheritdoc/>
+        [SuppressMessage("ReSharper", "PossibleNullReferenceException")]
+        public int Compare(GameObject x, GameObject y)
+        {
+            return string.Compare(x.name, y.name, StringComparison.Ordinal);
+        }
+    }
+}

Tests/Runtime/Comparers/GameObjectNameComparerTest.cs

@@ -0,0 +1,37 @@
+// Copyright (c) 2023 Koji Hasegawa.
+// This software is released under the MIT License.
+
+using NUnit.Framework;
+using UnityEngine;
+
+namespace TestHelper.Comparers
+{
+    [TestFixture]
+    public class GameObjectNameComparerTest
+    {
+        [Test]
+        public void UsingWithEqualTo_CompareGameObjectsByName()
+        {
+            var actual = new GameObject("test");
+
+            Assert.That(actual, Is.EqualTo(new GameObject("test")).Using(new GameObjectNameComparer()));
+            // Message if failure:
+            //   Expected: <test1 (UnityEngine.GameObject)>
+            //   But was:  <test (UnityEngine.GameObject)>
+        }
+
+        [Test]
+        public void UsingWithCollection_CompareGameObjectsByName()
+        {
+            var actual = new []
+            {
+                new GameObject("test1"), new GameObject("test2"), new GameObject("test3"),
+            };
+
+            Assert.That(actual, Does.Contain(new GameObject("test3")).Using(new GameObjectNameComparer()));
+            // Message if failure:
+            //   Expected: collection containing <test4 (UnityEngine.GameObject)>
+            //   But was:  < <test1 (UnityEngine.GameObject)>, <test2 (UnityEngine.GameObject)>, <test3 (UnityEngine.GameObject)> >
+        }
+    }
+}