Add C++17 bindings

Author: palchukovsky

.github/ci-versions.env

@@ -2,3 +2,4 @@ CI_RUST=1.93.1
 CI_GO=1.22.3
 CI_GOLANGCI_LINT=2.12.2
 CI_PYTHON=3.10
+CI_CLANG_FORMAT=22.1.5

.github/workflows/docs.yml

@@ -60,7 +60,8 @@ jobs:
           "$PYTHON_PATH" -m pip install -r docs/requirements.txt
 
       - name: Install maturin and Python build dependencies
-        run: "$PYTHON_PATH" -m pip install -r requirements.txt
+        run: |
+          "$PYTHON_PATH" -m pip install -r requirements.txt
 
       - name: Setup just
         uses: extractions/setup-just@v3

.github/workflows/release.yml

@@ -241,6 +241,11 @@ jobs:
         shell: bash
         run: just --justfile "$JUSTFILE" copy-python-metadata
 
+      - name: Use static MSVC CRT for Windows wheel
+        if: matrix.target == 'x86_64-pc-windows-msvc'
+        shell: bash
+        run: echo "RUSTFLAGS=-C target-feature=+crt-static" >> "$GITHUB_ENV"
+
       - name: Build Linux wheel
         if: startsWith(matrix.os, 'ubuntu')
         uses: PyO3/maturin-action@v1
@@ -271,15 +276,12 @@ jobs:
           echo "WHEEL_PATH=${WHEEL_PATH}" >> "$GITHUB_ENV"
 
       - name: Install built wheel
-        if:
-          matrix.name == 'linux-x86_64-manylinux2014' || !startsWith(matrix.os,
-          'ubuntu')
-        run: "$PYTHON_PATH" -m pip install --force-reinstall --no-deps "${{ env.WHEEL_PATH }}"
+        if: matrix.name == 'linux-x86_64-manylinux2014' || !startsWith(matrix.os, 'ubuntu')
+        run: |
+          "$PYTHON_PATH" -m pip install --force-reinstall --no-deps "${{ env.WHEEL_PATH }}"
 
       - name: Verify wheel import and version
-        if:
-          matrix.name == 'linux-x86_64-manylinux2014' || !startsWith(matrix.os,
-          'ubuntu')
+        if: matrix.name == 'linux-x86_64-manylinux2014' || !startsWith(matrix.os, 'ubuntu')
         shell: bash
         env:
           BASE_VERSION: ${{ needs.verify-tag.outputs.base_version }}
@@ -288,9 +290,7 @@ jobs:
         run: just --justfile "$JUSTFILE" verify-wheel-version "$RELEASE_MODE" "$VERSION" "$BASE_VERSION"
 
       - name: Run wheel tests
-        if:
-          matrix.name == 'linux-x86_64-manylinux2014' || !startsWith(matrix.os,
-          'ubuntu')
+        if: matrix.name == 'linux-x86_64-manylinux2014' || !startsWith(matrix.os, 'ubuntu')
         shell: bash
         run: just --justfile "$JUSTFILE" test-wheel
 
@@ -520,11 +520,19 @@ jobs:
           $src = "target/${{ matrix.target }}/release/${{ matrix.lib_name }}"
           $dst = "dist/openpit-ffi--${{ matrix.goos }}-${{ matrix.goarch }}-${{ matrix.lib_name }}"
           Copy-Item $src $dst -Force
+          $implibSrc = "$src.lib"
+          if (!(Test-Path $implibSrc)) {
+            throw "MSVC import library not found at $implibSrc"
+          }
+          $implibDst = "$dst.lib"
+          Copy-Item $implibSrc $implibDst -Force
           Copy-Item bindings/c/openpit.h dist/openpit.h -Force
           Copy-Item LICENSE dist/LICENSE -Force
           Copy-Item OWNERS dist/OWNERS -Force
           $hash = (Get-FileHash -Path $dst -Algorithm SHA256).Hash.ToLower()
           Set-Content -Path "$dst.sha256" -Value $hash
+          $implibHash = (Get-FileHash -Path $implibDst -Algorithm SHA256).Hash.ToLower()
+          Set-Content -Path "$implibDst.sha256" -Value $implibHash
 
       - name: Upload runtime artifacts
         if: ${{ needs.verify-tag.outputs.release_mode == 'production' }}
@@ -543,12 +551,82 @@ jobs:
           if-no-files-found: error
           retention-days: 1
 
