move 'WireMock.Net.OpenApiParser.Preview' to ''src-preview' folder

src-preview/WireMock.Net.OpenApiParser.Preview/Extensions/DictionaryExtensions.cs

@@ -0,0 +1,22 @@
+// Copyright © WireMock.Net
+
+#if NET46 || NET47 || NETSTANDARD2_0
+using System.Collections.Generic;
+
+namespace WireMock.Net.OpenApiParser.Extensions;
+
+internal static class DictionaryExtensions
+{
+    public static bool TryAdd<TKey, TValue>(this Dictionary<TKey, TValue>? dictionary, TKey key, TValue value)
+    {
+        if (dictionary is null || dictionary.ContainsKey(key))
+        {
+            return false;
+        }
+
+        dictionary[key] = value;
+
+        return true;
+    }
+}
+#endif

src-preview/WireMock.Net.OpenApiParser.Preview/Extensions/OpenApiSchemaExtensions.cs

@@ -0,0 +1,85 @@
+// Copyright © WireMock.Net
+
+using System.Linq;
+using System.Text.Json;
+using Microsoft.OpenApi.Any;
+using Microsoft.OpenApi.Models;
+using Microsoft.OpenApi.Models.Interfaces;
+using WireMock.Net.OpenApiParser.Types;
+
+namespace WireMock.Net.OpenApiParser.Extensions;
+
+internal static class OpenApiSchemaExtensions
+{
+    public static bool TryGetXNullable(this IOpenApiSchema schema, out bool value)
+    {
+        value = false;
+
+        if (schema.Extensions != null && schema.Extensions.TryGetValue(OpenApiConstants.NullableExtension, out var nullExtRawValue) && nullExtRawValue is OpenApiAny { Node: { } jsonNode })
+        {
+            value = jsonNode.GetValueKind() == JsonValueKind.True;
+            return true;
+        }
+
+        return false;
+    }
+
+    public static JsonSchemaType? GetSchemaType(this IOpenApiSchema? schema, out bool isNullable)
+    {
+        isNullable = false;
+
+        if (schema == null)
+        {
+            return null;
+        }
+
+        if (schema.Type == null)
+        {
+            if (schema.AllOf?.Any() == true || schema.AnyOf?.Any() == true)
+            {
+                return JsonSchemaType.Object;
+            }
+        }
+
+        isNullable = (schema.Type | JsonSchemaType.Null) == JsonSchemaType.Null || (schema.TryGetXNullable(out var xNullable) && xNullable);
+
+        // Removes the Null flag from the schema.Type, ensuring the returned value represents a non-nullable type.
+        return schema.Type & ~JsonSchemaType.Null;
+    }
+
+    public static SchemaFormat GetSchemaFormat(this IOpenApiSchema? schema)
+    {
+        switch (schema?.Format)
+        {
+            case "float":
+                return SchemaFormat.Float;
+
+            case "double":
+                return SchemaFormat.Double;
+
+            case "int32":
+                return SchemaFormat.Int32;
+
+            case "int64":
+                return SchemaFormat.Int64;
+
+            case "date":
+                return SchemaFormat.Date;
+
+            case "date-time":
+                return SchemaFormat.DateTime;
+
+            case "password":
+                return SchemaFormat.Password;
+
+            case "byte":
+                return SchemaFormat.Byte;
+
+            case "binary":
+                return SchemaFormat.Binary;
+
+            default:
+                return SchemaFormat.Undefined;
+        }
+    }
+}

src-preview/WireMock.Net.OpenApiParser.Preview/Extensions/WireMockServerExtensions.cs

