Added documentation for property attributes

Author: Fa-BRAIK

docs/PropertyAttributes.md

@@ -0,0 +1,31 @@
+Property Attributes
+=
+
+In order to provide more functionality to your DTOs, you can use the following attributes:
+- [Computed](#Computed) - To define a property that is computed from other properties.
+
+Computed
+-
+
+Sometimes, we may need to specify that a property is computed, meaning that it is derived from other properties. 
+This can be done using the `Computed` attribute.
+
+```php
+use Nuxtifyts\PhpDto\Data;
+use Nuxtifyts\PhpDto\Attributes\PropertyAttributes\Computed;
+
+final readonly class Person extends Data
+{
+    #[Computed]
+    public string $fullName;
+
+    public function __construct(
+        public string $firstName,
+        public string $lastName
+    ) {
+        $this->fullName = "$this->firstName $this->lastName";
+    }
+}
+```
+
+This will make the DTO aware of the `fullName` property, and it will not be serialized or deserialized.

docs/Quickstart.md

@@ -78,4 +78,4 @@ can be found here:
 
 - [Supported Types](https://github.com/nuxtifyts/php-dto/blob/main/docs/SupportedTypes.md)
 - [Normalizers](https://github.com/nuxtifyts/php-dto/blob/main/docs/Normalizers.md)
-- [Property Attributes (TBD)](#)
+- [Property Attributes](https://github.com/nuxtifyts/php-dto/blob/main/docs/PropertyAttributes.md)

tests/Unit/Documentation/PropertyAttributesExampleTest.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace Nuxtifyts\PhpDto\Tests\Unit\Documentation;
+
+use Nuxtifyts\PhpDto\Attributes\PropertyAttributes\Computed;
+use Nuxtifyts\PhpDto\Data;
+use Nuxtifyts\PhpDto\Tests\Unit\UnitCase;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\Attributes\UsesClass;
+use Throwable;
+
+#[UsesClass(Computed::class)]
+#[UsesClass(Data::class)]
+final class PropertyAttributesExampleTest extends UnitCase
+{
+    /**
+     * @throws Throwable
+     */
+    #[Test]
+    public function will_be_able_to_handle_data_classes_with_computed_properties(): void
+    {
+        $person = new readonly class ('John', 'Doe') extends Data {
+            #[Computed]
+            public string $fullName;
+
+            public function __construct(
+                public string $firstName,
+                public string $lastName
+            ) {
+                $this->fullName = $this->firstName . ' ' . $this->lastName;
+            }
+        };
+
+        self::assertEquals(
+            $serializedData = [
+                'firstName' => 'John',
+                'lastName' => 'Doe'
+            ],
+            $person->toArray(),
+        );
+
+        $personFrom = $person::from($serializedData);
+
+        self::assertEquals('John Doe', $personFrom->fullName);
+    }
+}