Add MatchOperator "Or", "And" and "Average" for patterns (#755)

* wip

* ...

* .

* ...

* ...

* path

* url

* b

* t

* client

* .

* RequestMessageMethodMatcherTests

* .

* h

* .

* fix tests

* .

src/WireMock.Net/IMapping.cs

@@ -1,4 +1,3 @@
-using JetBrains.Annotations;
 using System;
 using System.Threading.Tasks;
 using WireMock.Matchers.Request;
@@ -6,130 +5,125 @@ using WireMock.Models;
 using WireMock.ResponseProviders;
 using WireMock.Settings;
 
-namespace WireMock
+namespace WireMock;
+
+/// <summary>
+/// The IMapping interface.
+/// </summary>
+public interface IMapping
 {
     /// <summary>
-    /// The IMapping interface.
+    /// Gets the unique identifier.
     /// </summary>
-    public interface IMapping
-    {
-        /// <summary>
-        /// Gets the unique identifier.
-        /// </summary>
-        Guid Guid { get; }
+    Guid Guid { get; }
 
-        /// <summary>
-        /// Gets the TimeSettings (Start, End and TTL).
-        /// </summary>
-        ITimeSettings TimeSettings { get; }
+    /// <summary>
+    /// Gets the TimeSettings (Start, End and TTL).
+    /// </summary>
+    ITimeSettings TimeSettings { get; }
 
-        /// <summary>
-        /// Gets the unique title.
-        /// </summary>
-        string Title { get; }
+    /// <summary>
+    /// Gets the unique title.
+    /// </summary>
+    string Title { get; }
 
-        /// <summary>
-        /// Gets the description.
-        /// </summary>
-        string Description { get; }
+    /// <summary>
+    /// Gets the description.
+    /// </summary>
+    string Description { get; }
 
-        /// <summary>
-        /// The full filename path for this mapping (only defined for static mappings).
-        /// </summary>
-        string Path { get; set; }
+    /// <summary>
+    /// The full filename path for this mapping (only defined for static mappings).
+    /// </summary>
+    string Path { get; set; }
 
-        /// <summary>
-        /// Gets the priority.  (A low value means higher priority.)
-        /// </summary>
-        int Priority { get; }
+    /// <summary>
+    /// Gets the priority.  (A low value means higher priority.)
+    /// </summary>
+    int Priority { get; }
 
-        /// <summary>
-        /// Scenario.
-        /// </summary>
-        [CanBeNull]
-        string Scenario { get; }
+    /// <summary>
+    /// Scenario.
+    /// </summary>
+    string? Scenario { get; }
 
-        /// <summary>
-        /// Execution state condition for the current mapping.
-        /// </summary>
-        [CanBeNull]
-        string ExecutionConditionState { get; }
+    /// <summary>
+    /// Execution state condition for the current mapping.
+    /// </summary>
+    string? ExecutionConditionState { get; }
 
-        /// <summary>
-        /// The next state which will be signaled after the current mapping execution.
-        /// In case the value is null, state will not be changed.
-        /// </summary>
-        [CanBeNull]
-        string NextState { get; }
+    /// <summary>
+    /// The next state which will be signaled after the current mapping execution.
+    /// In case the value is null, state will not be changed.
+    /// </summary>
+    string? NextState { get; }
 
-        /// <summary>
-        /// The number of times this match should be matched before the state will be changed to the next state.
-        /// </summary>
-        [CanBeNull]
-        int? StateTimes { get; }
+    /// <summary>
+    /// The number of times this match should be matched before the state will be changed to the next state.
+    /// </summary>
+    int? StateTimes { get; }
 
-        /// <summary>
-        /// The Request matcher.
-        /// </summary>
-        IRequestMatcher RequestMatcher { get; }
+    /// <summary>
+    /// The Request matcher.
+    /// </summary>
+    IRequestMatcher RequestMatcher { get; }
 
-        /// <summary>
-        /// The Provider.
-        /// </summary>
-        IResponseProvider Provider { get; }
+    /// <summary>
+    /// The Provider.
+    /// </summary>
+    IResponseProvider Provider { get; }
 
-        /// <summary>
-        /// The WireMockServerSettings.
-        /// </summary>
-        WireMockServerSettings Settings { get; }
+    /// <summary>
+    /// The WireMockServerSettings.
+    /// </summary>
+    WireMockServerSettings Settings { get; }
 
-        /// <summary>
-        /// Is State started ?
-        /// </summary>
-        bool IsStartState { get; }
+    /// <summary>
+    /// Is State started ?
+    /// </summary>
+    bool IsStartState { get; }
 
-        /// <summary>
-        /// Gets a value indicating whether this mapping is an Admin Interface.
-        /// </summary>
-        /// <value>
-        /// <c>true</c> if this mapping is an Admin Interface; otherwise, <c>false</c>.
-        /// </value>
-        bool IsAdminInterface { get; }
+    /// <summary>
+    /// Gets a value indicating whether this mapping is an Admin Interface.
+    /// </summary>
+    /// <value>
+    /// <c>true</c> if this mapping is an Admin Interface; otherwise, <c>false</c>.
+    /// </value>
+    bool IsAdminInterface { get; }
 
-        /// <summary>
-        /// Gets a value indicating whether this mapping is a Proxy Mapping.
-        /// </summary>
-        /// <value>
-        /// <c>true</c> if this mapping is a Proxy Mapping; otherwise, <c>false</c>.
-        /// </value>
-        bool IsProxy { get; }
+    /// <summary>
+    /// Gets a value indicating whether this mapping is a Proxy Mapping.
+    /// </summary>
+    /// <value>
+    /// <c>true</c> if this mapping is a Proxy Mapping; otherwise, <c>false</c>.
+    /// </value>
+    bool IsProxy { get; }
 
-        /// <summary>
-        /// Gets a value indicating whether this mapping to be logged.
-        /// </summary>
-        /// <value>
-        /// <c>true</c> if this mapping to be logged; otherwise, <c>false</c>.
-        /// </value>
-        bool LogMapping { get; }
+    /// <summary>
+    /// Gets a value indicating whether this mapping to be logged.
+    /// </summary>
+    /// <value>
+    /// <c>true</c> if this mapping to be logged; otherwise, <c>false</c>.
+    /// </value>
+    bool LogMapping { get; }
 
-        /// <summary>
-        /// The Webhooks.
-        /// </summary>
-        IWebhook[] Webhooks { get; }
+    /// <summary>
+    /// The Webhooks.
+    /// </summary>
+    IWebhook[]? Webhooks { get; }
 
-        /// <summary>
-        /// ProvideResponseAsync
-        /// </summary>
-        /// <param name="requestMessage">The request message.</param>
-        /// <returns>The <see cref="ResponseMessage"/> including a new (optional) <see cref="IMapping"/>.</returns>
-        Task<(IResponseMessage Message, IMapping Mapping)> ProvideResponseAsync(IRequestMessage requestMessage);
+    /// <summary>
+    /// ProvideResponseAsync
+    /// </summary>
+    /// <param name="requestMessage">The request message.</param>
+    /// <returns>The <see cref="ResponseMessage"/> including a new (optional) <see cref="IMapping"/>.</returns>
+    Task<(IResponseMessage Message, IMapping Mapping)> ProvideResponseAsync(IRequestMessage requestMessage);
 
-        /// <summary>
-        /// Gets the RequestMatchResult based on the RequestMessage.
-        /// </summary>
-        /// <param name="requestMessage">The request message.</param>
-        /// <param name="nextState">The Next State.</param>
-        /// <returns>The <see cref="IRequestMatchResult"/>.</returns>
-        IRequestMatchResult GetRequestMatchResult(IRequestMessage requestMessage, [CanBeNull] string nextState);
-    }
+    /// <summary>
+    /// Gets the RequestMatchResult based on the RequestMessage.
+    /// </summary>
+    /// <param name="requestMessage">The request message.</param>
+    /// <param name="nextState">The Next State.</param>
+    /// <returns>The <see cref="IRequestMatchResult"/>.</returns>
+    IRequestMatchResult GetRequestMatchResult(IRequestMessage requestMessage, string? nextState);
 }