feat: add driver abstraction to generate.sh

Replaces hardcoded docker exec/cp calls with pluggable driver functions,
making fixture generation usable without Docker.

Driver API (exec_sysdba, exec_user, oracle_spool_path, fetch_spool,
fetch_archive, olr_path, run_olr) selected via ORACLE_DRIVER env var.

Included drivers:
- docker (default): docker exec + compose exec, existing behaviour
- local: local sqlplus + OLR binary, no Docker needed

Usage:
  ORACLE_DRIVER=local OLR_BINARY=/path/to/OpenLogReplicator ./generate.sh basic-crud

Author: rophy

tests/scripts/drivers/docker.sh

@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Driver: docker
+# Oracle via docker exec, OLR via docker compose exec.
+# This is the default driver. Used when ORACLE_DRIVER=docker (or unset).
+#
+# Additional env vars (optional):
+#   ORACLE_CONTAINER — Docker container running Oracle (default: oracle)
+#   DOCKER_EXEC_USER — User for docker exec (set to "oracle" for official images)
+
+: "${ORACLE_CONTAINER:=oracle}"
+
+_DEXEC="docker exec"
+if [[ -n "${DOCKER_EXEC_USER:-}" ]]; then
+    _DEXEC="docker exec -u $DOCKER_EXEC_USER"
+fi
+
+_CONTAINER_TESTS="/opt/OpenLogReplicator-local/tests"
+_OLR_BINARY="/opt/OpenLogReplicator/OpenLogReplicator"
+
+# Validate environment directory and set COMPOSE
+[[ -d "$ENV_DIR" ]] || { echo "ERROR: Environment directory not found: $ENV_DIR" >&2; exit 1; }
+COMPOSE="docker compose -f $ENV_DIR/docker-compose.yaml"
+
+# Run SQL as sysdba; returns stdout
+exec_sysdba() {
+    local sql_file="$1"
+    local remote="/tmp/$(basename "$sql_file")"
+    docker cp "$sql_file" "${ORACLE_CONTAINER}:${remote}"
+    $_DEXEC "$ORACLE_CONTAINER" sqlplus -S / as sysdba @"$remote"
+}
+
+# Run SQL as test user; returns stdout
+exec_user() {
+    local sql_file="$1"
+    local remote="/tmp/$(basename "$sql_file")"
+    docker cp "$sql_file" "${ORACLE_CONTAINER}:${remote}"
+    $_DEXEC "$ORACLE_CONTAINER" sqlplus -S "$DB_CONN" @"$remote"
+}
+
+# Path for SPOOL directive (inside Oracle container filesystem)
+oracle_spool_path() {
+    echo "/tmp/olr_spool.lst"
+}
+
+# Copy spool output back to a local file
+fetch_spool() {
+    docker cp "${ORACLE_CONTAINER}:/tmp/olr_spool.lst" "$1"
+}
+
+# Copy an archive log from Oracle container to a local path
+fetch_archive() {
+    docker cp "${ORACLE_CONTAINER}:$1" "$2"
+}
+
+# Convert a host-side absolute path to the OLR-visible path inside its container
+# (tests/ is bind-mounted at _CONTAINER_TESTS in the olr compose service)
+olr_path() {
+    echo "${_CONTAINER_TESTS}/${1#$TESTS_DIR/}"
+}
+
+# Run OLR with the given config file (host path); caller redirects stdout/stderr
+run_olr() {
+    local host_config="$1"
+    $COMPOSE exec -T olr \
+        "$_OLR_BINARY" -r -f "$(olr_path "$host_config")"
+}

tests/scripts/drivers/local.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# Driver: local
+# Oracle via local sqlplus, OLR binary on local filesystem.
+# Use this when Oracle and OLR are installed locally (no Docker needed).
+#
+# Required env vars:
+#   OLR_BINARY — path to OpenLogReplicator binary
+#
+# Optional env vars:
+#   ORACLE_SID — set if needed for OS authentication (/ as sysdba)
+#   DB_CONN    — sqlplus connect string for test user (set in generate.sh)
+
+OLR_BINARY="${OLR_BINARY:?OLR_BINARY must be set for the local driver (path to OpenLogReplicator binary)}"
+
+# No environment directory needed for local Oracle
+# No COMPOSE setup needed
+
+# Run SQL as sysdba; returns stdout
+exec_sysdba() {
+    sqlplus -S / as sysdba @"$1"
+}
+
+# Run SQL as test user; returns stdout
+exec_user() {
+    sqlplus -S "$DB_CONN" @"$1"
+}
+
+# Path for SPOOL directive (local filesystem, directly in work dir)
+oracle_spool_path() {
+    echo "$WORK_DIR/olr_spool.lst"
+}
+
+# Fetch spool output — already local, no-op if dest matches spool path
+fetch_spool() {
+    local dest="$1"
+    [[ "$dest" != "$(oracle_spool_path)" ]] && cp "$(oracle_spool_path)" "$dest"
+}
+
+# Copy an archive log from Oracle filesystem to a local path
+# (for local Oracle, archive path is already on local filesystem)
+fetch_archive() {
+    cp "$1" "$2"
+}
+
+# No path mapping needed — OLR runs on the same filesystem
+olr_path() {
+    echo "$1"
+}
+
+# Run OLR with the given config file; caller redirects stdout/stderr
+run_olr() {
+    "$OLR_BINARY" -r -f "$1"
+}