feat: add roave/better-reflection reflector factory

composer.json

@@ -23,6 +23,7 @@
         "doctrine/annotations": "^1.0",
         "phpdocumentor/reflection": "^4.0 || ^5.0",
         "phpunit/phpunit": "^10.5",
+        "roave/better-reflection": "^6.0",
         "roave/security-advisories": "dev-master",
         "solido/php-coding-standards": "dev-master",
         "symfony/error-handler": "^5.0 || ^6.0 || ^7.0"

lib/Iterator/Psr0Iterator.php

@@ -13,6 +13,7 @@
 use Throwable;
 
 use function array_map;
+use function assert;
 use function class_exists;
 use function defined;
 use function in_array;
@@ -68,6 +69,8 @@ class_exists($class, true);
             null,
         );
 
+        assert($include instanceof Closure);
+
         foreach ($this->search() as $path => $info) {
             if (! preg_match($pattern, $path, $m) || ! $info->isReadable()) {
                 continue;

lib/Iterator/Psr4Iterator.php

@@ -13,6 +13,7 @@
 use Throwable;
 
 use function array_map;
+use function assert;
 use function class_exists;
 use function defined;
 use function in_array;
@@ -68,6 +69,8 @@ class_exists($class, true);
             null,
         );
 
+        assert($include instanceof Closure);
+
         foreach ($this->search() as $path => $info) {
             if (! preg_match($pattern, $path, $m) || ! $info->isReadable()) {
                 continue;

lib/Iterator/RecursiveIteratorTrait.php

@@ -27,9 +27,7 @@ private function search(): Generator
                 $files = new RecursiveIteratorIterator(
                     new RecursiveCallbackFilterIterator(
                         new RecursiveDirectoryIterator($path, FilesystemIterator::SKIP_DOTS | FilesystemIterator::FOLLOW_SYMLINKS),
-                        static function (SplFileInfo $file) {
-                            return $file->getBasename()[0] !== '.';
-                        },
+                        static fn (SplFileInfo $file): bool => $file->getBasename()[0] !== '.',
                     ),
                     RecursiveIteratorIterator::LEAVES_ONLY,
                 );

lib/Reflection/BetterReflectionReflectorFactory.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kcs\ClassFinder\Reflection;
+
+use Roave\BetterReflection\BetterReflection;
+
+class BetterReflectionReflectorFactory implements ReflectorFactoryInterface
+{
+    public function reflect(string $className): object
+    {
+        return (new BetterReflection())
+            ->reflector()
+            ->reflectClass($className);
+    }
+}

tests/unit/Reflection/BetterReflectionReflectorFactoryTest.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Kcs\ClassFinder\Tests\unit\Reflection;
+
+use Kcs\ClassFinder\Reflection\BetterReflectionReflectorFactory;
+use PHPUnit\Framework\TestCase;
+use Roave\BetterReflection\Reflection\ReflectionClass;
+
+class BetterReflectionReflectorFactoryTest extends TestCase
+{
+    public function testShouldReturnABetterReflectionReflectorObject(): void
+    {
+        $factory = new BetterReflectionReflectorFactory();
+        self::assertInstanceOf(ReflectionClass::class, $factory->reflect(self::class));
+    }
+}