Move Equal onto ObjectAssertions.

Author: MrKWatkins

doc/MrKWatkins.Assertions.tree

@@ -42,13 +42,6 @@
           <toc-element toc-title="Value" topic="MrKWatkins.Assertions.EnumerableAssertionsChain-2.Value.md" />
         </toc-element>
       </toc-element>
-      <toc-element toc-title="EqualityExtensions">
-        <toc-element toc-title="EqualityExtensions" topic="MrKWatkins.Assertions.EqualityExtensions.md" />
-        <toc-element toc-title="Methods">
-          <toc-element toc-title="Equal" topic="MrKWatkins.Assertions.EqualityExtensions.Equal.md" />
-          <toc-element toc-title="NotEqual" topic="MrKWatkins.Assertions.EqualityExtensions.NotEqual.md" />
-        </toc-element>
-      </toc-element>
       <toc-element toc-title="ExceptionExtensions">
         <toc-element toc-title="ExceptionExtensions" topic="MrKWatkins.Assertions.ExceptionExtensions.md" />
         <toc-element toc-title="Methods">
@@ -94,12 +87,14 @@
           <toc-element toc-title="BeNull" topic="MrKWatkins.Assertions.ObjectAssertions-1.BeNull.md" />
           <toc-element toc-title="BeOfType" topic="MrKWatkins.Assertions.ObjectAssertions-1.BeOfType.md" />
           <toc-element toc-title="BeTheSameInstanceAs" topic="MrKWatkins.Assertions.ObjectAssertions-1.BeTheSameInstanceAs.md" />
+          <toc-element toc-title="Equal" topic="MrKWatkins.Assertions.ObjectAssertions-1.Equal.md" />
           <toc-element toc-title="Equals" topic="MrKWatkins.Assertions.ObjectAssertions-1.Equals.md" />
           <toc-element toc-title="GetHashCode" topic="MrKWatkins.Assertions.ObjectAssertions-1.GetHashCode.md" />
           <toc-element toc-title="GetType" topic="MrKWatkins.Assertions.ObjectAssertions-1.GetType.md" />
           <toc-element toc-title="NotBeNull" topic="MrKWatkins.Assertions.ObjectAssertions-1.NotBeNull.md" />
           <toc-element toc-title="NotBeOfType" topic="MrKWatkins.Assertions.ObjectAssertions-1.NotBeOfType.md" />
           <toc-element toc-title="NotBeTheSameInstanceAs" topic="MrKWatkins.Assertions.ObjectAssertions-1.NotBeTheSameInstanceAs.md" />
+          <toc-element toc-title="NotEqual" topic="MrKWatkins.Assertions.ObjectAssertions-1.NotEqual.md" />
           <toc-element toc-title="ToString" topic="MrKWatkins.Assertions.ObjectAssertions-1.ToString.md" />
         </toc-element>
       </toc-element>

doc/topics/API/MrKWatkins.Assertions.EqualityExtensions.Equal.md

@@ -0,0 +1,16 @@
+# ObjectAssertions<T>.Equal Method
+## Definition
+
+```c#
+public ObjectAssertionsChain<T> Equal(T? expected);
+```
+
+## Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| expected | T |  |
+
+## Returns
+
+[ObjectAssertionsChain&lt;T&gt;](MrKWatkins.Assertions.ObjectAssertionsChain-1.md)

doc/topics/API/MrKWatkins.Assertions.EqualityExtensions.NotEqual.md

@@ -0,0 +1,16 @@
+# ObjectAssertions<T>.NotEqual Method
+## Definition
+
+```c#
+public ObjectAssertionsChain<T> NotEqual(T? expected);
+```
+
+## Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| expected | T |  |
+
+## Returns
+
+[ObjectAssertionsChain&lt;T&gt;](MrKWatkins.Assertions.ObjectAssertionsChain-1.md)

doc/topics/API/MrKWatkins.Assertions.EqualityExtensions.md

@@ -30,11 +30,13 @@ public class ObjectAssertions<T>
 | [BeNull()](MrKWatkins.Assertions.ObjectAssertions-1.BeNull.md) |  |
 | [BeOfType&lt;TOther&gt;()](MrKWatkins.Assertions.ObjectAssertions-1.BeOfType.md) |  |
 | [BeTheSameInstanceAs(T)](MrKWatkins.Assertions.ObjectAssertions-1.BeTheSameInstanceAs.md) |  |
