Updated Using WireMock.Net.Testcontainers (markdown)

Stef Heyenrath
2023-06-06 22:34:52 +02:00
parent 76583002f4
commit a5c47b80bd
+30 -1
@@ -1 +1,30 @@
... # WireMock.Net.Testcontainers
WireMock.Net.Testcontainers uses [Testcontainers for .NET](https://dotnet.testcontainers.org/) to spinup a docker container directly from the C# (unittest) code.
This options requires docker service running locally.
Both the [Linux](https://hub.docker.com/repository/docker/sheyenrath/wiremock.net) and the [Windows](https://hub.docker.com/repository/docker/sheyenrath/wiremock.net-windows/general) version from WireMock.Net are supported.
## Usage
### Build and Start
To build a container and startup this container, use this code:
``` C#
var container = new WireMockContainerBuilder()
.WithAutoRemove(true)
.WithCleanUp(true)
.Build();
await container.StartAsync().ConfigureAwait(false);
```
#### Methods
The following builder methods are available for the `WireMockContainerBuilder`:
| Method | Example | What |
| - | - | - |
| `WithMappings` | `.WithMappings(@"C:\example\\mappings")` | Specifies the path for the (static) mapping json files.
| `WithWatchStaticMappings` | `.WithWatchStaticMappings(true)` | Watch the static mapping files + folder for changes when running.
| `WithAdminUserNameAndPassword` | `.WithAdminUserNameAndPassword("x", "y")` | Set the admin username. and password for the container (basic authentication).
## Usage in Unit Test
Follow the tutorial [here](https://github.com/testcontainers/testcontainers-dotnet/blob/develop/examples/WeatherForecast/tests/WeatherForecast.Tests/WeatherForecastTest.cs) and make sure to use WireMock.Net container instead of the container used in that example.