Add EnumCase::except() provider

Author: remipelhate

src/PHPUnit/DataProviders/EnumCase.php

@@ -6,11 +6,14 @@
 
 use LogicException;
 use ReflectionEnum;
+use ReflectionEnumUnitCase;
 use UnitEnum;
 use ValueError;
 
 use function array_filter;
+use function array_map;
 use function array_rand;
+use function array_reduce;
 use function count;
 use function in_array;
 
@@ -78,4 +81,22 @@ public static function options(UnitEnum ...$options): iterable
             yield "$case->name" => [new self($case, ...$options)];
         }
     }
+
+    /**
+     * @param class-string<TValue> $enumFQCN
+     * @return iterable<array<self<TValue>>>
+     */
+    public static function except(string $enumFQCN, UnitEnum ...$except): iterable
+    {
+        $options = array_map(function (ReflectionEnumUnitCase $reflection) use ($except): ?UnitEnum {
+            $case = $reflection->getValue();
+
+            return match (in_array($case, $except, true)) {
+                true => null,
+                false => $case,
+            };
+        }, new ReflectionEnum($enumFQCN)->getCases());
+
+        yield from self::options(...array_filter($options));
+    }
 }

src/PHPUnit/DataProviders/EnumCaseTest.php

@@ -164,4 +164,20 @@ public function itCanProvideFromGivenOptions(string $enumFQCN): void
             $this->assertContains($case[0]->instance, $expected);
         });
     }
+
+    #[Test]
+    #[DataProvider('enumFQCNs')] /** @param class-string<UnitEnumInterface> $enumFQCN */
+    public function itCanProvideFromEnumFQCNsExceptSomeCases(string $enumFQCN): void
+    {
+        $options = $enumFQCN::cases();
+        [$keep, $except] = collect($options)->shuffle()->split(2);
+
+        $cases = iterator_to_array(EnumCase::except($enumFQCN, ...$except));
+
+        $this->assertCount(count($keep), $cases);
+        collect($cases)->each(function (array $case) use ($keep): void {
+            $this->assertInstanceOf(EnumCase::class, $case[0]);
+            $this->assertContains($case[0]->instance, $keep);
+        });
+    }
 }