@@ -0,0 +1,96 @@
+// Copyright © WireMock.Net
+
+using System.IO;
+using System.Linq;
+using JetBrains.Annotations;
+using Microsoft.OpenApi.Models;
+using Microsoft.OpenApi.Reader;
+using Stef.Validation;
+using WireMock.Net.OpenApiParser.Settings;
+using WireMock.Server;
+
+namespace WireMock.Net.OpenApiParser.Extensions;
+
+/// <summary>
+/// Some extension methods for <see cref="IWireMockServer"/>.
+/// </summary>
+public static class WireMockServerExtensions
+{
+    /// <summary>
+    /// Register the mappings via an OpenAPI (swagger) V2/V3/V3.1 file.
+    /// </summary>
+    /// <param name="server">The WireMockServer instance</param>
+    /// <param name="path">Path containing OpenAPI file to parse and use the mappings.</param>
+    /// <param name="diagnostic">Returns diagnostic object containing errors detected during parsing</param>
+    [PublicAPI]
+    public static IWireMockServer WithMappingFromOpenApiFile(this IWireMockServer server, string path, out OpenApiDiagnostic diagnostic)
+    {
+        return WithMappingFromOpenApiFile(server, path, new WireMockOpenApiParserSettings(), out diagnostic);
+    }
+
+    /// <summary>
+    /// Register the mappings via an OpenAPI (swagger) V2/V3/V3.1 file.
+    /// </summary>
+    /// <param name="server">The WireMockServer instance</param>
+    /// <param name="path">Path containing OpenAPI file to parse and use the mappings.</param>
+    /// <param name="settings">Additional settings</param>
+    /// <param name="diagnostic">Returns diagnostic object containing errors detected during parsing</param>
+    [PublicAPI]
+    public static IWireMockServer WithMappingFromOpenApiFile(this IWireMockServer server, string path, WireMockOpenApiParserSettings settings, out OpenApiDiagnostic diagnostic)
+    {
+        Guard.NotNull(server);
+        Guard.NotNullOrEmpty(path);
+
+        var mappings = new WireMockOpenApiParser().FromFile(path, settings, out diagnostic);
+
+        return server.WithMapping(mappings.ToArray());
+    }
+
+    /// <summary>
+    /// Register the mappings via an OpenAPI (swagger) V2/V3/V3.1 stream.
+    /// </summary>
+    /// <param name="server">The WireMockServer instance</param>
+    /// <param name="stream">Stream containing OpenAPI description to parse and use the mappings.</param>
+    /// <param name="diagnostic">Returns diagnostic object containing errors detected during parsing</param>
+    [PublicAPI]
+    public static IWireMockServer WithMappingFromOpenApiStream(this IWireMockServer server, Stream stream, out OpenApiDiagnostic diagnostic)
+    {
+        return WithMappingFromOpenApiStream(server, stream, new WireMockOpenApiParserSettings(), out diagnostic);
+    }
+
+    /// <summary>
+    /// Register the mappings via an OpenAPI (swagger) V2/V3/V3.1 stream.
+    /// </summary>
+    /// <param name="server">The WireMockServer instance</param>
+    /// <param name="stream">Stream containing OpenAPI description to parse and use the mappings.</param>
+    /// <param name="settings">Additional settings</param>
+    /// <param name="diagnostic">Returns diagnostic object containing errors detected during parsing</param>
+    [PublicAPI]
+    public static IWireMockServer WithMappingFromOpenApiStream(this IWireMockServer server, Stream stream, WireMockOpenApiParserSettings settings, out OpenApiDiagnostic diagnostic)
+    {
+        Guard.NotNull(server);
+        Guard.NotNull(stream);
+        Guard.NotNull(settings);
+
+        var mappings = new WireMockOpenApiParser().FromStream(stream, settings, out diagnostic);
+
+        return server.WithMapping(mappings.ToArray());
+    }
+
+    /// <summary>
+    /// Register the mappings via an OpenAPI (swagger) V2/V3/V3.1 document.
+    /// </summary>
+    /// <param name="server">The WireMockServer instance</param>
+    /// <param name="document">The OpenAPI document to use as mappings.</param>
+    /// <param name="settings">Additional settings [optional].</param>
+    [PublicAPI]
+    public static IWireMockServer WithMappingFromOpenApiDocument(this IWireMockServer server, OpenApiDocument document, WireMockOpenApiParserSettings? settings = null)
+    {
+        Guard.NotNull(server);
+        Guard.NotNull(document);
+
+        var mappings = new WireMockOpenApiParser().FromDocument(document, settings);
+
+        return server.WithMapping(mappings.ToArray());
+    }
+}