prepare for release (via #69)

remorhaz · web-flow · commit 3884842467bc · 2021-12-29T14:34:16.000+03:00
diff --git a/README.md b/README.md
@@ -49,53 +49,36 @@ Then add Allure test listener in **phpunit.xml** file:
     <extension class="Qameta\Allure\PHPUnit\AllureExtension">
         <!-- Optional arguments block; omit it if you want to use default values -->
         <arguments>
-            <!-- JSON files output directory (default is build/allure-results; you may pass null to use default value) -->
-            <string>build/allure-results</string>
-            <!-- Configurator object class (default is Qameta\Allure\PHPUnit\Setup\DefaultConfigurator; you pass null to use default value) -->
-            <string>Qameta\Allure\PHPUnit\Setup\DefaultConfigurator</string>
-            <!-- Other arguments (if any) are passed to configurator's constructor -->
+            <!-- Path to config file (default is config/allure.config.php) -->
+            <string>config/allure.config.php</string>
         </arguments>
     </extension>
 </extensions>
 ```
-After running PHPUnit tests a new folder will be created (**build/allure-results** in the example above). This folder will contain generated JSON files. See [framework help](https://docs.qameta.io/allure/#_reporting) for details about how to generate report from JSON files. By default generated report will only show a limited set of information but you can use cool Allure features by adding a minimum of test code changes. Read next section for details.
-
-You can also use setup hook to tune or extend Allure lifecycle:
-```xml
-<extensions>
-    <extension class="Qameta\Allure\PHPUnit\AllureExtension">
-        <!-- Optional arguments block; omit it if you want to use default values -->
-        <arguments>
-            <!-- JSON files output directory (default is build/allure-results; you may pass null to use default value) -->
-            <null/>
-            <!-- Configurator object class (default is Qameta\Allure\PHPUnit\Setup\DefaultConfigurator; you pass null to use default value) -->
-            <null/>
-            <!-- For default configurator, just pass name of invokable class in this argument -->
-            <string>My\Namespace\OnSetupHook</string>
-        </arguments>
-    </extension>
-</extensions>
-```
-
-And the hook class could look like this:
-
+Config is common PHP file that should return an array: 
 ```php
 <?php
 
-namespace My\Namespace;
-
-use Qameta\Allure\Allure;
-
-class OnSetupHook
-{
-    public function __invoke(): void
-    {
-        Allure::getLifecycleConfigurator()->addHooks(new MyHook())
-    }
-}
+return [
+    // Path to output directory (default is build/allure-results)
+    'outputDirectory' => 'build/allure-results',
+    'linkTemplates' => [
+        // Class or object must implement \Qameta\Allure\Setup\LinkTemplateInterface
+        'tms' => \My\LinkTemplate::class,
+    ],
+    'setupHook' => function (): void {
+        // Some actions performed before starting the lifecycle
+    },
+     // Class or object must implement \Qameta\Allure\PHPUnit\Setup\ThreadDetectorInterface
+    'threadDetector' => \My\ThreadDetector::class,
+    'lifecycleHooks' => [
+        // Class or object must implement one of \Qameta\Allure\Hook\LifecycleHookInterface descendants.
+        \My\LifecycleHook::class,
+    ],
+];
 ```
 
-In the above example we add some custom hook `MyHook` to Allure lifecycle.
+After running PHPUnit tests a new folder will be created (**build/allure-results** in the example above). This folder will contain generated JSON files. See [framework help](https://docs.qameta.io/allure/#_reporting) for details about how to generate report from JSON files. By default generated report will only show a limited set of information but you can use cool Allure features by adding a minimum of test code changes. Read next section for details.
 
 ## Main features
 This adapter comes with a set of PHP annotations and traits allowing to use main Allure features.
diff --git a/composer.json b/composer.json
@@ -30,14 +30,14 @@
   },
   "require": {
     "php": "^8",
-    "allure-framework/allure-php-commons": "2.0.0-rc4",
+    "allure-framework/allure-php-commons": "^2",
     "phpunit/phpunit": "^9"
   },
   "require-dev": {
-    "brianium/paratest": "^6.3.3",
+    "brianium/paratest": "^6.4.1",
     "psalm/plugin-phpunit": "^0.16.1",
-    "squizlabs/php_codesniffer": "^3.6.1",
-    "vimeo/psalm": "^4.13.1"
+    "squizlabs/php_codesniffer": "^3.6.2",
+    "vimeo/psalm": "^4.16.1"
   },
   "conflict": {
     "amphp/byte-stream": "<1.5.1"
diff --git a/src/AllureAdapter.php b/src/AllureAdapter.php
@@ -15,7 +15,6 @@
 
 final class AllureAdapter implements AllureAdapterInterface
 {
-
     private static ?AllureAdapterInterface $instance = null;
 
     /**
diff --git a/src/AllureAdapterInterface.php b/src/AllureAdapterInterface.php
@@ -12,7 +12,6 @@
 
 interface AllureAdapterInterface
 {
-
     public function registerStart(ContainerResult $containerResult, TestResult $testResult, TestInfo $info): string;
 
     public function registerRun(TestResult $testResult, TestInfo $info): TestRunInfo;
diff --git a/src/AllureExtension.php b/src/AllureExtension.php
@@ -74,7 +74,9 @@ private function createTestLifecycle(string|array|ConfigInterface|null $configSo
 
     private function setupAllure(ConfigInterface $config): void
     {
-        Allure::setOutputDirectory($config->getOutputDirectory() ?? self::DEFAULT_OUTPUT_DIRECTORY);
+        Allure::getLifecycleConfigurator()->setOutputDirectory(
+            $config->getOutputDirectory() ?? self::DEFAULT_OUTPUT_DIRECTORY,
+        );
 
         foreach ($config->getLinkTemplates() as $linkType => $linkTemplate) {
             Allure::getLifecycleConfigurator()->addLinkTemplate(
diff --git a/src/ExceptionDetailsTrait.php b/src/ExceptionDetailsTrait.php
@@ -8,7 +8,6 @@
 
 trait ExceptionDetailsTrait
 {
-
     protected function onNotSuccessfulTest(Throwable $t): void
     {
         AllureAdapter::getInstance()->setLastException($t);
diff --git a/src/Internal/ConfigInterface.php b/src/Internal/ConfigInterface.php
@@ -10,7 +10,6 @@
 
 interface ConfigInterface
 {
-
     public function getOutputDirectory(): ?string;
 
     /**
diff --git a/src/Internal/DefaultThreadDetector.php b/src/Internal/DefaultThreadDetector.php
@@ -17,7 +17,6 @@
  */
 final class DefaultThreadDetector implements ThreadDetectorInterface
 {
-
     private string|false|null $hostName = null;
 
     public function getThread(): ?string
diff --git a/src/Internal/TestInfo.php b/src/Internal/TestInfo.php
@@ -9,7 +9,6 @@
  */
 final class TestInfo
 {
-
     /**
      * @param string            $test
      * @param class-string|null $class
diff --git a/src/Internal/TestLifecycle.php b/src/Internal/TestLifecycle.php
@@ -23,7 +23,6 @@
  */
 final class TestLifecycle implements TestLifecycleInterface
 {
-
     private ?TestInfo $currentTest = null;
 
     public function __construct(
diff --git a/src/Internal/TestLifecycleInterface.php b/src/Internal/TestLifecycleInterface.php
@@ -8,7 +8,6 @@
 
 interface TestLifecycleInterface
 {
-
     public function create(): TestLifecycleInterface;
 
     public function updateInfo(): TestLifecycleInterface;
diff --git a/src/Internal/TestRunInfo.php b/src/Internal/TestRunInfo.php
@@ -9,7 +9,6 @@
  */
 final class TestRunInfo
 {
-
     public function __construct(
         private TestInfo $testInfo,
         private string $uuid,
diff --git a/src/Internal/TestStartInfo.php b/src/Internal/TestStartInfo.php
@@ -6,7 +6,6 @@
 
 final class TestStartInfo
 {
-
     public function __construct(
         private string $containerId,
         private string $testId,
diff --git a/src/Internal/TestUpdater.php b/src/Internal/TestUpdater.php
@@ -25,7 +25,6 @@
  */
 class TestUpdater implements TestUpdaterInterface
 {
-
     public function __construct(
         private LinkTemplateCollectionInterface $linkTemplates,
     ) {
diff --git a/src/Internal/TestUpdaterInterface.php b/src/Internal/TestUpdaterInterface.php
@@ -14,7 +14,6 @@
  */
 interface TestUpdaterInterface
 {
-
     public function setInfo(TestResult $testResult, TestInfo $info): void;
 
     public function setRunInfo(TestResult $testResult, TestRunInfo $runInfo): void;
diff --git a/src/Setup/ThreadDetectorInterface.php b/src/Setup/ThreadDetectorInterface.php
@@ -6,7 +6,6 @@
 
 interface ThreadDetectorInterface
 {
-
     public function getThread(): ?string;
 
     public function getHost(): ?string;
diff --git a/test/report/Generate/Annotation/TitleClassLevelLegacyTest.php b/test/report/Generate/Annotation/TitleClassLevelLegacyTest.php
@@ -17,7 +17,6 @@
 ]
 class TitleClassLevelLegacyTest extends TestCase
 {
-
     public function testWithoutTitleAnnotation(): void
     {
         $this->expectNotToPerformAssertions();
diff --git a/test/report/Generate/Annotation/TitleClassLevelMixedTest.php b/test/report/Generate/Annotation/TitleClassLevelMixedTest.php
@@ -18,7 +18,6 @@
 ]
 class TitleClassLevelMixedTest extends TestCase
 {
-
     public function testWithoutTitleAnnotation(): void
     {
         $this->expectNotToPerformAssertions();
diff --git a/test/report/Generate/Annotation/TitleClassLevelNativeTest.php b/test/report/Generate/Annotation/TitleClassLevelNativeTest.php
@@ -14,7 +14,6 @@
 ]
 class TitleClassLevelNativeTest extends TestCase
 {
-
     public function testWithoutTitleAnnotation(): void
     {
         $this->expectNotToPerformAssertions();
diff --git a/test/report/Generate/AnnotationTest.php b/test/report/Generate/AnnotationTest.php
@@ -17,8 +17,6 @@
 
 class AnnotationTest extends TestCase
 {
-
-
     /**
      * @Description ("Legacy description with `markdown`", type = DescriptionType::MARKDOWN)
      */
diff --git a/test/report/Hook/OnLifecycleErrorHook.php b/test/report/Hook/OnLifecycleErrorHook.php
@@ -9,7 +9,6 @@
 
 final class OnLifecycleErrorHook implements OnLifecycleErrorHookInterface
 {
-
     /**
      * @throws Throwable
      */
diff --git a/test/report/Hook/OnSetupHook.php b/test/report/Hook/OnSetupHook.php
@@ -8,7 +8,6 @@
 
 final class OnSetupHook
 {
-
     public function __invoke()
     {
         Allure::getLifecycleConfigurator()
diff --git a/test/unit/AllureAdapterTest.php b/test/unit/AllureAdapterTest.php
@@ -23,7 +23,6 @@
  */
 class AllureAdapterTest extends TestCase
 {
-
     public function setUp(): void
     {
         AllureAdapter::reset();
diff --git a/test/unit/AllureExtensionTest.php b/test/unit/AllureExtensionTest.php
@@ -8,70 +8,18 @@
 use Qameta\Allure\Allure;
 use Qameta\Allure\Model\Status;
 use Qameta\Allure\PHPUnit\AllureExtension;
-use Qameta\Allure\PHPUnit\Internal\ConfigInterface;
 use Qameta\Allure\PHPUnit\Internal\TestLifecycleInterface;
-use Qameta\Allure\Setup\LifecycleBuilderInterface;
-
-use const DIRECTORY_SEPARATOR;
 
 /**
  * @covers \Qameta\Allure\PHPUnit\AllureExtension
  */
 class AllureExtensionTest extends TestCase
 {
-
     public function setUp(): void
     {
         Allure::reset();
     }
 
-    /**
-     * @dataProvider providerOutputDirectory
-     */
-    public function testConstruct_ConfigProvidesOutputDirectory_ConstructsResultsWriterWithWithMatchingDirectory(
-        ?string $outputDirectory,
-        string $expectedValue,
-    ): void {
-        $builder = $this->createMock(LifecycleBuilderInterface::class);
-        Allure::setLifecycleBuilder($builder);
-        $config = $this->createStub(ConfigInterface::class);
-        $config
-            ->method('getOutputDirectory')
-            ->willReturn($outputDirectory);
-        $builder
-            ->expects(self::once())
-            ->method('createResultsWriter')
-            ->with(self::identicalTo($expectedValue));
-        new AllureExtension($config);
-    }
-
-    /**
-     * @return iterable<string, array{string|null, string}>
-     */
-    public function providerOutputDirectory(): iterable
-    {
-        return [
-            'Null' => [null, 'build' . DIRECTORY_SEPARATOR . 'allure-results'],
-            'Non-null' => ['a', 'a'],
-        ];
-    }
-
-    /**
-     * @dataProvider providerOutputDirectory
-     */
-    public function testConstruct_ConfigDataProvidesOutputDirectory_ConstructsResultsWriterWithWithMatchingDirectory(
-        ?string $outputDirectory,
-        string $expectedValue,
-    ): void {
-        $builder = $this->createMock(LifecycleBuilderInterface::class);
-        Allure::setLifecycleBuilder($builder);
-        $builder
-            ->expects(self::once())
-            ->method('createResultsWriter')
-            ->with(self::identicalTo($expectedValue));
-        new AllureExtension(['outputDirectory' => $outputDirectory]);
-    }
-
     public function testExecuteBeforeTest_Constructed_CreatesTestAfterResettingSwitchedContext(): void
     {
         $testLifecycle = $this->createMock(TestLifecycleInterface::class);
diff --git a/test/unit/ExceptionDetailsTraitTest.php b/test/unit/ExceptionDetailsTraitTest.php
@@ -16,7 +16,6 @@
  */
 class ExceptionDetailsTraitTest extends TestCase
 {
-
     public function testOnNotSuccessfulTest_GivenException_ThrowsSameException(): void
     {
         $sharedState = $this->createStub(AllureAdapterInterface::class);
diff --git a/test/unit/Internal/ConfigTest.php b/test/unit/Internal/ConfigTest.php
@@ -18,7 +18,6 @@
  */
 class ConfigTest extends TestCase
 {
-
     /**
      * @dataProvider providerNoOutputDirectory
      */
diff --git a/test/unit/Internal/DefaultThreadDetectorTest.php b/test/unit/Internal/DefaultThreadDetectorTest.php
@@ -12,7 +12,6 @@
  */
 class DefaultThreadDetectorTest extends TestCase
 {
-
     public function testGetThread_WithoutParatestToken_ReturnsNull(): void
     {
         unset($_ENV['TEST_TOKEN']);
diff --git a/test/unit/Internal/TestInfoTest.php b/test/unit/Internal/TestInfoTest.php
@@ -13,7 +13,6 @@
  */
 class TestInfoTest extends TestCase
 {
-
     public function testGetTest_ConstructedWithTest_ReturnsSameValue(): void
     {
         $info = new TestInfo(
diff --git a/test/unit/Internal/TestLinkTemplate.php b/test/unit/Internal/TestLinkTemplate.php
@@ -8,7 +8,6 @@
 
 final class TestLinkTemplate implements LinkTemplateInterface
 {
-
     public function buildUrl(?string $name): ?string
     {
         return null;
diff --git a/test/unit/Internal/TestRunInfoTest.php b/test/unit/Internal/TestRunInfoTest.php
@@ -13,7 +13,6 @@
  */
 class TestRunInfoTest extends TestCase
 {
-
     public function testGetTestInfo_ConstructedWithTestInfo_ReturnsSameInstance(): void
     {
         $testInfo = new TestInfo(
diff --git a/test/unit/Internal/TestStartInfoTest.php b/test/unit/Internal/TestStartInfoTest.php
@@ -12,7 +12,6 @@
  */
 class TestStartInfoTest extends TestCase
 {
-
     public function testGetContainerId_ConstructedWithContainerId_ReturnsSameId(): void
     {
         $info = new TestStartInfo('a', 'b');
diff --git a/test/unit/Internal/TestThreadDetector.php b/test/unit/Internal/TestThreadDetector.php
diff --git a/test/unit/Setup/OnSetupHook.php b/test/unit/Setup/OnSetupHook.php
diff --git a/test/unit/TestTestLifecycle.php b/test/unit/TestTestLifecycle.php

Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,6 @@`
`15`	`15`
`16`	`16`	`final class AllureAdapter implements AllureAdapterInterface`
`17`	`17`	`{`
`18`		`-`
`19`	`18`	`private static ?AllureAdapterInterface $instance = null;`
`20`	`19`
`21`	`20`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,6 @@`
`12`	`12`
`13`	`13`	`interface AllureAdapterInterface`
`14`	`14`	`{`
`15`		`-`
`16`	`15`	`public function registerStart(ContainerResult $containerResult, TestResult $testResult, TestInfo $info): string;`
`17`	`16`
`18`	`17`	`public function registerRun(TestResult $testResult, TestInfo $info): TestRunInfo;`
Original file line number	Diff line number	Diff line change
`@@ -74,7 +74,9 @@ private function createTestLifecycle(string\|array\|ConfigInterface\|null $configSo`
`74`	`74`
`75`	`75`	`private function setupAllure(ConfigInterface $config): void`
`76`	`76`	`{`
`77`		`- Allure::setOutputDirectory($config->getOutputDirectory() ?? self::DEFAULT_OUTPUT_DIRECTORY);`
	`77`	`+ Allure::getLifecycleConfigurator()->setOutputDirectory(`
	`78`	`+ $config->getOutputDirectory() ?? self::DEFAULT_OUTPUT_DIRECTORY,`
	`79`	`+ );`
`78`	`80`
`79`	`81`	`foreach ($config->getLinkTemplates() as $linkType => $linkTemplate) {`
`80`	`82`	`Allure::getLifecycleConfigurator()->addLinkTemplate(`
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,6 @@`
`8`	`8`
`9`	`9`	`trait ExceptionDetailsTrait`
`10`	`10`	`{`
`11`		`-`
`12`	`11`	`protected function onNotSuccessfulTest(Throwable $t): void`
`13`	`12`	`{`
`14`	`13`	`AllureAdapter::getInstance()->setLastException($t);`
Original file line number	Diff line number	Diff line change
`@@ -10,7 +10,6 @@`
`10`	`10`
`11`	`11`	`interface ConfigInterface`
`12`	`12`	`{`
`13`		`-`
`14`	`13`	`public function getOutputDirectory(): ?string;`
`15`	`14`
`16`	`15`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,6 @@`
`17`	`17`	`*/`
`18`	`18`	`final class DefaultThreadDetector implements ThreadDetectorInterface`
`19`	`19`	`{`
`20`		`-`
`21`	`20`	`private string\|false\|null $hostName = null;`
`22`	`21`
`23`	`22`	`public function getThread(): ?string`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,6 @@`
`9`	`9`	`*/`
`10`	`10`	`final class TestInfo`
`11`	`11`	`{`
`12`		`-`
`13`	`12`	`/**`
`14`	`13`	`* @param string $test`
`15`	`14`	`* @param class-string\|null $class`
Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,6 @@`
`23`	`23`	`*/`
`24`	`24`	`final class TestLifecycle implements TestLifecycleInterface`
`25`	`25`	`{`
`26`		`-`
`27`	`26`	`private ?TestInfo $currentTest = null;`
`28`	`27`
`29`	`28`	`public function __construct(`