Add predicateForAttributeInstanceOf()

Author: olvlvl

MIGRATION.md

@@ -10,7 +10,7 @@ None
 
 - [#11](https://github.com/olvlvl/composer-attribute-collector/pull/11) Attribute instantiation errors are decorated to help find origin (@withinboredom @olvlvl)
 - [#12](https://github.com/olvlvl/composer-attribute-collector/pull/12) `Attributes::filterTargetClasses()` can filter target classes using a predicate (@olvlvl)
-- [#12](https://github.com/olvlvl/composer-attribute-collector/pull/12) `Attributes::filterTargetMethods()` can filter target methods using a predicate (@olvlvl)
+- [#12](https://github.com/olvlvl/composer-attribute-collector/pull/12) `Attributes::filterTargetMethods()` can filter target methods using a predicate. `Attributes::predicateForAttributeInstanceOf()` can be used to create a predicate to filter classes or methods targeted by an attribute class or subclass (@olvlvl)
 - [#10](https://github.com/olvlvl/composer-attribute-collector/pull/10) 3 types of cache speed up generation by limiting updates to changed files (@xepozz @olvlvl)
 
 ### Backward Incompatible Changes

README.md

@@ -350,7 +350,7 @@ Because the `Get` and `Post` attributes extend `Route`, all action methods can b
 ```php
 /** @var TargetMethod<Route>[] $target_methods */
 $target_methods = Attributes::filterTargetMethods(
-    fn($attribute) => is_a($attribute, Route::class, true)
+    Attributes::predicateForAttributeInstanceOf(Route::class)
 );
 ```
 
@@ -399,7 +399,7 @@ $target_methods = [
 
 /** @var TargetMethod<Route>[] $target_methods */
 $target_methods = Attributes::filterTargetMethods(
-    fn($attribute) => is_a($attribute, Route::class, true)
+    Attributes::predicateForAttributeInstanceOf(Route::class)
 );
 ```
 

src/Attributes.php

@@ -12,6 +12,8 @@
 use Closure;
 use LogicException;
 
+use function is_a;
+
 final class Attributes
 {
     /**
@@ -74,6 +76,16 @@ public static function filterTargetMethods(callable $predicate): array
         return self::getCollection()->filterTargetMethods($predicate);
     }
 
+    /**
+     * @param class-string $class
+     *
+     * @return Closure(class-string $attribute):bool
+     */
+    public static function predicateForAttributeInstanceOf(string $class): Closure
+    {
+        return fn(string $attribute): bool => is_a($attribute, $class, true);
+    }
+
     /**
      * @var array<class-string, ForClass>
      */

tests/PluginTest.php

@@ -201,7 +201,7 @@ public function testFilterTargetClasses(): void
     public function testFilterTargetMethods(): void
     {
         $actual = Attributes::filterTargetMethods(
-            fn($attribute) => is_a($attribute, Route::class, true)
+            Attributes::predicateForAttributeInstanceOf(Route::class)
         );
 
         $this->assertEquals([