path: root/.github/workflows/ci.yml

name: CI

on:
  push:
  pull_request:
  workflow_dispatch:

env:
  BOOST_VERSION: 1.81.0
  CMAKE_FLAGS: -D WINAPI_UTF8_TESTS=ON

jobs:
  lint:
    runs-on: ubuntu-latest
    name: Linting
    if: github.ref == 'refs/heads/master'
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: recursive
      - name: Run clang-format
        run: ./cmake/tools/project-clang-format.py

  build:
    strategy:
      matrix:
        toolset: [mingw, vs2019, vs2022]
        platform: [x64, x86]
        configuration: [Debug, RelWithDebInfo]
        include:
          # MinGW builds are done on Linux, since it's more up-to-date there, and
          # it's much faster.
          - {toolset: mingw, os: ubuntu-latest}
          - {toolset: vs2019, os: windows-2019}
          - {toolset: vs2022, os: windows-2022}
    runs-on: '${{ matrix.os }}'
    name: 'Build: ${{ matrix.toolset }} / ${{ matrix.platform }} / ${{ matrix.configuration }}'
    defaults:
      run:
        shell: pwsh
    env:
      TOOLSET: '${{ matrix.toolset }}'
      PLATFORM: '${{ matrix.platform }}'
      CONFIGURATION: '${{ matrix.configuration }}'
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: recursive
      - name: Cache Boost
        uses: actions/cache@v4
        with:
          path: './build/boost_*.tar.gz'
          key: 'boost_${{ env.BOOST_VERSION }}'
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.x'
      - name: Set up MinGW
        uses: egor-tensin/setup-mingw@v2
        with:
          platform: '${{ matrix.platform }}'
        if: matrix.toolset == 'mingw'
      - name: Build Boost
        run: make deps
      - name: Build
        run: make install
      - name: Upload binaries
        uses: actions/upload-artifact@v4
        with:
          name: 'winapi-utf8-${{ matrix.toolset }}-${{ matrix.platform }}-${{ matrix.configuration }}'
          path: './build/install/'
          if-no-files-found: error
      - name: Test
        run: make test
        if: runner.os == 'Windows'

  docs:
    needs: [lint, build]
    runs-on: ubuntu-latest
    name: Docs
    if: github.ref == 'refs/heads/master'
    env:
      TOOLSET: mingw
      CMAKE_FLAGS: -D WINAPI_UTF8_TESTS=OFF
    steps:
      # This is rather stupid. In order to build Doxygen docs, I need a working
      # CMake build directory, so I assume that means I need to pretty much
      # build the project. TODO: research if this is possible without having a
      # Doxyfile.
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: recursive
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.x'
      - name: Set up MinGW
        uses: egor-tensin/setup-mingw@v2
      - name: Install Doxygen
        run: |
          sudo apt-get update
          sudo DEBIAN_FRONTEND=noninteractive apt-get install -yq --no-install-recommends doxygen
      - name: Build
        run: make install
      - name: Build docs
        run: make docs
      - name: Publish to GitHub Pages
        uses: JamesIves/github-pages-deploy-action@v4
        with:
          branch: gh-pages
          folder: ./build/cmake/html
          single-commit: true