#581: Add OverrideStrategy enum for the fakeable trait to support merge/replace

src/Testing/Enums/OverrideStrategy.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenAI\Testing\Enums;
+
+enum OverrideStrategy: string
+{
+    case Merge = 'merge';
+    case Replace = 'replace';
+}

src/Testing/Responses/Concerns/Fakeable.php

@@ -5,44 +5,27 @@
 namespace OpenAI\Testing\Responses\Concerns;
 
 use OpenAI\Responses\Meta\MetaInformation;
+use OpenAI\Testing\Enums\OverrideStrategy;
 
 trait Fakeable
 {
     /**
-     * @param  array<string, mixed>  $override
+     * @param array<string, mixed> $override
      */
-    public static function fake(array $override = [], ?MetaInformation $meta = null): static
+    public static function fake(
+        array $override = [],
+        ?MetaInformation $meta = null,
+        OverrideStrategy $strategy = OverrideStrategy::Merge,
+    ): static
     {
         $class = str_replace('OpenAI\\Responses\\', 'OpenAI\\Testing\\Responses\\Fixtures\\', static::class).'Fixture';
 
         return static::from(
-            self::buildAttributes($class::ATTRIBUTES, $override),
+            self::buildAttributes($class::ATTRIBUTES, $override, $strategy),
             $meta ?? self::fakeResponseMetaInformation(),
         );
     }
 
-    /**
-     * @return mixed[]
-     */
-    private static function buildAttributes(array $original, array $override): array
-    {
-        $new = [];
-
-        foreach ($original as $key => $entry) {
-            $new[$key] = is_array($entry)
-                ? self::buildAttributes($entry, $override[$key] ?? [])
-                : $override[$key] ?? $entry;
-            unset($override[$key]);
-        }
-
-        // we are going to append all remaining overrides
-        foreach ($override as $key => $value) {
-            $new[$key] = $value;
-        }
-
-        return $new;
-    }
-
     public static function fakeResponseMetaInformation(): MetaInformation
     {
         return MetaInformation::from([
@@ -59,4 +42,22 @@ public static function fakeResponseMetaInformation(): MetaInformation
             'x-request-id' => ['3813fa4fa3f17bdf0d7654f0f49ebab4'],
         ]);
     }
+
+    /**
+     * @param array $original
+     * @param array $override
+     * @param \OpenAI\Testing\Enums\OverrideStrategy $strategy
+     *
+     * @return array
+     */
+    private static function buildAttributes(
+        array $original,
+        array $override,
+        OverrideStrategy $strategy = OverrideStrategy::Merge): array
+    {
+        return match ($strategy) {
+            OverrideStrategy::Replace => array_replace($original, $override),
+            OverrideStrategy::Merge => array_replace_recursive($original, $override),
+        };
+    }
 }