From 9db8787270bcb82946888656a1d7cd0703e3fe81 Mon Sep 17 00:00:00 2001
From: Stef Heyenrath <Stef.Heyenrath@gmail.com>
Date: Tue, 27 Feb 2024 08:13:32 +0100
Subject: [PATCH] Created Request Matching CSharpCode (markdown)

---
 Request-Matching-CSharpCode.md | 49 ++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 Request-Matching-CSharpCode.md

diff --git a/Request-Matching-CSharpCode.md b/Request-Matching-CSharpCode.md
new file mode 100644
index 0000000..c48dd6f
--- /dev/null
+++ b/Request-Matching-CSharpCode.md
@@ -0,0 +1,49 @@
+## CSharp Code (CSharpCodeMatcher)
+*Advanced!* With this matcher you can use complex C# code to match an JObject or string value.
+* You need to include the NuGet package [WireMock.Net.Matchers.CSharpCode](https://www.nuget.org/packages/WireMock.Net.Matchers.CSharpCode/)
+* Note that this functionality will only work if enabled in the settings (`AllowCSharpCodeMatcher = true`).
+* The argument-name from the string or JObject to match will be `it`.
+
+#### C# option
+```csharp
+var server = WireMockServer.Start();
+server
+    .Given(Request.Create().WithPath("/cs")
+        .WithParam("from", new CSharpCodeMatcher("return it == \"x\";")))
+    .RespondWith(Response.Create()
+        .WithBody("cs match")
+    );
+```
+
+#### JSON Mapping option
+``` js
+{
+    "Guid": "67ae335b-5d79-42dc-8ca7-236280ab9211",
+    "Priority": 0,
+    "Request": {
+        "Path": {
+            "Matchers": [
+                {
+                    "Name": "WildcardMatcher",
+                    "Pattern": "/cs"
+                }
+            ]
+        },
+        "Params": [
+            {
+                "Name": "from",
+                "Matchers": [
+                    {
+                        "Name": "CSharpCodeMatcher",
+                        "Pattern": "return it == \"x\";"
+                    }
+                ]
+            }
+        ],
+        "Body": {}
+    },
+    "Response": {
+        "Body": "cs match"
+    }
+}
+```
\ No newline at end of file