Add getBackedEnum method to Arr class for enum retrieval with default fallback

Author: Fa-BRAIK

src/Support/Arr.php

@@ -126,6 +126,24 @@ public static function getBackedEnumOrNull(
             );        
     }
 
+    /** 
+     * @template T of BackedEnum 
+     * 
+     * @param array<array-key, mixed> $array
+     * @param class-string<T> $enumClass
+     * @param T $default
+     * 
+     * @return T
+     */
+    public static function getBackedEnum(
+        array $array, 
+        string $key, 
+        string $enumClass, 
+        BackedEnum $default
+    ): BackedEnum {
+        return self::getBackedEnumOrNull($array, $key, $enumClass, $default) ?? $default;
+    }
+
     /**
      * @param array<array-key, mixed> $array
      * @param class-string<object> $classString

tests/Unit/Support/ArrTest.php

@@ -296,7 +296,37 @@ public static function get_arr_provider(): array
                     'enumClass' => YesNoBackedEnum::class,
                 ],
                 YesNoBackedEnum::YES
-            ]
+            ],
+            'get backed enum, invalid value' => [
+                'getBackedEnum',
+                [
+                    'array' => ['key' => 'invalid'],
+                    'key' => 'key',
+                    'enumClass' => YesNoBackedEnum::class,
+                    'default' => YesNoBackedEnum::NO,
+                ],
+                YesNoBackedEnum::NO
+            ],
+            'get backed enum, valid backed enum value' => [
+                'getBackedEnum',
+                [
+                    'array' => ['key' => YesNoBackedEnum::YES],
+                    'key' => 'key',
+                    'enumClass' => YesNoBackedEnum::class,
+                    'default' => YesNoBackedEnum::NO,
+                ],
+                YesNoBackedEnum::YES
+            ],
+            'get backed enum, valid string value' => [
+                'getBackedEnum',
+                [
+                    'array' => ['key' => 'yes'],
+                    'key' => 'key',
+                    'enumClass' => YesNoBackedEnum::class,
+                    'default' => YesNoBackedEnum::NO,
+                ],
+                YesNoBackedEnum::YES
+            ],
         ];
     }