added attributes for standard labels and attribute sets support (fixes #33, via #58)

Author: remorhaz

README.md

@@ -19,5 +19,56 @@ In order to use this API you simply need to add the following to **composer.json
 }
 ```
 
-## Usage examples
-See [allure-phpunit](https://github.com/allure-framework/allure-phpunit) project.
+## Custom attributes
+You can easily implement custom attributes and use them with your test framework. In most cases you would like
+to implement [`Qameta\Allure\Attribute\AttributeSetInterface`](./src/Attribute/AttributeSetInterface.php) that allows to set several attributes at once:
+
+```php
+<?php
+
+use Qameta\Allure\Attribute\AttributeSetInterface;
+use Qameta\Allure\Attribute\DisplayName;
+use Qameta\Allure\Attribute\Tag;
+
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
+class MyAttribute implements AttributeSetInterface
+{
+    private array $tags;
+
+    public function __construct(
+        private string $displayName,
+        string ...$tags,
+    ) {
+        $this->tags = $tags;
+    }
+    
+    public function getAttributes() : array
+    {
+        return [
+            new DisplayName($this->displayName),
+            ...array_map(
+                fn (string $tag): Tag => new Tag($tag),
+                $this->tags,
+            ),
+        ];
+    }
+}
+
+// Example of usage
+#[MyAttribute('Test name', 'tag 1', 'tag 2')]
+class MyTestClass
+{
+}
+```
+
+You can also implement particular attribute interfaces instead of using one of the standard implementations:
+
+- [`Qameta\Allure\Attribute\DescriptionInterface`](./src/Attribute/DescriptionInterface.php)
+- [`Qameta\Allure\Attribute\DisplayNameInterface`](./src/Attribute/DisplayNameInterface.php)
+- [`Qameta\Allure\Attribute\LabelInterface`](./src/Attribute/LabelInterface.php)
+- [`Qameta\Allure\Attribute\LinkInterface`](./src/Attribute/LinkInterface.php)
+- [`Qameta\Allure\Attribute\ParameterInterface`](./src/Attribute/ParameterInterface.php)
+
+## Other usage examples
+See [allure-phpunit](https://github.com/allure-framework/allure-phpunit)
+and [allure-codeception](https://github.com/allure-framework/allure-codeception) projects.

src/Allure.php

@@ -193,6 +193,11 @@ public static function package(string $value): void
         self::getInstance()->doLabel(Label::package($value));
     }
 
+    public static function layer(string $value): void
+    {
+        self::getInstance()->doLabel(Label::layer($value));
+    }
+
     public static function label(string $name, string $value): void
     {
         self::getInstance()->doLabel(

src/Attribute/AttributeParser.php

@@ -18,6 +18,8 @@
 use ReflectionProperty;
 
 use function array_merge;
+use function array_pop;
+use function array_push;
 use function array_reverse;
 use function is_string;
 
@@ -107,7 +109,12 @@ public static function createForChain(
 
     private function processAnnotations(AttributeInterface ...$attributes): void
     {
-        foreach ($attributes as $attribute) {
+        while (!empty($attributes)) {
+            $attribute = array_shift($attributes);
+            if ($attribute instanceof AttributeSetInterface) {
+                array_unshift($attributes, ...$attribute->getAttributes());
+                continue;
+            }
             if ($attribute instanceof DisplayNameInterface) {
                 $this->displayName = $attribute->getValue();
             }

src/Attribute/AttributeSetInterface.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Qameta\Allure\Attribute;
+
+interface AttributeSetInterface extends AttributeInterface
+{
+    /**
+     * @return list<AttributeInterface>
+     */
+    public function getAttributes(): array;
+}

src/Attribute/Label.php

@@ -21,11 +21,14 @@ final class Label extends AbstractLabel
     public const TAG = Model\Label::TAG;
     public const OWNER = Model\Label::OWNER;
     public const LEAD = Model\Label::LEAD;
+    public const PACKAGE = Model\Label::PACKAGE;
+    public const LAYER = Model\Label::LAYER;
+
+    // Technical labels, set by framework automatically
     public const HOST = Model\Label::HOST;
     public const THREAD = Model\Label::THREAD;
     public const TEST_METHOD = Model\Label::TEST_METHOD;
     public const TEST_CLASS = Model\Label::TEST_CLASS;
-    public const PACKAGE = Model\Label::PACKAGE;
     public const FRAMEWORK = Model\Label::FRAMEWORK;
     public const LANGUAGE = Model\Label::LANGUAGE;
 }

src/Attribute/Layer.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Qameta\Allure\Attribute;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
+final class Layer extends AbstractLabel
+{
+    public function __construct(string $value)
+    {
+        parent::__construct(Label::LAYER, $value);
+    }
+}

src/Attribute/Lead.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Qameta\Allure\Attribute;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
+final class Lead extends AbstractLabel
+{
+    public function __construct(string $value)
+    {
+        parent::__construct(Label::LEAD, $value);
+    }
+}

src/Attribute/Owner.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Qameta\Allure\Attribute;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
+final class Owner extends AbstractLabel
+{
+    public function __construct(string $value)
+    {
+        parent::__construct(Label::OWNER, $value);
+    }
+}

src/Attribute/Package.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Qameta\Allure\Attribute;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
+final class Package extends AbstractLabel
+{
+    public function __construct(string $value)
+    {
+        parent::__construct(Label::PACKAGE, $value);
+    }
+}

src/Attribute/ParentSuite.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Qameta\Allure\Attribute;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
+final class ParentSuite extends AbstractLabel
+{
+    public function __construct(string $value)
+    {
+        parent::__construct(Label::PARENT_SUITE, $value);
+    }
+}