Create WireMock.Net.MimePart project (#1300)

* Create WireMock.Net.MimePart project

* .

* REFACTOR

* ILRepack

* --

* ...

* x

* x

* .

* fix

* public class MimePartMatcher

* shared

* min

* .

* <!--<DelaySign>true</DelaySign>-->

* Update README.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

src/WireMock.Net.Minimal/Util/PortUtils.cs

@@ -0,0 +1,110 @@
+// Copyright © WireMock.Net
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
+using System.Linq;
+using System.Net;
+using System.Net.Sockets;
+using System.Text.RegularExpressions;
+using WireMock.Constants;
+
+namespace WireMock.Util;
+
+/// <summary>
+/// Port Utility class
+/// </summary>
+internal static class PortUtils
+{
+    private static readonly Regex UrlDetailsRegex = new(@"^((?<proto>\w+)://)(?<host>[^/]+?):(?<port>\d+)\/?$", RegexOptions.Compiled, RegexConstants.DefaultTimeout);
+
+    /// <summary>
+    /// Finds a random, free port to be listened on.
+    /// </summary>
+    /// <returns>A random, free port to be listened on.</returns>
+    /// <remarks>https://github.com/SeleniumHQ/selenium/blob/trunk/dotnet/src/webdriver/Internal/PortUtilities.cs</remarks>
+    public static int FindFreeTcpPort()
+    {
+        // Locate a free port on the local machine by binding a socket to an IPEndPoint using IPAddress.Any and port 0.
+        // The socket will select a free port.
+        var portSocket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
+        try
+        {
+            var socketEndPoint = new IPEndPoint(IPAddress.Any, 0);
+            portSocket.Bind(socketEndPoint);
+            socketEndPoint = (IPEndPoint)portSocket.LocalEndPoint!;
+            return socketEndPoint.Port;
+        }
+        finally
+        {
+#if !NETSTANDARD1_3
+            portSocket.Close();
+#endif
+            portSocket.Dispose();
+        }
+    }
+
+    /// <summary>
+    /// Finds a specified number of random, free ports to be listened on.
+    /// </summary>
+    /// <param name="count">The number of free ports to find.</param>
+    /// <returns>A list of random, free ports to be listened on.</returns>
+    public static IReadOnlyList<int> FindFreeTcpPorts(int count)
+    {
+        var sockets = Enumerable
+            .Range(0, count)
+            .Select(_ => new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp))
+            .ToArray();
+
+        var freePorts = new List<int>();
+
+        try
+        {
+            foreach (var socket in sockets)
+            {
+                var socketEndPoint = new IPEndPoint(IPAddress.Any, 0);
+                socket.Bind(socketEndPoint);
+                socketEndPoint = (IPEndPoint)socket.LocalEndPoint!;
+
+                freePorts.Add(socketEndPoint.Port);
+            }
+
+            return freePorts;
+        }
+        finally
+        {
+            foreach (var socket in sockets)
+            {
+#if !NETSTANDARD1_3
+                socket.Close();
+#endif
+                socket.Dispose();
+            }
+        }
+    }
+
+    /// <summary>
+    /// Extract the isHttps, isHttp2, protocol, host and port from a URL.
+    /// </summary>
+    public static bool TryExtract(string url, out bool isHttps, out bool isHttp2, [NotNullWhen(true)] out string? protocol, [NotNullWhen(true)] out string? host, out int port)
+    {
+        isHttps = false;
+        isHttp2 = false;
+        protocol = null;
+        host = null;
+        port = 0;
+
+        var match = UrlDetailsRegex.Match(url);
+        if (match.Success)
+        {
+            protocol = match.Groups["proto"].Value;
+            isHttps = protocol.StartsWith("https", StringComparison.OrdinalIgnoreCase) || protocol.StartsWith("grpcs", StringComparison.OrdinalIgnoreCase);
+            isHttp2 = protocol.StartsWith("grpc", StringComparison.OrdinalIgnoreCase);
+            host = match.Groups["host"].Value;
+
+            return int.TryParse(match.Groups["port"].Value, out port);
+        }
+
+        return false;
+    }
+}