chore: Update ClickHouseContainerTest modifier

Author: HofmeisterAn

docs/modules/activemq.md

@@ -30,9 +30,9 @@ You can start an Apache ActiveMQ Artemis container instance from any .NET applic
 
 Connect to the container and produce a message:
 
-=== "EstablishesConnection"
+=== "Establish connection"
     ```csharp
-    --8<-- "tests/Testcontainers.ActiveMq.Tests/ArtemisContainerTest.cs:ArtemisContainerEstablishesConnection"
+    --8<-- "tests/Testcontainers.ActiveMq.Tests/ArtemisContainerTest.cs:EstablishConnection"
     ```
 
 The test example uses the following NuGet dependencies:

docs/modules/clickhouse.md

@@ -12,20 +12,22 @@ You can start a ClickHouse container instance from any .NET application. This ex
 
 === "Test class"
     ```csharp
-    --8<-- "tests/Testcontainers.ClickHouse.Tests/ClickHouseContainerTest.docs.cs:Class"
+    --8<-- "tests/Testcontainers.ClickHouse.Tests/ClickHouseContainerTest.docs.cs:UseClickHouseContainer"
     }
     ```
 
-Connecting to container example:
-=== "Connecting to ClickHouse"
+Connect to the container:
+
+=== "Establish connection"
     ```csharp
-    --8<-- "tests/Testcontainers.ClickHouse.Tests/ClickHouseContainerTest.docs.cs:Connecting"
+    --8<-- "tests/Testcontainers.ClickHouse.Tests/ClickHouseContainerTest.docs.cs:EstablishConnection"
     ```
 
-Execute SQL script example:
-=== "SQL Script"
+Execute a SQL script:
+
+=== "Run SQL script"
     ```csharp
-    --8<-- "tests/Testcontainers.ClickHouse.Tests/ClickHouseContainerTest.docs.cs:SQLScript"
+    --8<-- "tests/Testcontainers.ClickHouse.Tests/ClickHouseContainerTest.docs.cs:RunSQLScript"
     ```
 
 The test example uses the following NuGet dependencies:

tests/Testcontainers.ActiveMq.Tests/ArtemisContainerTest.cs

@@ -31,7 +31,7 @@ await DisposeAsyncCore()
     }
     // # --8<-- [end:UseArtemisContainer]
 
-    // # --8<-- [start:ArtemisContainerEstablishesConnection]
+    // # --8<-- [start:EstablishConnection]
     [Fact]
     [Trait(nameof(DockerCli.DockerPlatform), nameof(DockerCli.DockerPlatform.Linux))]
     public async Task EstablishesConnection()
@@ -74,7 +74,7 @@ await producer.SendAsync(producedMessage)
 
         Assert.Equal(producedMessage.Text, receivedMessage.Body<string>());
     }
-    // # --8<-- [end:ArtemisContainerEstablishesConnection]
+    // # --8<-- [end:EstablishConnection]
 
     protected virtual ValueTask DisposeAsyncCore()
     {

tests/Testcontainers.ClickHouse.Tests/ClickHouseContainerTest.docs.cs

@@ -1,25 +1,26 @@
 namespace Testcontainers.ClickHouse;
 
-public partial class ClickHouseContainerTest
+public abstract partial class ClickHouseContainerTest
 {
-    [UsedImplicitly]
-    // <!-- -8<- [start:Class] -->
-    public sealed class ClickHouseContainerTestDocumentation : IAsyncLifetime
+    // <!-- -8<- [start:UseClickHouseContainer] -->
+    public sealed class ClickHouseContainerExample : IAsyncLifetime
     {
         private readonly ClickHouseContainer _clickHouseContainer = new ClickHouseBuilder().Build();
 
         public async ValueTask DisposeAsync()
         {
-            await _clickHouseContainer.DisposeAsync();
+            await _clickHouseContainer.DisposeAsync()
+                .ConfigureAwait(false);
         }
 
         public async ValueTask InitializeAsync()
         {
-            await _clickHouseContainer.StartAsync(TestContext.Current.CancellationToken);
+            await _clickHouseContainer.StartAsync(TestContext.Current.CancellationToken)
+                .ConfigureAwait(false);
         }
-        // <!-- -8<- [end:Class] -->
+        // <!-- -8<- [end:UseClickHouseContainer] -->
 
-        // <!-- -8<- [start:Connecting] -->
+        // <!-- -8<- [start:EstablishConnection] -->
         [Fact]
         [Trait(nameof(DockerCli.DockerPlatform), nameof(DockerCli.DockerPlatform.Linux))]
         public void ConnectionStateReturnsOpen()
@@ -33,9 +34,9 @@ public void ConnectionStateReturnsOpen()
             // Then
             Assert.Equal(ConnectionState.Open, connection.State);
         }
-        // <!-- -8<- [end:Connecting] -->
+        // <!-- -8<- [end:EstablishConnection] -->
 
-        // <!-- -8<- [start:SQLScript] -->
+        // <!-- -8<- [start:RunSQLScript] -->
         [Fact]
         [Trait(nameof(DockerCli.DockerPlatform), nameof(DockerCli.DockerPlatform.Linux))]
         public async Task ExecScriptReturnsSuccessful()
@@ -44,14 +45,13 @@ public async Task ExecScriptReturnsSuccessful()
             const string scriptContent = "SELECT 1;";
 
             // When
-            var execResult = await _clickHouseContainer
-                .ExecScriptAsync(scriptContent, TestContext.Current.CancellationToken)
+            var execResult = await _clickHouseContainer.ExecScriptAsync(scriptContent, CancellationToken.None)
                 .ConfigureAwait(true);
 
             // Then
             Assert.True(0L.Equals(execResult.ExitCode), execResult.Stderr);
             Assert.Empty(execResult.Stderr);
         }
-        // <!-- -8<- [end:SQLScript] -->
+        // <!-- -8<- [end:RunSQLScript] -->
     }
 }

tests/Testcontainers.ClickHouse.Tests/Usings.cs

@@ -1,5 +1,6 @@
 global using System.Data;
 global using System.Data.Common;
+global using System.Threading;
 global using System.Threading.Tasks;
 global using ClickHouse.Client.ADO;
 global using DotNet.Testcontainers.Builders;