+| [Equal(T)](MrKWatkins.Assertions.ObjectAssertions-1.Equal.md) |  |
 | [Equals(Object)](MrKWatkins.Assertions.ObjectAssertions-1.Equals.md) |  |
 | [GetHashCode()](MrKWatkins.Assertions.ObjectAssertions-1.GetHashCode.md) |  |
 | [GetType()](MrKWatkins.Assertions.ObjectAssertions-1.GetType.md) |  |
 | [NotBeNull()](MrKWatkins.Assertions.ObjectAssertions-1.NotBeNull.md) |  |
 | [NotBeOfType&lt;TOther&gt;()](MrKWatkins.Assertions.ObjectAssertions-1.NotBeOfType.md) |  |
 | [NotBeTheSameInstanceAs(T)](MrKWatkins.Assertions.ObjectAssertions-1.NotBeTheSameInstanceAs.md) |  |
+| [NotEqual(T)](MrKWatkins.Assertions.ObjectAssertions-1.NotEqual.md) |  |
 | [ToString()](MrKWatkins.Assertions.ObjectAssertions-1.ToString.md) |  |
 

doc/topics/API/MrKWatkins.Assertions.ObjectAssertions-1.Equal.md

@@ -70,6 +70,81 @@ public async Task NotBeNull_Chain()
         await Assert.That(and.Value).IsEqualTo(notNullValue);
     }
 
+    [Test]
+    public async Task Equal_Null()
+    {
+        string? nullValue = null;
+        const string nonNullValue = "Not Null";
+
+        await Assert.That(() => nullValue.Should().Equal(nonNullValue)).Throws<AssertionException>().WithMessage("Value should equal \"Not Null\" but was null.");
+        await Assert.That(() => nullValue.Should().Equal(nullValue)).ThrowsNothing();
+    }
+
+    [Test]
+    public async Task Equal()
+    {
+        const string value = "Test";
+        const string otherValue = "Not Test";
+
+        await Assert.That(() => value.Should().Equal(otherValue)).Throws<AssertionException>().WithMessage("Value should equal \"Not Test\" but was \"Test\".");
+        await Assert.That(() => value.Should().Equal(value)).ThrowsNothing();
+    }
+
+    [Test]
+    public async Task Equal_Enum()
+    {
+        const ConsoleColor value = ConsoleColor.Blue;
+        const ConsoleColor otherValue = ConsoleColor.Red;
+
+        await Assert.That(() => value.Should().Equal(otherValue)).Throws<AssertionException>().WithMessage("Value should equal Red but was Blue.");
+        await Assert.That(() => value.Should().Equal(value)).ThrowsNothing();
+    }
+
+    [Test]
+    public async Task Equal_Chain()
+    {
+        const string value = "Test";
+
+        var chain = value.Should().Equal(value);
+        await Assert.That(chain.Value).IsEqualTo(value);
+
+        var and = chain.And;
+        await Assert.That(and.Value).IsEqualTo(value);
+    }
+
+    [Test]
+    public async Task NotEqual_Null()
+    {
+        string? nullValue = null;
+        const string nonNullValue = "Not Null";
+
+        await Assert.That(() => nullValue.Should().NotEqual(nonNullValue)).ThrowsNothing();
+        await Assert.That(() => nullValue.Should().NotEqual(nullValue)).Throws<AssertionException>().WithMessage("Value should not equal null.");
+    }
+
+    [Test]
+    public async Task NotEqual()
+    {
+        const string value = "Test";
+        const string otherValue = "Not Test";
+
+        await Assert.That(() => value.Should().NotEqual(otherValue)).ThrowsNothing();
+        await Assert.That(() => value.Should().NotEqual(value)).Throws<AssertionException>().WithMessage("Value should not equal \"Test\".");
+    }
+
+    [Test]
+    public async Task NotEqual_Chain()
+    {
+        const string value = "Test";
+        const string otherValue = "Not Test";
+
+        var chain = value.Should().NotEqual(otherValue);
+        await Assert.That(chain.Value).IsEqualTo(value);
+
+        var and = chain.And;
+        await Assert.That(and.Value).IsEqualTo(value);
+    }
+
     [Test]
     public async Task BeTheSameInstanceAs()
     {