feat(Testing): Add TestRunner trait with TestingSuite attribute (#36)

Author: roxblnfk

src/Testing/Attribute/TestingSuite.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Testo\Testing\Attribute;
+
+use Internal\Path;
+
+/**
+ * Configure Test Suite for the testing tools.
+ */
+#[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_FUNCTION)]
+final class TestingSuite
+{
+    public function __construct(
+        /**
+         * @var string|Path Stub directory or file path.
+         */
+        public readonly string|Path $path,
+    ) {}
+}

tests/Assert/StubRunner.php src/Testing/Traits/TestRunner.phptests/Assert/StubRunner.php renamed to src/Testing/Traits/TestRunner.php

@@ -2,17 +2,19 @@
 
 declare(strict_types=1);
 
-namespace Tests\Assert;
+namespace Testo\Testing\Traits;
 
 use InvalidArgumentException as InvalidArgument;
 use Testo\Application\Application;
 use Testo\Application\Config\ApplicationConfig;
 use Testo\Application\Config\FinderConfig;
 use Testo\Application\Config\SuiteConfig;
 use Testo\Application\Value\Filter;
+use Testo\Common\Reflection;
 use Testo\Core\Context\TestResult;
+use Testo\Testing\Attribute\TestingSuite;
 
-final class StubRunner
+trait TestRunner
 {
     /**
      * Run a specific test function and return its result.
@@ -30,7 +32,7 @@ public static function runTest(array|string $testFunction): TestResult
         $filter = new Filter();
 
         # Run application to get test results
-        $suites = self::app()->run($filter)->results;
+        $suites = self::getTestoApp()->run($filter)->results;
 
         # Find and return the test result for the given test function
         foreach ($suites as $suite) {
@@ -57,28 +59,34 @@ public static function runTest(array|string $testFunction): TestResult
         throw new InvalidArgument('Test function not found: ' . $testFunction());
     }
 
-    private static function app(): Application
+    protected static function getTestoApp(): Application
     {
-        # Create and cache application instance
-        static $app = null;
-        if ($app !== null) {
-            return $app;
-        }
+        /**
+         * Try to create Application instance from Call Stack Attributes
+         * @var list<\ReflectionAttribute<TestingSuite>> $suiteConfigs
+         */
+        $suiteConfigs = Reflection::getAttributesFromCallStack(
+            attributeClass: TestingSuite::class,
+            includeClasses: true,
+            limit: 1,
+        );
+
+        $suiteConfigs === [] and throw new \RuntimeException('Testing Suite is not configured.');
+        $config = \reset($suiteConfigs)->newInstance();
 
-        $app = Application::createFromConfig(
+        return Application::createFromConfig(
             new ApplicationConfig(
                 src: null,
                 suites: [
                     new SuiteConfig(
-                        'Stubs',
+                        'Testing',
                         location: new FinderConfig(
-                            include: [__DIR__ . '/Stub'],
+                            include: [$config->path],
                         ),
                     ),
                 ],
             ),
         );
-        return $app;
     }
 
     /**

tests/Assert/Feature/CommonTest.php

@@ -7,15 +7,19 @@
 use Testo\Application\Attribute\Test;
 use Testo\Assert;
 use Testo\Core\Value\Status;
+use Testo\Testing\Attribute\TestingSuite;
+use Testo\Testing\Traits\TestRunner;
 use Tests\Assert\Stub\Common;
-use Tests\Assert\StubRunner;
 
+#[TestingSuite(path: __DIR__ . '/../Stub')]
 final class CommonTest
 {
+    use TestRunner;
+
     #[Test(description: 'A successfully finished test without any assertion marked as Risky')]
     public function noAssertions(): void
     {
-        $result = StubRunner::runTest([Common::class, 'risky']);
+        $result = self::runTest([Common::class, 'risky']);
         Assert::same(Status::Risky, $result->status);
     }
 }