From d78800dd7089ec0ec951c71c711f052e7ef60cde Mon Sep 17 00:00:00 2001
From: Ludovic Henry <git@ludovic.dev>
Date: Mon, 21 Sep 2026 09:50:02 +0000
Subject: [PATCH] cmeel-octomap: Add version 1.10.0

Build the OctoMap 1.10.0 cmeel distribution for riscv64: liboctomap,
liboctomath, their headers, CMake/pkg-config files and command-line tools,
installed into the shared cmeel prefix.

[tool.cmeel] has-sitelib = false, so the wheel holds no Python extension and
one py3-none-manylinux_riscv64 wheel covers every interpreter; the build runs
as a single cibuildwheel job. The tag's .c5 suffix is the cmeel packaging
revision, which the backend stamps as the wheel's build tag.

Mirrors upstream's release.yml, including CMEEL_RUN_TESTS=false: octomap's
test_color_tree asserts a hardcoded node count that changes wherever the
compiler contracts a*b+c into an FMA, which riscv64 does by default.
---
 .github/workflows/build-cmeel-octomap.yml | 138 ++++++++++++++++++++++
 docs/packages/cmeel-octomap.yaml          |   5 +
 2 files changed, 143 insertions(+)
 create mode 100644 .github/workflows/build-cmeel-octomap.yml
 create mode 100644 docs/packages/cmeel-octomap.yaml

