feat: add alias for MapperBuilder

.github/workflows/quality-assurance.yml

@@ -37,12 +37,6 @@ jobs:
       - name: Warming up cache
         run: php tests/App/bin/console cache:warmup --env=test
 
-      - name: TODO TMP
-        run: |
-          pwd
-          ls -al var/cache/test
-          ls -al var/cache/test/default
-
       - name: Running PHPStan
         run: php vendor/bin/phpstan
 

README.md

@@ -99,6 +99,33 @@ services:
 
 </details>
 
+---
+
+For more granular control, a `MapperBuilder` instance can be injected instead.
+
+```php
+use CuyZ\Valinor\Mapper\MapperBuilder;
+
+final class SomeAutowiredService
+{
+    public function __construct(
+        private MapperBuilder $mapperBuilder,
+    ) {}
+
+    public function someMethod(): void
+    {
+        $this->mapperBuilder
+            // …
+            // Some mapper configuration 
+            // …
+            ->mapper()
+            ->map(SomeDto::class, /* … */);
+
+        // …
+    }
+}
+````
+
 ## Bundle configuration
 
 Global configuration for the bundle can be done in a package configuration file…

composer.json

@@ -12,7 +12,7 @@
         }
     ],
     "require": {
-        "php": "~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0",
+        "php": "~8.1.0 || ~8.2.0 || ~8.3.0",
         "cuyz/valinor": "^1.0",
         "symfony/config": "^5.4 || ^6.4 || ^7.0",
         "symfony/dependency-injection": "^5.4 || ^6.4 || ^7.0",

src/Resources/config/services.php

@@ -47,6 +47,7 @@
     // @formatter:off
     $container->services()
         ->alias(TreeMapper::class, 'valinor.tree_mapper')
+        ->alias(MapperBuilder::class, 'valinor.mapper_builder')
 
         ->set('valinor.tree_mapper', TreeMapper::class)
             ->factory([service('valinor.mapper_builder'), 'mapper'])

tests/App/src/Cache/CacheSpy.php

@@ -9,6 +9,7 @@
 
 use function array_filter;
 use function count;
+use function method_exists;
 
 final class CacheSpy implements CacheInterface
 {
@@ -25,7 +26,19 @@ public function hasCachedClassDefinition(string $className): bool
     {
         $definitions = array_filter(
             $this->calls,
-            static fn (mixed $value): bool => $value instanceof ClassDefinition && $value->name() === $className
+            static function (mixed $value) use ($className): bool {
+                if (! $value instanceof ClassDefinition) {
+                    return false;
+                }
+
+                // @phpstan-ignore-next-line
+                if (method_exists($value, 'name')) {
+                    return $value->name() === $className;
+                }
+
+                // @phpstan-ignore-next-line
+                return $value->name === $className;
+            }
         );
 
         return count($definitions) > 0;

tests/App/src/Mapper/MapperContainer.php

@@ -5,6 +5,7 @@
 namespace CuyZ\ValinorBundle\Tests\App\Mapper;
 
 use CuyZ\Valinor\Mapper\TreeMapper;
+use CuyZ\Valinor\MapperBuilder;
 use CuyZ\ValinorBundle\Configurator\Attributes\AllowPermissiveTypes;
 use CuyZ\ValinorBundle\Configurator\Attributes\AllowSuperfluousKeys;
 use CuyZ\ValinorBundle\Configurator\Attributes\EnableFlexibleCasting;
@@ -14,6 +15,7 @@
 final class MapperContainer
 {
     public function __construct(
+        public MapperBuilder $mapperBuilder,
         public TreeMapper $defaultMapper,
         #[EnableFlexibleCasting]
         public TreeMapper $mapperWithFlexibleCasting,

tests/Integration/MapperBuilderTest.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CuyZ\ValinorBundle\Tests\Integration;
+
+final class MapperBuilderTest extends IntegrationTestCase
+{
+    public function test_mapper_builder_is_injected_and_works_properly(): void
+    {
+        $result = $this->mapperContainer()
+            ->mapperBuilder
+            ->mapper()
+            ->map('string', 'foo');
+
+        self::assertSame('foo', $result);
+    }
+}