// Copyright © WireMock.Net
using Aspire.Hosting.ApplicationModel;
using Aspire.Hosting.Lifecycle;
using Stef.Validation;
using WireMock.Client.Builders;
using WireMock.Net.Aspire;
// ReSharper disable once CheckNamespace
namespace Aspire.Hosting;
///
/// Provides extension methods for adding WireMock.Net Server resources to the application model.
///
public static class WireMockServerBuilderExtensions
{
// Linux only (https://github.com/dotnet/aspire/issues/854)
private const string DefaultLinuxImage = "sheyenrath/wiremock.net-alpine";
private const string DefaultLinuxMappingsPath = "/app/__admin/mappings";
///
/// Adds a WireMock.Net Server resource to the application model.
///
/// The .
/// The name of the resource. This name will be used as the connection string name when referenced in a dependency.
/// The HTTP port for the WireMock Server.
/// A reference to the .
public static IResourceBuilder AddWireMock(this IDistributedApplicationBuilder builder, string name, int? port = null)
{
Guard.NotNull(builder);
Guard.NotNullOrWhiteSpace(name);
Guard.Condition(port, p => p is null or > 0 and <= ushort.MaxValue);
return builder.AddWireMock(name, callback =>
{
callback.HttpPort = port;
});
}
///
/// Adds a WireMock.Net Server resource to the application model.
///
/// The .
/// The name of the resource. This name will be used as the connection string name when referenced in a dependency.
/// The arguments to start the WireMock.Net Server.
/// A reference to the .
public static IResourceBuilder AddWireMock(this IDistributedApplicationBuilder builder, string name, WireMockServerArguments arguments)
{
Guard.NotNull(builder);
Guard.NotNullOrWhiteSpace(name);
Guard.NotNull(arguments);
var wireMockContainerResource = new WireMockServerResource(name, arguments);
var resourceBuilder = builder
.AddResource(wireMockContainerResource)
.WithImage(DefaultLinuxImage)
.WithEnvironment(ctx => ctx.EnvironmentVariables.Add("DOTNET_USE_POLLING_FILE_WATCHER", "1")) // https://khalidabuhakmeh.com/aspnet-docker-gotchas-and-workarounds#configuration-reloads-and-filesystemwatcher
.WithHttpEndpoint(port: arguments.HttpPort, targetPort: WireMockServerArguments.HttpContainerPort);
if (!string.IsNullOrEmpty(arguments.MappingsPath))
{
resourceBuilder = resourceBuilder.WithBindMount(arguments.MappingsPath, DefaultLinuxMappingsPath);
}
resourceBuilder = resourceBuilder.WithArgs(ctx =>
{
foreach (var arg in arguments.GetArgs())
{
ctx.Args.Add(arg);
}
});
return resourceBuilder;
}
///
/// Adds a WireMock.Net Server resource to the application model.
///
/// The .
/// The name of the resource. This name will be used as the connection string name when referenced in a dependency.
/// A callback that allows for setting the .
/// A reference to the .
public static IResourceBuilder AddWireMock(this IDistributedApplicationBuilder builder, string name, Action callback)
{
Guard.NotNull(builder);
Guard.NotNullOrWhiteSpace(name);
Guard.NotNull(callback);
var arguments = new WireMockServerArguments();
callback(arguments);
return builder.AddWireMock(name, arguments);
}
///
/// Defines if the static mappings should be read at startup.
///
/// Default set to false.
///
/// A reference to the .
public static IResourceBuilder WithReadStaticMappings(this IResourceBuilder wiremock)
{
Guard.NotNull(wiremock).Resource.Arguments.ReadStaticMappings = true;
return wiremock;
}
///
/// Watch the static mapping files + folder for changes when running.
///
/// Default set to false.
///
/// A reference to the .
public static IResourceBuilder WithWatchStaticMappings(this IResourceBuilder wiremock)
{
Guard.NotNull(wiremock).Resource.Arguments.WithWatchStaticMappings = true;
return wiremock;
}
///
/// Specifies the path for the (static) mapping json files.
///
/// The .
/// The local path.
/// A reference to the .
public static IResourceBuilder WithMappingsPath(this IResourceBuilder wiremock, string mappingsPath)
{
return Guard.NotNull(wiremock)
.WithBindMount(Guard.NotNullOrWhiteSpace(mappingsPath), DefaultLinuxMappingsPath);
}
///
/// Set the admin username and password for accessing the admin interface from WireMock.Net via HTTP.
///
/// The .
/// The admin username.
/// The admin password.
/// A reference to the .
public static IResourceBuilder WithAdminUserNameAndPassword(this IResourceBuilder wiremock, string username, string password)
{
Guard.NotNull(wiremock);
wiremock.Resource.Arguments.AdminUsername = Guard.NotNull(username);
wiremock.Resource.Arguments.AdminPassword = Guard.NotNull(password);
return wiremock;
}
///
/// Use WireMock Client's AdminApiMappingBuilder to configure the WireMock.Net resource.
///
/// The .
/// Delegate that will be invoked to configure the WireMock.Net resource.
///
public static IResourceBuilder WithApiMappingBuilder(this IResourceBuilder wiremock, Func configure)
{
Guard.NotNull(wiremock);
wiremock.ApplicationBuilder.Services.TryAddLifecycleHook();
wiremock.Resource.Arguments.ApiMappingBuilder = configure;
return wiremock;
}
}