Add Weaviate module (#8337)

Author: eddumelendez

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -55,6 +55,7 @@ body:
         - ToxiProxy
         - Trino
         - Vault
+        - Weaviate
         - YugabyteDB
     validations:
       required: true

.github/ISSUE_TEMPLATE/enhancement.yaml

@@ -55,6 +55,7 @@ body:
         - ToxiProxy
         - Trino
         - Vault
+        - Weaviate
         - YugabyteDB
     validations:
       required: true

.github/ISSUE_TEMPLATE/feature.yaml

@@ -55,6 +55,7 @@ body:
         - ToxiProxy
         - Trino
         - Vault
+        - Weaviate
         - YugabyteDB
         - New Module
   - type: textarea

.github/dependabot.yml

@@ -302,6 +302,11 @@ updates:
     schedule:
       interval: "weekly"
     open-pull-requests-limit: 10
+  - package-ecosystem: "gradle"
+    directory: "/modules/weaviate"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
   - package-ecosystem: "gradle"
     directory: "/modules/yugabytedb"
     schedule:

.github/labeler.yml

@@ -192,6 +192,10 @@
   - changed-files:
     - any-glob-to-any-file:
       - modules/vault/**/*
+"modules/weaviate":
+  - changed-files:
+    - any-glob-to-any-file:
+      - modules/weaviate/**/*
 "modules/yugabytedb":
   - changed-files:
     - any-glob-to-any-file:

.github/settings.yml

@@ -238,6 +238,9 @@ labels:
   - name: modules/vault
     color: '#006b75'
 
+  - name: modules/weaviate
+    color: '#006b75'
+
   - name: modules/yugabytedb
     color: '#006b75'
 

docs/modules/weaviate.md

@@ -0,0 +1,30 @@
+# Weaviate
+
+Testcontainers module for [Weaviate](https://hub.docker.com/r/semitechnologies/weaviate)
+
+## WeaviateContainer's usage examples
+
+You can start a Weaviate container instance from any Java application by using:
+
+<!--codeinclude-->
+[Default Weaviate container](../../modules/weaviate/src/test/java/org/testcontainers/weaviate/WeaviateContainerTest.java) inside_block:container
+<!--/codeinclude-->
+
+## Adding this module to your project dependencies
+
+Add the following dependency to your `pom.xml`/`build.gradle` file:
+
+=== "Gradle"
+```groovy
+testImplementation "org.testcontainers:weaviate:{{latest_version}}"
+```
+
+=== "Maven"
+```xml
+<dependency>
+<groupId>org.testcontainers</groupId>
+<artifactId>weaviate</artifactId>
+<version>{{latest_version}}</version>
+<scope>test</scope>
+</dependency>
+```

mkdocs.yml

@@ -93,6 +93,7 @@ nav:
           - modules/solr.md
           - modules/toxiproxy.md
           - modules/vault.md
+          - modules/weaviate.md
           - modules/webdriver_containers.md
     - Test framework integration:
           - test_framework_integration/junit_4.md

modules/weaviate/build.gradle

@@ -0,0 +1,8 @@
+description = "Testcontainers :: Weaviate"
+
+dependencies {
+    api project(':testcontainers')
+
+    testImplementation 'org.assertj:assertj-core:3.25.1'
+    testImplementation 'io.weaviate:client:4.5.1'
+}

modules/weaviate/src/main/java/org/testcontainers/weaviate/WeaviateContainer.java

@@ -0,0 +1,36 @@
+package org.testcontainers.weaviate;
+
+import org.testcontainers.containers.GenericContainer;
+import org.testcontainers.utility.DockerImageName;
+
+/**
+ * Testcontainers implementation of Weaviate.
+ * <p>
+ * Supported image: {@code semitechnologies/weaviate}
+ * <p>
+ * Exposed ports:
+ * <ul>
+ *     <li>HTTP: 8080</li>
+ *     <li>gRPC: 50051</li>
+ * </ul>
+ */
+public class WeaviateContainer extends GenericContainer<WeaviateContainer> {
+
+    private static final String WEAVIATE_IMAGE = "semitechnologies/weaviate";
+
+    public WeaviateContainer(String dockerImageName) {
+        this(DockerImageName.parse(dockerImageName));
+    }
+
+    public WeaviateContainer(DockerImageName dockerImageName) {
+        super(dockerImageName);
+        dockerImageName.assertCompatibleWith(DockerImageName.parse(WEAVIATE_IMAGE));
+        withExposedPorts(8080, 50051);
+        withEnv("AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED", "true");
+        withEnv("PERSISTENCE_DATA_PATH", "/var/lib/weaviate");
+    }
+
+    public String getHttpHostAddress() {
+        return getHost() + ":" + getMappedPort(8080);
+    }
+}

modules/weaviate/src/test/java/org/testcontainers/weaviate/WeaviateContainerTest.java

@@ -0,0 +1,25 @@
+package org.testcontainers.weaviate;
+
+import io.weaviate.client.Config;
+import io.weaviate.client.WeaviateClient;
+import io.weaviate.client.base.Result;
+import io.weaviate.client.v1.misc.model.Meta;
+import org.junit.Test;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+public class WeaviateContainerTest {
+
+    @Test
+    public void test() {
+        try ( // container {
+            WeaviateContainer weaviate = new WeaviateContainer("semitechnologies/weaviate:1.22.4")
+            // }
+        ) {
+            weaviate.start();
+            WeaviateClient client = new WeaviateClient(new Config("http", weaviate.getHttpHostAddress()));
+            Result<Meta> meta = client.misc().metaGetter().run();
+            assertThat(meta.getResult().getVersion()).isEqualTo("1.22.4");
+        }
+    }
+}

modules/weaviate/src/test/resources/logback-test.xml

@@ -0,0 +1,16 @@
+<configuration>
+
+    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
+        <!-- encoders are assigned the type
+             ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
+        <encoder>
+            <pattern>%d{HH:mm:ss.SSS} %-5level %logger - %msg%n</pattern>
+        </encoder>
+    </appender>
+
+    <root level="INFO">
+        <appender-ref ref="STDOUT"/>
+    </root>
+
+    <logger name="org.testcontainers" level="INFO"/>
+</configuration>