python-bindings.yml

name: Python Bindings

on:
  push:
    branches: [main]
    paths:
      - '.github/workflows/python-bindings.yml'
      - 'bindings/python/**'
      - 'cmake/**'
      - 'CMakeLists.txt'
      - 'conanfile.py'
      - 'include/**'
      - 'src/**'
  pull_request:
    branches: [main]
    paths:
      - '.github/workflows/python-bindings.yml'
      - 'bindings/python/**'
      - 'cmake/**'
      - 'CMakeLists.txt'
      - 'conanfile.py'
      - 'include/**'
      - 'src/**'
  release:
    types: [published]

permissions:
  contents: write
  id-token: write

env:
  CIBUILDWHEEL_VERSION: "2.23.4"

jobs:
  test:
    name: Test on ${{ matrix.os }} / Python ${{ matrix.python }}
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        include:
          - os: ubuntu-latest
            python: '3.11'
          - os: ubuntu-latest
            python: '3.12'
          - os: ubuntu-latest
            python: '3.13'
          - os: macos-latest
            python: '3.12'
          - os: windows-latest
            python: '3.12'

    steps:
      - uses: actions/checkout@v4

      - name: Set up Python ${{ matrix.python }}
        uses: actions/setup-python@v5
        with:
          python-version: ${{ matrix.python }}

      - name: Install build tools
        run: pip install conan ninja

      - name: Install Conan dependencies (Unix)
        if: runner.os != 'Windows'
        run: |
          conan profile detect
          conan install . --output-folder=buildDir --build=missing --build="antlr4-cppruntime/*" -s build_type=Release -s compiler.cppstd=20 -o with_tests=False

      - name: Install LLVM (Windows)
        if: runner.os == 'Windows'
        run: |
          choco install llvm --version=20.1.4 --force
          echo "C:\Program Files\LLVM\bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
        shell: pwsh

      - name: Install Conan dependencies (Windows)
        if: runner.os == 'Windows'
        run: pwsh scripts/install_conan_windows.ps1 Release -o with_tests=False

      - name: Install zyxdb (Unix)
        if: runner.os != 'Windows'
        run: CMAKE_ARGS="-DCMAKE_TOOLCHAIN_FILE=$PWD/buildDir/conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release" pip install "bindings/python[test]"

      - name: Install zyxdb (Windows)
        if: runner.os == 'Windows'
        run: |
          $toolchain = "$PWD\buildDir\conan_toolchain.cmake" -replace '\\', '/'
          $env:CC = "clang-cl"
          $env:CXX = "clang-cl"
          $env:CMAKE_ARGS = "-DCMAKE_TOOLCHAIN_FILE=$toolchain -DCMAKE_BUILD_TYPE=Release"
          pip install "bindings/python[test]"
        shell: pwsh

      - name: Run tests
        run: |
          cd bindings/python
          python -m pytest tests/ -v

  build-wheels:
    name: Build wheels on ${{ matrix.os }}
    needs: test
    if: github.event_name == 'release'
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]

    steps:
      - uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'

      - name: Install cibuildwheel
        # Keep the wheel builder pinned so Python patch installers do not change
        # underneath release jobs before CPython's Windows NuGet package is live.
        run: pip install "cibuildwheel==${{ env.CIBUILDWHEEL_VERSION }}"

      - name: Build wheels
        run: python -m cibuildwheel --output-dir wheelhouse bindings/python
        env:
          CIBW_BUILD: cp310-* cp311-* cp312-* cp313-*
          CIBW_BUILD_FRONTEND: "build"
          CIBW_SKIP: '*-musllinux_* *-win32'
          CIBW_BEFORE_ALL_LINUX: >
            pip install conan ninja &&
            conan profile detect &&
            conan install . --output-folder=/project/buildDir --build=missing --build="b2/*" --build="antlr4-cppruntime/*" -s build_type=Release -s compiler.cppstd=20 -o with_tests=False
          CIBW_BEFORE_ALL_MACOS: >
            pip install conan ninja &&
            conan profile detect &&
            conan install . --output-folder=/tmp/conan-deps --build=missing --build="antlr4-cppruntime/*" -s build_type=Release -s compiler.cppstd=20 -o with_tests=False
          CIBW_BEFORE_ALL_WINDOWS: >
            pip install conan ninja &&
            set "CONAN_OUTPUT_DIR=C:\conan-deps" &&
            choco install llvm --version=20.1.4 --force &&
            pwsh scripts/install_conan_windows.ps1 Release -o with_tests=False
          CIBW_ENVIRONMENT_LINUX: CMAKE_ARGS="-DCMAKE_TOOLCHAIN_FILE=/project/buildDir/conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release"
          CIBW_ENVIRONMENT_MACOS: CMAKE_ARGS="-DCMAKE_TOOLCHAIN_FILE=/tmp/conan-deps/conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release" MACOSX_DEPLOYMENT_TARGET=13.3
          CIBW_ENVIRONMENT_WINDOWS: CC=clang-cl CXX=clang-cl CMAKE_ARGS="-DCMAKE_TOOLCHAIN_FILE=C:/conan-deps/conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release"

      - name: Upload wheels
        uses: actions/upload-artifact@v4
        with:
          name: wheels-${{ matrix.os }}
          path: ./wheelhouse/*.whl

  build-sdist:
    name: Build sdist
    needs: test
    if: github.event_name == 'release'
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'

      - name: Build sdist
        run: |
          pip install build
          python -m build --sdist bindings/python --outdir dist/

      - name: Upload sdist
        uses: actions/upload-artifact@v4
        with:
          name: sdist
          path: dist/*.tar.gz

  publish-pypi:
    name: Publish to PyPI
    needs: [build-wheels, build-sdist]
    runs-on: ubuntu-latest
    environment: pypi

    steps:
      - name: Download wheel artifacts
        uses: actions/download-artifact@v4
        with:
          pattern: wheels-*
          path: dist/
          merge-multiple: true

      - name: Download sdist artifact
        uses: actions/download-artifact@v4
        with:
          name: sdist
          path: dist/

      - name: Publish to PyPI
        uses: pypa/gh-action-pypi-publish@release/v1

  upload-release-assets:
    name: Upload release assets
    needs: [build-wheels, build-sdist]
    runs-on: ubuntu-latest

    steps:
      - name: Download wheel artifacts
        uses: actions/download-artifact@v4
        with:
          pattern: wheels-*
          path: dist/
          merge-multiple: true

      - name: Download sdist artifact
        uses: actions/download-artifact@v4
        with:
          name: sdist
          path: dist/

      - name: Upload assets to GitHub Release
        uses: softprops/action-gh-release@v2
        with:
          files: dist/*