feat: adds deep copy infrastructure

Signed-off-by: Vincent Biret <vibiret@microsoft.com>

Author: baywet

src/Microsoft.OpenApi/Interfaces/IDeepCopyable.cs

@@ -0,0 +1,16 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT license.
+
+namespace Microsoft.OpenApi;
+/// <summary>
+/// Interface for deep copyable objects.
+/// </summary>
+/// <typeparam name="T">The type of the resulting object.</typeparam>
+public interface IDeepCopyable<out T>
+{
+    /// <summary>
+    /// Create a deep copy of the current instance.
+    /// </summary>
+    T CreateDeepCopy();
+}
+

src/Microsoft.OpenApi/Models/BaseOpenApiReference.cs

@@ -295,6 +295,12 @@ internal void EnsureHostDocumentIsSet(OpenApiDocument currentDocument)
             Utils.CheckArgumentNull(currentDocument);
             hostDocument ??= currentDocument;
         }
+
+        internal void SetHostDocument(OpenApiDocument currentDocument)
+        {
+            Utils.CheckArgumentNull(currentDocument);
+            hostDocument = currentDocument;
+        }
         /// <summary>
         /// Gets the property value from a JsonObject node.
         /// </summary>

src/Microsoft.OpenApi/Models/OpenApiCallback.cs

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT license.
 
 using System;
@@ -9,7 +9,7 @@ namespace Microsoft.OpenApi
     /// <summary>
     /// Callback Object: A map of possible out-of band callbacks related to the parent operation.
     /// </summary>
-    public class OpenApiCallback : IOpenApiExtensible, IOpenApiCallback
+    public class OpenApiCallback : IOpenApiExtensible, IOpenApiCallback, IDeepCopyable<IOpenApiCallback>
     {
         /// <inheritdoc/>
         public Dictionary<RuntimeExpression, IOpenApiPathItem>? PathItems { get; set; }
@@ -113,5 +113,10 @@ public IOpenApiCallback CreateShallowCopy()
         {
             return new OpenApiCallback(this);
         }
+        /// <inheritdoc/>
+        public IOpenApiCallback CreateDeepCopy()
+        {
+            return new OpenApiDeepCopyContext().Copy(this);
+        }
     }
 }

src/Microsoft.OpenApi/Models/OpenApiComponents.cs

@@ -10,7 +10,7 @@ namespace Microsoft.OpenApi
     /// <summary>
     /// Components Object.
     /// </summary>
-    public class OpenApiComponents : IOpenApiSerializable, IOpenApiExtensible
+    public class OpenApiComponents : IOpenApiSerializable, IOpenApiExtensible, IDeepCopyable<OpenApiComponents>
     {
         /// <summary>
         /// An object to hold reusable <see cref="IOpenApiSchema"/> Objects.
@@ -96,6 +96,12 @@ public OpenApiComponents(OpenApiComponents? components)
             Extensions = components?.Extensions != null ? new Dictionary<string, IOpenApiExtension>(components.Extensions) : null;
         }
 
+        /// <inheritdoc/>
+        public OpenApiComponents CreateDeepCopy()
+        {
+            return new OpenApiDeepCopyContext().Copy(this);
+        }
+
         /// <summary>
         /// Serialize <see cref="OpenApiComponents"/> to Open API v3.2.
         /// </summary>

src/Microsoft.OpenApi/Models/OpenApiContact.cs

@@ -1,4 +1,4 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
+// Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT license.
 
 using System;
@@ -9,7 +9,7 @@ namespace Microsoft.OpenApi
     /// <summary>
     /// Contact Object.
     /// </summary>
-    public class OpenApiContact : IOpenApiSerializable, IOpenApiExtensible
+    public class OpenApiContact : IOpenApiSerializable, IOpenApiExtensible, IDeepCopyable<OpenApiContact>
     {
         /// <summary>
         /// The identifying name of the contact person/organization.
@@ -47,6 +47,11 @@ public OpenApiContact(OpenApiContact contact)
             Email = contact?.Email ?? Email;
             Extensions = contact?.Extensions != null ? new Dictionary<string, IOpenApiExtension>(contact.Extensions) : null;
         }
+        /// <inheritdoc/>
+        public OpenApiContact CreateDeepCopy()
+        {
+            return new OpenApiDeepCopyContext().Copy(this);
+        }
         /// <summary>
         /// Serialize <see cref="OpenApiContact"/> to Open Api v3.2
         /// </summary>