docs: document 28 of the existing rust community modules

modules/azurite/index.md

@@ -72,6 +72,26 @@ docs:
       ```bash
       npm install @testcontainers/azurite --save-dev
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/index.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{
+          azurite,
+          azurite::{Azurite, BLOB_PORT},
+          testcontainers::runners::SyncRunner,
+      };
+
+      let azurite = Azurite::default().start().unwrap();
+      let blob_port = azurite.get_host_port_ipv4(BLOB_PORT).unwrap();
+
+      // do something with the started azurite instance..
+      ```
+    installation: |
+      ```bash
+      cargo add -F azurite --dev testcontainers-modules
+      ```
 description: |
   A lightweight server clone of Azure Storage.
 ---

modules/clickhouse/index.md

@@ -58,6 +58,22 @@ docs:
       ```bash
       pip install testcontainers[clickhouse]
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/clickhouse/struct.ClickHouse.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{clickhouse, testcontainers::runners::SyncRunner};
+
+      let clickhouse = clickhouse::ClickHouse::default().start().unwrap();
+      let http_port = clickhouse.get_host_port_ipv4(8123).unwrap();
+
+      // do something with the started clickhouse instance..
+      ```
+    installation: |
+      ```bash
+      cargo add -F clickhouse --dev testcontainers-modules
+      ```
 description: |
   ClickHouse is an open-source database management system for analytical processing that allows users to generate reports using SQL queries in real-time.
 ---

modules/cockroachdb/index.md

@@ -74,6 +74,22 @@ docs:
       ```bash
       pip install testcontainers[cockroachdb]
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/cockroach_db/struct.CockroachDb.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{cockroach_db, testcontainers::runners::SyncRunner};
+
+      let cockroach = cockroach_db::CockroachDb::default().start().unwrap();
+      let http_port = cockroach.get_host_port_ipv4(26257).unwrap();
+
+      // do something with the started cockroach instance..
+      ```
+    installation: |
+      ```bash
+      cargo add -F clicockroach_db --dev testcontainers-modules
+      ```
 description: |
   CockroachDB is an open-source, cloud-native, resilient, distributed SQL database.
 ---

modules/consul/index.md

@@ -45,6 +45,22 @@ docs:
       ```bash
       dotnet add package Testcontainers.Consul
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/consul/struct.Consul.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{consul, testcontainers::runners::SyncRunner};
+
+      let consul = consul::Consul::default().start().unwrap();
+      let http_port = consul.get_host_port_ipv4(8500).unwrap();
+
+      // do something with the started consul instance..
+      ```
+    installation: |
+      ```bash
+      cargo add -F consul --dev testcontainers-modules
+      ```
 description: |
   Consul is a service mesh and distributed key-value store.
 

modules/databend/index.md

@@ -32,15 +32,20 @@ docs:
       go get github.com/testcontainers/testcontainers-go/modules/databend
       ```
   - id: rust
-    url: https://github.com/testcontainers/testcontainers-rs-modules-community
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/databend/struct.Databend.html
     maintainer: community
     example: |
       ```rust
-      let databend = DatabendImage::default().start().await.unwrap();
+      use testcontainers_modules::{databend, testcontainers::runners::SyncRunner};
+
+      let databend = databend::Databend::default().start().unwrap();
+      let http_port = databend.get_host_port_ipv4(8000).unwrap();
+
+      // do something with the started databend instance.
       ```
     installation: |
       ```bash
