MetaLoader: preload excludes, tests

Author: mabar

composer.json

@@ -36,6 +36,7 @@
 		"orisai/reflection-meta": "^1.0.0",
 		"orisai/source-map": "^1.0.0",
 		"orisai/utils": "^1.0.0",
+		"symfony/filesystem": "^5.4.0|^6.0.0",
 		"symfony/polyfill-php80": "^1.27.0"
 	},
 	"require-dev": {

docs/README.md

@@ -1858,6 +1858,17 @@ $metaLoader->preloadFromPaths([
 ]);
 ```
 
+You may as well exclude paths
+
+```php
+$metaLoader->preloadFromPaths([
+	__DIR__ . '/path1',
+	__DIR__ . '/path2',
+], [
+	__DIR__ . '/path1/excluded',
+]);
+```
+
 ## Tracking input values
 
 Track input values of every mapped object in hierarchy, before they were processed by rules.

src/Meta/MetaLoader.php

@@ -13,12 +13,15 @@
 use Orisai\SourceMap\ClassSource;
 use ReflectionClass;
 use ReflectionEnum;
+use Symfony\Component\Filesystem\Path;
 use function array_merge;
 use function array_unique;
 use function array_values;
 use function assert;
 use function class_exists;
+use function interface_exists;
 use function is_subclass_of;
+use function trait_exists;
 
 final class MetaLoader
 {
@@ -147,18 +150,30 @@ private function createRuntimeMeta(ReflectionClass $class): array
 
 	/**
 	 * @param list<string> $paths
+	 * @param list<string> $excludePaths
 	 */
-	public function preloadFromPaths(array $paths): void
+	public function preloadFromPaths(array $paths, array $excludePaths = []): void
 	{
 		$loader = new RobotLoader();
+		$loader->reportParseErrors(false);
+
 		foreach ($paths as $path) {
 			$loader->addDirectory($path);
 		}
 
 		$loader->rebuild();
 
 		foreach ($loader->getIndexedClasses() as $class => $file) {
-			assert(class_exists($class));
+			foreach ($excludePaths as $excludePath) {
+				if (Path::isBasePath($excludePath, $file)) {
+					continue 2;
+				}
+			}
+
+			require_once $file;
+
+			assert(class_exists($class) || interface_exists($class) || trait_exists($class));
+
 			$classRef = new ReflectionClass($class);
 
 			if (!$classRef->isSubclassOf(MappedObject::class)) {

tests/Unit/Meta/MetaLoaderTest.php

@@ -8,6 +8,7 @@
 use Tests\Orisai\ObjectMapper\Doubles\FieldNames\FieldNameIdenticalWithAnotherPropertyNameVO;
 use Tests\Orisai\ObjectMapper\Doubles\FieldNames\MultipleIdenticalFieldNamesVO;
 use Tests\Orisai\ObjectMapper\Toolkit\ProcessingTestCase;
+use const PHP_VERSION_ID;
 
 final class MetaLoaderTest extends ProcessingTestCase
 {
@@ -69,4 +70,42 @@ public function testMultipleIdenticalPropertyNames(): void
 		$this->metaLoader->load(ChildCollidingFieldVO::class);
 	}
 
+	/**
+	 * @runInSeparateProcess
+	 */
+	public function testPreload(): void
+	{
+		$excludes = [];
+		$excludes[] = __DIR__ . '/../../Doubles/FieldNames/FieldNameIdenticalWithAnotherPropertyNameVO.php';
+		$excludes[] = __DIR__ . '/../../Doubles/FieldNames/MultipleIdenticalFieldNamesVO.php';
+		$excludes[] = __DIR__ . '/../../Doubles/FieldNames/ChildCollidingFieldVO.php';
+		$excludes[] = __DIR__ . '/../../Doubles/Constructing/DependentVO.php';
+
+		if (PHP_VERSION_ID < 8_00_00) {
+			$excludes[] = __DIR__ . '/../../Doubles/PhpVersionSpecific/AttributesVO.php';
+		}
+
+		if (PHP_VERSION_ID < 8_01_00) {
+			$excludes[] = __DIR__ . '/../../Doubles/Callbacks/ObjectInitializingVoPhp81.php';
+			$excludes[] = __DIR__ . '/../../Doubles/Enums';
+			$excludes[] = __DIR__ . '/../../Doubles/PhpVersionSpecific/ConstructorPromotedVO.php';
+			$excludes[] = __DIR__ . '/../../Doubles/PhpVersionSpecific/ObjectDefaultVO.php';
+			$excludes[] = __DIR__ . '/../../Doubles/PhpVersionSpecific/ReadonlyPropertiesVO.php';
+		}
+
+		if (PHP_VERSION_ID < 8_02_00) {
+			$excludes[] = __DIR__ . '/../../Doubles/PhpVersionSpecific/ReadonlyClassVO.php';
+		}
+
+		$this->metaLoader->preloadFromPaths(
+			[
+				__DIR__ . '/../../Doubles',
+			],
+			$excludes,
+		);
+
+		// Makes PHPUnit happy
+		self::assertTrue(true);
+	}
+
 }

tools/phpstan.baseline.neon

@@ -20,6 +20,11 @@ parameters:
 			count: 1
 			path: ../tests/Doubles/Inheritance/trait-callback.php
 
+		-
+			message: "#^Call to static method PHPUnit\\\\Framework\\\\Assert\\:\\:assertTrue\\(\\) with true will always evaluate to true\\.$#"
+			count: 1
+			path: ../tests/Unit/Meta/MetaLoaderTest.php
+
 		-
 			message: "#^Call to static method PHPUnit\\\\Framework\\\\Assert\\:\\:assertSame\\(\\) with ReflectionClass\\<Tests\\\\Orisai\\\\ObjectMapper\\\\Unit\\\\Meta\\\\Runtime\\\\CallbackRuntimeMetaTest\\> and ReflectionClass\\<Orisai\\\\ObjectMapper\\\\MappedObject\\> will always evaluate to false\\.$#"
 			count: 1