feat: array helper::map-to (#505)

tempestphp · Oct 1, 2024 · e4bb059 · e4bb059
1 parent 1572122
commit e4bb059
Show file tree

Hide file tree

Showing 12 changed files with 68 additions and 18 deletions.
diff --git a/src/Tempest/Support/src/ArrayHelper.php b/src/Tempest/Support/src/ArrayHelper.php
@@ -10,7 +10,12 @@
 use Generator;
 use Iterator;
 use Serializable;
+use function Tempest\map;
 
+/**
+ * @template TValueType
+ * @implements ArrayAccess<array-key, TValueType>
+ */
 final class ArrayHelper implements Iterator, ArrayAccess, Serializable, Countable
 {
     use IsIterable;
@@ -269,4 +274,14 @@ public function toArray(): array
     {
         return $this->array;
     }
+
+    /**
+     * @template T
+     * @param class-string<T> $to
+     * @return self<T>
+     */
+    public function mapTo(string $to): self
+    {
+        return new self(map($this->array)->collection()->to($to));
+    }
 }
diff --git a/tests/Integration/Core/EnvHelperTest.php b/tests/Integration/Core/EnvHelperTest.php
@@ -6,12 +6,12 @@
 
 use PHPUnit\Framework\Attributes\DataProvider;
 use function Tempest\env;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 
 /**
  * @internal
  */
-final class EnvHelperTest extends IntegrationTestCase
+final class EnvHelperTest extends FrameworkIntegrationTestCase
 {
     public function test_env_fallback_value(): void
     {

diff --git a/tests/Integration/EventBus/EventIntegrationTestCase.php b/tests/Integration/EventBus/EventIntegrationTestCase.php
@@ -7,12 +7,12 @@
 use function Tempest\event;
 use Tempest\EventBus\Tests\Fixtures\MyEventHandler;
 use Tests\Tempest\Fixtures\Events\ItHappened;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 
 /**
  * @internal
  */
-final class EventIntegrationTestCase extends IntegrationTestCase
+final class EventIntegrationTestCase extends FrameworkIntegrationTestCase
 {
     public function test_event(): void
     {

diff --git a/tests/Integration/Mapper/Mappers/ArrayToJsonMapperTestCase.php b/tests/Integration/Mapper/Mappers/ArrayToJsonMapperTestCase.php
@@ -6,12 +6,12 @@
 
 use function Tempest\map;
 use Tempest\Mapper\MapTo;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 
 /**
  * @internal
  */
-final class ArrayToJsonMapperTestCase extends IntegrationTestCase
+final class ArrayToJsonMapperTestCase extends FrameworkIntegrationTestCase
 {
     public function test_mapper(): void
     {

diff --git a/tests/Integration/Mapper/Mappers/ArrayToObjectMapperTestCase.php b/tests/Integration/Mapper/Mappers/ArrayToObjectMapperTestCase.php
@@ -8,7 +8,7 @@
 use Tempest\Http\Method;
 use function Tempest\map;
 use Tempest\Mapper\Exceptions\MissingValuesException;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 use Tests\Tempest\Integration\Mapper\Fixtures\ObjectA;
 use Tests\Tempest\Integration\Mapper\Fixtures\ObjectWithBuiltInCasters;
 use Tests\Tempest\Integration\Mapper\Fixtures\ObjectWithDefaultValues;
@@ -22,7 +22,7 @@
 /**
  * @internal
  */
-final class ArrayToObjectMapperTestCase extends IntegrationTestCase
+final class ArrayToObjectMapperTestCase extends FrameworkIntegrationTestCase
 {
     public function test_missing_values(): void
     {

diff --git a/tests/Integration/Mapper/Mappers/JsonToArrayMapperTestCase.php b/tests/Integration/Mapper/Mappers/JsonToArrayMapperTestCase.php
@@ -6,12 +6,12 @@
 
 use function Tempest\map;
 use Tempest\Mapper\MapTo;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 
 /**
  * @internal
  */
-final class JsonToArrayMapperTestCase extends IntegrationTestCase
+final class JsonToArrayMapperTestCase extends FrameworkIntegrationTestCase
 {
     public function test_mapper(): void
     {

diff --git a/tests/Integration/Mapper/Mappers/JsonToObjectMapperTestCase.php b/tests/Integration/Mapper/Mappers/JsonToObjectMapperTestCase.php
@@ -6,13 +6,13 @@
 
 use function Tempest\map;
 use Tempest\Mapper\Mappers\JsonToObjectMapper;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 use Tests\Tempest\Integration\Mapper\Fixtures\ObjectA;
 
 /**
  * @internal
  */
-final class JsonToObjectMapperTestCase extends IntegrationTestCase
+final class JsonToObjectMapperTestCase extends FrameworkIntegrationTestCase
 {
     public function test_json_to_object(): void
     {

diff --git a/tests/Integration/Mapper/Mappers/ObjectToArrayMapperTestCase.php b/tests/Integration/Mapper/Mappers/ObjectToArrayMapperTestCase.php
@@ -6,13 +6,13 @@
 
 use function Tempest\map;
 use Tempest\Mapper\MapTo;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 use Tests\Tempest\Integration\Mapper\Fixtures\ObjectA;
 
 /**
  * @internal
  */
-final class ObjectToArrayMapperTestCase extends IntegrationTestCase
+final class ObjectToArrayMapperTestCase extends FrameworkIntegrationTestCase
 {
     public function test_object_to_array(): void
     {

diff --git a/tests/Integration/Mapper/Mappers/ObjectToJsonMapperTestCase.php b/tests/Integration/Mapper/Mappers/ObjectToJsonMapperTestCase.php
@@ -6,13 +6,13 @@
 
 use function Tempest\map;
 use Tempest\Mapper\MapTo;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 use Tests\Tempest\Integration\Mapper\Fixtures\ObjectA;
 
 /**
  * @internal
  */
-final class ObjectToJsonMapperTestCase extends IntegrationTestCase
+final class ObjectToJsonMapperTestCase extends FrameworkIntegrationTestCase
 {
     public function test_object_to_json(): void
     {

diff --git a/tests/Integration/Mapper/ObjectFactoryTestCase.php b/tests/Integration/Mapper/ObjectFactoryTestCase.php
@@ -11,13 +11,13 @@
 use Tempest\Mapper\Mappers\ArrayToObjectMapper;
 use Tempest\Mapper\Mappers\ObjectToArrayMapper;
 use Tempest\Mapper\ObjectFactory;
-use Tests\Tempest\Integration\IntegrationTestCase;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
 use Tests\Tempest\Integration\Mapper\Fixtures\ObjectA;
 
 /**
  * @internal
  */
-final class ObjectFactoryTestCase extends IntegrationTestCase
+final class ObjectFactoryTestCase extends FrameworkIntegrationTestCase
 {
     public function test_single_object(): void
     {

diff --git a/tests/Integration/Support/ArrayHelperTest.php b/tests/Integration/Support/ArrayHelperTest.php
@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Tempest\Integration\Support;
+
+use function Tempest\Support\arr;
+use Tests\Tempest\Integration\FrameworkIntegrationTestCase;
+use Tests\Tempest\Integration\Support\Fixtures\TestObject;
+
+/**
+ * @internal
+ */
+final class ArrayHelperTest extends FrameworkIntegrationTestCase
+{
+    public function test_map_to(): void
+    {
+        $array = arr([['name' => 'test']])->mapTo(TestObject::class);
+
+        $this->assertInstanceOf(TestObject::class, $array[0]);
+    }
+}
diff --git a/tests/Integration/Support/Fixtures/TestObject.php b/tests/Integration/Support/Fixtures/TestObject.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Tempest\Integration\Support\Fixtures;
+
+final readonly class TestObject
+{
+    public function __construct(
+        public string $name,
+    ) {
+    }
+}