add the config and compose modules

config: dotenv files are parsed, never sourced, so a value can hold a # or a $(...) without breaking or executing. The make engine included .env with make syntax, which neither allowed. compose: one call per project instead of one per sub-stack.
2026-09-03 18:29:36 +02:00
parent e7eab505e9
commit 990b99f0c0
4 changed files with 226 additions and 0 deletions
@@ -0,0 +1,60 @@
+#shellcheck shell=sh
+# compose: find a usable docker compose, and call it once per project.
+#
+# The legacy engine ran one `docker compose up` per sub-stack, each time with
+# the full file list, so N sub-stacks meant N identical calls. The CLI calls
+# compose once per project (documented in spec/golden/DELTAS.md).
+
+MYOS_COMPOSE_MIN_VERSION=${COMPOSE_VERSION:-2.24.4}
+
+# myos_compose_bin  print the compose command to use, fail with MYOS_E_NOREQ
+myos_compose_bin() {
+  [ -n "${MYOS_COMPOSE_BIN:-}" ] && { printf '%s' "$MYOS_COMPOSE_BIN"; return 0; }
+  if myos_have docker; then
+    _v=$(docker compose version --short 2>/dev/null)
+    if myos_verle "$MYOS_COMPOSE_MIN_VERSION" "$_v"; then printf 'docker compose'; return 0; fi
+  fi
+  if myos_have docker-compose; then
+    _v=$(docker-compose version --short 2>/dev/null)
+    if myos_verle "$MYOS_COMPOSE_MIN_VERSION" "$_v"; then printf 'docker-compose'; return 0; fi
+  fi
+  myos_error "docker compose >= $MYOS_COMPOSE_MIN_VERSION not found (install the docker compose plugin or docker-compose)"
+  return "$MYOS_E_NOREQ"
+}
+
+# myos_compose PROJECT FILES -- ARGS...
+# FILES is a newline separated list; the project directory is that of the first
+# file, so relative build contexts and env_file entries keep working.
+myos_compose() {
+  _project=$1; _files=$2; shift 2
+  [ "${1:-}" = "--" ] && shift
+  [ -n "$_files" ] || { myos_error "no compose file for project $_project"; return "$MYOS_E_NOSTACK"; }
+  _bin=$(myos_compose_bin) || return $?
+
+  _fargs=""
+  _first=""
+  for _f in $_files; do
+    [ -n "$_first" ] || _first=$_f
+    _fargs="$_fargs -f $_f"
+  done
+  _dir=$(dirname "$_first")
+
+  # variables the compose files reference, plus the network names they default
+  # on (networks.yml is appended after the scan, so its variables are added here)
+  # shellcheck disable=SC2086  # both are deliberate word lists
+  _vars=$(myos_env_vars $_files)
+  # shellcheck disable=SC2086
+  _envargs=$(myos_env_export $_vars DOCKER_NETWORK_DEFAULT DOCKER_NETWORK_PRIVATE DOCKER_NETWORK_PUBLIC COMPOSE_SERVICE_NAME)
+
+  if [ "${DRYRUN:-false}" = true ]; then
+    printf '%s%s -p %s --project-directory %s %s\n' "$_bin" "$_fargs" "$_project" "$_dir" "$*"
+  else
+    _IFS=$IFS; IFS='
+'
+    # shellcheck disable=SC2046,SC2086  # deliberate word splitting on IFS=newline
+    env $_envargs $_bin --ansi=auto $_fargs -p "$_project" --project-directory "$_dir" "$@"
+    _rc=$?
+    IFS=$_IFS
+    return $_rc
+  fi
+}