feat(assert): add Assert:equal(), Assert::notEqual()

- feat: add new `Assert:equal()`, `Assert::notEqual()`
- fix: change expected and actual values in correct order in default compare message

Author: petrdobr

src/Assert.php

@@ -50,6 +50,42 @@ public static function notSame(mixed $expected, mixed $actual, string $message =
             ));
     }
 
+    /**
+     * Asserts that two values are equal (not strict).
+     *
+     * @param mixed $expected The expected value.
+     * @param mixed $actual The actual value to compare against the expected value.
+     * @param string $message Short description about what exactly is being asserted.
+     * @throws AssertException when the assertion fails.
+     */
+    public static function equal(mixed $expected, mixed $actual, string $message = ''): void
+    {
+        $actual == $expected
+            ? StaticState::log('Assert equal: `' . Support::stringify($expected) . '`', $message)
+            : StaticState::fail(AssertException::compare($expected, $actual, $message));
+    }
+
+    /**
+     * Asserts that two values are not equal (not strict).
+     *
+     * @param mixed $expected The expected value.
+     * @param mixed $actual The actual value to compare against the expected value.
+     * @param string $message Short description about what exactly is being asserted.
+     * @throws AssertException when the assertion fails.
+     */
+    public static function notEqual(mixed $expected, mixed $actual, string $message = ''): void
+    {
+        $actual != $expected
+            ? StaticState::log('Assert not equal: `' . Support::stringify($expected) . '`', $message)
+            : StaticState::fail(AssertException::compare(
+                $expected,
+                $actual,
+                $message,
+                pattern: 'Failed asserting that `%1s` is not equal to `%2s`',
+                showDiff: false,
+            ));
+    }
+
     /**
      * Asserts that the condition is true.
      *
@@ -104,7 +140,7 @@ public static function instanceOf(string $expected, mixed $actual, string $messa
                 $expected,
                 $actual,
                 $message,
-                'Expected instance of `%2$s`, got `%1$s`',
+                'Expected instance of `%1$s`, got `%2$s`',
             ));
     }
 
@@ -128,7 +164,7 @@ public static function contains(mixed $needle, iterable $haystack, string $messa
             $needle,
             $haystack,
             $message,
-            'Failed asserting that `%1$s` contains `%2$s`',
+            'Failed asserting that `%2$s` contains `%1$s`',
         ));
     }
 

src/Assert/State/AssertException.php

@@ -45,8 +45,8 @@ public static function compare(
 
         $msg = \sprintf(
             $pattern,
-            Support::stringify($actual),
             Support::stringify($expected),
+            Support::stringify($actual),
         );
         return new self(
             assertion: $msg,

tests/Testo/AsserTest.php

@@ -22,6 +22,8 @@ public function simpleAssertions(): void
         Assert::contains(1, [1,2,3]);
         Assert::contains(2, new \ArrayIterator([1,2,3]));
         Assert::instanceOf(\Exception::class, new \RuntimeException());
+        Assert::equal(1, '1');
+        Assert::notEqual(42,43);
     }
 
     #[Test]