Added comparison logic for

- OpenApiInfo
- OpenApiContact
- OpenApiLicense
- OpenApiExternalDocs
- OpenApiSecurityRequirements
- OpenApiTag

Author: Shwetap05

src/Microsoft.OpenApi/Services/OpenApiComparerBase.cs

@@ -2,6 +2,8 @@
 // Licensed under the MIT license.
 
 using System;
+using System.Collections.Generic;
+using System.Linq;
 using Microsoft.OpenApi.Models;
 
 namespace Microsoft.OpenApi.Services
@@ -46,6 +48,32 @@ internal void Compare(string source, string target, ComparisonContext comparison
             }
         }
 
+        /// <summary>
+        /// Compares two Uri object.
+        /// </summary>
+        /// <param name="source">The source.</param>
+        /// <param name="target">The target.</param>
+        /// <param name="comparisonContext">The context under which to compare the objects.</param>
+        internal void Compare(Uri source, Uri target, ComparisonContext comparisonContext)
+        {
+            if (source == null && target == null)
+            {
+                return;
+            }
+
+            if (source != target)
+            {
+                comparisonContext.AddOpenApiDifference(new OpenApiDifference
+                {
+                    OpenApiDifferenceOperation = OpenApiDifferenceOperation.Update,
+                    OpenApiComparedElementType = typeof(Uri),
+                    SourceValue = source,
+                    TargetValue = target,
+                    Pointer = comparisonContext.PathString
+                });
+            }
+        }
+
         /// <summary>
         /// Compares two boolean object.
         /// </summary>
@@ -138,6 +166,125 @@ internal void Compare<TEnum>(Enum source, Enum target, ComparisonContext compari
             }
         }
 
+        /// <summary>
+        /// Compares <see cref="OpenApiReference"/> object.
+        /// </summary>
+        /// <param name="sourceReference">The source.</param>
+        /// <param name="targetReference">The target.</param>
+        /// <param name="comparisonContext">The context under which to compare the objects.</param>
+        internal void Compare<TReference>(
+            OpenApiReference sourceReference,
+            OpenApiReference targetReference,
+            ComparisonContext comparisonContext)
+        {
+            if (sourceReference == null && targetReference == null)
+            {
+                return;
+            }
+
+            if (sourceReference == null || targetReference == null)
+            {
+                comparisonContext.AddOpenApiDifference(
+                    new OpenApiDifference
+                    {
+                        OpenApiDifferenceOperation = OpenApiDifferenceOperation.Update,
+                        SourceValue = sourceReference,
+                        TargetValue = targetReference,
+                        OpenApiComparedElementType = typeof(OpenApiReference),
+                        Pointer = comparisonContext.PathString
+                    });
+
+                return;
+            }
+
+            if (sourceReference.Id != targetReference.Id || sourceReference.Type != targetReference.Type)
+            {
+                WalkAndAddOpenApiDifference(
+                    comparisonContext,
+                    OpenApiConstants.DollarRef,
+                    new OpenApiDifference
+                    {
+                        OpenApiDifferenceOperation = OpenApiDifferenceOperation.Update,
+                        SourceValue = sourceReference,
+                        TargetValue = targetReference,
+                        OpenApiComparedElementType = typeof(OpenApiReference)
+                    });
+
+                return;
+            }
+
+            var source = (TReference) comparisonContext.SourceDocument.ResolveReference(
+                sourceReference);
+
+            var target = (TReference) comparisonContext.TargetDocument.ResolveReference(
+                targetReference);
+
+            comparisonContext
+                .GetComparer<TReference>()
+                .Compare(source, target, comparisonContext);
+        }
+
+        /// <summary>
+        /// Compares <see cref="IDictionary{TKey,TValue}"/> where TKey is <see cref="string"/> and TValue is
+        /// <see cref="string"/>.
+        /// </summary>
+        /// <param name="source">The source.</param>
+        /// <param name="target">The target.</param>
+        /// <param name="comparisonContext">The context under which to compare the objects.</param>
+        internal void Compare(IDictionary<string, string> source, IDictionary<string, string> target,
+            ComparisonContext comparisonContext)
+        {
+            if (source == null && target == null)
+            {
+                return;
+            }
+
+            if (source == null || target == null)
+            {
+                comparisonContext.AddOpenApiDifference(
+                    new OpenApiDifference
+                    {
+                        OpenApiDifferenceOperation = OpenApiDifferenceOperation.Update,
+                        SourceValue = source,
+                        TargetValue = target,
+                        OpenApiComparedElementType = typeof(IDictionary<string, T>),
+                        Pointer = comparisonContext.PathString
+                    });
+
+                return;
+            }
+
+            var newKeysInTarget = target.Keys.Except(source.Keys).ToList();
+
+            foreach (var newKeyInTarget in newKeysInTarget)
+            {
+                comparisonContext.AddOpenApiDifference(
+                    new OpenApiDifference
+                    {
+                        OpenApiDifferenceOperation = OpenApiDifferenceOperation.Add,
+                        TargetValue = new KeyValuePair<string, string>(
+                            newKeyInTarget,
+                            target[newKeyInTarget]),
+                        OpenApiComparedElementType = typeof(KeyValuePair<string, string>)
+                    });
+            }
+
+            var removedKeysFromSource = source.Keys.Except(target.Keys).ToList();
+
+            foreach (var removedKeyFromSource in removedKeysFromSource)
+            {
+                comparisonContext.AddOpenApiDifference(
+                    new OpenApiDifference
+                    {
+                        OpenApiDifferenceOperation = OpenApiDifferenceOperation.Add,
+                        TargetValue = new KeyValuePair<string, string>(
+                            removedKeyFromSource,
+                            source[removedKeyFromSource]),
+                        OpenApiComparedElementType = typeof(KeyValuePair<string, string>)
+                    });
+            }
+        }
+
         /// <summary>
         /// Adds a segment to the context path to enable pointing to the current location in the document.
         /// </summary>

