chore: add postgres docker-compose file for local dev (#207)

* chore: add postgres docker-compose file for local dev

Author: thunderz99

.github/workflows/maven.yml

@@ -20,7 +20,7 @@ jobs:
           # refer: https://hub.docker.com/_/postgres
         env:
           POSTGRES_USER: postgres
-          POSTGRES_PASSWORD: mysecretpassword
+          POSTGRES_PASSWORD: postgres
           POSTGRES_DB: postgres
         ports:
           - 5432:5432

README.md

@@ -23,7 +23,7 @@ java-cosmos is a client for Azure CosmosDB 's SQL API (also called documentdb fo
 <dependency>
   <groupId>com.github.thunderz99</groupId>
     <artifactId>java-cosmos</artifactId>
-    <version>0.8.22</version>
+    <version>0.8.23</version>
 </dependency>
 ```
 

mongo/README.md

@@ -0,0 +1,39 @@
+# MongoDB local dev
+
+This folder contains a Docker Compose setup for a single-node MongoDB replica set used by local unit tests.
+
+## Start
+
+From the repository root:
+
+```bash
+cd mongo
+docker-compose up -d
+```
+
+The setup starts:
+- `mongo-replica` on `localhost:27017`
+- `mongo-init-replica` to initialize replica set `rs0`
+
+## Verify
+
+```bash
+docker-compose ps
+docker logs mongo-init-replica
+```
+
+When initialization succeeds, logs include `Replica set initialized.`
+
+## Local unit test
+
+Then you can run the follow cmd or use an IDE to run unit tests.
+
+```bash
+mvn -Dtest='io.github.thunderz99.cosmos.impl.mongo.**.*Test' test
+```
+
+## Stop
+
+```bash
+docker-compose down
+```

mongo/docker-compose.yml

@@ -1,4 +1,3 @@
-version: '3.8'
 services:
   mongo-replica:
     image: mongo:5.0

pom.xml

@@ -4,7 +4,7 @@
     <groupId>com.github.thunderz99</groupId>
     <artifactId>java-cosmos</artifactId>
     <packaging>jar</packaging>
-    <version>0.8.22</version>
+    <version>0.8.23</version>
     <name>${project.groupId}:${project.artifactId}$</name>
     <description>A lightweight Azure CosmosDB client for Java</description>
     <url>https://github.com/thunderz99/java-cosmos</url>

postgres/Dockerfile

@@ -0,0 +1,15 @@
+FROM postgres:16
+
+# Install dependencies and add the PostgreSQL APT repository
+RUN set -eux; \
+    apt-get update; \
+    apt-get install -y --no-install-recommends ca-certificates gnupg lsb-release wget; \
+    mkdir -p /etc/apt/keyrings; \
+    wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor -o /etc/apt/keyrings/pgdg.gpg; \
+    echo "deb [signed-by=/etc/apt/keyrings/pgdg.gpg] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list; \
+    apt-get update; \
+    apt-get install -y --no-install-recommends postgresql-16-cron; \
+    rm -rf /var/lib/apt/lists/*
+
+# Copy an initialization script to enable the extension
+COPY init-pgcron.sql /docker-entrypoint-initdb.d/

postgres/README.md

@@ -0,0 +1,42 @@
+# PostgreSQL local dev
+
+This folder contains a Docker Compose setup for local PostgreSQL used by unit tests.
+
+The image is built from `postgres/Dockerfile`, which installs `postgresql-16-cron` and runs `init-pgcron.sql` to enable `pg_cron`.
+
+## Start
+
+From the repository root:
+
+```bash
+cd postgres
+docker-compose up -d --build
+```
+
+Default connection details:
+- Host: `localhost`
+- Port: `5432`
+- Database: `postgres`
+- User: `postgres`
+- Password: `postgres`
+
+## Verify
+
+```bash
+docker-compose ps
+docker exec -it postgres16 psql -U postgres -d postgres -c "SELECT extname FROM pg_extension WHERE extname='pg_cron';"
+```
+
+## Local unit test
+
+Then you can run the follow cmd or use an IDE to run unit tests.
+
+```bash
+mvn -Dtest='io.github.thunderz99.cosmos.impl.postgres.**.*Test' test
+```
+
+## Stop
+
+```bash
+docker-compose down
+```

postgres/docker-compose.yml

@@ -0,0 +1,13 @@
+services:
+  postgres:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: postgres16
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: postgres
+    ports:
+      - "5432:5432"
+    command: postgres -c shared_preload_libraries=pg_cron

postgres/init-pgcron.sql

@@ -0,0 +1 @@
+CREATE EXTENSION IF NOT EXISTS pg_cron;

src/test/java/io/github/thunderz99/cosmos/impl/postgres/PostgresImplTest.java

@@ -13,7 +13,7 @@ public class PostgresImplTest {
     /**
      * local postgres connection string if test against a local setup.
      */
-    public static final String LOCAL_CONNECTION_STRING = "jdbc:postgresql://localhost:5432/postgres?user=postgres&password=mysecretpassword&sslmode=disable";
+    public static final String LOCAL_CONNECTION_STRING = "jdbc:postgresql://localhost:5432/postgres?user=postgres&password=postgres&sslmode=disable";
 
     String db = "unit_test_db_" + RandomStringUtils.randomAlphanumeric(6);