feat(hydrator): add NullableStrategy

Author: tntrex

CHANGELOG.md

@@ -22,6 +22,10 @@ Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) princip
 - Nothing
 -->
 
+## [1.2.0] - 2020-06-12
+### Added
+- Added `NullableStrategy`
+
 ## [1.1.0] - 2020-04-21
 ### Added
 - Added phpDoc comments as possible

Makefile

@@ -0,0 +1,6 @@
+start:
+	docker-compose up -d
+	docker-compose exec app bash
+
+stop:
+	docker-compose down

composer.json

@@ -29,7 +29,7 @@
     "phpstan/phpstan-webmozart-assert": "^0.12",
     "phpunit/phpunit": "^8.0",
     "ramsey/uuid": "^3.9|^4.0",
-    "symplify/easy-coding-standard-prefixed": "^7.2"
+    "symplify/easy-coding-standard-prefixed": "^8.0"
   },
   "suggest": {
     "ramsey/uuid": "To use UuidValue",

phpstan.neon.dist

@@ -8,10 +8,10 @@ parameters:
 	inferPrivatePropertyTypeFromConstructor: true
 	checkMissingIterableValueType: false
 	checkGenericClassInNonGenericObjectType: false
+	bootstrapFiles:
+		- vendor/autoload.php
 	paths:
 		- src/
-	autoload_files:
-		- vendor/autoload.php
 	ignoreErrors:
 		- '/^PHPDoc tag \@param for parameter (.*) with type (.*)\|string is not subtype of native type string.$/'
 		- '/^Parameter #2 \$class of static method Webmozart\\Assert\\Assert::isInstanceOf\(\) expects class-string\<object\>, (.*) given.$/'

src/Integrations/HydratorStrategy/NullableStrategy.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace spaceonfire\ValueObject\Integrations\HydratorStrategy;
+
+use Laminas\Hydrator\Strategy\StrategyInterface;
+
+final class NullableStrategy implements StrategyInterface
+{
+    /**
+     * @var StrategyInterface
+     */
+    private $strategy;
+
+    /**
+     * NullableStrategy constructor.
+     * @param StrategyInterface $strategy
+     */
+    public function __construct(StrategyInterface $strategy)
+    {
+        $this->strategy = $strategy;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function extract($value, ?object $object = null)
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        return $this->strategy->extract($value, $object);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function hydrate($value, ?array $data)
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        return $this->strategy->hydrate($value, $data);
+    }
+}

tests/Integrations/HydratorStrategy/NullableStrategyTest.php

@@ -0,0 +1,42 @@
+<?php
+
+declare(strict_types=1);
+
+namespace spaceonfire\ValueObject\Integrations\HydratorStrategy;
+
+use Laminas\Hydrator\Strategy\StrategyInterface;
+use PHPUnit\Framework\TestCase;
+use Prophecy\Argument;
+
+class NullableStrategyTest extends TestCase
+{
+    public function testExtract(): void
+    {
+        $strategyMock = $this->prophesize(StrategyInterface::class);
+        $strategyMock->extract(Argument::any(), Argument::any())
+            ->shouldBeCalledTimes(1)
+            ->will(function ($args) {
+                return $args[0];
+            });
+
+        $strategy = new NullableStrategy($strategyMock->reveal());
+
+        self::assertSame('foo', $strategy->extract('foo'));
+        self::assertNull($strategy->extract(null));
+    }
+
+    public function testHydrate(): void
+    {
+        $strategyMock = $this->prophesize(StrategyInterface::class);
+        $strategyMock->hydrate(Argument::any(), Argument::any())
+            ->shouldBeCalledTimes(1)
+            ->will(function ($args) {
+                return $args[0];
+            });
+
+        $strategy = new NullableStrategy($strategyMock->reveal());
+
+        self::assertSame('foo', $strategy->hydrate('foo', []));
+        self::assertNull($strategy->hydrate(null, []));
+    }
+}