src/Microsoft.OpenApi/Services/OpenApiComparerFactory.cs

@@ -33,14 +33,29 @@ public class OpenApiComparerFactory
             {typeof(IDictionary<string, OpenApiParameter>), new OpenApiDictionaryComparer<OpenApiParameter>()},
             {typeof(IDictionary<string, OpenApiRequestBody>), new OpenApiDictionaryComparer<OpenApiRequestBody>()},
             {typeof(IDictionary<string, OpenApiSchema>), new OpenApiDictionaryComparer<OpenApiSchema>()},
+            {
+                typeof(IDictionary<string, OpenApiSecurityScheme>),
+                new OpenApiDictionaryComparer<OpenApiSecurityScheme>()
+            },
             {typeof(OpenApiHeader), new OpenApiHeaderComparer()},
             {typeof(OpenApiRequestBody), new OpenApiRequestBodyComparer()},
             {typeof(OpenApiResponse), new OpenApiResponseComparer()},
             {typeof(OpenApiComponents), new OpenApiComponentsComparer()},
             {typeof(OpenApiEncoding), new OpenApiEncodingComparer()},
             {typeof(IList<OpenApiServer>), new OpenApiServersComparer()},
             {typeof(OpenApiServer), new OpenApiServerComparer()},
-            {typeof(OpenApiServerVariable), new OpenApiServerVariableComparer()}
+            {typeof(OpenApiServerVariable), new OpenApiServerVariableComparer()},
+            {typeof(OpenApiOAuthFlow), new OpenApiOAuthFlowComparer()},
+            {typeof(OpenApiOAuthFlows), new OpenApiOAuthFlowsComparer()},
+            {typeof(OpenApiSecurityRequirement), new OpenApiSecurityRequirementComparer()},
+            {typeof(OpenApiInfo), new OpenApiInfoComparer()},
+            {typeof(OpenApiContact), new OpenApiContactComparer()},
+            {typeof(OpenApiLicense), new OpenApiLicenseComparer()},
+            {typeof(IList<OpenApiSecurityRequirement>), new OpenApiOrderedListComparer<OpenApiSecurityRequirement>()},
+            {typeof(IList<OpenApiTag>), new OpenApiOrderedListComparer<OpenApiTag>()},
+            {typeof(OpenApiExternalDocs), new OpenApiExternalDocsComparer()},
+            {typeof(OpenApiTag), new OpenApiTagComparer()},
+            {typeof(OpenApiSecurityScheme), new OpenApiSecuritySchemeComparer()}
         };
 
         private readonly Dictionary<Type, object> _typeToComparerMap = new Dictionary<Type, object>();

src/Microsoft.OpenApi/Services/OpenApiComponentsComparer.cs

@@ -77,8 +77,14 @@ public override void Compare(
                     .GetComparer<IDictionary<string, OpenApiHeader>>()
                     .Compare(sourceComponents.Headers, targetComponents.Headers, comparisonContext));
 
+            WalkAndCompare(
+                comparisonContext,
+                OpenApiConstants.SecuritySchemes,
+                () => comparisonContext
+                    .GetComparer<IDictionary<string, OpenApiSecurityScheme>>()
+                    .Compare(sourceComponents.SecuritySchemes, targetComponents.SecuritySchemes, comparisonContext));
+
             // To Do compare Examples
-            // To Do compare SecuritySchemes
             // To Do compare Links
             // To Do compare Callbacks
             // To Do compare Extensions

src/Microsoft.OpenApi/Services/OpenApiContactComparer.cs

