feat: using php attributes

Author: Matej Grgić

rector.php

@@ -3,12 +3,26 @@
 declare(strict_types=1);
 
 use Rector\Config\RectorConfig;
+use Rector\Doctrine\Set\DoctrineSetList;
+use Rector\Php80\Rector\Class_\AnnotationToAttributeRector;
+use Rector\Php80\ValueObject\AnnotationToAttribute;
+use Rector\Symfony\Set\SensiolabsSetList;
+use Rector\Symfony\Set\SymfonySetList;
+use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
 
-return RectorConfig::configure()
-    ->withPaths([
+return static function (RectorConfig $rectorConfig): void {
+    // Paths for Rector to act upon
+    $rectorConfig->paths([
         __DIR__ . '/src',
         __DIR__ . '/tests',
-    ])
-    ->withPhpSets(true)
-    ->withRules([
     ]);
+
+    $rectorConfig->sets([
+        DoctrineSetList::ANNOTATIONS_TO_ATTRIBUTES,
+        SymfonySetList::ANNOTATIONS_TO_ATTRIBUTES,
+        SensiolabsSetList::ANNOTATIONS_TO_ATTRIBUTES,
+    ]);
+    $rectorConfig->ruleWithConfiguration(AnnotationToAttributeRector::class, [
+        new AnnotationToAttribute(UniqueEntity::class),
+    ]);
+};

src/Model/Resource/Attribute/Attribute.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Undabot\SymfonyJsonApi\Model\Resource\Attribute;
+
+use Attribute as PhpAttribute;
+
+#[PhpAttribute(PhpAttribute::TARGET_PROPERTY | PhpAttribute::IS_REPEATABLE)]
+class Attribute
+{
+    public function __construct(
+        public string $name,
+        public ?string $description = null,
+        public ?string $example = null,
+        public ?string $format = null,
+        public bool $nullable = false
+    ) {}
+}

src/Model/Resource/Attribute/Relationship.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Undabot\SymfonyJsonApi\Model\Resource\Attribute;
+
+abstract class Relationship
+{
+    public function __construct(
+        public string $name,
+        public ?string $type = null,
+        public ?string $description = null,
+        public bool $nullable = false
+    ) {}
+
+    abstract public function isToMany(): bool;
+}

src/Model/Resource/Attribute/ToMany.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Undabot\SymfonyJsonApi\Model\Resource\Attribute;
+
+use Attribute as PhpAttribute;
+
+#[PhpAttribute(PhpAttribute::TARGET_PROPERTY | PhpAttribute::IS_REPEATABLE)]
+class ToMany extends Relationship
+{
+    public function isToMany(): bool
+    {
+        return true;
+    }
+}

src/Model/Resource/Attribute/ToOne.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Undabot\SymfonyJsonApi\Model\Resource\Attribute;
+
+use Attribute as PhpAttribute;
+
+#[PhpAttribute(PhpAttribute::TARGET_PROPERTY | PhpAttribute::IS_REPEATABLE)]
+class ToOne extends Relationship
+{
+    public function isToMany(): bool
+    {
+        return false;
+    }
+}

tests/Bridge/OpenAPI/Model/Article.php

@@ -45,6 +45,7 @@ class Article implements ApiModel
      *
      * @Attribute(name="eventDate")
      */
+    #[\Undabot\SymfonyJsonApi\Model\Resource\Attribute\Attribute('ovoJeIme')]
     private $date;
 
     /**