Merge pull request #4 from TheDragonCode/2.x

Added the ability to apply casts

Author: Andrey Helldar

README.md

@@ -110,6 +110,57 @@ return $instance->qwerty;
 // null
 ```
 
+### Casts
+
+```php
+namespace App\DTO;
+
+use DragonCode\SimpleDataTransferObject\DataTransferObject;
+use DragonCode\Support\Facades\Helpers\Str;
+
+class YourInstance extends DataTransferObject
+{
+    public $foo;
+   
+    public $bar;
+    
+    public $baz;
+    
+    public $qwerty;
+   
+    protected $map = [
+        'data.foo' => 'foo',
+        'data.bar' => 'bar',
+    ];
+    
+    protected function castFoo($value)
+    {
+        return Str::upper($value);
+    }
+}
+
+$instance = YourInstance::make([
+    'data' => [
+        'foo' => 'Foo',
+        'bar' => 'Bar'
+    ],
+    'baz' => 'Baz'
+]);
+
+
+return $instance->foo;
+// FOO
+
+return $instance->bar;
+// Bar
+
+return $instance->baz;
+// Baz
+
+return $instance->qwerty;
+// null
+```
+
 [badge_downloads]:      https://img.shields.io/packagist/dt/dragon-code/simple-data-transfer-object.svg?style=flat-square
 
 [badge_license]:        https://img.shields.io/packagist/l/dragon-code/simple-data-transfer-object.svg?style=flat-square

src/DataTransferObject.php

@@ -5,6 +5,7 @@
 use DragonCode\Contracts\DataTransferObject\DataTransferObject as Contract;
 use DragonCode\SimpleDataTransferObject\Contracts\Reflection;
 use DragonCode\Support\Concerns\Makeable;
+use DragonCode\Support\Facades\Helpers\Ables\Stringable;
 use DragonCode\Support\Facades\Helpers\Arr;
 use DragonCode\Support\Facades\Helpers\Str;
 use ReflectionClass;
@@ -89,10 +90,21 @@ protected function getValueByKey(array $items, string $key, string $default)
     protected function setValue(string $key, $value): void
     {
         if ($this->isAllow($key)) {
-            $this->{$key} = $value;
+            $this->{$key} = $this->cast($value, $key);
         }
     }
 
+    protected function cast($value, string $key)
+    {
+        $method = $this->getMethodName($key, 'cast');
+
+        if (method_exists($this, $method)) {
+            return call_user_func([$this, $method], $value);
+        }
+
+        return $value;
+    }
+
     /**
      * @param  string  $key
      *
@@ -127,4 +139,12 @@ protected function isAllowKey(string $key): bool
     {
         return ! in_array(Str::lower($key), $this->disallow, true);
     }
+
+    protected function getMethodName(string $key, string $prefix): string
+    {
+        return (string) Stringable::of($key)
+            ->trim()
+            ->start($prefix . '_')
+            ->camel();
+    }
 }

tests/Fixtures/Cast.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Fixtures;
+
+use DragonCode\SimpleDataTransferObject\DataTransferObject;
+use DragonCode\Support\Facades\Helpers\Str;
+
+class Cast extends DataTransferObject
+{
+    public $foo;
+
+    public $bar;
+
+    public $baz;
+
+    protected $map = [
+        'wa.sd'   => 'foo',
+        'qwe.rty' => 'bar',
+    ];
+
+    protected function castFoo($value)
+    {
+        return Str::upper($value);
+    }
+
+    protected function castBar($value)
+    {
+        return Str::lower($value);
+    }
+}

tests/Unit/CastTest.php

@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Unit;
+
+use DragonCode\Support\Facades\Helpers\Str;
+use Tests\Fixtures\Cast;
+use Tests\TestCase;
+
+class CastTest extends TestCase
+{
+    public function testMake()
+    {
+        $object = Cast::make([
+            'wa' => [
+                'sd' => $this->foo,
+            ],
+
+            'qwe.rty' => $this->bar,
+            'baz'     => $this->baz,
+        ]);
+
+        $this->assertSame(Str::upper($this->foo), $object->foo);
+        $this->assertSame(Str::lower($this->bar), $object->bar);
+        $this->assertSame($this->baz, $object->baz);
+    }
+
+    public function testConstruct()
+    {
+        $object = new Cast([
+            'wa' => [
+                'sd' => $this->foo,
+            ],
+
+            'qwe.rty' => $this->bar,
+            'baz'     => $this->baz,
+        ]);
+
+        $this->assertSame(Str::upper($this->foo), $object->foo);
+        $this->assertSame(Str::lower($this->bar), $object->bar);
+        $this->assertSame($this->baz, $object->baz);
+    }
+
+    public function testToArray()
+    {
+        $object = new Cast([
+            'wa' => [
+                'sd' => $this->foo,
+            ],
+
+            'qwe.rty' => $this->bar,
+            'baz'     => $this->baz,
+        ]);
+
+        $this->assertIsArray($object->toArray());
+
+        $this->assertSame([
+            'foo' => Str::upper($this->foo),
+            'bar' => Str::lower($this->bar),
+            'baz' => $this->baz,
+        ], $object->toArray());
+    }
+}

tests/Unit/MapTest.php

@@ -34,8 +34,6 @@ public function testConstruct()
             'baz'     => $this->baz,
         ]);
 
-        $this->assertSame($this->foo, $object->foo);
-
         $this->assertSame($this->foo, $object->foo);
         $this->assertSame($this->bar, $object->bar);
         $this->assertSame($this->baz, $object->baz);