diff --git a/.github/workflows/build-cmeel-octomap.yml b/.github/workflows/build-cmeel-octomap.yml
new file mode 100644
index 0000000000..4929ab2a2b
--- /dev/null
+++ b/.github/workflows/build-cmeel-octomap.yml
@@ -0,0 +1,138 @@
+# SPDX-FileCopyrightText: 2026 The RISE Project
+# SPDX-License-Identifier: MIT
+---
+# This workflow is based on: https://github.com/cmake-wheel/cmeel-octomap/blob/v1.10.0.c5/.github/workflows/release.yml
+name: Build cmeel-octomap wheels (riscv64)
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version glob to (re)build; empty builds every version of docs/packages/cmeel-octomap.yaml not released yet'
+        required: false
+        default: ''
+  pull_request:
+    branches: [main]
+    paths:
+      - '.github/workflows/build-cmeel-octomap.yml'
+      - 'docs/packages/cmeel-octomap.yaml'
+  push:
+    branches: [main]
+    paths:
+      - '.github/workflows/build-cmeel-octomap.yml'
+      - 'docs/packages/cmeel-octomap.yaml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read  # to fetch code (actions/checkout)
+
+env:
+  MANYLINUX_RISCV64_IMAGE: quay.io/pypa/manylinux_2_39_riscv64
+
+jobs:
+  setup:
+    uses: $/.github/workflows/_setup.yml
+    with:
+      package: cmeel-octomap
+      version: ${{ inputs.version }}
+
+  build_wheels:
+    needs: [setup]
+    if: needs.setup.outputs.versions != '[]'
+    name: Build cmeel-octomap ${{ matrix.version }} manylinux_riscv64
+    runs-on: ubuntu-24.04-riscv
+    timeout-minutes: 120
+    strategy:
+      fail-fast: false
+      matrix:
+        version: ${{ fromJSON(needs.setup.outputs.versions) }}
+
+    env:
+      CMEEL_OCTOMAP_VERSION: ${{ matrix.version }}
+
+    steps:
+      # cmeel-octomap's release tags carry a packaging-revision suffix (.c5) that is the
+      # wheel's build tag, not part of its version; .c5 is the revision 1.10.0 released last.
+      - name: Checkout cmeel-octomap v${{ env.CMEEL_OCTOMAP_VERSION }}.c5
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          repository: cmake-wheel/cmeel-octomap
+          ref: v${{ env.CMEEL_OCTOMAP_VERSION }}.c5
+          submodules: true
+          persist-credentials: false
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@1828c10ab37f080699c7b81cea34097c684a7074  # v4.2.0
+        with:
+          output-dir: wheelhouse/
+          # has-sitelib = false: the wheel holds no Python extension, so one
+          # py3-none wheel covers every interpreter.
+          only: cp312-manylinux_riscv64
+        env:
+          CIBW_MANYLINUX_RISCV64_IMAGE: ${{ env.MANYLINUX_RISCV64_IMAGE }}
+          CIBW_ENVIRONMENT: CMEEL_LOG_LEVEL=DEBUG CMEEL_RUN_TESTS=false
+          # cmeel installs into a shared prefix with an $ORIGIN RPATH it sets itself.
+          CIBW_REPAIR_WHEEL_COMMAND: ""
+
+      - name: Check wheel contents
+        run: |
+          python3 - wheelhouse/*.whl <<'EOF'
+          import sys, zipfile
+          names = zipfile.ZipFile(sys.argv[1]).namelist()
+          assert "cmeel.prefix/lib/liboctomap.so.1.10.0" in names, names
+          assert "cmeel.prefix/lib/liboctomath.so.1.10.0" in names, names
+          assert "cmeel.prefix/include/octomap/OcTree.h" in names, names
+          EOF
+
+      - name: Smoke-test the built library
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y -qq --no-install-recommends python3-venv
+          python3 -m venv .venv
+          . .venv/bin/activate
+          # gotcha 234: stock Ubuntu 24.04 apt pip (24.0) has zero manylinux_*_riscv64
+          # tags, so it rejects the riscv64 wheel outright without upgrading first.
+          pip install -q --upgrade pip
+          pip install -q wheelhouse/*.whl
+          prefix=$(python3 -c "import pathlib, sysconfig; print(pathlib.Path(sysconfig.get_paths()['purelib']) / 'cmeel.prefix')")
+          python3 -c "import ctypes; ctypes.CDLL('$prefix/lib/liboctomap.so')"
+          python3 - > scan.log <<'EOF'
+          import math
+          print("NODE 0 0 0 0 0 0")
+          for i in range(720):
+              a = i * math.pi / 360
+              for j in range(20):
+                  r = 2 + j * 0.1
+                  print(f"{r * math.cos(a):.4f} {r * math.sin(a):.4f} {(j - 10) * 0.05:.4f}")
+          EOF
+          # cmeel's patch gives the libraries an $ORIGIN RPATH but not the tools, as upstream ships them.
+          export LD_LIBRARY_PATH="$prefix/lib"
+          "$prefix/bin/log2graph" scan.log scan.graph
+          "$prefix/bin/graph2tree" -i scan.graph -o tree.bt
+          test -s tree.bt
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: cmeel-octomap-${{ env.CMEEL_OCTOMAP_VERSION }}-py3-none-manylinux_riscv64
+          path: wheelhouse/*.whl
+          if-no-files-found: error
+
+  publish:
+    name: Publish cmeel-octomap ${{ matrix.version }}
+    needs: [setup, build_wheels]
+    if: needs.setup.outputs.versions != '[]'
+    strategy:
+      fail-fast: false
+      matrix:
+        version: ${{ fromJSON(needs.setup.outputs.versions) }}
+    permissions:
+      contents: write
+      pull-requests: write
+    uses: $/.github/workflows/_publish-wheel.yml
+    secrets:
+      app-private-key: ${{ secrets.RISEPROJECT_APP_PRIVATE_KEY }}
+    with:
+      artifact-pattern: cmeel-octomap-${{ matrix.version }}-py3-none-manylinux_riscv64
diff --git a/docs/packages/cmeel-octomap.yaml b/docs/packages/cmeel-octomap.yaml
new file mode 100644
index 0000000000..a652167913
--- /dev/null
+++ b/docs/packages/cmeel-octomap.yaml
@@ -0,0 +1,5 @@
+package-name: cmeel-octomap
+source-code: https://github.com/cmake-wheel/cmeel-octomap.git
+license: BSD-3-Clause
+versions:
+- version: 1.10.0