feat: Implement composite action for Python environment setup and refactor test workflow to utilize it

.gitea/actions/setup-python-env/action.yml

@@ -0,0 +1,111 @@
+name: Setup Python Environment
+description: Configure Python, proxies, dependencies, and optional database setup for CI jobs.
+author: CalMiner Team
+inputs:
+  python-version:
+    description: Python version to install.
+    required: false
+    default: "3.10"
+  install-playwright:
+    description: Install Playwright browsers when true.
+    required: false
+    default: "false"
+  install-requirements:
+    description: Space-delimited list of requirement files to install.
+    required: false
+    default: "requirements.txt requirements-test.txt"
+  run-db-setup:
+    description: Run database wait and setup scripts when true.
+    required: false
+    default: "true"
+  db-dry-run:
+    description: Execute setup script dry run before live run when true.
+    required: false
+    default: "true"
+runs:
+  using: composite
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+    - name: Configure apt proxy
+      shell: bash
+      run: |
+        set -euo pipefail
+        PROXY_HOST="http://apt-cacher:3142"
+        if ! curl -fsS --connect-timeout 3 "${PROXY_HOST}" >/dev/null; then
+          PROXY_HOST="http://192.168.88.14:3142"
+        fi
+        echo "Using APT proxy ${PROXY_HOST}"
+        {
+          echo "http_proxy=${PROXY_HOST}"
+          echo "https_proxy=${PROXY_HOST}"
+          echo "HTTP_PROXY=${PROXY_HOST}"
+          echo "HTTPS_PROXY=${PROXY_HOST}"
+        } >> "$GITHUB_ENV"
+        sudo tee /etc/apt/apt.conf.d/01proxy >/dev/null <<EOF
+        Acquire::http::Proxy "${PROXY_HOST}";
+        Acquire::https::Proxy "${PROXY_HOST}";
+        EOF
+    - name: Install dependencies
+      shell: bash
+      run: |
+        set -euo pipefail
+        requirements="${{ inputs.install-requirements }}"
+        if [ -n "${requirements}" ]; then
+          for requirement in ${requirements}; do
+            if [ -f "${requirement}" ]; then
+              pip install -r "${requirement}"
+            else
+              echo "Requirement file ${requirement} not found" >&2
+              exit 1
+            fi
+          done
+        fi
+    - name: Install Playwright browsers
+      if: ${{ inputs.install-playwright == 'true' }}
+      shell: bash
+      run: |
+        set -euo pipefail
+        python -m playwright install --with-deps
+    - name: Wait for database service
+      if: ${{ inputs.run-db-setup == 'true' }}
+      shell: bash
+      run: |
+        set -euo pipefail
+        python - <<'PY'
+        import os
+        import time
+
+        import psycopg2
+
+        dsn = (
+            f"dbname={os.environ['DATABASE_SUPERUSER_DB']} "
+            f"user={os.environ['DATABASE_SUPERUSER']} "
+            f"password={os.environ['DATABASE_SUPERUSER_PASSWORD']} "
+            f"host={os.environ['DATABASE_HOST']} "
+            f"port={os.environ['DATABASE_PORT']}"
+        )
+
+        for attempt in range(30):
+            try:
+                with psycopg2.connect(dsn):
+                    break
+            except psycopg2.OperationalError:
+                time.sleep(2)
+        else:
+            raise SystemExit("Postgres service did not become available")
+        PY
+    - name: Run database setup (dry run)
+      if: ${{ inputs.run-db-setup == 'true' && inputs.db-dry-run == 'true' }}
+      shell: bash
+      run: |
+        set -euo pipefail
+        python scripts/setup_database.py --ensure-database --ensure-role --ensure-schema --initialize-schema --run-migrations --seed-data --dry-run -v
+    - name: Run database setup
+      if: ${{ inputs.run-db-setup == 'true' }}
+      shell: bash
+      run: |
+        set -euo pipefail
+        python scripts/setup_database.py --ensure-database --ensure-role --ensure-schema --initialize-schema --run-migrations --seed-data -v

.gitea/workflows/test.yml

@@ -5,6 +5,18 @@ jobs:
   tests:
     name: ${{ matrix.target }} tests
     runs-on: ubuntu-latest
+    env:
+      DATABASE_DRIVER: postgresql
+      DATABASE_HOST: postgres
+      DATABASE_PORT: "5432"
+      DATABASE_NAME: calminer_ci
+      DATABASE_USER: calminer
+      DATABASE_PASSWORD: secret
+      DATABASE_SCHEMA: public
+      DATABASE_SUPERUSER: calminer
+      DATABASE_SUPERUSER_PASSWORD: secret
+      DATABASE_SUPERUSER_DB: calminer_ci
+      DATABASE_URL: postgresql+psycopg2://calminer:secret@postgres:5432/calminer_ci
     strategy:
       fail-fast: false
       matrix:
@@ -24,108 +36,11 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Prepare Python environment
+        uses: ./.gitea/actions/setup-python-env
         with:
-          python-version: "3.10"
-      - name: Configure apt proxy
-        run: |
-          set -euo pipefail
-          PROXY_HOST="http://apt-cacher:3142"
-          if ! curl -fsS --connect-timeout 3 "${PROXY_HOST}" >/dev/null; then
-            PROXY_HOST="http://192.168.88.14:3142"
-          fi
-          echo "Using APT proxy ${PROXY_HOST}"
-          echo "http_proxy=${PROXY_HOST}" >> "$GITHUB_ENV"
-          echo "https_proxy=${PROXY_HOST}" >> "$GITHUB_ENV"
-          echo "HTTP_PROXY=${PROXY_HOST}" >> "$GITHUB_ENV"
-          echo "HTTPS_PROXY=${PROXY_HOST}" >> "$GITHUB_ENV"
-          sudo tee /etc/apt/apt.conf.d/01proxy >/dev/null <<EOF
-          Acquire::http::Proxy "${PROXY_HOST}";
-          Acquire::https::Proxy "${PROXY_HOST}";
-          EOF
-      # - name: Cache pip
-      #   uses: actions/cache@v4
-      #   with:
-      #     path: ~/.cache/pip
-      #     key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt', 'requirements-test.txt') }}
-      #     restore-keys: |
-      #       ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
-      #       ${{ runner.os }}-pip-
-      - name: Install dependencies
-        run: |
-          pip install -r requirements.txt
-          pip install -r requirements-test.txt
-      - name: Install Playwright browsers
-        if: ${{ matrix.target == 'e2e' }}
-        run: |
-          python -m playwright install --with-deps
-      - name: Wait for database service
-        env:
-          DATABASE_DRIVER: postgresql
-          DATABASE_HOST: postgres
-          DATABASE_PORT: "5432"
-          DATABASE_NAME: calminer_ci
-          DATABASE_USER: calminer
-          DATABASE_PASSWORD: secret
-          DATABASE_SCHEMA: public
-          DATABASE_SUPERUSER: calminer
-          DATABASE_SUPERUSER_PASSWORD: secret
-          DATABASE_SUPERUSER_DB: calminer_ci
-        run: |
-          python - <<'PY'
-          import os
-          import time
-
-          import psycopg2
-
-          dsn = (
-              f"dbname={os.environ['DATABASE_SUPERUSER_DB']} "
-              f"user={os.environ['DATABASE_SUPERUSER']} "
-              f"password={os.environ['DATABASE_SUPERUSER_PASSWORD']} "
-              f"host={os.environ['DATABASE_HOST']} "
-              f"port={os.environ['DATABASE_PORT']}"
-          )
-
-          for attempt in range(30):
-              try:
-                  with psycopg2.connect(dsn):
-                      break
-              except psycopg2.OperationalError:
-                  time.sleep(2)
-          else:
-              raise SystemExit("Postgres service did not become available")
-          PY
-      - name: Run database setup (dry run)
-        env:
-          DATABASE_DRIVER: postgresql
-          DATABASE_HOST: postgres
-          DATABASE_PORT: "5432"
-          DATABASE_NAME: calminer_ci
-          DATABASE_USER: calminer
-          DATABASE_PASSWORD: secret
-          DATABASE_SCHEMA: public
-          DATABASE_SUPERUSER: calminer
-          DATABASE_SUPERUSER_PASSWORD: secret
-          DATABASE_SUPERUSER_DB: calminer_ci
-        run: python scripts/setup_database.py --ensure-database --ensure-role --ensure-schema --initialize-schema --run-migrations --seed-data --dry-run -v
-      - name: Run database setup
-        env:
-          DATABASE_DRIVER: postgresql
-          DATABASE_HOST: postgres
-          DATABASE_PORT: "5432"
-          DATABASE_NAME: calminer_ci
-          DATABASE_USER: calminer
-          DATABASE_PASSWORD: secret
-          DATABASE_SCHEMA: public
-          DATABASE_SUPERUSER: calminer
-          DATABASE_SUPERUSER_PASSWORD: secret
-          DATABASE_SUPERUSER_DB: calminer_ci
-        run: python scripts/setup_database.py --ensure-database --ensure-role --ensure-schema --initialize-schema --run-migrations --seed-data -v
+          install-playwright: ${{ matrix.target == 'e2e' }}
       - name: Run tests
-        env:
-          DATABASE_URL: postgresql+psycopg2://calminer:secret@postgres:5432/calminer_ci
-          DATABASE_SCHEMA: public
         run: |
           if [ "${{ matrix.target }}" = "unit" ]; then
             pytest tests/unit