user_config_build.yaml

name: Reusable user config build

on:
  workflow_call:
    inputs:
      build_matrix_path:
        description: "Path to the build matrix file"
        default: "build.yaml"
        required: false
        type: string
      config_path:
        description: "Path to the config directory"
        default: "config"
        required: false
        type: string
      shield_path:
        description: "Path to the shields directory"
        default: "boards/shields/charybdis"
        required: false
        type: string
      keymap_path:
        description: "Path to the keymap directory"
        default: "boards/shields/charybdis/keymaps"
        required: false
        type: string
      fallback_binary:
        description: "Fallback binary format, if no *.uf2 file was built"
        default: "bin"
        required: false
        type: string

jobs:
  matrix:
    runs-on: ubuntu-latest
    name: Fetch Build Keyboards
    outputs:
      build_matrix: ${{ env.build_matrix }}
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Install yaml2json
        run: python3 -m pip install remarshal

      - name: Fetch Build Matrix
        run: |
          echo "build_matrix=$(yaml2json '${{ inputs.build_matrix_path }}' | jq -c .)" >> $GITHUB_ENV
          yaml2json "${{ inputs.build_matrix_path }}" | jq

  build:
    runs-on: ubuntu-latest
    container:
      image: zmkfirmware/zmk-build-arm:stable
    needs: matrix
    name: Build
    strategy:
      fail-fast: false
      matrix: ${{ fromJson(needs.matrix.outputs.build_matrix) }}
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Create build directory
        run: |
          echo "build_dir=$(mktemp -d)" >> $GITHUB_ENV

      - name: Prepare variables
        shell: sh -x {0}
        env:
          board: ${{ matrix.board }}
          shield: ${{ matrix.shield }}
          keymap: ${{ matrix.keymap }}
          format: ${{ matrix.format }}
          artifact_name: ${{ matrix.artifact-name }}
          snippet: ${{ matrix.snippet }}
        run: |
          if [ -e zephyr/module.yml ]; then
            export zmk_load_arg=" -DZMK_EXTRA_MODULES='${GITHUB_WORKSPACE}'"
            new_tmp_dir="${TMPDIR:-/tmp}/zmk-config"
            mkdir -p "${new_tmp_dir}"
            echo "base_dir=${new_tmp_dir}" >> $GITHUB_ENV
          else
            echo "base_dir=${GITHUB_WORKSPACE}" >> $GITHUB_ENV
          fi

          if [ -n "${snippet}" ]; then
            extra_west_args="-S \"${snippet}\""
          fi

          echo "zephyr_version=${ZEPHYR_VERSION}" >> $GITHUB_ENV
          echo "extra_west_args=${extra_west_args}" >> $GITHUB_ENV
          echo "extra_cmake_args=${shield:+-DSHIELD=\"$shield\"}${zmk_load_arg}" >> $GITHUB_ENV
          echo "display_name=${shield:+$shield - }${board}" >> $GITHUB_ENV
          echo "format=${format}" >> $GITHUB_ENV
          echo "keymap=${keymap}" >> $GITHUB_ENV
          echo "shield=${shield}" >> $GITHUB_ENV
          echo "artifact_name=${artifact_name:-${shield:+$shield-}${board}-zmk}" >> $GITHUB_ENV

      - name: Download keymaps
        uses: actions/download-artifact@v4
        with:
          name: keymap_files
          path: "${{ github.workspace }}/"

      - name: Copy keymaps to keymap directory
        run: |
          rm -f $GITHUB_WORKSPACE/config/*.keymap
          mkdir -p "$GITHUB_WORKSPACE/${{ inputs.keymap_path }}/"
          cd "$GITHUB_WORKSPACE"
          mv charybdis.keymap qwerty.keymap
          mv *.keymap "$GITHUB_WORKSPACE/${{ inputs.keymap_path }}/"
          ls -lR "$GITHUB_WORKSPACE/${{ inputs.keymap_path }}/"

      - name: Copy config files to isolated temporary directory
        run: |
          if [ "${{ env.base_dir }}" != "${GITHUB_WORKSPACE}" ]; then
            apt-get -qq update && apt-get -q install -o Dpkg::Progress-Fancy="0" -o APT::Color="0" -o Dpkg::Use-Pty="0" tree
            
            # Define base directory for config
            base_config_path="${{ env.base_dir }}/${{ inputs.config_path }}"

            # Create config directory
            mkdir -p "$base_config_path"
            
            # Copy config files
            cp -R "${{ inputs.config_path }}"/* "$base_config_path/"
            echo "config files ready"
            
            # Copy keymap & physical layouts
            if [ "${{ env.shield }}" != "settings_reset" ]; then
              # Copy physical layout file to shield directory
              mv -v "$base_config_path/charybdis-layouts.dtsi" \
              "${GITHUB_WORKSPACE}/boards/shields/charybdis-${{ env.format }}/"

              # Copy active keymap to the board directory & adjust for bt/dongle format
              cp -Rv "$GITHUB_WORKSPACE/${{ inputs.keymap_path }}/${{ env.keymap }}.keymap" \
                "$base_config_path/charybdis.keymap"
              echo "format: ${{ env.format }}"
              case "${{ env.format }}" in
                *bt*)
                  echo "converting trackball device to bt/usb format"
                  sed -i 's/device = <&vtrackball>;/device = <\&trackball>;/g' "$base_config_path/charybdis.keymap"
                  grep "device = <" "$base_config_path/charybdis.keymap"
                  ;;
              esac
            fi
          fi

          # Remove untargeted shields so they don't get auto picked up by the west build command
          find "${GITHUB_WORKSPACE}/boards/shields" \
            -mindepth 1 \
            -maxdepth 1 \
            ! -name "charybdis-${{ env.format }}" \
            -exec rm -rf {} +
          echo "Removed extra shields"

          echo "Build files list:"
          tree "${{ env.base_dir }}"
          tree "${GITHUB_WORKSPACE}/boards/shields"

      - name: Cache west modules
        uses: actions/cache@v4
        continue-on-error: true
        env:
          cache_name: cache-zephyr-${{ env.zephyr_version }}-modules
        with:
          path: |
            ${{ env.base_dir }}/modules/
            ${{ env.base_dir }}/tools/
            ${{ env.base_dir }}/zephyr/
            ${{ env.base_dir }}/bootloader/
            ${{ env.base_dir }}/zmk/
          key: ${{ runner.os }}-build-${{ env.cache_name }}-${{ hashFiles('**/west.yml', '**/build.yaml') }}
          restore-keys: |
            ${{ runner.os }}-build-${{ env.cache_name }}-
            ${{ runner.os }}-build-
            ${{ runner.os }}-

      - name: West Init
        working-directory: ${{ env.base_dir }}
        run: west init -l "${{ env.base_dir }}/${{ inputs.config_path }}"

      - name: West Update
        working-directory: ${{ env.base_dir }}
        run: west update

      - name: West Zephyr export
        working-directory: ${{ env.base_dir }}
        run: west zephyr-export

      - name: West Build (${{ env.display_name }})
        working-directory: ${{ env.base_dir }}
        shell: sh -x {0}
        run: west build --pristine -s zmk/app -d "${{ env.build_dir }}" -b "${{ matrix.board }}" ${{ env.extra_west_args }} -- -DZMK_CONFIG=${{ env.base_dir }}/${{ inputs.config_path }} ${{ env.extra_cmake_args }} ${{ matrix.cmake-args }}

      - name: ${{ env.display_name }} Kconfig file
        run: |
          if [ -f "${{ env.build_dir }}/zephyr/.config" ]
          then
            grep -v -e "^#" -e "^$" "${{ env.build_dir }}/zephyr/.config" | sort
          else
            echo "No Kconfig output"
          fi
        if: ${{ !cancelled() }}

      - name: ${{ env.display_name }} Devicetree file
        run: |
          if [ -f "${{ env.build_dir }}/zephyr/zephyr.dts" ]
          then
            cat "${{ env.build_dir }}/zephyr/zephyr.dts"
          elif [ -f "${{ env.build_dir }}/zephyr/zephyr.dts.pre" ]
          then
            cat -s "${{ env.build_dir }}/zephyr/zephyr.dts.pre"
          else
            echo "No Devicetree output"
          fi
        if: ${{ !cancelled() }}

      - name: Rename artifacts
        shell: sh -x {0}
        run: |
          mkdir "${{ env.build_dir }}/artifacts"
          if [ -f "${{ env.build_dir }}/zephyr/zmk.uf2" ]
          then
            cp "${{ env.build_dir }}/zephyr/zmk.uf2" "${{ env.build_dir }}/artifacts/${{ env.artifact_name }}.uf2"
          elif [ -f "${{ env.build_dir }}/zephyr/zmk.${{ inputs.fallback_binary }}" ]
          then
            cp "${{ env.build_dir }}/zephyr/zmk.${{ inputs.fallback_binary }}" "${{ env.build_dir }}/artifacts/${{ env.artifact_name }}.${{ inputs.fallback_binary }}"
          fi

      - name: Upload (${{ env.display_name }})
        uses: actions/upload-artifact@v4
        with:
          name: artifact-${{ env.artifact_name }}
          path: ${{ env.build_dir }}/artifacts

  cleanup:
    runs-on: ubuntu-latest
    continue-on-error: true
    needs: build
    name: Merge & Prune Artifacts (optional)
    steps:
      - name: Upload Charybdis ZMK Firmware (QWERTY BT)
        continue-on-error: true
        uses: actions/upload-artifact/merge@v4
        with:
          pattern: artifact-charybdis_qwerty_{left,right}
          name: firmware-charybdis-qwerty
          delete-merged: true

      - name: Upload Charybdis ZMK Firmware (QWERTY Dongle)
        continue-on-error: true
        uses: actions/upload-artifact/merge@v4
        with:
          pattern: artifact-charybdis_qwerty_dongle*
          name: firmware-charybdis-qwerty-dongle
          delete-merged: true

      - name: Upload Charybdis ZMK Firmware (Colemak BT)
        continue-on-error: true
        uses: actions/upload-artifact/merge@v4
        with:
          pattern: artifact-charybdis_colemak_{left,right}
          name: firmware-charybdis-colemak
          delete-merged: true

      - name: Upload Charybdis ZMK Firmware (Colemak Dongle)
        continue-on-error: true
        uses: actions/upload-artifact/merge@v4
        with:
          pattern: artifact-charybdis_colemak_dongle*
          name: firmware-charybdis-colemak-dongle
          delete-merged: true

      - name: Upload Firmware Reset (Nano v2)
        continue-on-error: true
        uses: actions/upload-artifact/merge@v4
        with:
          pattern: artifact-firmware_reset_nano_v2
          name: firmware-reset-nanov2
          delete-merged: true

      - name: Delete keymap artifacts
        continue-on-error: true
        uses: geekyeggo/delete-artifact@v5
        with:
          name: keymap_files