@@ -0,0 +1,54 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT license.
+
+using Microsoft.OpenApi.Models;
+
+namespace Microsoft.OpenApi.Services
+{
+    /// <summary>
+    /// Defines behavior for comparing properties of <see cref="OpenApiContact"/>.
+    /// </summary>
+    public class OpenApiContactComparer : OpenApiComparerBase<OpenApiContact>
+    {
+        /// <summary>
+        /// Executes comparision against source and target <see cref="OpenApiContact"/>.
+        /// </summary>
+        /// <param name="sourceContact">The source.</param>
+        /// <param name="targetContact">The target.</param>
+        /// <param name="comparisonContext">Context under which to compare the source and target.</param>
+        public override void Compare(
+            OpenApiContact sourceContact,
+            OpenApiContact targetContact,
+            ComparisonContext comparisonContext)
+        {
+            if (sourceContact == null && targetContact == null)
+            {
+                return;
+            }
+
+            if (sourceContact == null || targetContact == null)
+            {
+                comparisonContext.AddOpenApiDifference(
+                    new OpenApiDifference
+                    {
+                        OpenApiDifferenceOperation = OpenApiDifferenceOperation.Update,
+                        SourceValue = sourceContact,
+                        TargetValue = targetContact,
+                        OpenApiComparedElementType = typeof(OpenApiContact),
+                        Pointer = comparisonContext.PathString
+                    });
+
+                return;
+            }
+
+            WalkAndCompare(comparisonContext, OpenApiConstants.Name,
+                () => Compare(sourceContact.Name, targetContact.Name, comparisonContext));
+
+            WalkAndCompare(comparisonContext, OpenApiConstants.Email,
+                () => Compare(sourceContact.Email, targetContact.Email, comparisonContext));
+
+            WalkAndCompare(comparisonContext, OpenApiConstants.Url,
+                () => Compare(sourceContact.Url, targetContact.Url, comparisonContext));
+        }
+    }
+}

src/Microsoft.OpenApi/Services/OpenApiDocumentComparer.cs

@@ -43,11 +43,34 @@ public override void Compare(
                     .GetComparer<IList<OpenApiServer>>()
                     .Compare(sourceDocument.Servers, targetDocument.Servers, comparisonContext));
 
-            // To Do Compare Info
-            // To Do Compare Security Requirements
-            // To Do Compare Tags
-            // To Do Compare External Docs
-            // To Do Compare Extensions
+            WalkAndCompare(
+                comparisonContext,
+                OpenApiConstants.Info,
+                () => comparisonContext
+                    .GetComparer<OpenApiInfo>()
+                    .Compare(sourceDocument.Info, targetDocument.Info, comparisonContext));
+
+            WalkAndCompare(
+                comparisonContext,
+                OpenApiConstants.Security,
+                () => comparisonContext
+                    .GetComparer<IList<OpenApiSecurityRequirement>>()
+                    .Compare(sourceDocument.SecurityRequirements, targetDocument.SecurityRequirements,
+                        comparisonContext));
+
+            WalkAndCompare(
+                comparisonContext,
+                OpenApiConstants.Tags,
+                () => comparisonContext
+                    .GetComparer<IList<OpenApiTag>>()
+                    .Compare(sourceDocument.Tags, targetDocument.Tags, comparisonContext));
+
+            WalkAndCompare(
+                comparisonContext,
+                OpenApiConstants.ExternalDocs,
+                () => comparisonContext
+                    .GetComparer<OpenApiExternalDocs>()
+                    .Compare(sourceDocument.ExternalDocs, targetDocument.ExternalDocs, comparisonContext));
         }
     }
 }

src/Microsoft.OpenApi/Services/OpenApiExternalDocsComparer.cs

@@ -0,0 +1,48 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT license. 
+
+using Microsoft.OpenApi.Models;
+
+namespace Microsoft.OpenApi.Services
+{
+    /// <summary>
+    ///  Defines behavior for comparing properties of <see cref="OpenApiExternalDocs"/>.
+    /// </summary>
+    public class OpenApiExternalDocsComparer : OpenApiComparerBase<OpenApiExternalDocs>
+    {
+        /// <summary>
+        /// Executes comparision against source and target <see cref="OpenApiExternalDocs"/>.
+        /// </summary>
+        /// <param name="sourceDocs">The source.</param>
+        /// <param name="targetDocs">The target.</param>
+        /// <param name="comparisonContext">Context under which to compare the source and target.</param>
+        public override void Compare(OpenApiExternalDocs sourceDocs, OpenApiExternalDocs targetDocs,
+            ComparisonContext comparisonContext)
+        {
+            if (sourceDocs == null && targetDocs == null)
+            {
+                return;
+            }
+
+            if (sourceDocs == null || targetDocs == null)
+            {
+                comparisonContext.AddOpenApiDifference(
+                    new OpenApiDifference
+                    {
+                        OpenApiDifferenceOperation = OpenApiDifferenceOperation.Update,
+                        SourceValue = sourceDocs,
+                        TargetValue = targetDocs,
+                        OpenApiComparedElementType = typeof(OpenApiExternalDocs),
+                        Pointer = comparisonContext.PathString
+                    });
+                return;
+            }
+
+            WalkAndCompare(comparisonContext, OpenApiConstants.Description,
+                () => Compare(sourceDocs.Description, targetDocs.Description, comparisonContext));
+
+            WalkAndCompare(comparisonContext, OpenApiConstants.Url,
+                () => Compare(sourceDocs.Url, targetDocs.Url, comparisonContext));
+        }
+    }
+}