Use PHP attributes for PHPUnit tests (#631)

Author: Brian Faust

src/Generators/PhpUnitTestGenerator.php

@@ -52,6 +52,7 @@ public function output(Tree $tree): array
         /** @var \Blueprint\Models\Controller $controller */
         foreach ($tree->controllers() as $controller) {
             $this->addImport($controller, \Tests\TestCase::class);
+            $this->addImport($controller, 'PHPUnit\Framework\Attributes\Test');
 
             $path = $this->getPath($controller);
 
@@ -531,9 +532,7 @@ private function buildFormRequestName(Controller $controller, string $name)
     private function buildFormRequestTestCase(string $controller, string $action, string $form_request)
     {
         return <<< END
-    /**
-     * @test
-     */
+    #[Test]
     public function ${action}_uses_form_request_validation(): void
     {
         \$this->assertActionUsesFormRequest(

stubs/phpunit.test.case.stub

@@ -1,6 +1,4 @@
-    /**
-     * @test
-     */
+    #[Test]
     public function {{ method }}(): void
     {
         {{ body }}

stubs/phpunit.test.class.stub

@@ -7,7 +7,7 @@ namespace {{ namespace }};
 /**
  * @see {{ namespacedClass }}
  */
-class {{ class }} extends TestCase
+final class {{ class }} extends TestCase
 {
     {{ body }}
 }

tests/Feature/Commands/BuildCommandTest.php

@@ -5,11 +5,12 @@
 use Blueprint\Blueprint;
 use Blueprint\Builder;
 use Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration;
-use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use Tests\TestCase;
 
-#[CoversClass(\Blueprint\Commands\BuildCommand::class)]
+/**
+ * @see \Blueprint\Commands\BuildCommand
+ */
 final class BuildCommandTest extends TestCase
 {
     use MockeryPHPUnitIntegration;

tests/Feature/Commands/EraseCommandTest.php

@@ -5,11 +5,12 @@
 use Blueprint\Blueprint;
 use Blueprint\Tracer;
 use Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration;
-use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use Tests\TestCase;
 
-#[CoversClass(\Blueprint\Commands\EraseCommand::class)]
+/**
+ * @see \Blueprint\Commands\EraseCommand
+ */
 final class EraseCommandTest extends TestCase
 {
     use MockeryPHPUnitIntegration;

tests/Feature/Commands/InitCommandTest.php

@@ -3,11 +3,12 @@
 namespace Tests\Feature\Commands;
 
 use Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration;
-use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use Tests\TestCase;
 
-#[CoversClass(\Blueprint\Commands\InitCommand::class)]
+/**
+ * @see \Blueprint\Commands\InitCommand
+ */
 final class InitCommandTest extends TestCase
 {
     use MockeryPHPUnitIntegration;

tests/Feature/Commands/NewCommandTest.php

@@ -3,11 +3,12 @@
 namespace Tests\Feature\Commands;
 
 use Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration;
-use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use Tests\TestCase;
 
-#[CoversClass(\Blueprint\Commands\NewCommand::class)]
+/**
+ * @see \Blueprint\Commands\NewCommand
+ */
 final class NewCommandTest extends TestCase
 {
     use MockeryPHPUnitIntegration;

tests/Feature/Commands/TraceCommandTest.php

@@ -6,12 +6,13 @@
 use Blueprint\Builder;
 use Blueprint\Tracer;
 use Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration;
-use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use Symfony\Component\Yaml\Yaml;
 use Tests\TestCase;
 
-#[CoversClass(\Blueprint\Commands\TraceCommand::class)]
+/**
+ * @see \Blueprint\Commands\TraceCommand
+ */
 final class TraceCommandTest extends TestCase
 {
     use MockeryPHPUnitIntegration;

tests/Unit/EnumTypeTest.php

@@ -2,12 +2,13 @@
 
 namespace Tests\Unit;
 
-use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\DataProvider;
 use PHPUnit\Framework\Attributes\Test;
 use Tests\TestCase;
 
-#[CoversClass(\Blueprint\EnumType::class)]
+/**
+ * @see \Blueprint\EnumType
+ */
 final class EnumTypeTest extends TestCase
 {
     #[Test]

tests/Unit/TreeTest.php

@@ -4,11 +4,12 @@
 
 use Blueprint\Tree;
 use InvalidArgumentException;
-use PHPUnit\Framework\Attributes\CoversClass;
 use PHPUnit\Framework\Attributes\Test;
 use Tests\TestCase;
 
-#[CoversClass(\Blueprint\Tree::class)]
+/**
+ * @see \Blueprint\Tree
+ */
 final class TreeTest extends TestCase
 {
     #[Test]