.github/workflows/test.yml

on:
  push:
  pull_request:

jobs:
  build:
    # Prevent running twice for PRs from same repo
    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.event.pull_request.base.repo.full_name
    name: Build & Test
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, windows-latest, macos-latest]
        generator: ["Ninja", "Unix Makefiles", "Visual Studio 18 2026"]
        mbedtls: ["mbedtls", ""]
        libusb: ["libusb", ""]
        compile: ["compile", ""]
        exclude:
          - os: 'windows-latest'
            generator: "Unix Makefiles"
          - os: 'ubuntu-latest'
            generator: "Visual Studio 18 2026"
          - os: 'macos-latest'
            generator: "Visual Studio 18 2026"
          - libusb: ""
            compile: "compile"
          - os: 'windows-latest'
            # only precompiled ELFs supported for Windows MSVC
            compile: "compile"
            generator: "Visual Studio 18 2026"
    runs-on: ${{ matrix.os }}

    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Install arm-none-eabi-gcc (Windows & MacOS)
        if: runner.os == 'Windows' || runner.os == 'macOS'
        uses: carlosperate/arm-none-eabi-gcc-action@v1
        with:
          release: 14.3.Rel1
      - name: Install dependencies (Windows)
        if: runner.os == 'Windows'
        run: |
          curl -L https://github.com/libusb/libusb/releases/download/v1.0.27/libusb-1.0.27.7z -o libusb.7z
          7z x libusb.7z -olibusb
          ls libusb
      - name: Set LIBUSB_ROOT (Windows)
        if: runner.os == 'Windows'
        run: |
          "LIBUSB_ROOT=$(pwd)/libusb" >> $env:GITHUB_ENV
      - name: Check LIBUSB_ROOT (Windows)
        if: runner.os == 'Windows'
        run: |
          echo $env:LIBUSB_ROOT

      - name: Install dependencies (macOS)
        if: runner.os == 'macOS'
        run: |
          brew install libusb ninja

      - name: Install dependencies (Linux)
        if: runner.os == 'Linux'
        run: sudo apt install cmake ninja-build python3 build-essential gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib libusb-1.0-0-dev
      - name: Checkout Pico SDK
        uses: actions/checkout@v4
        with:
          repository: raspberrypi/pico-sdk
          ref: develop
          path: pico-sdk
          submodules: ${{ matrix.mbedtls && 'recursive' || 'false' }}

      - name: Build and Install
        run: |
          cmake -S . -B build -G "${{ matrix.generator }}" -D PICO_SDK_PATH="${{ github.workspace }}/pico-sdk" ${{ !matrix.libusb && '-D PICOTOOL_NO_LIBUSB=1' || '' }} ${{ matrix.compile && '-D USE_PRECOMPILED=false' || '' }}
          cmake --build build
          ${{ runner.os != 'Windows' && 'sudo' || '' }} cmake --install build --config Debug
      - name: Add to path (Windows)
        if: runner.os == 'Windows'
        run: echo "C:\Program Files (x86)\picotool\bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append

      - name: Test
        run: |
          picotool help
          curl -L https://github.com/raspberrypi/pico-sdk-prebuilts/releases/latest/download/blink_universal.uf2 -o blink.uf2
          curl -L https://github.com/raspberrypi/pico-sdk-prebuilts/releases/latest/download/hello_universal.uf2 -o hello_world.uf2
          curl -L https://github.com/raspberrypi/pico-sdk-prebuilts/releases/latest/download/nuke_universal.uf2 -o flash_nuke.uf2
          picotool info -a blink.uf2
          picotool info -a hello_world.uf2
          picotool info -a flash_nuke.uf2
      
      - name: Test libusb compiled
        if: matrix.libusb == 'libusb'
        run: |
          picotool help load
          picotool help save
          picotool help erase

  test-examples:
    # Prevent running twice for PRs from same repo
    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.event.pull_request.base.repo.full_name
    name: Test Build Examples
    strategy:
      fail-fast: false
      matrix:
        compiler: ["gcc", "clang"]
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Install dependencies
        run: sudo apt install cmake ninja-build python3 build-essential libusb-1.0-0-dev
      - name: Install GCC
        if: matrix.compiler == 'gcc'
        run: sudo apt install gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib
      - name: Install Clang
        if: matrix.compiler == 'clang'
        uses: stellar-aria/llvm-embedded-toolchain-for-arm-action@latest
      - name: Checkout Pico SDK
        uses: actions/checkout@v4
        with:
          repository: raspberrypi/pico-sdk
          ref: develop
          path: pico-sdk
          submodules: 'recursive'
      - name: Build and Install
        run: |
          cmake -S . -B build -G "Ninja" -D PICO_SDK_PATH="${{ github.workspace }}/pico-sdk"
          cmake --build build
          sudo cmake --install build
      - name: Checkout Pico Examples
        uses: actions/checkout@v4
        with:
          repository: raspberrypi/pico-examples
          ref: develop
          path: pico-examples
      - name: Build Pico Examples
        run: |
          cmake -S pico-examples -B build-examples -G "Ninja" -D PICO_SDK_PATH="${{ github.workspace }}/pico-sdk" -D PICO_BOARD=pico2_w ${{ matrix.compiler == 'clang' && '-D PICO_COMPILER=pico_arm_clang' || '' }}
          cmake --build build-examples

  test-older-sdk:
    # Due to 2.1.0 and 2.1.1 pointing at the develop tag (https://github.com/raspberrypi/pico-sdk/pull/2401)
    # This test can be removed once 2.1.0 and 2.1.1 are no longer supported (use 2.1.x-correct-picotool instead)
    # Prevent running twice for PRs from same repo
    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.event.pull_request.base.repo.full_name
    strategy:
      fail-fast: false
      matrix:
        sdk: ["2.1.1", "2.1.0"]
    name: Test Build with older SDK
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Install dependencies
        # No libusb, as that is how the SDK auto-builds picotool
        run: sudo apt install cmake ninja-build python3 build-essential
      - name: Checkout Pico SDK
        uses: actions/checkout@v4
        with:
          repository: raspberrypi/pico-sdk
          ref: ${{ matrix.sdk }}
          path: pico-sdk
          submodules: 'recursive'
      - name: Build and Install
        run: |
          cmake -S . -B build -G "Ninja" -D PICO_SDK_PATH="${{ github.workspace }}/pico-sdk" -D PICOTOOL_NO_LIBUSB=1
          cmake --build build
          sudo cmake --install build
      - name: Test
        run: |
          picotool version ${{ matrix.sdk }}