Switch default fallback to a text-based match report

This is a behavior-breaking change as previously match failures returns
a NotFound / 404 result, but now the default behavior throws an
exception.

The previous behavior can be reverted by using
`mockHandler.Fallback.RespondMatchSummary`

Author: richardszalay

RichardSzalay.MockHttp.Tests/Matchers/AnyMatcherTests.cs

@@ -1,4 +1,5 @@
 using RichardSzalay.MockHttp.Matchers;
+using System;
 using System.Linq;
 using Xunit;
 
@@ -30,6 +31,23 @@ public void Fails_if_all_matchers_fail()
         Assert.False(result);
     }
 
+
+    [Fact]
+    public void ToString_describes_matcher()
+    {
+        var sut = new AnyMatcher(new[]
+        {
+            new FakeMatcher(true),
+            new FakeMatcher(false)
+        });
+
+        var result = sut.ToString();
+        var expected = $"matches any one of matches fake True{Environment.NewLine}" +
+            $"    OR matches fake False{Environment.NewLine}";
+
+        Assert.Equal(expected, result);
+    }
+
     public bool Test(params bool[] matcherResults)
     {
         var matchers = matcherResults
@@ -50,5 +68,8 @@ public bool Matches(System.Net.Http.HttpRequestMessage message)
         {
             return _result;
         }
+
+        public override string ToString()
+            => $"matches fake {_result}";
     }
 }

RichardSzalay.MockHttp.Tests/Matchers/ContentMatcherTests.cs

@@ -1,4 +1,5 @@
 using RichardSzalay.MockHttp.Matchers;
+using System;
 using System.Net.Http;
 using Xunit;
 
@@ -28,6 +29,16 @@ public void Fails_on_unmatched_content()
         Assert.False(result);
     }
 
+    [Fact]
+    public void ToString_describes_matcher()
+    {
+        var sut = new ContentMatcher("test");
+
+        var result = sut.ToString();
+
+        Assert.Equal("request body matches test", result);
+    }
+
     private bool Test(string expected, string actual)
     {
         var request = new HttpRequestMessage(HttpMethod.Get,

RichardSzalay.MockHttp.Tests/Matchers/CustomMatcherTests.cs

@@ -23,6 +23,16 @@ public void Should_fail_when_handler_fails()
         Assert.False(result);
     }
 
+    [Fact]
+    public void ToString_describes_matcher()
+    {
+        var sut = new CustomMatcher(_ => true);
+
+        var result = sut.ToString();
+
+        Assert.Equal("request matches a custom predicate", result);
+    }
+
     private bool Test(Func<HttpRequestMessage, bool> handler)
     {
         var sut = new CustomMatcher(handler);

RichardSzalay.MockHttp.Tests/Matchers/FormDataMatcherTests.cs

@@ -217,4 +217,24 @@ private bool Test(string expected, HttpContent actual)
             "http://tempuri.org/home")
         { Content = actual });
     }
+
+    [Fact]
+    public void ToString_describes_partial_matcher()
+    {
+        var sut = new FormDataMatcher("key=Value+with%20spaces&b=2", exact: false);
+
+        var result = sut.ToString();
+
+        Assert.Equal("form data matches key=Value%20with%20spaces&b=2", result);
+    }
+
+    [Fact]
+    public void ToString_describes_exact_matcher()
+    {
+        var sut = new FormDataMatcher("key=Value+with%20spaces&b=2", exact: true);
+
+        var result = sut.ToString();
+
+        Assert.Equal("form data exacly matches (no additional keys allowed) key=Value%20with%20spaces&b=2", result);
+    }
 }

RichardSzalay.MockHttp.Tests/Matchers/HeadersMatcherTests.cs

@@ -59,4 +59,17 @@ private bool Test(HeadersMatcher expected, Action<HttpRequestMessage> actual)
         return expected.Matches(request);
     }
 
+    [Fact]
+    public void ToString_describes_matcher()
+    {
+        var sut = new HeadersMatcher(@"Accept: application/json
+Authorization: Basic abcdef");
+
+        var result = sut.ToString();
+
+        Assert.Equal($"headers match {Environment.NewLine}" +
+            $"    Accept: application/json{Environment.NewLine}" +
+            $"    Authorization: Basic abcdef{Environment.NewLine}", result);
+    }
+
 }

RichardSzalay.MockHttp.Tests/Matchers/JsonContentMatcherTests.cs

@@ -46,4 +46,14 @@ private bool Test(Func<JsonContent, bool> expected, JsonContent actual)
     }
 
     public record JsonContent(bool Value);
+
+    [Fact]
+    public void ToString_describes_matcher()
+    {
+        var sut = new JsonContentMatcher<JsonContent>(x => true);
+
+        var result = sut.ToString();
+
+        Assert.Equal("JSON request body matches custom JsonContent predicate", result);
+    }
 }

RichardSzalay.MockHttp.Tests/Matchers/MethodMatcherTests.cs

@@ -35,4 +35,14 @@ private bool Test(HttpMethod expected, HttpMethod actual)
         return sut.Matches(new HttpRequestMessage(actual,
             "http://tempuri.org/home"));
     }
+
+    [Fact]
+    public void ToString_describes_matcher()
+    {
+        var sut = new MethodMatcher(HttpMethod.Get);
+
+        var result = sut.ToString();
+
+        Assert.Equal("method matches GET", result);
+    }
 }

RichardSzalay.MockHttp.Tests/Matchers/PartialContentMatcherTests.cs

@@ -37,4 +37,14 @@ private bool Test(string expected, string actual)
 
         return new PartialContentMatcher(expected).Matches(request);
     }
+
+    [Fact]
+    public void ToString_describes_matcher()
+    {
+        var sut = new PartialContentMatcher("test");
+
+        var result = sut.ToString();
+
+        Assert.Equal("request body partially matches test", result);
+    }
 }

RichardSzalay.MockHttp.Tests/Matchers/QueryStringMatcherTests.cs

@@ -118,4 +118,24 @@ private bool Test(string expected, string actual, bool exact = false)
         return sut.Matches(new HttpRequestMessage(HttpMethod.Get,
             "http://tempuri.org/home?" + actual));
     }
+
+    [Fact]
+    public void ToString_describes_partial_matcher()
+    {
+        var sut = new QueryStringMatcher("key=Value+with%20spaces&b=2", exact: false);
+
+        var result = sut.ToString();
+
+        Assert.Equal("query string matches key=Value%20with%20spaces&b=2", result);
+    }
+
+    [Fact]
+    public void ToString_describes_exact_matcher()
+    {
+        var sut = new QueryStringMatcher("key=Value+with%20spaces&b=2", exact: true);
+
+        var result = sut.ToString();
+
+        Assert.Equal("query string exacly matches (no additional keys allowed) key=Value%20with%20spaces&b=2", result);
+    }
 }

RichardSzalay.MockHttp.Tests/Matchers/UrlMatcherTests.cs

@@ -148,4 +148,14 @@ private HttpRequestMessage Request(string url)
     {
         return new HttpRequestMessage(HttpMethod.Get, url);
     }
+
+    [Fact]
+    public void ToString_describes_matcher()
+    {
+        var sut = new UrlMatcher("http://tempuri.org/");
+
+        var result = sut.ToString();
+
+        Assert.Equal("URL matches http://tempuri.org/", result);
+    }
 }