feat: integrate https://github.com/nilsnolde/osrm-bindings

.github/workflows/osrm-backend.yml

@@ -24,7 +24,10 @@ concurrency:
 jobs:
   conan-windows-release-node:
     needs: format-taginfo-docs
-    runs-on: windows-2025
+    strategy:
+      matrix:
+        os: [windows-2025]
+    runs-on: ${{ matrix.os }}
     continue-on-error: false
     env:
       BUILD_TYPE: Release
@@ -43,7 +46,16 @@ jobs:
           echo PUBLISH=$([[ "${GITHUB_REF:-}" == "refs/tags/v${PACKAGE_JSON_VERSION}" ]] && echo "On" || echo "Off") >> $GITHUB_ENV
       - run: npm install --ignore-scripts
       - run: npm link --ignore-scripts
+      - name: Restore Conan cache
+        id: conan-restore
+        uses: actions/cache/restore@v5
+        with:
+          path: ~/.conan2
+          key: v11-conan-${{ matrix.os }}-${{ hashFiles('conanfile.py') }}
+          restore-keys: |
+            v11-conan-${{ matrix.os }}-
       - name: Build
+        id: build
         shell: bash
         run: |
           mkdir build
@@ -56,6 +68,12 @@ jobs:
 
           cmake -DCMAKE_BUILD_TYPE=Release -DENABLE_CONAN=ON -DENABLE_NODE_BINDINGS=ON ..
           cmake --build . --config Release
+      - name: Save Conan cache
+        if: steps.build.outcome == 'success' && steps.conan-restore.outputs.cache-hit != 'true'
+        uses: actions/cache/save@v5
+        with:
+          path: ~/.conan2
+          key: v11-conan-${{ matrix.name }}-${{ hashFiles('conanfile.py') }}
 
       # TODO: MSVC goes out of memory when building our tests
       # - name: Run tests
@@ -75,22 +93,36 @@ jobs:
 
       #     ./lib/binding_napi_v8/osrm-datastore.exe test/data/ch/monaco.osrm
       #     node test/nodejs/index.js
-      - name: Build Node package
-        shell: bash
-        run: ./scripts/ci/node_package.sh
-      - name: Publish Node package
-        if: ${{ env.PUBLISH == 'On' }}
-        uses: ncipollo/release-action@v1
+      # - name: Build Node package
+      #   shell: bash
+      #   run: ./scripts/ci/node_package.sh
+      # - name: Publish Node package
+      #   if: ${{ env.PUBLISH == 'On' }}
+      #   uses: ncipollo/release-action@v1
+      #   with:
+      #     allowUpdates: true
+      #     artifactErrorsFailBuild: true
+      #     artifacts: build/stage/**/*.tar.gz
+      #     omitBody: true
+      #     omitBodyDuringUpdate: true
+      #     omitName: true
+      #     omitNameDuringUpdate: true
+      #     replacesArtifacts: true
+      #     token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Run CIBuildWheel
+        if: github.event_name != 'pull_request'
+        uses: pypa/cibuildwheel@v3.4.0
         with:
