add ArrayAssertions::assertSubset()

Author: Gummibeer

README.md

@@ -28,6 +28,7 @@ This will prevent any method name conflicts with core, your custom or other trai
 \Astrotomic\PhpunitAssertions\ArrayAssertions::assertIndexed(['foo', 'bar']);
 \Astrotomic\PhpunitAssertions\ArrayAssertions::assertAssociative(['foo' => 'bar']);
 \Astrotomic\PhpunitAssertions\ArrayAssertions::assertEquals(['foo', 'bar'], ['bar', 'foo']);
+\Astrotomic\PhpunitAssertions\ArrayAssertions::assertSubset(['foo' => 'bar'], ['baz' => 'foo', 'foo' => 'bar']);
 ```
 
 ### Country

src/ArrayAssertions.php

@@ -38,4 +38,14 @@ public static function assertEquals(array $expected, $actual): void
 
         PHPUnit::assertEquals($expected, $actual);
     }
+
+    public static function assertSubset(array $expected, $actual): void
+    {
+        PHPUnit::assertIsArray($actual);
+
+        foreach($expected as $key => $value) {
+            PHPUnit::assertArrayHasKey($key, $actual);
+            PHPUnit::assertEquals($value, $actual[$key]);
+        }
+    }
 }

tests/ArrayAssertionsTest.php

@@ -57,4 +57,19 @@ public static function it_can_validate_associative_array_equality(): void
 
         ArrayAssertions::assertEquals($expected, $actual);
     }
+
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_associative_array_subset(): void
+    {
+        $array = self::randomArray(self::randomInt(5, 20), true);
+
+        $actual = $array;
+        $expected = array_slice($array, 0, ceil(count($array) / self::randomInt(2, 4)), true);
+        uksort($expected, fn (): int => self::randomInt() <=> self::randomInt());
+
+        ArrayAssertions::assertSubset($expected, $actual);
+    }
 }