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/Transformers/Handlebars/FileHelpers.cs

@@ -0,0 +1,34 @@
+// Copyright © WireMock.Net
+
+using HandlebarsDotNet;
+using HandlebarsDotNet.Helpers.Attributes;
+using HandlebarsDotNet.Helpers.Enums;
+using HandlebarsDotNet.Helpers.Helpers;
+using HandlebarsDotNet.Helpers.Options;
+using Stef.Validation;
+using WireMock.Handlers;
+using WireMock.Settings;
+
+namespace WireMock.Transformers.Handlebars;
+
+internal class FileHelpers : BaseHelpers, IHelpers
+{
+    internal const string Name = "File";
+
+    private readonly IFileSystemHandler _fileSystemHandler;
+
+    public FileHelpers(IHandlebars context, WireMockServerSettings settings) : base(context, new HandlebarsHelpersOptions())
+    {
+        _fileSystemHandler = Guard.NotNull(settings.FileSystemHandler);
+    }
+
+    [HandlebarsWriter(WriterType.String, usage: HelperUsage.Both, passContext: true, name: Name)]
+    public string Read(Context context, string path)
+    {
+        var templateFunc = Context.Compile(path);
+        var transformedPath = templateFunc(context.Value);
+        return _fileSystemHandler.ReadResponseBodyAsString(transformedPath);
+    }
+
+    public Category Category => Category.Custom;
+}

src/WireMock.Net.Minimal/Transformers/Handlebars/HandlebarsContext.cs

@@ -0,0 +1,39 @@
+// Copyright © WireMock.Net
+
+using HandlebarsDotNet;
+using HandlebarsDotNet.Helpers.Extensions;
+using Stef.Validation;
+using WireMock.Handlers;
+
+namespace WireMock.Transformers.Handlebars;
+
+internal class HandlebarsContext : IHandlebarsContext
+{
+    public IHandlebars Handlebars { get; }
+
+    public IFileSystemHandler FileSystemHandler { get; }
+
+    public HandlebarsContext(IHandlebars handlebars, IFileSystemHandler fileSystemHandler)
+    {
+        Handlebars = Guard.NotNull(handlebars);
+        FileSystemHandler = Guard.NotNull(fileSystemHandler);
+    }
+
+    public string ParseAndRender(string text, object model)
+    {
+        var template = Handlebars.Compile(text);
+        return template(model);
+    }
+
+    public object? ParseAndEvaluate(string text, object model)
+    {
+        if (text.StartsWith("{{") && text.EndsWith("}}") &&
+            Handlebars.TryEvaluate(text, model, out var result) &&
+            result is not UndefinedBindingResult)
+        {
+            return result;
+        }
+
+        return ParseAndRender(text, model);
+    }
+}

src/WireMock.Net.Minimal/Transformers/Handlebars/HandlebarsContextFactory.cs

@@ -0,0 +1,32 @@
+// Copyright © WireMock.Net
+
+using HandlebarsDotNet;
+using Stef.Validation;
+using WireMock.Settings;
+
+namespace WireMock.Transformers.Handlebars;
+
+internal class HandlebarsContextFactory : ITransformerContextFactory
+{
+    private readonly WireMockServerSettings _settings;
+
+    public HandlebarsContextFactory(WireMockServerSettings settings)
+    {
+        _settings = Guard.NotNull(settings);
+    }
+
+    public ITransformerContext Create()
+    {
+        var config = new HandlebarsConfiguration
+        {
+            FormatProvider = _settings.Culture
+        };
+        var handlebars = HandlebarsDotNet.Handlebars.Create(config);
+
+        WireMockHandlebarsHelpers.Register(handlebars, _settings);
+
+        _settings.HandlebarsRegistrationCallback?.Invoke(handlebars, _settings.FileSystemHandler);
+
+        return new HandlebarsContext(handlebars, _settings.FileSystemHandler);
+    }
+}

src/WireMock.Net.Minimal/Transformers/Handlebars/IHandlebarsContext.cs

@@ -0,0 +1,10 @@
+// Copyright © WireMock.Net
+
+using HandlebarsDotNet;
+
+namespace WireMock.Transformers.Handlebars;
+
+internal interface IHandlebarsContext : ITransformerContext
+{
+    IHandlebars Handlebars { get; }
+}

src/WireMock.Net.Minimal/Transformers/Handlebars/WireMockHandlebarsHelpers.cs

@@ -0,0 +1,58 @@
+// Copyright © WireMock.Net
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using HandlebarsDotNet;
+using HandlebarsDotNet.Helpers;
+using HandlebarsDotNet.Helpers.Helpers;
+using WireMock.Settings;
+using WireMock.Types;
+
+namespace WireMock.Transformers.Handlebars;
+
+internal static class WireMockHandlebarsHelpers
+{
+    internal static void Register(IHandlebars handlebarsContext, WireMockServerSettings settings)
+    {
+        // Register https://github.com/Handlebars.Net/Handlebars.Net.Helpers
+        HandlebarsHelpers.Register(handlebarsContext, o =>
+        {
+            var paths = new List<string>
+            {
+                Directory.GetCurrentDirectory(),
+                GetBaseDirectory(),
+            };
+
+#if !NETSTANDARD1_3_OR_GREATER
+            void Add(string? path, ICollection<string> customHelperPaths)
+            {
+                if (!string.IsNullOrEmpty(path))
+                {
+                    customHelperPaths.Add(path!);
+                }
+            }
+            Add(Path.GetDirectoryName(System.Reflection.Assembly.GetEntryAssembly()?.Location), paths);
+            Add(Path.GetDirectoryName(System.Reflection.Assembly.GetCallingAssembly().Location), paths);
+            Add(Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location), paths);
+            Add(Path.GetDirectoryName(System.Diagnostics.Process.GetCurrentProcess().MainModule?.FileName), paths);
+#endif
+            o.CustomHelperPaths = paths;
+
+            o.CustomHelpers = new Dictionary<string, IHelpers>();
+            if (settings.HandlebarsSettings?.AllowedCustomHandlebarsHelpers.HasFlag(CustomHandlebarsHelpers.File) == true)
+            {
+                o.CustomHelpers.Add(FileHelpers.Name, new FileHelpers(handlebarsContext, settings));
+            }
+        });
+    }
+
+    private static string GetBaseDirectory()
+    {
+#if NETSTANDARD1_3_OR_GREATER || NET6_0_OR_GREATER
+        return AppContext.BaseDirectory.TrimEnd(Path.DirectorySeparatorChar);
+#else
+        return AppDomain.CurrentDomain.BaseDirectory.TrimEnd(Path.DirectorySeparatorChar);
+#endif
+    }
+}