Feat: Add modifiers for filtering classes by trait, interface, and inheritance in arch tests

src/PendingArchExpectation.php

@@ -72,6 +72,36 @@ public function enums(): self
         return $this;
     }
 
+    /**
+     * Filters the given "targets" by only classes implementing the given interface.
+     */
+    public function implementing(string $interface): self
+    {
+        $this->excludeCallbacks[] = fn (ObjectDescription $object): bool => ! in_array($interface, class_implements($object->name));
+
+        return $this;
+    }
+
+    /**
+     * Filters the given "targets" by only classes extending the given class.
+     */
+    public function extending(string $parentClass): self
+    {
+        $this->excludeCallbacks[] = fn (ObjectDescription $object): bool => ! is_subclass_of($object->name, $parentClass);
+
+        return $this;
+    }
+
+    /**
+     * Filters the given "targets" by only classes using the given trait.
+     */
+    public function usingTrait(string $trait): self
+    {
+        $this->excludeCallbacks[] = fn (ObjectDescription $object): bool => ! in_array($trait, class_uses($object->name));
+
+        return $this;
+    }
+
     /**
      * Creates an opposite expectation.
      */

tests/Fixtures/Controllers/UserController.php

@@ -4,9 +4,12 @@
 
 use Tests\Fixtures\Contracts\Controllers\Indexable;
 use Tests\Fixtures\Controller;
+use Tests\Fixtures\HasResponses;
 
 class UserController extends Controller implements Indexable
 {
+    use HasResponses;
+
     public function index(): array
     {
         return [

tests/Fixtures/HasResponses.php

@@ -0,0 +1,5 @@
+<?php
+
+namespace Tests\Fixtures;
+
+trait HasResponses {}

tests/Modifiers.php

@@ -0,0 +1,23 @@
+<?php
+
+use Tests\Fixtures\Contracts\Controllers\Indexable;
+use Tests\Fixtures\Controller;
+use Tests\Fixtures\HasResponses;
+
+test('only classes extending Controller are tested', function (): void {
+    expect('Tests\Fixtures\Controllers')
+        ->extending(Controller::class)
+        ->toExtend(Controller::class);
+});
+
+test('only classes implementing interfaces are tested', function (): void {
+    expect('Tests\Fixtures\Controllers')
+        ->implementing(Indexable::class)
+        ->toImplement(Indexable::class);
+});
+
+test('only class using traits are tested', function (): void {
+    expect('Tests\Fixtures\Controllers')
+        ->usingTrait(Tests\Fixtures\HasResponses::class)
+        ->toUseTrait(HasResponses::class);
+});