Add enum_cases function

src/Extension/EnumExtension.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Twig\Extension;
+
+/*
+ * This file is part of Twig.
+ *
+ * (c) Fabien Potencier
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+use Twig\TwigFunction;
+
+class EnumExtension extends AbstractExtension
+{
+    public function getFunctions(): array
+    {
+        return [
+            new TwigFunction('enum_cases', __CLASS__.'::enumCases'),
+        ];
+    }
+
+    /**
+     * @template T of \BackedEnum
+     *
+     * @param class-string<T> $backedEnum
+     *
+     * @return T[]
+     */
+    public static function enumCases(string $backedEnum): array
+    {
+        if (!is_a($backedEnum, \BackedEnum::class, true)) {
+            throw new \InvalidArgumentException(sprintf('The enum must be a "\BackedEnum", "%s" given.', $backedEnum));
+        }
+
+        return $backedEnum::cases();
+    }
+}

tests/Extension/EnumExtensionTest.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Twig\Tests\Extension;
+
+/*
+ * This file is part of Twig.
+ *
+ * (c) Fabien Potencier
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+use PHPUnit\Framework\TestCase;
+use Twig\Extension\EnumExtension;
+
+/**
+ * @requires PHP 8.1
+ */
+class EnumExtensionTest extends TestCase
+{
+    public function testEnumCases()
+    {
+        $cases = EnumExtension::enumCases(MyBackedEnum::class);
+
+        $this->assertSame(MyBackedEnum::cases(), $cases);
+    }
+
+    public function testEnumCasesThrowsIfNotBacked()
+    {
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('The enum must be a "\BackedEnum", "Twig\Tests\Extension\MyUnitEnum" given.');
+
+        EnumExtension::enumCases(MyUnitEnum::class);
+    }
+}
+
+if (80100 <= \PHP_VERSION_ID) {
+    enum MyBackedEnum: string
+    {
+        case ONE = 'one';
+        case TWO = 'two';
+    }
+
+    enum MyUnitEnum
+    {
+        case ONE;
+        case TWO;
+    }
+}