-      cargo add -F surrealdb --dev testcontainers-modules
+      cargo add -F databend --dev testcontainers-modules
       ```
 description: |
     Databend, built in Rust, is an open-source cloud data warehouse.

modules/dynamodb/index.md

@@ -28,6 +28,21 @@ docs:
       ```bash
       dotnet add package Testcontainers.DynamoDb
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/dynamodb_local/struct.DynamoDb.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{dynamodb_local, testcontainers::runners::SyncRunner};
+
+      let dynamodb = dynamodb_local::DynamoDb::default().start().unwrap();
+
+      // do something with the started dynamodb instance..
+      ```
+    installation: |
+      ```bash
+      cargo add -F dynamodb --dev testcontainers-modules
+      ```
 description: |
   Amazon DynamoDB is a fully managed NoSQL database service that provides fast and predictable performance with seamless scalability.
 

modules/elasticsearch/index.md

@@ -69,6 +69,21 @@ docs:
       ```bash
       pip install testcontainers[elasticsearch]
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/elastic_search/struct.ElasticSearch.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{elastic_search, testcontainers::runners::SyncRunner};
+
+      let dynamodb = elastic_search::ElasticSearch::default().start().unwrap();
+
+      // do something with the started elastic_search instance..
+      ```
+    installation: |
+      ```bash
+      cargo add -F elastic_search --dev testcontainers-modules
+      ```
 description: |
   Elasticsearch is a search and analytics engine based on Apache Lucene. It provides a distributed, multitenant-capable full-text search engine with an HTTP web interface and schema-free JSON documents.
 ---

modules/k3s/index.md

@@ -67,6 +67,36 @@ docs:
       ```bash
       npm install @testcontainers/k3s --save-dev
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/k3s/struct.K3s.html
+    maintainer: community
+    example: |
+      ```rust
+      use std::env::temp_dir;
+
+      use testcontainers_modules::{
+          k3s::{K3s, KUBE_SECURE_PORT},
+          testcontainers::{runners::SyncRunner, ImageExt},
+      };
+
+      let k3s_instance = K3s::default()
+          .with_conf_mount(&temp_dir())
+          .with_privileged(true)
+          .with_userns_mode("host")
+          .start()
+          .unwrap();
+
+      let kube_port = k3s_instance.get_host_port_ipv4(KUBE_SECURE_PORT);
+      let kube_conf = k3s_instance
+          .image()
+          .read_kube_config()
+          .expect("Cannot read kube conf");
+      // use kube_port and kube_conf to connect and control k3s cluster
+      ```
+    installation: |
+      ```bash
+      cargo add -F k3s --dev testcontainers-modules
+      ```
 description: |
   K3s is a highly available, certified Kubernetes distribution designed for production workloads in unattended, resource-constrained, remote locations or inside IoT appliances.
 ---

modules/kafka/index.md

