chore: remove annotations

README.md

@@ -22,7 +22,7 @@ An OEM *(Object Excel Manager)*, if you will.
 
 ## Example usage
 
-### Without annotations
+### Without attributes
 
 ```php
 class Product
@@ -54,19 +54,16 @@ $iterator = $iteratorFactory->fromFile(
 );
 ```
 
-### With annotations
+### With attributes
 
 ```php
-use Xezilaires\Annotation as XLS;
+use Xezilaires\Attribute as XLS;
 
-/**
- * @XLS\Options(header=1, start=2)
- */
+
+#[XLS\Options(header=1, start=2)]
 class Product
 {
-    /**
-     * @XLS\HeaderReference(header="Name")
-     */
+    #[@XLS\HeaderReference(header="Name")]
     private $name;
 }
 
@@ -77,12 +74,12 @@ $normalizer = new \Xezilaires\Bridge\Symfony\Serializer\ObjectSerializer($symfon
 $iteratorFactory = new \Xezilaires\SpreadsheetIteratorFactory($normalizer, [
     \Xezilaires\Bridge\PhpSpreadsheet\Spreadsheet::class,
 ]);
-$annotationDriver = new \Xezilaires\Metadata\Annotation\AnnotationDriver();
+$attributeDriver = new \Xezilaires\Metadata\Attribute\AttributeDriver();
 
 $iterator = $iteratorFactory->fromFile(
     // https://github.com/sigwinhq/xezilaires-dev/raw/master/src/Xezilaires/Test/resources/fixtures/products.xlsx
     new \SplFileObject(__DIR__.'/../../src/Xezilaires/Test/resources/fixtures/products.xlsx'),
-    $annotationDriver->getMetadataMapping(Product::class, ['reverse' => true])
+    $attributeDriver->getMetadataMapping(Product::class, ['reverse' => true])
 );
 ```
 
@@ -107,8 +104,7 @@ Features included:
 *(using either `phpoffice/PhpSpreadsheet` or `openspout/openspout`)*
 - **Denormalization / normalization** support  
 *(using `symfony/serializer`, from / to all supported formats)*
-- **Annotations** support  
-*(using `doctrine/annotations`)*
+- Attributes support
 - mapping via **column names** or **header labels**  
 *(saying "Map header label `PrdctEN` to property `product`")*
 - **A Symfony bundle**  

composer.json

