Cassandra

Author: cristianrgreco

docs/modules/arangodb.md

@@ -8,11 +8,11 @@ npm install @testcontainers/arangodb --save-dev
 
 ## Example
 
-This example uses the [arangojs](https://www.npmjs.com/package/arangojs/v/6.0.0-alpha.0) library:
+This example uses the following libraries:
 
-```bash
-npm install arangojs
-```
+- [arangojs](https://www.npmjs.com/package/arangojs/v/6.0.0-alpha.0)
+
+        npm install arangojs
 
 ---
 

docs/modules/cassandra.md

@@ -1,8 +1,4 @@
-# Cassandra Module
-
-[Cassandra](https://cassandra.apache.org/_/index.html) is a free and open source, distributed NoSQL database management system. It is designed to handle large amounts of data across many commodity servers, providing high availability with no single point of failure.
-
-
+# Cassandra
 
 ## Install
 
@@ -12,18 +8,30 @@ npm install @testcontainers/cassandra --save-dev
 
 ## Examples
 
-<!--codeinclude-->
-[Connect:](../../packages/modules/cassandra/src/cassandra-container.test.ts) inside_block:connectWithDefaultCredentials
-<!--/codeinclude-->
+These examples use the following libraries:
+
+- [cassandra-driver](https://www.npmjs.com/package/cassandra-driver)
+
+        npm install cassandra-driver
+
+---
+
+Choose an image from [Docker Hub](https://hub.docker.com/_/cassandra) and substitute `IMAGE`.
+ 
+### Execute a query
 
 <!--codeinclude-->
-[Connect with custom credentials:](../../packages/modules/cassandra/src/cassandra-container.test.ts) inside_block:connectWithCustomCredentials
+[](../../packages/modules/cassandra/src/cassandra-container.test.ts) inside_block:connectWithDefaultCredentials
 <!--/codeinclude-->
 
+### Custom credentials
+
 <!--codeinclude-->
-[With custom datacenter / rack](../../packages/modules/cassandra/src/cassandra-container.test.ts) inside_block:customDataCenterAndRack
+[](../../packages/modules/cassandra/src/cassandra-container.test.ts) inside_block:connectWithCustomCredentials
 <!--/codeinclude-->
 
+### Custom datacenter / rack
+
 <!--codeinclude-->
-[Insert & fetch data:](../../packages/modules/cassandra/src/cassandra-container.test.ts) inside_block:createAndFetchData
+[](../../packages/modules/cassandra/src/cassandra-container.test.ts) inside_block:customDataCenterAndRack
 <!--/codeinclude-->

packages/modules/cassandra/src/cassandra-container.test.ts

@@ -6,27 +6,26 @@ import { CassandraContainer } from "./cassandra-container";
 const IMAGE = getImage(__dirname);
 
 describe.sequential("Cassandra", { timeout: 240_000 }, () => {
-  // connectWithDefaultCredentials {
   it("should connect and execute a query with default credentials", async () => {
+    // connectWithDefaultCredentials {
     await using container = await new CassandraContainer(IMAGE).start();
 
     const client = new Client({
       contactPoints: [container.getContactPoint()],
       localDataCenter: container.getDatacenter(),
       keyspace: "system",
     });
-
     await client.connect();
 
     const result = await client.execute("SELECT release_version FROM system.local");
     expect(result.rows[0].release_version).toBe(ImageName.fromString(IMAGE).tag);
 
     await client.shutdown();
+    // }
   });
-  // }
 
-  // connectWithCustomCredentials {
   it("should connect with custom username and password", async () => {
+    // connectWithCustomCredentials {
     const username = "testUser";
     const password = "testPassword";
 
@@ -38,6 +37,7 @@ describe.sequential("Cassandra", { timeout: 240_000 }, () => {
       credentials: { username, password },
       keyspace: "system",
     });
+    // }
 
     await client.connect();
 
@@ -46,12 +46,12 @@ describe.sequential("Cassandra", { timeout: 240_000 }, () => {
 
     await client.shutdown();
   });
-  // }
 
-  // customDataCenterAndRack {
   it("should set datacenter and rack", async () => {
+    // customDataCenterAndRack {
     const customDataCenter = "customDC";
     const customRack = "customRack";
+
     await using container = await new CassandraContainer(IMAGE)
       .withDatacenter(customDataCenter)
       .withRack(customRack)
@@ -61,15 +61,15 @@ describe.sequential("Cassandra", { timeout: 240_000 }, () => {
       contactPoints: [container.getContactPoint()],
       localDataCenter: container.getDatacenter(),
     });
-
     await client.connect();
+
     const result = await client.execute("SELECT data_center, rack FROM system.local");
     expect(result.rows[0].data_center).toBe(customDataCenter);
     expect(result.rows[0].rack).toBe(customRack);
 
     await client.shutdown();
+    // }
   });
-  // }
 
   // createAndFetchData {
   it("should create keyspace, a table, insert data, and retrieve it", async () => {