Create docker environment

Author: kkesslerabilex

.gitattributes

@@ -0,0 +1,3 @@
+*.sql text eol=lf
+*.csv text eol=lf
+*.sh  text eol=lf

.github/workflows/sql-bootstrap-expected.yml

@@ -0,0 +1,65 @@
+name: SQL Bootstrap Expected
+
+on:
+  workflow_dispatch:
+
+jobs:
+  record-expected:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    services:
+      mysql:
+        image: mysql:8
+        env:
+          MYSQL_ROOT_PASSWORD: rootpw
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 -prootpw || exit 1"
+          --health-interval=5s
+          --health-timeout=3s
+          --health-retries=60
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install MySQL client
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y mysql-client
+          chmod +x tests/run_tests.sh
+
+      - name: Record expected CSVs
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: 3306
+          DB_USER: root
+          DB_PASS: rootpw
+          DB_NAME: testdb
+          RECORD: "1"
+        run: ./tests/run_tests.sh
+
+      - name: Commit changes
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git checkout -b bootstrap-expected
+          git add tests/expected/*.csv || true
+          if git diff --cached --quiet; then
+            echo "No expected files to commit."
+          else
+            git commit -m "Bootstrap expected CSVs"
+            git push -u origin bootstrap-expected
+          fi
+
+      - name: Create pull request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: bootstrap-expected
+          title: "Bootstrap expected CSVs"
+          body: "Erzeugt Expected-Dateien aus aktuellen SQL-Ausgaben."
+          delete-branch: true

.github/workflows/sql-ci.yml

@@ -0,0 +1,47 @@
+name: SQL CI (MySQL)
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test-sql:
+    runs-on: ubuntu-latest
+
+    services:
+      mysql:
+        image: mysql:8
+        env:
+          MYSQL_ROOT_PASSWORD: rootpw
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 -prootpw || exit 1"
+          --health-interval=5s
+          --health-timeout=3s
+          --health-retries=60
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install MySQL client
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y mysql-client
+          chmod +x tests/run_tests.sh
+
+      - name: Run SQL snapshot tests
+        env:
+          DB_HOST: 127.0.0.1
+          DB_PORT: 3306
+          DB_USER: root
+          DB_PASS: rootpw
+          DB_NAME: testdb
+        run: ./tests/run_tests.sh
+
+      - name: Upload outputs on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: sql-test-outputs
+          path: tests/out/*.csv

src/sql/foo.sql

@@ -0,0 +1,4 @@
+SELECT id, name, price
+FROM products
+WHERE category = 'tools'
+ORDER BY price, id;

tests/fixtures/seed.sql

@@ -0,0 +1,14 @@
+DROP TABLE IF EXISTS products;
+CREATE TABLE products (
+  id INT PRIMARY KEY,
+  name VARCHAR(100) NOT NULL,
+  price DECIMAL(10,2) NOT NULL,
+  category VARCHAR(50) NOT NULL
+);
+
+INSERT INTO products (id, name, price, category) VALUES
+  (1, 'Widget A', 10.00, 'tools'),
+  (2, 'Widget B', 12.50, 'tools'),
+  (3, 'Cable X',  5.90,  'cables'),
+  (4, 'Cable Y',  8.10,  'cables'),
+  (5, 'Adapter',  7.00,  'accessories');

tests/run_tests.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+DB_HOST="${DB_HOST:-127.0.0.1}"
+DB_PORT="${DB_PORT:-3306}"
+DB_USER="${DB_USER:-root}"
+DB_PASS="${DB_PASS:-rootpw}"
+DB_NAME="${DB_NAME:-testdb}"
+RECORD="${RECORD:-0}"   # 1 = Expected-Dateien neu schreiben
+
+CLI="mysql -h ${DB_HOST} -P ${DB_PORT} -u ${DB_USER} -p${DB_PASS} --batch --skip-column-names"
+
+# Nur SELECTs zulassen (Heuristik)
+for sql in src/sql/*.sql; do
+  if grep -Eiq '(^|[^a-z])(insert|update|delete|merge|replace|create|alter|drop)\b' "$sql"; then
+    echo "❌ $sql enthält schreibende/DDL-Statements. Erwartet werden reine SELECTs."
+    exit 3
+  fi
+done
+
+# DB vorbereiten
+$CLI -e "CREATE DATABASE IF NOT EXISTS \`${DB_NAME}\` /*\!40100 DEFAULT CHARACTER SET utf8mb4 */;"
+$CLI -e "SET GLOBAL sql_mode='STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION';"
+$CLI -e "SET GLOBAL time_zone='+00:00';"
+$CLI "${DB_NAME}" < tests/fixtures/seed.sql
+
+mkdir -p tests/out tests/expected
+fail=0
+
+for sql in src/sql/*.sql; do
+  name="$(basename "$sql" .sql)"
+  out="tests/out/${name}.csv"
+  exp="tests/expected/${name}.csv"
+
+  $CLI "${DB_NAME}" < "$sql" > "$out"
+
+  sed -i 's/\r$//' "$out"
+  sed -i 's/[[:space:]]\+$//' "$out"
+
+  if [ "$RECORD" = "1" ]; then
+    cp -f "$out" "$exp"
+    echo "📝 Recorded: $exp"
+  else
+    if ! diff -u "$exp" "$out"; then
+      echo "❌ Test failed: ${name}"
+      fail=1
+    else
+      echo "✅ Test passed: ${name}"
+    fi
+  fi
+done
+
+exit $fail