@@ -68,6 +68,30 @@ docs:
       ```bash
       pip install testcontainers[kafka]
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/kafka/index.html
+    maintainer: community
+    example: |
+      ```rust
+      use std::env::temp_dir;
+
+      use testcontainers_modules::kafka::confluent::Kafka;
+      // or also avaliable:  testcontainers_modules::kafka::apache::Kafka;
+
+      use testcontainers_modules::{
+          testcontainers::{runners::SyncRunner, ImageExt},
+      };
+
+      let kafka_instance = Kafka::default()
+          .start()
+          .unwrap();
+
+      // do something with the started kafka instance..
+      ```
+    installation: |
+      ```bash
+      cargo add -F kafka --dev testcontainers-modules
+      ```
 description: |
   Kafka is an open-source distributed event streaming platform for high-performance data pipelines, streaming analytics, data integration, and mission-critical applications.
 ---

modules/mariadb/index.md

@@ -56,6 +56,24 @@ docs:
       ```bash
       npm install @testcontainers/mariadb --save-dev
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/mariadb/struct.Mariadb.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{mariadb, testcontainers::runners::SyncRunner};
+
+      let mariadb_instance = mariadb::Mariadb::default().start().unwrap();
+      let mariadb_url = format!(
+          "mariadb://{}:{}/test",
+          mariadb_instance.get_host().unwrap(),
+          mariadb_instance.get_host_port_ipv4(3306).unwrap(),
+      );
+      ```
+    installation: |
+      ```bash
+      cargo add -F mariadb --dev testcontainers-modules
+      ```
 description: |
   MariaDB is a community-developed, commercially supported fork of the MySQL relational database management system.
 ---

modules/meilisearch/index.md

@@ -32,6 +32,25 @@ docs:
       ```bash
       go get github.com/testcontainers/testcontainers-go/modules/meilisearch
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/meilisearch/struct.Meilisearch.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{meilisearch, testcontainers::runners::SyncRunner};
+
+      let meilisearch_instance = meilisearch::Meilisearch::default().start().unwrap();
+
+      let dashboard = format!(
+          "http://{}:{}",
+          meilisearch_instance.get_host().unwrap(),
+          meilisearch_instance.get_host_port_ipv4(7700).unwrap()
+      );
+      ```
+    installation: |
+      ```bash
+      cargo add -F meilisearch --dev testcontainers-modules
+      ```
 description: |
   Meilisearch is a flexible and powerful user-focused search engine that can be added to any website or application.
 ---

modules/minio/index.md

@@ -68,6 +68,19 @@ docs:
       ```bash
       npm install @testcontainers/minio --save-dev
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/minio/struct.MinIO.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{minio, testcontainers::runners::SyncRunner};
+
+      let minio_instance = minio::MinIO::default().start().unwrap();
+      ```
+    installation: |
+      ```bash
+      cargo add -F minio --dev testcontainers-modules
+      ```
 description: |
   MinIO is a high performance object storage solution. It is API compatible with the Amazon S3 cloud storage service and can handle unstructured data such as photos, videos, log files, backups, and container images with a current maximum supported object size of 5TB.
 ---

modules/mongodb/index.md

@@ -68,6 +68,19 @@ docs:
       ```bash
       pip install testcontainers[mongodb]
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/mongo/struct.Mongo.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{mongo, testcontainers::runners::SyncRunner};
+
+      let mongo_instance = mongo::Mongo::default().start().unwrap();
+      ```
+    installation: |
+      ```bash
+      cargo add -F mongo --dev testcontainers-modules
+      ```
 description: |
   MongoDB is a source-available cross-platform document-oriented database program.
 ---

modules/mosquitto/index.md

@@ -15,6 +15,25 @@ docs:
       ```bash
       pip install testcontainers[mqtt]
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/mosquitto/struct.Mosquitto.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{mosquitto, testcontainers::runners::SyncRunner};
+
+      let mosquitto_instance = mosquitto::Mosquitto::default().start().unwrap();
+
+      let broker_url = format!(
+          "{}:{}",
+          mosquitto_instance.get_host().unwrap(),
+          mosquitto_instance.get_host_port_ipv4(1883).unwrap()
+      );
+      ```
+    installation: |
+      ```bash
+      cargo add -F mosquitto --dev testcontainers-modules
+      ```
 description: |
   Eclipse Mosquitto is an open source message broker which implements MQTT version 5, 3.1.1 and 3.1.
 ---

modules/mssql/index.md

@@ -74,6 +74,24 @@ docs:
       ```bash
       pip install testcontainers[mssql]
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/mssql_server/struct.MssqlServer.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{testcontainers::runners::SyncRunner, mssql_server};
+
+      let mssql_server = mssql_server::MssqlServer::default().with_accept_eula().start().unwrap();
+      let ado_connection_string = format!(
+        "Server=tcp:{},{};Database=test;User Id=sa;Password=yourStrong(!)Password;TrustServerCertificate=True;",
+        mssql_server.get_host().unwrap(),
+        mssql_server.get_host_port_ipv4(1433).unwrap()
+      );
+      ```
+    installation: |
+      ```bash
+      cargo add -F mssql_server --dev testcontainers-modules
+      ```
 description: |
   Microsoft SQL Server is a relational database management system.
 ---

modules/mysql/index.md

@@ -68,6 +68,24 @@ docs:
       ```bash
       pip install testcontainers[mysql]
       ```
+  - id: rust
+    url: https://docs.rs/testcontainers-modules/latest/testcontainers_modules/mysql/struct.Mysql.html
+    maintainer: community
+    example: |
+      ```rust
+      use testcontainers_modules::{mysql, testcontainers::runners::SyncRunner};
+
+      let mysql_instance = mysql::Mysql::default().start().unwrap();
+      let mysql_url = format!(
+          "mysql://{}:{}/test",
+          mysql_instance.get_host().unwrap(),
+          mysql_instance.get_host_port_ipv4(3306).unwrap()
+      );
+      ```
+    installation: |
+      ```bash
+      cargo add -F mysql --dev testcontainers-modules
+      ```
 description: |
   MySQL is an open-source relational database management system.
 ---