feat: process-compose

Author: pythoninthegrass

.pc_env

@@ -0,0 +1,10 @@
+# https://f1bonacc1.github.io/process-compose/configuration/
+
+# disable tui (default: 1)
+PC_DISABLE_TUI=1
+
+# set port (default: 8080)
+PC_PORT_NUM=10000
+
+# disable server (default: 1)
+# PC_NO_SERVER=1

.tool-versions

@@ -1,3 +1,4 @@
-python 3.11.9
 poetry 1.8.3
+process-compose 1.24.2
+python 3.11.9
 uv 0.2.5

process-compose.yml

@@ -0,0 +1,39 @@
+version: "0.5"
+
+log_location: /tmp/process-compose.log
+log_level: info     # trace / debug / info / warn / error / fatal / panic
+log_configuration:
+  rotation:
+    max_size_mb: 1  # size in MB of the logfile before it's rolled
+    max_age_days: 5 # age in days to keep a logfile
+    max_backups: 3  # number of rolled files to keep
+    compress: true
+
+is_strict: true
+
+disable_env_expansion: true
+
+processes:
+  redis:
+    command: >
+      docker run --rm -d \
+        --name "${NAME:-devbox-redis}" \
+        -p "${PORT:-6379}:6379" \
+        "redis:${VERSION:-6.2}-alpine"
+    is_daemon: true
+    environment: null
+    readiness_probe:
+      exec:
+        command: >
+          timeout 12s bash -c \
+          "until echo PING \
+          | nc -z localhost ${PORT:-6379} \
+          ; do sleep 1 \
+          ; done"
+    availability:
+      exit_on_end: true
+    is_tty: false
+    shutdown:
+      command: "docker stop $NAME"
+      timeout_seconds: 10           # default: 10
+      signal: 15                    # default: 15

taskfile.yml

@@ -16,6 +16,8 @@ includes:
     taskfile: ./taskfiles/docker.yml
   poetry:
     taskfile: ./taskfiles/poetry.yml
+  redis:
+    taskfile: ./taskfiles/redis.yml
 
 tasks:
   default:

taskfiles/redis.yml

@@ -0,0 +1,22 @@
+version: "3.0"
+
+set: ['e', 'u', 'pipefail']
+shopt: ['globstar']
+
+env:
+  NAME: dev-redis
+  PORT: 6379
+  VERSION: 6.2
+
+tasks:
+  start:
+    desc: "Start Redis server"
+    cmds:
+      - process-compose up -D redis 2>&1 > /dev/null
+    silent: true
+
+  stop:
+    desc: "Stop Redis server"
+    cmds:
+      - process-compose down
+    silent: true