Add pinecone module (#9911)

Author: eddumelendez

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -50,6 +50,7 @@ body:
         - Oracle Free
         - Oracle XE
         - OrientDB
+        - Pinecone
         - PostgreSQL
         - Presto
         - Pulsar

.github/ISSUE_TEMPLATE/enhancement.yaml

@@ -50,6 +50,7 @@ body:
         - Oracle Free
         - Oracle XE
         - OrientDB
+        - Pinecone
         - PostgreSQL
         - Presto
         - Pulsar

.github/ISSUE_TEMPLATE/feature.yaml

@@ -50,6 +50,7 @@ body:
         - Oracle Free
         - Oracle XE
         - OrientDB
+        - Pinecone
         - PostgreSQL
         - Qdrant
         - QuestDB

.github/dependabot.yml

@@ -274,6 +274,11 @@ updates:
     schedule:
       interval: "weekly"
     open-pull-requests-limit: 10
+  - package-ecosystem: "gradle"
+    directory: "/modules/pinecone"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
   - package-ecosystem: "gradle"
     directory: "/modules/pulsar"
     schedule:

.github/labeler.yml

@@ -168,6 +168,10 @@
   - changed-files:
     - any-glob-to-any-file:
       - modules/orientdb/**/*
+"modules/pinecone":
+  - changed-files:
+    - any-glob-to-any-file:
+      - modules/pinecone/**/*
 "modules/postgres":
   - changed-files:
     - any-glob-to-any-file:

.github/settings.yml

@@ -211,6 +211,9 @@ labels:
   - name: modules/orientdb
     color: '#006b75'
 
+  - name: modules/pinecone
+    color: '#006b75'
+
   - name: modules/postgres
     color: '#006b75'
 

docs/modules/pinecone.md

@@ -0,0 +1,30 @@
+# Pinecone
+
+Testcontainers module for [Pinecone](https://github.com/orgs/pinecone-io/packages/container/package/pinecone-local).
+
+## PineconeContainer's usage examples
+
+You can start an Pinecone container instance from any Java application by using:
+
+<!--codeinclude-->
+[Pinecone container](../../modules/pinecone/src/test/java/org/testcontainers/pinecone/PineconeContainerTest.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:pinecone:{{latest_version}}"
+```
+
+=== "Maven"
+```xml
+<dependency>
+    <groupId>org.testcontainers</groupId>
+    <artifactId>pinecone</artifactId>
+    <version>{{latest_version}}</version>
+    <scope>test</scope>
+</dependency>
+```

mkdocs.yml

@@ -95,6 +95,7 @@ nav:
           - modules/nginx.md
           - modules/ollama.md
           - modules/openfga.md
+          - modules/pinecone.md
           - modules/pulsar.md
           - modules/qdrant.md
           - modules/rabbitmq.md

modules/pinecone/build.gradle

@@ -0,0 +1,8 @@
+description = "Testcontainers :: ActiveMQ"
+
+dependencies {
+    api project(':testcontainers')
+
+    testImplementation 'org.assertj:assertj-core:3.26.3'
+    testImplementation 'io.pinecone:pinecone-client:3.1.0'
+}

modules/pinecone/src/main/java/org/testcontainers/pinecone/PineconeContainer.java

@@ -0,0 +1,34 @@
+package org.testcontainers.pinecone;
+
+import org.testcontainers.containers.GenericContainer;
+import org.testcontainers.utility.DockerImageName;
+
+/**
+ * Testcontainers implementation for Pinecone.
+ * <p>
+ * Exposed port: 5080
+ */
+public class PineconeContainer extends GenericContainer<PineconeContainer> {
+
+    private static final DockerImageName DEFAULT_IMAGE_NAME = DockerImageName.parse(
+        "ghcr.io/pinecone-io/pinecone-local"
+    );
+
+    private static final int PORT = 5080;
+
+    public PineconeContainer(String dockerImageName) {
+        this(DockerImageName.parse(dockerImageName));
+    }
+
+    public PineconeContainer(DockerImageName dockerImageName) {
+        super(dockerImageName);
+        dockerImageName.assertCompatibleWith(DEFAULT_IMAGE_NAME);
+
+        withEnv("PORT", String.valueOf(5080));
+        withExposedPorts(5080);
+    }
+
+    public String getEndpoint() {
+        return "http://" + getHost() + ":" + getMappedPort(PORT);
+    }
+}