Implement #[WithoutErrorHandler] attribute for #5428

Author: sebastianbergmann

src/Framework/Attributes/WithoutErrorHandler.php

@@ -0,0 +1,22 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace PHPUnit\Framework\Attributes;
+
+use Attribute;
+
+/**
+ * @psalm-immutable
+ *
+ * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
+ */
+#[Attribute(Attribute::TARGET_METHOD)]
+final class WithoutErrorHandler
+{
+}

src/Metadata/Metadata.php

@@ -364,6 +364,11 @@ public static function usesDefaultClass(string $className): UsesDefaultClass
         return new UsesDefaultClass(self::CLASS_LEVEL, $className);
     }
 
+    public static function withoutErrorHandler(): WithoutErrorHandler
+    {
+        return new WithoutErrorHandler(self::METHOD_LEVEL);
+    }
+
     protected function __construct(int $level)
     {
         $this->level = $level;
@@ -708,4 +713,12 @@ public function isUsesFunction(): bool
     {
         return false;
     }
+
+    /**
+     * @psalm-assert-if-true WithoutErrorHandler $this
+     */
+    public function isWithoutErrorHandler(): bool
+    {
+        return false;
+    }
 }

src/Metadata/MetadataCollection.php

@@ -529,4 +529,14 @@ public function isUsesFunction(): self
             ),
         );
     }
+
+    public function isWithoutErrorHandler(): self
+    {
+        return new self(
+            ...array_filter(
+                $this->metadata,
+                static fn (Metadata $metadata): bool => $metadata->isWithoutErrorHandler(),
+            ),
+        );
+    }
 }

src/Metadata/Parser/AttributeParser.php

@@ -64,6 +64,7 @@
 use PHPUnit\Framework\Attributes\Ticket;
 use PHPUnit\Framework\Attributes\UsesClass;
 use PHPUnit\Framework\Attributes\UsesFunction;
+use PHPUnit\Framework\Attributes\WithoutErrorHandler;
 use PHPUnit\Metadata\Metadata;
 use PHPUnit\Metadata\MetadataCollection;
 use PHPUnit\Metadata\Version\ConstraintRequirement;
@@ -614,6 +615,13 @@ public function forMethod(string $className, string $methodName): MetadataCollec
 
                     $result[] = Metadata::groupOnMethod($attributeInstance->text());
 
+                    break;
+
+                case WithoutErrorHandler::class:
+                    assert($attributeInstance instanceof WithoutErrorHandler);
+
+                    $result[] = Metadata::withoutErrorHandler();
+
                     break;
             }
         }

src/Metadata/WithoutErrorHandler.php

@@ -0,0 +1,23 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace PHPUnit\Metadata;
+
+/**
+ * @psalm-immutable
+ *
+ * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit
+ */
+final class WithoutErrorHandler extends Metadata
+{
+    public function isWithoutErrorHandler(): bool
+    {
+        return true;
+    }
+}

tests/_files/Metadata/Attribute/tests/WithoutErrorHandlerTest.php

@@ -0,0 +1,21 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of PHPUnit.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace PHPUnit\TestFixture\Metadata\Attribute;
+
+use PHPUnit\Framework\Attributes\WithoutErrorHandler;
+use PHPUnit\Framework\TestCase;
+
+final class WithoutErrorHandlerTest extends TestCase
+{
+    #[WithoutErrorHandler]
+    public function testOne(): void
+    {
+    }
+}

tests/unit/Metadata/MetadataCollectionTest.php

@@ -475,6 +475,14 @@ public function test_Can_be_filtered_for_UsesFunction(): void
         $this->assertTrue($collection->asArray()[0]->isUsesFunction());
     }
 
+    public function test_Can_be_filtered_for_WithoutErrorHandler(): void
+    {
+        $collection = $this->collectionWithOneOfEach()->isWithoutErrorHandler();
+
+        $this->assertCount(1, $collection);
+        $this->assertTrue($collection->asArray()[0]->isWithoutErrorHandler());
+    }
+
     private function collectionWithOneOfEach(): MetadataCollection
     {
         return MetadataCollection::fromArray(
@@ -531,6 +539,7 @@ private function collectionWithOneOfEach(): MetadataCollection
                 Metadata::usesClass(''),
                 Metadata::usesDefaultClass(''),
                 Metadata::usesFunction(''),
+                Metadata::withoutErrorHandler(),
             ],
         );
     }