feat: allow directly accessing property (#5)

Co-authored-by: Phan An <me@phanan.net>

Author: hungthai1401

README.md

@@ -203,6 +203,16 @@ $data->toArray(); // ['email' => 'alice@company.tld', 'password' => 'SoSecureWow
 
   $data->compact()->toArray(); // ['email' => 'alice@company.tld', 'password' => 'SoSecureWow']
   ```
+* `DataTransferObject::get($name): mixed` returns the value of `$name` property.
+  ```php
+  $data = UserCreationData::make([
+     'email' => 'alice@company.tld',
+     'password' => 'SoSecureWow',
+  ]);
+
+  $data->get('email'); // 'alice@company.tld'
+  $data->password; // 'SoSecureWow'
+  ```  
 
 ## Differences from spatie/data-transfer-object
 

src/DataTransferObject.php

@@ -44,6 +44,15 @@ public function set($name, $value = null): self
         return $this;
     }
 
+    /**
+     * @param $name
+     * @return mixed
+     */
+    public function get($name)
+    {
+        return $this->{$name};
+    }
+
     /** @return static */
     public function unset(string ...$names): self
     {
@@ -139,4 +148,12 @@ public function __unset($name): void
     {
         unset($this->data[$name]);
     }
+
+    /** @return mixed */
+    public function __get($name)
+    {
+        $this->assertPropertyExists($name);
+
+        return $this->data[$name];
+    }
 }

tests/Unit/DataTransferObjectTest.php

@@ -203,4 +203,20 @@ public function testNestedDTO(): void
 
         self::assertEquals(['nested' => ['sample_prop' => 'sample']], $data->compact()->toArray());
     }
+
+    public function testPropertyAccess(): void
+    {
+        $data = SampleData::make(['simple_prop' => 'foo']);
+        
+        self::assertSame('foo', $data->get('simple_prop'));
+        self::assertSame('foo', $data->simple_prop);
+    }
+
+    public function testAccessingNonExistentPropertyWillThrow(): void
+    {
+        self::expectException(DataTransferObjectException::class);
+        self::expectExceptionMessage('Public property $nope does not exist in class Tests\Fixtures\SampleData');
+
+        echo SampleData::make()->nope;
+    }
 }