Subversion Repositories ESP8266_P1_Meter

# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json

name: (ESP8266) Build with PlatformIO

on:
  workflow_dispatch:
  push:
    branches:
      - dev
  pull_request:

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  platformio-esp8266:
    name: ESP8266 (pio) (board=${{ matrix.board }}, shard=${{ matrix.shard }})
    if: github.event_name == 'workflow_dispatch' || vars.ENABLE_BUILDS == 'true'
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      matrix:
        board:
          - d1_mini
        shard: [1, 2, 3, 4]

    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Cache PlatformIO
        uses: actions/cache@v4
        with:
          key: ${{ runner.os }}-pio
          path: |
            ~/.cache/pip
            ~/.platformio

      - name: Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.x"

      - name: Install PIO
        run: |
          python -m pip install --upgrade pip
          pip install --upgrade platformio

      - name: Build Examples
        run: |
          set -uo pipefail

          total_shards=4
          shard="${{ matrix.shard }}"

          # Examples not intended for ESP8266 / this job
          EXCLUDE_EXAMPLES=(
            esp32-cam
            binaryWebSocket
            csvLoggerSD
            localRFID
            mysqlRFID
            mqtt_webserver
          )

          report_file="build-report-esp8266-pio-${{ matrix.board }}-shard${{ matrix.shard }}.txt"
          : > "$report_file"

          failures=0
          total=0
          index=0

          for dir in examples/*; do
            if [[ ! -d "$dir" ]]; then
              continue
            fi

            example="$(basename "$dir")"

            if [[ " ${EXCLUDE_EXAMPLES[*]} " == *" ${example} "* ]]; then
              echo "Skipping: ${example}"
              printf '%-25s : SKIP\n' "${example}" >> "$report_file"
              continue
            fi

            # Split examples across shards for faster CI.
            index=$((index + 1))
            example_shard=$(( (index - 1) % total_shards + 1 ))
            if [[ "$example_shard" != "$shard" ]]; then
              continue
            fi

            total=$((total + 1))

            echo "============================================================="
            echo "Building examples/${example} (board=${{ matrix.board }}, shard=${shard})..."
            echo "============================================================="

            echo "::group::pio run - examples/${example}"
            set +e
            # Use a per-example build directory to avoid cross-example artefacts.
            PLATFORMIO_BUILD_DIR=".pio/build-${{ matrix.board }}-${example}" \
            PLATFORMIO_SRC_DIR="examples/${example}" PIO_BOARD="${{ matrix.board }}" \
              pio run -e ci-esp8266
            rc=$?
            set -e
            echo "::endgroup::"

            if [[ $rc -eq 0 ]]; then
              printf '%-25s : OK\n' "${example}" >> "$report_file"
            else
              failures=$((failures + 1))
              printf '%-25s : FAIL (exit=%s)\n' "${example}" "$rc" >> "$report_file"
            fi
          done

          echo ""
          echo "==================== Build report (esp8266/pio, board=${{ matrix.board }}, shard=${{ matrix.shard }}) ===================="
          cat "$report_file"
          echo "==============================================================================================="
          echo "Total attempted: ${total} | Failures: ${failures}"

          # Do not fail the job here: the final report job will decide.

      - name: Upload build report
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: pio-esp8266-report-${{ matrix.board }}-shard${{ matrix.shard }}
          path: build-report-esp8266-pio-${{ matrix.board }}-shard${{ matrix.shard }}.txt

  report:
    name: ESP8266 (pio) - Final report
    runs-on: ubuntu-latest
    needs: platformio-esp8266
    if: always() && needs.platformio-esp8266.result != 'skipped'
    steps:
      - name: Download all reports
        uses: actions/download-artifact@v4
        with:
          pattern: pio-esp8266-report-*
          merge-multiple: true
          path: reports

      - name: Print final report and set status
        run: |
          set -uo pipefail
          echo "==================== Final build report (ESP8266/pio) ===================="
          failures=0
          files=0
          shopt -s nullglob
          for f in reports/*.txt; do
            files=$((files + 1))
            echo "--- ${f} ---"
            cat "$f"
            if grep -q " : FAIL" "$f"; then
              failures=$((failures + 1))
            fi
          done
          if [[ $files -eq 0 ]]; then
            echo "No report files found (artifact download failed?)"
            exit 1
          fi
          echo "==========================================================================="
          if [[ $failures -gt 0 ]]; then
            echo "One or more shards reported FAIL."
            exit 1
          fi