Merge branch 'main' into release-11.0.0

Author: cristianrgreco

docs/features/compose.md

@@ -41,6 +41,17 @@ const environment = await new DockerComposeEnvironment(composeFilePath, composeF
   .up();
 ```
 
+### With a default wait strategy
+
+By default Testcontainers uses the "listening ports" wait strategy for all containers. If you'd like to override
+the default wait strategy for all services, you can do so:
+
+```javascript
+const environment = await new DockerComposeEnvironment(composeFilePath, composeFile)
+  .withDefaultWaitStrategy(Wait.forHealthCheck())
+  .up();
+```
+
 ### With a pull policy
 
 Testcontainers will automatically pull an image if it doesn't exist. This is configurable:

docs/modules/clickhouse.md

@@ -0,0 +1,55 @@
+# ClickHouse Module
+
+[ClickHouse](https://clickhouse.com/) is a column-oriented database management system for online analytical processing (OLAP) that allows users to generate analytical reports using SQL queries in real-time.
+
+## Install
+
+```bash
+npm install @testcontainers/clickhouse --save-dev
+```
+
+## Examples
+
+<!--codeinclude-->
+[Connect and execute query:](../../packages/modules/clickhouse/src/clickhouse-container.test.ts) inside_block:connectWithOptions
+<!--/codeinclude-->
+
+<!--codeinclude-->
+[Connect using URL and execute query:](../../packages/modules/clickhouse/src/clickhouse-container.test.ts) inside_block:connectWithUrl
+<!--/codeinclude-->
+
+<!--codeinclude-->
+[Connect with username and password and execute query:](../../packages/modules/clickhouse/src/clickhouse-container.test.ts) inside_block:connectWithUsernameAndPassword
+<!--/codeinclude-->
+
+<!--codeinclude-->
+[Set database:](../../packages/modules/clickhouse/src/clickhouse-container.test.ts) inside_block:setDatabase
+<!--/codeinclude-->
+
+<!--codeinclude-->
+[Set username:](../../packages/modules/clickhouse/src/clickhouse-container.test.ts) inside_block:setUsername
+<!--/codeinclude-->
+
+### Connection Methods
+
+The module provides several methods to connect to the ClickHouse container:
+
+1. `getClientOptions()` - Returns a configuration object suitable for `@clickhouse/client`:
+   ```typescript
+   {
+     url: string; // HTTP URL with host and port
+     username: string; // Container username
+     password: string; // Container password
+     database: string; // Container database
+   }
+   ```
+2. `getConnectionUrl()` - Returns a complete HTTP URL including credentials and database:
+   ```
+   http://[username[:password]@][host[:port]]/database
+   ```
+3. `getHttpUrl()` - Returns the base HTTP URL without credentials:
+   ```
+   http://[host[:port]]
+   ```
+
+These methods can be used with the `@clickhouse/client` package or any other ClickHouse client.

mkdocs.yml

@@ -51,6 +51,7 @@ nav:
       - Azurite: modules/azurite.md
       - Cassandra: modules/cassandra.md
       - ChromaDB: modules/chromadb.md
+      - ClickHouse: modules/clickhouse.md
       - CosmosDB: modules/cosmosdb.md
       - Couchbase: modules/couchbase.md
       - CockroachDB: modules/cockroachdb.md