chore: Log experimental feature

testcontainers · Jan 20, 2024 · bafb41b · bafb41b
1 parent 18ac11e
commit bafb41b
Show file tree

Hide file tree

Showing 4 changed files with 14 additions and 0 deletions.
diff --git a/src/Testcontainers/Containers/DockerContainer.cs b/src/Testcontainers/Containers/DockerContainer.cs
@@ -368,6 +368,8 @@ protected override async Task UnsafeCreateAsync(CancellationToken ct = default)
 
       if (_configuration.Reuse.HasValue && _configuration.Reuse.Value)
       {
+        Logger.ReusableExperimentalFeature();
+
         var filters = new FilterByReuseHash(_configuration);
 
         var reusableContainers = await _client.Container.GetAllAsync(filters, ct)

diff --git a/src/Testcontainers/Logging.cs b/src/Testcontainers/Logging.cs
@@ -101,6 +101,9 @@ internal static class Logging
     private static readonly Action<ILogger, string, Exception> _DockerRegistryCredentialFound
       = LoggerMessage.Define<string>(LogLevel.Information, default, "Docker registry credential {DockerRegistry} found");
 
+    private static readonly Action<ILogger, Exception> _ReusableExperimentalFeature
+      = LoggerMessage.Define(LogLevel.Warning, default, "Reuse is an experimental feature. For more information, visit: https://dotnet.testcontainers.org/api/resource_reuse/");
+
     private static readonly Action<ILogger, Exception> _ReusableResourceFound
       = LoggerMessage.Define(LogLevel.Information, default, "Reusable resource found");
 
@@ -261,6 +264,11 @@ public static void DockerRegistryCredentialFound(this ILogger logger, string doc
       _DockerRegistryCredentialFound(logger, dockerRegistry, null);
     }
 
+    public static void ReusableExperimentalFeature(this ILogger logger)
+    {
+      _ReusableExperimentalFeature(logger, null);
+    }
+
     public static void ReusableResourceFound(this ILogger logger)
     {
       _ReusableResourceFound(logger, null);

diff --git a/src/Testcontainers/Networks/DockerNetwork.cs b/src/Testcontainers/Networks/DockerNetwork.cs
@@ -103,6 +103,8 @@ protected override async Task UnsafeCreateAsync(CancellationToken ct = default)
 
       if (_configuration.Reuse.HasValue && _configuration.Reuse.Value)
       {
+        _logger.ReusableExperimentalFeature();
+
         var filters = new FilterByReuseHash(_configuration);
 
         var reusableNetworks = await _client.Network.GetAllAsync(filters, ct)

diff --git a/src/Testcontainers/Volumes/DockerVolume.cs b/src/Testcontainers/Volumes/DockerVolume.cs
@@ -103,6 +103,8 @@ protected override async Task UnsafeCreateAsync(CancellationToken ct = default)
 
       if (_configuration.Reuse.HasValue && _configuration.Reuse.Value)
       {
+        _logger.ReusableExperimentalFeature();
+
         var filters = new FilterByReuseHash(_configuration);
 
         var reusableVolumes = await _client.Volume.GetAllAsync(filters, ct)