add inline normalizer

Author: DavidBadura

src/Normalizer/InlineNormalizer.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Patchlevel\Hydrator\Normalizer;
+
+use Attribute;
+use Closure;
+
+/**
+ * @template N of mixed
+ * @template D of mixed
+ */
+#[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_CLASS)]
+class InlineNormalizer implements Normalizer
+{
+    /**
+     * @param Closure(D):N $normalize
+     * @param Closure(N):D $denormalize
+     */
+    public function __construct(
+        private readonly Closure $normalize,
+        private readonly Closure $denormalize,
+        private readonly bool $passNull = false,
+    ) {
+    }
+
+    /**
+     * @param D $value
+     *
+     * @return N
+     */
+    public function normalize(mixed $value): mixed
+    {
+        if (!$this->passNull && $value === null) {
+            return null;
+        }
+
+        return ($this->normalize)($value);
+    }
+
+    /**
+     * @param N $value
+     *
+     * @return D
+     */
+    public function denormalize(mixed $value): mixed
+    {
+        if (!$this->passNull && $value === null) {
+            return null;
+        }
+
+        return ($this->denormalize)($value);
+    }
+}

tests/Unit/Fixture/ProfileCreatedWithInlineNormalizer.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Patchlevel\Hydrator\Tests\Unit\Fixture;
+
+use Patchlevel\Hydrator\Normalizer\InlineNormalizer;
+
+final class ProfileCreatedWithInlineNormalizer
+{
+    public function __construct(
+        #[IdNormalizer]
+        public ProfileId $profileId,
+        #[InlineNormalizer(
+            normalize: static function (Email $email): string {
+                return $email->toString();
+            },
+            denormalize: static function (string $value): Email {
+                return Email::fromString($value);
+            },
+        )]
+        public Email $email,
+    ) {
+    }
+}

tests/Unit/MetadataHydratorTest.php

@@ -33,6 +33,7 @@
 use Patchlevel\Hydrator\Tests\Unit\Fixture\NormalizerInBaseClassDefinedDto;
 use Patchlevel\Hydrator\Tests\Unit\Fixture\ParentDto;
 use Patchlevel\Hydrator\Tests\Unit\Fixture\ProfileCreated;
+use Patchlevel\Hydrator\Tests\Unit\Fixture\ProfileCreatedWithInlineNormalizer;
 use Patchlevel\Hydrator\Tests\Unit\Fixture\ProfileCreatedWithNormalizer;
 use Patchlevel\Hydrator\Tests\Unit\Fixture\ProfileCreatedWrapper;
 use Patchlevel\Hydrator\Tests\Unit\Fixture\ProfileId;
@@ -113,7 +114,7 @@ public function testExtractCircularReference(): void
         $this->hydrator->extract($dto1);
     }
 
-    public function testExtractWithInferNormalizer2(): void
+    public function testExtractWithInferNormalizer(): void
     {
         $result = $this->hydrator->extract(
             new InferNormalizerWithNullableDto(
@@ -148,6 +149,20 @@ public function testExtractWithInferNormalizerFailed(): void
         );
     }
 
+    #[RequiresPhp('>=8.5')]
+    public function testExtractWithInlineNormalizer(): void
+    {
+        $event = new ProfileCreatedWithInlineNormalizer(
+            ProfileId::fromString('1'),
+            Email::fromString('info@patchlevel.de'),
+        );
+
+        self::assertEquals(
+            ['profileId' => '1', 'email' => 'info@patchlevel.de'],
+            $this->hydrator->extract($event),
+        );
+    }
+
     public function testExtractWithHooks(): void
     {
         $data = $this->hydrator->extract(new DtoWithHooks());
@@ -236,6 +251,22 @@ public function testHydrateWithTypeMismatch(): void
         );
     }
 
+    #[RequiresPhp('>=8.5')]
+    public function testHydrateWithInlineNormalizer(): void
+    {
+        $expected = new ProfileCreatedWithInlineNormalizer(
+            ProfileId::fromString('1'),
+            Email::fromString('info@patchlevel.de'),
+        );
+
+        $event = $this->hydrator->hydrate(
+            ProfileCreatedWithInlineNormalizer::class,
+            ['profileId' => '1', 'email' => 'info@patchlevel.de'],
+        );
+
+        self::assertEquals($expected, $event);
+    }
+
     public function testDenormalizationFailure(): void
     {
         $this->expectException(DenormalizationFailure::class);