Merge pull request #35 from LinioIT/feature/uuid-transformer

feature: provide a UUID transformer.

composer.json

@@ -6,7 +6,8 @@
     "license": "BSD-3-Clause",
     "require": {
         "php": ">=7.0",
-        "doctrine/inflector": "^1.0"
+        "doctrine/inflector": "^1.0",
+        "ramsey/uuid": "^3.8"
     },
     "require-dev": {
         "phpunit/phpunit": "^6.0",

src/Exception/TransformationException.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Linio\Component\Input\Exception;
+
+class TransformationException extends \RuntimeException
+{
+}

src/Transformer/UuidTransformer.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Linio\Component\Input\Transformer;
+
+use Exception;
+use Linio\Component\Input\Exception\TransformationException;
+use Ramsey\Uuid\Uuid;
+
+class UuidTransformer implements TransformerInterface
+{
+    public function transform($value)
+    {
+        try {
+            return Uuid::fromString($value);
+        } catch (Exception $exception) {
+            throw new TransformationException($exception->getMessage());
+        }
+    }
+}

tests/Transformer/UuidTransformerTest.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Linio\Component\Input\Transformer;
+
+use Linio\Component\Input\Exception\TransformationException;
+use PHPUnit\Framework\TestCase;
+use Ramsey\Uuid\Uuid;
+use Ramsey\Uuid\UuidInterface;
+
+class UuidTransformerTest extends TestCase
+{
+    public function testItDoesTransformStringIntoUuid()
+    {
+        $transformer = new UuidTransformer();
+        $transformed = $transformer->transform('d1d6228d-604c-4a8a-9396-42e6c3b17754');
+        $this->assertInstanceOf(UuidInterface::class, $transformed);
+        $this->assertEquals(Uuid::fromString('d1d6228d-604c-4a8a-9396-42e6c3b17754'), $transformed);
+    }
+
+    public function testItDoesThrowExceptionBecauseOfInvalidString()
+    {
+        $transformer = new UuidTransformer();
+
+        $this->expectException(TransformationException::class);
+        $transformer->transform('d1d6228d-604c');
+    }
+}