-          allowUpdates: true
-          artifactErrorsFailBuild: true
-          artifacts: build/stage/**/*.tar.gz
-          omitBody: true
-          omitBodyDuringUpdate: true
-          omitName: true
-          omitNameDuringUpdate: true
-          replacesArtifacts: true
-          token: ${{ secrets.GITHUB_TOKEN }}
+          output-dir: dist
+        env:
+          CIBW_CONFIG_SETTINGS_WINDOWS: "cmake.define.ENABLE_CONAN=ON"
+      - name: Upload Windows wheel
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows
+          path: dist/*.whl
+          if-no-files-found: error
 
   format-taginfo-docs:
     runs-on: ubuntu-slim
@@ -313,7 +345,7 @@ jobs:
             ENABLE_LTO: OFF
 
           - name: conan-linux-release-node
-            build_node_package: true
+            build_bindings: true
             continue-on-error: false
             node: 24
             runs-on: ubuntu-24.04
@@ -324,7 +356,6 @@ jobs:
             NODE_PACKAGE_TESTS_ONLY: ON
 
           - name: conan-linux-debug-node
-            build_node_package: true
             continue-on-error: false
             node: 24
             runs-on: ubuntu-24.04
@@ -345,21 +376,21 @@ jobs:
             ENABLE_LTO: OFF
 
           - name: conan-macos-x64-release-node
-            build_node_package: true
+            build_bindings: true
             continue-on-error: true
             node: 24
-            runs-on: macos-26-intel # x86_64
+            runs-on: macos-15-intel # x86_64
             BUILD_TYPE: Release
             CCOMPILER: clang
             CXXCOMPILER: clang++
             ENABLE_ASSERTIONS: ON
             ENABLE_CONAN: ON
 
           - name: conan-macos-arm64-release-node
-            build_node_package: true
+            build_bindings: true
             continue-on-error: true
             node: 24
-            runs-on: macos-26 # arm64
+            runs-on: macos-15 # arm64
             BUILD_TYPE: Release
             CCOMPILER: clang
             CXXCOMPILER: clang++
@@ -386,8 +417,12 @@ jobs:
       OSRM_CONNECTION_RETRIES: ${{ matrix.OSRM_CONNECTION_RETRIES }}
       OSRM_CONNECTION_EXP_BACKOFF_COEF: ${{ matrix.OSRM_CONNECTION_EXP_BACKOFF_COEF }}
       ENABLE_LTO: ${{ matrix.ENABLE_LTO }}
+      BUILD_BINDINGS: ${{ matrix.build_bindings }}
     steps:
       - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          fetch-tags: true
       - name: Build machine architecture
         run: uname -m
       - name: Use Node.js
@@ -401,20 +436,22 @@ jobs:
           key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json') }}
           restore-keys: |
             ${{ runner.os }}-node-
-      - name: Enable compiler cache
-        uses: actions/cache@v5
+      - name: Restore compiler cache
+        id: ccache-restore
+        uses: actions/cache/restore@v5
         with:
           path: ~/.ccache
           key: ccache-${{ matrix.name }}-${{ github.sha }}
           restore-keys: |
             ccache-${{ matrix.name }}-
-      - name: Enable Conan cache
-        uses: actions/cache@v5
+      - name: Restore Conan cache
+        id: conan-restore
+        uses: actions/cache/restore@v5
         with:
           path: ~/.conan2
-          key: v10-conan-${{ matrix.name }}-${{ github.sha }}
+          key: v11-conan-${{ matrix.name }}-${{ hashFiles('conanfile.py') }}
           restore-keys: |
-            v10-conan-${{ matrix.name }}-
+            v11-conan-${{ matrix.name }}-
       - name: Enable test cache
         uses: actions/cache@v5
         with:
@@ -484,17 +521,15 @@ jobs:
             fi
           fi
 
-          # TBB
-          TBB_VERSION=2021.12.0
+          # TBB (Linux only; macOS gets it from conan or brew)
           if [[ "${RUNNER_OS}" == "Linux" ]]; then
+            TBB_VERSION=2021.12.0
             TBB_URL="https://github.com/oneapi-src/oneTBB/releases/download/v${TBB_VERSION}/oneapi-tbb-${TBB_VERSION}-lin.tgz"
-          elif [[ "${RUNNER_OS}" == "macOS" ]]; then
-            TBB_URL="https://github.com/oneapi-src/oneTBB/releases/download/v${TBB_VERSION}/oneapi-tbb-${TBB_VERSION}-mac.tgz"
+            wget --tries 5 ${TBB_URL} -O onetbb.tgz
+            tar zxvf onetbb.tgz
+            sudo cp -a oneapi-tbb-${TBB_VERSION}/lib/. /usr/local/lib/
+            sudo cp -a oneapi-tbb-${TBB_VERSION}/include/. /usr/local/include/
           fi
-          wget --tries 5 ${TBB_URL} -O onetbb.tgz
-          tar zxvf onetbb.tgz
-          sudo cp -a oneapi-tbb-${TBB_VERSION}/lib/. /usr/local/lib/
-          sudo cp -a oneapi-tbb-${TBB_VERSION}/include/. /usr/local/include/
       - name: Prepare build
         run: |
           mkdir ${OSRM_BUILD_DIR}
@@ -505,14 +540,9 @@ jobs:
           fi
           echo "CC=${CCOMPILER}" >> $GITHUB_ENV
           echo "CXX=${CXXCOMPILER}" >> $GITHUB_ENV
-          if [[ "${RUNNER_OS}" == "macOS" ]]; then
-            # missing from GCC path, needed for conan builds of libiconv, for example.
-            sudo xcode-select --switch /Library/Developer/CommandLineTools
-            echo "LIBRARY_PATH=${LIBRARY_PATH}:/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/lib" >> $GITHUB_ENV
-            echo "CPATH=${CPATH}:/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include" >> $GITHUB_ENV
-          fi
 
       - name: Build and install OSRM
+        id: build
         run: |
           echo "Using ${JOBS} jobs"
           pushd ${OSRM_BUILD_DIR}
@@ -556,6 +586,18 @@ jobs:
           popd
         env:
           Boost_ROOT: ${{ steps.install-boost.outputs.BOOST_ROOT }}
+      - name: Save compiler cache
+        if: steps.build.outcome == 'success'
+        uses: actions/cache/save@v5
+        with:
+          path: ~/.ccache
+          key: ccache-${{ matrix.name }}-${{ github.sha }}
+      - name: Save Conan cache
+        if: steps.build.outcome == 'success' && steps.conan-restore.outputs.cache-hit != 'true'
+        uses: actions/cache/save@v5
+        with:
+          path: ~/.conan2
+          key: v11-conan-${{ matrix.name }}-${{ hashFiles('conanfile.py') }}
       - name: Run all tests
         if: ${{ matrix.NODE_PACKAGE_TESTS_ONLY != 'ON' }}
         run: |
@@ -612,10 +654,10 @@ jobs:
           path: test/logs/
 
       - name: Build Node package
-        if: ${{ matrix.build_node_package }}
+        if: ${{ env.BUILD_BINDINGS }}
         run: ./scripts/ci/node_package.sh
       - name: Publish Node package
-        if: ${{ matrix.build_node_package && env.PUBLISH == 'On' }}
+        if: ${{ env.BUILD_BINDINGS && env.PUBLISH == 'On' }}
         uses: ncipollo/release-action@v1
         with:
           allowUpdates: true
@@ -627,13 +669,58 @@ jobs:
           omitNameDuringUpdate: true
           replacesArtifacts: true
           token: ${{ secrets.GITHUB_TOKEN }}
+
+      # Python bindings
+
+      - name: Set up Python
+        if: ${{ env.BUILD_BINDINGS }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist
+        if: ${{ env.BUILD_BINDINGS && runner.os == 'Linux' }}
+        run: |
+          python -m pip install build
+          python -m build --sdist
+
+      - name: Locate sdist
+        if: ${{ env.BUILD_BINDINGS && runner.os == 'Linux' }}
+        id: sdist
+        shell: bash
+        run: echo "path=$(ls dist/*.tar.gz | head -n1)" >> "$GITHUB_OUTPUT"
+
+      - name: Run cibuildwheel
+        uses: pypa/cibuildwheel@v3.4.1
+        if: ${{ env.BUILD_BINDINGS }}
+        with:
+          # for linux build the wheel from the sdist
+          package-dir: ${{ runner.os == 'Linux' && steps.sdist.outputs.path || '.' }}
+          output-dir: dist
+        env:
+          # Mount the workflow-cached ~/.ccache into the container so Linux
+          # wheel builds share the main-build ccache across runs.
+          CIBW_CONTAINER_ENGINE: "docker; create_args: --volume /home/runner/.ccache:/ccache"
+          CIBW_ENVIRONMENT_LINUX: "LD_LIBRARY_PATH=/usr/local/lib64:${LD_LIBRARY_PATH} CCACHE_DIR=/ccache"
+          CIBW_CONFIG_SETTINGS_MACOS: "cmake.define.CMAKE_CXX_COMPILER_LAUNCHER=ccache cmake.define.CMAKE_C_COMPILER_LAUNCHER=ccache"
+
+      - name: Upload wheels and sdist
+        if: ${{ env.BUILD_BINDINGS && startsWith(github.ref, 'refs/tags/v') }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.name }}
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+          if-no-files-found: error
+
       - name: Show CCache statistics
         run: |
           ccache -p
           ccache -s
 
   ci-complete:
     runs-on: ubuntu-latest
-    needs: [build-matrix, conan-windows-release-node, docker-image-matrix]
+    needs: [build-matrix]
     steps:
       - run: echo "CI complete"

.github/workflows/release-monthly.yml

@@ -25,8 +25,11 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
-      id-token: write
       actions: write
+    outputs:
+      tag: ${{ steps.version.outputs.tag }}
+      version: ${{ steps.version.outputs.version }}
+      run_id: ${{ steps.wait_ci.outputs.run_id }}
     steps:
       - uses: actions/checkout@v6
         with:
@@ -177,6 +180,7 @@ jobs:
           prerelease: false
 
       - name: Wait for CI to complete
+        id: wait_ci
         env:
           GH_TOKEN: ${{ github.token }}
         run: |
@@ -209,6 +213,7 @@ jobs:
               if [ "$STATUS" = "completed" ]; then
                 if [ "$CONCLUSION" = "success" ]; then
                   echo "✓ CI workflow completed successfully, proceeding with npm publish"
+                  echo "run_id=$RUN_ID" >> "$GITHUB_OUTPUT"
                   exit 0
                 else
                   echo "✗ CI workflow completed with conclusion=$CONCLUSION (expected success)"
@@ -228,9 +233,42 @@ jobs:
           echo "✗ Timed out waiting for CI workflow to complete for tag $TAG"
           exit 1
 
+
+  publish:
+    needs: release
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.release.outputs.tag }}
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          registry-url: 'https://registry.npmjs.org'
+
       - name: Install dependencies (skip native build scripts)
         run: npm ci --ignore-scripts
 
       - name: Publish to npm
         run: npm publish
 
+      - name: Download wheels from CI run
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+          run-id: ${{ needs.release.outputs.run_id }}
+          github-token: ${{ github.token }}
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.13.0
+        with:
+          skip-existing: true
+          verbose: true
+          repository-url: https://test.pypi.org/legacy/
+

.gitignore

@@ -111,6 +111,11 @@ debug.lua
 ##########################
 lib/binding_napi_v8
 
+# Python
+##########################
+__pycache__/
+*.whl
+
 # documentation related files
 ##########################
 .vitepress/cache