feat(lazy): checking lazy should be optional

Author: joelwurtz

src/Generator/MapMethodStatementsGenerator.php

@@ -241,28 +241,49 @@ private function isSourceIsLazyProxy(GeneratorMetadata $metadata): array
             ]),
         ];
 
-        if (!interface_exists(LazyObjectInterface::class)) {
-            return $statements;
+        if (interface_exists(LazyObjectInterface::class)) {
+            /**
+             *  ```php
+             *  if ($source instanceof LazyObjectInterface) {
+             *     $source->initializeLazyObject();
+             *  } else {
+             *      ...
+             *  }
+             *  ```.
+             */
+            $statements = [
+                new Stmt\If_(new Expr\Instanceof_($metadata->variableRegistry->getSourceInput(), new Name\FullyQualified(LazyObjectInterface::class)), [
+                    'stmts' => [
+                        new Stmt\Expression(
+                            new Expr\MethodCall($metadata->variableRegistry->getSourceInput(), 'initializeLazyObject')
+                        ),
+                    ],
+                    'else' => new Stmt\Else_($statements),
+                ]),
+            ];
         }
 
         /**
-         *  ```php
-         *  if ($source instanceof LazyObjectInterface) {
-         *     $source->initializeLazyObject();
-         *  } else {
-         *      ...
-         *  }
-         *  ```.
+         * ```php
+         * if ($context[MapperContext::INITIALIZE_LAZY_OBJECT] ?? false) {
+         *     ...
+         * }
+         * ```.
          */
+
         return [
-            new Stmt\If_(new Expr\Instanceof_($metadata->variableRegistry->getSourceInput(), new Name\FullyQualified(LazyObjectInterface::class)), [
-                'stmts' => [
-                    new Stmt\Expression(
-                        new Expr\MethodCall($metadata->variableRegistry->getSourceInput(), 'initializeLazyObject')
+            new Stmt\If_(
+                new Expr\BinaryOp\Coalesce(
+                    new Expr\ArrayDimFetch(
+                        $metadata->variableRegistry->getContext(),
+                        new Scalar\String_(MapperContext::INITIALIZE_LAZY_OBJECT)
                     ),
-                ],
-                'else' => new Stmt\Else_($statements),
-            ]),
+                    new Expr\ConstFetch(new Name('false'))
+                ),
+                [
+                    'stmts' => $statements,
+                ]
+            ),
         ];
     }
 

src/MapperContext.php

@@ -33,30 +33,33 @@
  *   "datetime_format"?: string,
  *   "datetime_force_timezone"?: string,
  *   "map_to_accessor_parameter"?: array<string, string>,
- *   "normalizer_format"?: string
+ *   "normalizer_format"?: string,
+ *   "initialize_lazy_object"?: bool,
+ *   "lazy_mapping"?: bool,
  * }
  */
 class MapperContext
 {
-    public const GROUPS = 'groups';
-    public const ALLOWED_ATTRIBUTES = 'allowed_attributes';
-    public const IGNORED_ATTRIBUTES = 'ignored_attributes';
-    public const CIRCULAR_REFERENCE_LIMIT = 'circular_reference_limit';
-    public const CIRCULAR_REFERENCE_HANDLER = 'circular_reference_handler';
-    public const CIRCULAR_REFERENCE_REGISTRY = 'circular_reference_registry';
-    public const CIRCULAR_COUNT_REFERENCE_REGISTRY = 'circular_count_reference_registry';
-    public const DEPTH = 'depth';
-    public const TARGET_TO_POPULATE = 'target_to_populate';
-    public const DEEP_TARGET_TO_POPULATE = 'deep_target_to_populate';
-    public const CONSTRUCTOR_ARGUMENTS = 'constructor_arguments';
-    public const SKIP_NULL_VALUES = 'skip_null_values';
-    public const SKIP_UNINITIALIZED_VALUES = 'skip_uninitialized_values';
-    public const ALLOW_READONLY_TARGET_TO_POPULATE = 'allow_readonly_target_to_populate';
-    public const DATETIME_FORMAT = 'datetime_format';
-    public const DATETIME_FORCE_TIMEZONE = 'datetime_force_timezone';
-    public const MAP_TO_ACCESSOR_PARAMETER = 'map_to_accessor_parameter';
-    public const NORMALIZER_FORMAT = 'normalizer_format';
-    public const LAZY_MAPPING = 'lazy_mapping';
+    public const string GROUPS = 'groups';
+    public const string ALLOWED_ATTRIBUTES = 'allowed_attributes';
+    public const string IGNORED_ATTRIBUTES = 'ignored_attributes';
+    public const string CIRCULAR_REFERENCE_LIMIT = 'circular_reference_limit';
+    public const string CIRCULAR_REFERENCE_HANDLER = 'circular_reference_handler';
+    public const string CIRCULAR_REFERENCE_REGISTRY = 'circular_reference_registry';
+    public const string CIRCULAR_COUNT_REFERENCE_REGISTRY = 'circular_count_reference_registry';
+    public const string DEPTH = 'depth';
+    public const string TARGET_TO_POPULATE = 'target_to_populate';
+    public const string DEEP_TARGET_TO_POPULATE = 'deep_target_to_populate';
+    public const string CONSTRUCTOR_ARGUMENTS = 'constructor_arguments';
+    public const string SKIP_NULL_VALUES = 'skip_null_values';
+    public const string SKIP_UNINITIALIZED_VALUES = 'skip_uninitialized_values';
+    public const string ALLOW_READONLY_TARGET_TO_POPULATE = 'allow_readonly_target_to_populate';
+    public const string DATETIME_FORMAT = 'datetime_format';
+    public const string DATETIME_FORCE_TIMEZONE = 'datetime_force_timezone';
+    public const string MAP_TO_ACCESSOR_PARAMETER = 'map_to_accessor_parameter';
+    public const string NORMALIZER_FORMAT = 'normalizer_format';
+    public const string INITIALIZE_LAZY_OBJECT = 'initialize_lazy_object';
+    public const string LAZY_MAPPING = 'lazy_mapping';
 
     /** @var MapperContextArray */
     private array $context = [

src/ObjectMapper/ObjectMapper.php

@@ -68,6 +68,7 @@ public function map(object $source, object|string|null $target = null): object
 
         return $this->autoMapper->map($source, $target, [
             MapperContext::SKIP_UNINITIALIZED_VALUES => true,
+            MapperContext::INITIALIZE_LAZY_OBJECT => true,
         ]);
     }