Merge pull request #36 from 21TORR/enumvalue

CHANGELOG.md

@@ -3,6 +3,7 @@
 
 * (deprecation) Deprecate passing a `bool` to the constructor of `ApiResponse`.
 * (feature) Enforce passing an explicit status code to the constructor of `ApiReponse`.
+* (feature) Add `EnumValue` helper.
 
 3.0.2
 =====

src/Helper/EnumValue.php

@@ -0,0 +1,27 @@
+<?php declare(strict_types=1);
+
+namespace Torr\Rad\Helper;
+
+abstract class EnumValue
+{
+	/**
+	 * Helper to resolve an enum / string value to a string.
+	 */
+	public static function strict (\BackedEnum|string $value) : string
+	{
+		return $value instanceof \BackedEnum
+			? (string) $value->value
+			: $value;
+	}
+
+
+	/**
+	 * Helper to resolve an enum / string / null value to a ?string.
+	 */
+	public static function get (\BackedEnum|string|null $value) : ?string
+	{
+		return null !== $value
+			? self::strict($value)
+			: $value;
+	}
+}

tests/Helper/EnumValueTest.php

@@ -0,0 +1,34 @@
+<?php declare(strict_types=1);
+
+namespace Tests\Torr\Rad\Helper;
+
+use Torr\Rad\Helper\EnumValue;
+use PHPUnit\Framework\TestCase;
+
+enum TestEnum : string
+{
+	case A = "a";
+}
+
+/**
+ */
+class EnumValueTest extends TestCase
+{
+	/**
+	 *
+	 */
+	public function provideTransform () : iterable
+	{
+		yield [null, null];
+		yield ["test", "test"];
+		yield ["a", TestEnum::A];
+	}
+
+	/**
+	 * @dataProvider provideTransform
+	 */
+	public function testTransform (?string $expected, mixed $value) : void
+	{
+		self::assertSame($expected, EnumValue::get($value));
+	}
+}