-
-
Notifications
You must be signed in to change notification settings - Fork 297
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Co-authored-by: Andre Hofmeister <9199345+HofmeisterAn@users.noreply.github.com>
- Loading branch information
1 parent
2229e96
commit 1f3daa7
Showing
12 changed files
with
288 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| root = true |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,69 @@ | ||
| namespace Testcontainers.Papercut; | ||
|
|
||
| /// <inheritdoc cref="ContainerBuilder{TBuilderEntity, TContainerEntity, TConfigurationEntity}" /> | ||
| [PublicAPI] | ||
| public sealed class PapercutBuilder : ContainerBuilder<PapercutBuilder, PapercutContainer, PapercutConfiguration> | ||
| { | ||
| public const string PapercutImage = "jijiechen/papercut:latest"; | ||
|
|
||
| public const ushort HttpPort = 37408; | ||
|
|
||
| public const ushort SmtpPort = 25; | ||
|
|
||
| /// <summary> | ||
| /// Initializes a new instance of the <see cref="PapercutBuilder" /> class. | ||
| /// </summary> | ||
| public PapercutBuilder() | ||
| : this(new PapercutConfiguration()) | ||
| { | ||
| DockerResourceConfiguration = Init().DockerResourceConfiguration; | ||
| } | ||
|
|
||
| /// <summary> | ||
| /// Initializes a new instance of the <see cref="PapercutBuilder" /> class. | ||
| /// </summary> | ||
| /// <param name="resourceConfiguration">The Docker resource configuration.</param> | ||
| private PapercutBuilder(PapercutConfiguration resourceConfiguration) | ||
| : base(resourceConfiguration) | ||
| { | ||
| DockerResourceConfiguration = resourceConfiguration; | ||
| } | ||
|
|
||
| /// <inheritdoc /> | ||
| protected override PapercutConfiguration DockerResourceConfiguration { get; } | ||
|
|
||
| /// <inheritdoc /> | ||
| public override PapercutContainer Build() | ||
| { | ||
| Validate(); | ||
| return new PapercutContainer(DockerResourceConfiguration, TestcontainersSettings.Logger); | ||
| } | ||
|
|
||
| /// <inheritdoc /> | ||
| protected override PapercutBuilder Init() | ||
| { | ||
| return base.Init() | ||
| .WithImage(PapercutImage) | ||
| .WithPortBinding(HttpPort, true) | ||
| .WithPortBinding(SmtpPort, true) | ||
| .WithWaitStrategy(Wait.ForUnixContainer().UntilHttpRequestIsSucceeded(request => request.ForPort(HttpPort))); | ||
| } | ||
|
|
||
| /// <inheritdoc /> | ||
| protected override PapercutBuilder Clone(IResourceConfiguration<CreateContainerParameters> resourceConfiguration) | ||
| { | ||
| return Merge(DockerResourceConfiguration, new PapercutConfiguration(resourceConfiguration)); | ||
| } | ||
|
|
||
| /// <inheritdoc /> | ||
| protected override PapercutBuilder Clone(IContainerConfiguration resourceConfiguration) | ||
| { | ||
| return Merge(DockerResourceConfiguration, new PapercutConfiguration(resourceConfiguration)); | ||
| } | ||
|
|
||
| /// <inheritdoc /> | ||
| protected override PapercutBuilder Merge(PapercutConfiguration oldValue, PapercutConfiguration newValue) | ||
| { | ||
| return new PapercutBuilder(new PapercutConfiguration(oldValue, newValue)); | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,53 @@ | ||
| namespace Testcontainers.Papercut; | ||
|
|
||
| /// <inheritdoc cref="ContainerConfiguration" /> | ||
| [PublicAPI] | ||
| public sealed class PapercutConfiguration : ContainerConfiguration | ||
| { | ||
| /// <summary> | ||
| /// Initializes a new instance of the <see cref="PapercutConfiguration" /> class. | ||
| /// </summary> | ||
| public PapercutConfiguration() | ||
| { | ||
| } | ||
|
|
||
| /// <summary> | ||
| /// Initializes a new instance of the <see cref="PapercutConfiguration" /> class. | ||
| /// </summary> | ||
| /// <param name="resourceConfiguration">The Docker resource configuration.</param> | ||
| public PapercutConfiguration(IResourceConfiguration<CreateContainerParameters> resourceConfiguration) | ||
| : base(resourceConfiguration) | ||
| { | ||
| // Passes the configuration upwards to the base implementations to create an updated immutable copy. | ||
| } | ||
|
|
||
| /// <summary> | ||
| /// Initializes a new instance of the <see cref="PapercutConfiguration" /> class. | ||
| /// </summary> | ||
| /// <param name="resourceConfiguration">The Docker resource configuration.</param> | ||
| public PapercutConfiguration(IContainerConfiguration resourceConfiguration) | ||
| : base(resourceConfiguration) | ||
| { | ||
| // Passes the configuration upwards to the base implementations to create an updated immutable copy. | ||
| } | ||
|
|
||
| /// <summary> | ||
| /// Initializes a new instance of the <see cref="PapercutConfiguration" /> class. | ||
| /// </summary> | ||
| /// <param name="resourceConfiguration">The Docker resource configuration.</param> | ||
| public PapercutConfiguration(PapercutConfiguration resourceConfiguration) | ||
| : this(new PapercutConfiguration(), resourceConfiguration) | ||
| { | ||
| // Passes the configuration upwards to the base implementations to create an updated immutable copy. | ||
| } | ||
|
|
||
| /// <summary> | ||
| /// Initializes a new instance of the <see cref="PapercutConfiguration" /> class. | ||
| /// </summary> | ||
| /// <param name="oldValue">The old Docker resource configuration.</param> | ||
| /// <param name="newValue">The new Docker resource configuration.</param> | ||
| public PapercutConfiguration(PapercutConfiguration oldValue, PapercutConfiguration newValue) | ||
| : base(oldValue, newValue) | ||
| { | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| namespace Testcontainers.Papercut; | ||
|
|
||
| /// <inheritdoc cref="DockerContainer" /> | ||
| [PublicAPI] | ||
| public sealed class PapercutContainer : DockerContainer | ||
| { | ||
| /// <summary> | ||
| /// Initializes a new instance of the <see cref="PapercutContainer" /> class. | ||
| /// </summary> | ||
| /// <param name="configuration">The container configuration.</param> | ||
| /// <param name="logger">The logger.</param> | ||
| public PapercutContainer(PapercutConfiguration configuration, ILogger logger) | ||
| : base(configuration, logger) | ||
| { | ||
| } | ||
|
|
||
| /// <summary> | ||
| /// Gets the SMTP port. | ||
| /// </summary> | ||
| public ushort SmtpPort => GetMappedPublicPort(PapercutBuilder.SmtpPort); | ||
|
|
||
| /// <summary> | ||
| /// Gets the Papercut base address. | ||
| /// </summary> | ||
| /// <returns>The Papercut base address.</returns> | ||
| public string GetBaseAddress() | ||
| { | ||
| return new UriBuilder(Uri.UriSchemeHttp, Hostname, GetMappedPublicPort(PapercutBuilder.HttpPort)).ToString(); | ||
| } | ||
| } |
16 changes: 16 additions & 0 deletions
16
src/Testcontainers.Papercut/Testcontainers.Papercut.csproj
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| <Project Sdk="Microsoft.NET.Sdk"> | ||
| <PropertyGroup> | ||
| <TargetFrameworks>netstandard2.0;netstandard2.1</TargetFrameworks> | ||
| <LangVersion>latest</LangVersion> | ||
| <Copyright>Copyright (c) 2019 - 2023 Liam Wilson, Andre Hofmeister and other authors</Copyright> | ||
| <Authors>Liam Wilson, Andre Hofmeister and contributors</Authors> | ||
| <Description>A Testcontainers Papercut module for testing SMTP clients and sending emails.</Description> | ||
| </PropertyGroup> | ||
| <ItemGroup> | ||
| <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" PrivateAssets="All"/> | ||
| <PackageReference Include="JetBrains.Annotations" Version="2022.3.1" PrivateAssets="All"/> | ||
| </ItemGroup> | ||
| <ItemGroup> | ||
| <ProjectReference Include="$(SolutionDir)src/Testcontainers/Testcontainers.csproj"/> | ||
| </ItemGroup> | ||
| </Project> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| global using System; | ||
| global using Docker.DotNet.Models; | ||
| global using DotNet.Testcontainers.Builders; | ||
| global using DotNet.Testcontainers.Configurations; | ||
| global using DotNet.Testcontainers.Containers; | ||
| global using JetBrains.Annotations; | ||
| global using Microsoft.Extensions.Logging; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| root = true |
72 changes: 72 additions & 0 deletions
72
tests/Testcontainers.Papercut.Tests/PapercutContainerTest.cs
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,72 @@ | ||
| namespace Testcontainers.Papercut; | ||
|
|
||
| public sealed class PapercutContainerTest : IAsyncLifetime | ||
| { | ||
| private readonly PapercutContainer _papercutContainer = new PapercutBuilder().Build(); | ||
|
|
||
| public Task InitializeAsync() | ||
| { | ||
| return _papercutContainer.StartAsync(); | ||
| } | ||
|
|
||
| public Task DisposeAsync() | ||
| { | ||
| return _papercutContainer.DisposeAsync().AsTask(); | ||
| } | ||
|
|
||
| [Fact] | ||
| [Trait(nameof(DockerCli.DockerPlatform), nameof(DockerCli.DockerPlatform.Linux))] | ||
| public async Task ReceivesSentMessage() | ||
| { | ||
| // Given | ||
| const string subject = "Test"; | ||
|
|
||
| Message[] messages; | ||
|
|
||
| using var httpClient = new HttpClient(); | ||
| httpClient.BaseAddress = new Uri(_papercutContainer.GetBaseAddress()); | ||
|
|
||
| using var smtpClient = new SmtpClient(_papercutContainer.Hostname, _papercutContainer.SmtpPort); | ||
|
|
||
| // When | ||
| smtpClient.Send("from@example.com", "to@example.com", subject, "A test message"); | ||
|
|
||
| do | ||
| { | ||
| var messagesJson = await httpClient.GetStringAsync("/api/messages") | ||
| .ConfigureAwait(false); | ||
|
|
||
| var jsonDocument = JsonDocument.Parse(messagesJson); | ||
| messages = jsonDocument.RootElement.GetProperty("messages").Deserialize<Message[]>(); | ||
| } | ||
| while (messages.Length == 0); | ||
|
|
||
| // Then | ||
| Assert.NotEmpty(messages); | ||
| Assert.Equal(subject, messages[0].Subject); | ||
| } | ||
|
|
||
| private readonly struct Message | ||
| { | ||
| [JsonConstructor] | ||
| public Message(string id, string subject, string size, DateTime createdAt) | ||
| { | ||
| Id = id; | ||
| Subject = subject; | ||
| Size = size; | ||
| CreatedAt = createdAt; | ||
| } | ||
|
|
||
| [JsonPropertyName("id")] | ||
| public string Id { get; } | ||
|
|
||
| [JsonPropertyName("subject")] | ||
| public string Subject { get; } | ||
|
|
||
| [JsonPropertyName("size")] | ||
| public string Size { get; } | ||
|
|
||
| [JsonPropertyName("createdAt")] | ||
| public DateTime CreatedAt { get; } | ||
| } | ||
| } |
17 changes: 17 additions & 0 deletions
17
tests/Testcontainers.Papercut.Tests/Testcontainers.Papercut.Tests.csproj
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,17 @@ | ||
| <Project Sdk="Microsoft.NET.Sdk"> | ||
| <PropertyGroup> | ||
| <TargetFrameworks>net6.0</TargetFrameworks> | ||
| <IsPackable>false</IsPackable> | ||
| <IsPublishable>false</IsPublishable> | ||
| </PropertyGroup> | ||
| <ItemGroup> | ||
| <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.7.2"/> | ||
| <PackageReference Include="coverlet.collector" Version="6.0.0"/> | ||
| <PackageReference Include="xunit.runner.visualstudio" Version="2.5.0"/> | ||
| <PackageReference Include="xunit" Version="2.5.0"/> | ||
| </ItemGroup> | ||
| <ItemGroup> | ||
| <ProjectReference Include="$(SolutionDir)src/Testcontainers.Papercut/Testcontainers.Papercut.csproj"/> | ||
| <ProjectReference Include="$(SolutionDir)tests/Testcontainers.Commons/Testcontainers.Commons.csproj"/> | ||
| </ItemGroup> | ||
| </Project> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| global using System; | ||
| global using System.Net.Http; | ||
| global using System.Net.Mail; | ||
| global using System.Text.Json; | ||
| global using System.Text.Json.Serialization; | ||
| global using System.Threading.Tasks; | ||
| global using DotNet.Testcontainers.Commons; | ||
| global using Xunit; |