added cases method to Subset

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to `Enumhancer` will be documented in this file
 
+## 1.4.1 - 2022-03-04
+
+- added `cases` method to `Subset`
+
 ## 1.4.0 - 2022-03-02
 
 - Renamed Multi to Subset

docs/subset.md

@@ -73,6 +73,17 @@ YourEnum::of(
     yourEnum::MY_OTHER_ENUM
 )->values(); // will return ['my_enum', 'my_other_enum']
 ```
+
+### cases
+This method returns the all the cases of the specified subset.
+
+```php
+YourEnum::of(
+    yourEnum::MY_ENUM, 
+    yourEnum::MY_OTHER_ENUM
+)->cases(); // will return [yourEnum::MY_ENUM, yourEnum::MY_OTHER_ENUM]
+```
+
 ### do
 This method allows you call a closure on each item in the subset. 
 

src/Contracts/EnumSubset.php

@@ -15,4 +15,6 @@ public function equals(BackedEnum|UnitEnum|string ...$enum): bool;
     public function names(): array;
 
     public function values(): array;
+
+    public function cases(): array;
 }

src/Helpers/EnumSubsetMethods.php

@@ -72,4 +72,9 @@ public function values(): array
             fn(mixed $enum) => $enum->value ?? $enum->value(), $this->enums
         );
     }
+
+    public function cases(): array
+    {
+        return $this->enums;
+    }
 }

tests/Fixtures/EnhancedUnitEnum.php

@@ -15,4 +15,5 @@ enum EnhancedUnitEnum
 
     case ENUM;
     case ANOTHER_ENUM;
+    case THIRD_ENUM;
 }

tests/Unit/Helpers/EnumSubsetMethodsTest.php

@@ -90,6 +90,26 @@ function (EnhancedUnitEnum $enum) use (&$enums) {
         $this->assertEquals(EnhancedUnitEnum::cases(), $enums);
     }
 
+    public function providesTestCasesForReturningSubsetOfCases(): array
+    {
+        return [
+            [[EnhancedUnitEnum::ENUM]],
+            [[EnhancedUnitEnum::ENUM, EnhancedUnitEnum::THIRD_ENUM]]
+        ];
+    }
+
+    /**
+     * @return void
+     * @dataProvider providesTestCasesForReturningSubsetOfCases
+     */
+    public function testCasesShouldReturnSubsetOfCases(array $cases)
+    {
+        $this->assertEquals(
+            $cases,
+            (new EnumSubsetMethods(EnhancedUnitEnum::class, ...$cases))->cases()
+        );
+    }
+
     private function getNames(array $cases): array
     {
         return array_map(fn($enum) => $enum->name, $cases);