+  build-cpp-distributable:
+    name: Build C++ distributable
+    needs:
+      - verify
+      - verify-tag
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Load CI versions
+        shell: bash
+        run: cat "$GITHUB_WORKSPACE/.github/ci-versions.env" >> "$GITHUB_ENV"
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.CI_RUST }}
+
+      - name: Cache Rust build
+        uses: Swatinem/rust-cache@v2
+
+      - name: Setup CMake
+        uses: jwlawson/actions-setup-cmake@v2
+        with:
+          cmake-version: "3.28"
+
+      - name: Setup just
+        uses: extractions/setup-just@v3
+
+      - name: Build C++ binding
+        shell: bash
+        run: just build-cpp
+
+      - name: Install C++ binding into staging prefix
+        shell: bash
+        env:
+          VERSION: ${{ needs.verify-tag.outputs.version }}
+        run: |
+          set -euo pipefail
+          cmake --install bindings/cpp/build \
+            --prefix /tmp/openpit-cpp-install \
+            --config Release
+          cp LICENSE /tmp/openpit-cpp-install/LICENSE
+          cp OWNERS  /tmp/openpit-cpp-install/OWNERS
+
+      - name: Package C++ distributable
+        shell: bash
+        env:
+          VERSION: ${{ needs.verify-tag.outputs.version }}
+        run: just --justfile "$JUSTFILE" package-cpp /tmp/openpit-cpp-install
+
+      - name: Upload C++ artifact
+        if: ${{ needs.verify-tag.outputs.release_mode == 'production' }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: cpp-distributable
+          path: dist/openpit-cpp--*.tar.gz*
+          if-no-files-found: error
+
+      - name: Upload C++ artifact (dry-run)
+        if: ${{ needs.verify-tag.outputs.release_mode == 'dry-run' }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: cpp-distributable
+          path: dist/openpit-cpp--*.tar.gz*
+          if-no-files-found: error
+          retention-days: 1
+
   publish-go-sources:
     name: Publish pit-go sources
     needs:
       - publish-rust
       - publish-sdist
       - build-runtime-artifacts
+      - build-cpp-distributable
       - verify-tag
     runs-on: ubuntu-22.04
     permissions:
@@ -708,6 +786,7 @@ jobs:
       - publish-rust
       - publish-sdist
       - build-runtime-artifacts
+      - build-cpp-distributable
       - verify-tag
     if: ${{ needs.verify-tag.outputs.release_mode == 'production' }}
     runs-on: ubuntu-22.04
@@ -724,6 +803,12 @@ jobs:
           path: release-assets
           merge-multiple: true
 
+      - name: Download C++ distributable artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: cpp-distributable
+          path: release-assets
+
       - name: Create GitHub Release with runtime assets
         shell: bash
         run: |
@@ -736,8 +821,12 @@ jobs:
           - crates.io: https://crates.io/crates/openpit
           - PyPI: https://pypi.org/project/openpit/${{ needs.verify-tag.outputs.version }}/
 
-          Runtime artifacts for Go SDK delivery are attached to this release
-          (`.so`, `.dylib`, `.dll` and `.sha256` files per target).
+          Runtime artifacts for SDK delivery are attached to this release
+          (\`.so\`, \`.dylib\`, \`.dll\`, Windows \`.dll.lib\`, and
+          \`.sha256\` files per target).
+
+          The C++ distributable (\`openpit-cpp--${{ needs.verify-tag.outputs.version }}.tar.gz\`)
+          contains the public headers and CMake config-file package.
           EOF
 
           mapfile -t ASSETS < <(find release-assets -type f | sort)

.github/workflows/verify.yml

@@ -128,6 +128,111 @@ jobs:
       - name: Check C
         run: just --justfile "$JUSTFILE" test-c-examples
 
+  cpp:
+    name: C++ checks (${{ matrix.name }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: linux-gcc
+            os: ubuntu-22.04
+            cc: gcc
+            cxx: g++
+          - name: linux-clang
+            os: ubuntu-22.04
+            cc: clang
+            cxx: clang++
+          - name: macos-appleclang
+            os: macos-14
+            cc: clang
+            cxx: clang++
+          - name: windows-msvc
+            os: windows-2022
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Load CI versions
+        shell: bash
+        run: cat "$GITHUB_WORKSPACE/.github/ci-versions.env" >> "$GITHUB_ENV"
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: ${{ env.CI_RUST }}
+
+      - name: Cache Rust build
+        uses: Swatinem/rust-cache@v2
+
+      - name: Setup CMake
+        uses: jwlawson/actions-setup-cmake@v2
+        with:
+          cmake-version: "3.28"
+
+      - name: Setup just
+        uses: extractions/setup-just@v3
+
+      - name: Install C++ tooling (Linux)
+        if: startsWith(matrix.os, 'ubuntu')
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes clang-tidy doxygen
+
+      - name: Install C++ tooling (macOS)
+        if: startsWith(matrix.os, 'macos')
+        run: brew install doxygen
+
+      # clang-format ships a per-OS-divergent format from apt/brew, so pin one
+      # wheel-packaged build across every runner to keep fmt-check deterministic.
+      - name: Install pinned clang-format
+        if: ${{ matrix.os != 'windows-2022' }}
+        shell: bash
+        run: |
+          pipx install "clang-format==${CI_CLANG_FORMAT}"
+          # Prepend pipx's bin dir so the pinned build shadows any clang-format
+          # already baked into the runner image (e.g. /usr/bin/clang-format).
+          CF_BIN_DIR="$(pipx environment --value PIPX_BIN_DIR)"
+          echo "$CF_BIN_DIR" >> "$GITHUB_PATH"
+          "$CF_BIN_DIR/clang-format" --version
+
+      - name: Build C++ binding
+        shell: bash
+        run: |
+          if [[ -n "${{ matrix.cc }}" ]]; then
+            export CC="${{ matrix.cc }}"
+            export CXX="${{ matrix.cxx }}"
+          fi
+          just build-cpp
+
+      - name: Test C++ binding
+        shell: bash
+        run: just test-cpp
+
+      - name: Build and test C++ examples
+        shell: bash
+        run: |
+          if [[ -n "${{ matrix.cc }}" ]]; then
+            export CC="${{ matrix.cc }}"
+            export CXX="${{ matrix.cxx }}"
+          fi
+          just test-examples-cpp
+
+      - name: Check C++ formatting
+        if: ${{ matrix.os != 'windows-2022' }}
+        shell: bash
+        run: just fmt-check-cpp
+
+      - name: Generate C++ API reference
+        if: ${{ matrix.os != 'windows-2022' }}
+        shell: bash
+        run: just gen-docs-cpp
+
+      - name: Lint C++ sources
+        if: startsWith(matrix.os, 'ubuntu')
+        shell: bash
+        run: just lint-cpp
+
   go:
     name: Go checks
     runs-on: ubuntu-22.04