feat: adds pest-arch-ignore-line or pest-arch-ignore-next-line

phpstan.neon

@@ -15,4 +15,3 @@ parameters:
     ignoreErrors:
         - "#has a nullable return type declaration.#"
         - "# with a nullable type declaration.#"
-        - "#has parameter \\$closure with null as default value.#"

src/Autoload.php

@@ -15,9 +15,9 @@
      * argument is the test description; the second argument
      * is a closure that contains the test expectations.
      */
-    function arch(?string $description = null, ?Closure $closure = null): TestCall
+    function arch(?string $description = null, ?Closure $closure = null): TestCall // @phpstan-ignore-line
     {
-        $test = test(...func_get_args());
+        $test = test(...func_get_args()); // @phpstan-ignore-line
 
         assert(! $test instanceof HigherOrderTapProxy);
 

src/Blueprint.php

@@ -109,7 +109,29 @@ public function targeted(callable $callback, LayerOptions $options, callable $fa
                 }
 
                 $path = (string) realpath($object->path);
+
                 $line = $lineFinder($path);
+
+                $file = file($path);
+
+                if (is_array($file)) {
+                    if (array_key_exists($line - 1, $file)) {
+                        $lineContent = $file[$line - 1];
+
+                        if (str_contains($lineContent, '@pest-arch-ignore-line')) {
+                            continue;
+                        }
+                    }
+
+                    if (array_key_exists($line - 2, $file)) {
+                        $lineContent = $file[$line - 2];
+
+                        if (str_contains($lineContent, '@pest-arch-ignore-next-line')) {
+                            continue;
+                        }
+                    }
+                }
+
                 $path = substr($path, strlen(TestSuite::getInstance()->rootPath) + 1);
 
                 $failure(new Violation($path, $line, $line));
@@ -229,6 +251,7 @@ private function getUsagePathAndLines(Layer $layer, string $objectName, string $
         /** @var ObjectDescription $dependOnObject */
         $dependOnObject = array_pop($dependOnObjects);
 
+        /** @var class-string<\PhpParser\Node> $class */
         $class = PhpCoreExpressions::getClass($target) ?? Name::class;
 
         $nodes = ServiceContainer::$nodeFinder->findInstanceOf(

src/Concerns/Architectable.php

@@ -21,7 +21,7 @@ trait Architectable
      */
     public function arch(): TestCaseOptions
     {
-        $options = $this->options ??= new TestCaseOptions();
+        $options = $this->options ??= new TestCaseOptions;
 
         return $this->options = $options;
     }

src/Objects/FunctionDescription.php

@@ -18,11 +18,11 @@ final class FunctionDescription extends ObjectDescription // @phpstan-ignore-lin
      */
     public static function make(string $path): self
     {
-        $description = new self();
+        $description = new self;
 
         try {
-            $description->path = (new ReflectionFunction($path))->getFileName();
-        } catch (\Throwable) {
+            $description->path = (string) (new ReflectionFunction($path))->getFileName();
+        } catch (\Throwable) { // @phpstan-ignore-line
             $description->path = $path;
         }
 

src/Objects/VendorObjectDescription.php

@@ -17,7 +17,7 @@ final class VendorObjectDescription extends ObjectDescription // @phpstan-ignore
      */
     public static function make(string $path): ?self // @phpstan-ignore-line
     {
-        $object = new self();
+        $object = new self;
 
         try {
             $vendorObject = ObjectDescriptionBase::make($path);

src/PendingArchExpectation.php

@@ -30,8 +30,7 @@ final class PendingArchExpectation
     public function __construct(
         private readonly Expectation $expectation,
         private array $excludeCallbacks,
-    ) {
-    }
+    ) {}
 
     /**
      * Filters the given "targets" by only classes.

tests/Fixtures/Controller.php

@@ -4,6 +4,4 @@
 
 namespace Tests\Fixtures;
 
-abstract class Controller
-{
-}
+abstract class Controller {}

tests/Fixtures/Controllers/ProductController.php

@@ -11,7 +11,7 @@ final class ProductController
     public function index(): array
     {
         return [
-            new Product(),
+            new Product,
         ];
     }
 }

tests/Fixtures/Functions.php

@@ -1,7 +1,5 @@
 <?php
 
 if (! function_exists('my_request_global_function')) {
-    function my_request_global_function(): void
-    {
-    }
+    function my_request_global_function(): void {}
 }

tests/Fixtures/Misc/DependsOnVendor.php

@@ -8,6 +8,6 @@ class DependsOnVendor
 {
     public function makeStrFromVendor(): Str
     {
-        return new Str();
+        return new Str;
     }
 }

tests/Fixtures/NamespacedFunctions.php

@@ -2,8 +2,6 @@
 
 namespace Tests\Fixtures {
     if (! function_exists('my_request_namespaced_function')) {
-        function my_request_namespaced_function(): void
-        {
-        }
+        function my_request_namespaced_function(): void {}
     }
 }

tests/Fixtures/Support/Env.php

@@ -2,6 +2,4 @@
 
 namespace Tests\Fixtures\Support;
 
-class Env
-{
-}
+class Env {}