@@ -16,7 +16,6 @@
         "symfony/serializer": "^6.4 || ^7.0"
     },
     "require-dev": {
-        "doctrine/annotations": "^1.12",
         "matthiasnoback/symfony-dependency-injection-test": "^4.0",
         "nyholm/nsa": "^1.1",
         "nyholm/symfony-bundle-test": "dev-master",

docs/examples/annotations.php → docs/examples/attributes.php

@@ -26,13 +26,13 @@
 $iteratorFactory = new \Xezilaires\SpreadsheetIteratorFactory($normalizer, [
     \Xezilaires\Bridge\PhpSpreadsheet\Spreadsheet::class,
 ]);
-$annotationDriver = new \Xezilaires\Metadata\Annotation\AnnotationDriver();
+$attributeDriver = new \Xezilaires\Metadata\Attribute\AttributeDriver();
 // </demo>
 
 $iterator = $iteratorFactory->fromFile(
     // https://github.com/sigwinhq/xezilaires/raw/master/resources/fixtures/products.xlsx
     new \SplFileObject(__DIR__.'/../../src/Xezilaires/Test/resources/fixtures/products.xlsx'),
-    $annotationDriver->getMetadataMapping(Product::class)
+    $attributeDriver->getMetadataMapping(Product::class)
 );
 
 $out = iterator_to_array($iterator);

docs/examples/reverse.php

@@ -26,13 +26,13 @@
 $iteratorFactory = new \Xezilaires\SpreadsheetIteratorFactory($normalizer, [
     \Xezilaires\Bridge\PhpSpreadsheet\Spreadsheet::class,
 ]);
-$annotationDriver = new \Xezilaires\Metadata\Annotation\AnnotationDriver();
+$attributeDriver = new \Xezilaires\Metadata\Attribute\AttributeDriver();
 // </demo>
 
 $iterator = $iteratorFactory->fromFile(
     // https://github.com/sigwinhq/xezilaires/raw/master/resources/fixtures/products.xlsx
     new \SplFileObject(__DIR__.'/../../src/Xezilaires/Test/resources/fixtures/products.xlsx'),
-    $annotationDriver->getMetadataMapping(Product::class, ['reverse' => true])
+    $attributeDriver->getMetadataMapping(Product::class, ['reverse' => true])
 );
 
 $out = iterator_to_array($iterator);

psalm.xml.dist

@@ -34,7 +34,7 @@
         </InternalMethod>
         <MissingConstructor>
             <errorLevel type="info">
-                <directory name="src/Xezilaires/Annotation/"/>
+                <directory name="src/Xezilaires/Attribute/"/>
                 <directory name="src/Xezilaires/Test/Model/"/>
             </errorLevel>
         </MissingConstructor>
@@ -46,7 +46,7 @@
         </MissingTemplateParam>
         <RedundantCondition>
             <errorLevel type="info">
-                <file name="src/Xezilaires/Metadata/Annotation/AnnotationDriver.php"/>
+                <file name="src/Xezilaires/Metadata/Attribute/AttributeDriver.php"/>
             </errorLevel>
         </RedundantCondition>
         <PropertyNotSetInConstructor>

src/Bridge/PhpSpreadsheet/composer.json

@@ -12,10 +12,9 @@
     "require": {
         "php": "^8.2",
         "phpoffice/phpspreadsheet": "^1.29",
-        "sigwin/xezilaires": "^0.6"
+        "sigwin/xezilaires": "^1.0"
     },
     "require-dev": {
-        "doctrine/annotations": "^1.11",
         "phpunit/phpunit": "^9.6",
         "symfony/phpunit-bridge": "^6.4 || ^7.0",
         "symfony/property-access": "^6.4 || ^7.0",

src/Bridge/Spout/composer.json

@@ -12,10 +12,9 @@
     "require": {
         "php": "^8.2",
         "openspout/openspout": "^4.0",
-        "sigwin/xezilaires": "^0.6"
+        "sigwin/xezilaires": "^1.0"
     },
     "require-dev": {
-        "doctrine/annotations": "^1.11",
         "nyholm/nsa": "^1.1",
         "phpunit/phpunit": "^9.6",
         "symfony/phpunit-bridge": "^6.4 || ^7.0",

src/Bridge/Symfony/Command/SerializeCommand.php

@@ -21,7 +21,7 @@
 use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Serializer\Encoder\CsvEncoder;
 use Xezilaires\IteratorFactory;
-use Xezilaires\Metadata\Annotation\AnnotationDriver;
+use Xezilaires\Metadata\Attribute\AttributeDriver;
 use Xezilaires\Serializer;
 
 #[AsCommand(
@@ -122,7 +122,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
                 break;
         }
 
-        $driver = new AnnotationDriver();
+        $driver = new AttributeDriver();
         $iterator = $this->iteratorFactory->fromFile(
             new \SplFileObject($path),
             $driver->getMetadataMapping($class, ['reverse' => $reverse, 'sequential' => true])

src/Bridge/Symfony/Command/ValidateCommand.php

@@ -22,7 +22,7 @@
 use Symfony\Component\Console\Style\SymfonyStyle;
 use Symfony\Component\Validator\ConstraintViolationInterface;
 use Xezilaires\IteratorFactory;
-use Xezilaires\Metadata\Annotation\AnnotationDriver;
+use Xezilaires\Metadata\Attribute\AttributeDriver;
 use Xezilaires\Validator;
 
 #[AsCommand(
@@ -79,7 +79,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         $style = new SymfonyStyle($input, $output);
         $style->title('Xezilaires validate');
 
-        $driver = new AnnotationDriver();
+        $driver = new AttributeDriver();
 
         $totalCount = 0;
         $totalInvalid = 0;

src/Bridge/Symfony/composer.json

@@ -11,7 +11,7 @@
     ],
     "require": {
         "php": "^8.2",
-        "sigwin/xezilaires": "^0.6",
+        "sigwin/xezilaires": "^1.0",
         "symfony/console": "^6.4 || ^7.0",
         "symfony/framework-bundle": "^6.4 || ^7.0",
         "symfony/property-access": "^6.4 || ^7.0",
@@ -22,8 +22,8 @@
         "matthiasnoback/symfony-dependency-injection-test": "^4.0",
         "nyholm/symfony-bundle-test": "dev-master",
         "phpunit/phpunit": "^9.6",
-        "sigwin/xezilaires-phpspreadsheet": "^0.6",
-        "sigwin/xezilaires-spout": "^0.6",
+        "sigwin/xezilaires-phpspreadsheet": "^1.0",
+        "sigwin/xezilaires-spout": "^1.0",
         "symfony/phpunit-bridge": "^6.4 || ^7.0"
     },
     "conflict": {

src/Xezilaires/Annotation/ArrayReference.php → src/Xezilaires/Attribute/ArrayReference.php

@@ -11,12 +11,8 @@
  * with this source code in the file LICENSE.
  */
 
-namespace Xezilaires\Annotation;
+namespace Xezilaires\Attribute;
 
-/**
- * @Annotation
- * @Target({"PROPERTY"})
- */
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 final class ArrayReference
 {

src/Xezilaires/Annotation/ColumnReference.php → src/Xezilaires/Attribute/ColumnReference.php

@@ -11,13 +11,8 @@
  * with this source code in the file LICENSE.
  */
 
-namespace Xezilaires\Annotation;
+namespace Xezilaires\Attribute;
 
-/**
- * @Annotation
- * @Target({"ANNOTATION", "PROPERTY"})
- * @NamedArgumentConstructor
- */
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 final class ColumnReference implements Reference
 {

src/Xezilaires/Annotation/HeaderReference.php → src/Xezilaires/Attribute/HeaderReference.php

@@ -11,13 +11,8 @@
  * with this source code in the file LICENSE.
  */
 
-namespace Xezilaires\Annotation;
+namespace Xezilaires\Attribute;
 
-/**
- * @Annotation
- * @Target({"ANNOTATION", "PROPERTY"})
- * @NamedArgumentConstructor
- */
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 final class HeaderReference implements Reference
 {

src/Xezilaires/Annotation/Options.php → src/Xezilaires/Attribute/Options.php

@@ -11,13 +11,8 @@
  * with this source code in the file LICENSE.
  */
 
-namespace Xezilaires\Annotation;
+namespace Xezilaires\Attribute;
 
-/**
- * @Annotation
- * @Target({"CLASS"})
- * @NamedArgumentConstructor
- */
 #[\Attribute(\Attribute::TARGET_CLASS)]
 final class Options
 {

src/Xezilaires/Annotation/Reference.php → src/Xezilaires/Attribute/Reference.php

@@ -11,7 +11,7 @@
  * with this source code in the file LICENSE.
  */
 
-namespace Xezilaires\Annotation;
+namespace Xezilaires\Attribute;
 
 /**
  * Marker interface Reference.

src/Xezilaires/Exception/AttributeException.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the xezilaires project.
+ *
+ * (c) sigwin.hr
+ *
+ * This source file is subject to the MIT license that is bundled
+ * with this source code in the file LICENSE.
+ */
+
+namespace Xezilaires\Exception;
+
+use Xezilaires\Exception;
+
+final class AttributeException extends \InvalidArgumentException implements Exception
+{
+    public static function unsupportedAttribute(): self
+    {
+        return new self('Unsupported attribute');
+    }
+
+    /**
+     * @param array<int, null|\Xezilaires\Attribute\ArrayReference|\Xezilaires\Attribute\Reference> $references
+     */
+    public static function tooManyReferencesDefined(\ReflectionProperty $property, array $references): self
+    {
+        return new self('Too many references defined for '.$property->getName());
+    }
+}