swmm-toolkit: Add version 0.17.0 (#3043)

* Port swmm-toolkit 0.17.0 to riscv64

PySWMM's SWIG/CFFI wrapper over EPA SWMM (OpenWaterAnalytics fork,
MIT-licensed, vendored as a git submodule). scikit-build-core + CMake +
SWIG, single abi3 wheel built on the cp39 floor (py-api = "cp39" in
pyproject.toml) and retested on cp312/cp313/cp314, mirroring upstream's
own build_wheel.yml CIBW_SKIP of free-threaded variants. Two patches:
lower the swig build requirement to 4.3.1 (the version this registry
already hosts for riscv64; $action has worked since SWIG 2001, so the
project's own .i files are unaffected) and bundle the vendored
swmm-solver submodule's MIT LICENSE, which upstream's own license-files
list omits.

* swmm-toolkit: pin swig to <4.4.0, not just >=4.3.1

PyPI started shipping a native riscv64 wheel for swig 4.5.1, so the
unbounded floor let pip pick that over our registry's 4.3.1, and SWIG
4.5's removed PyInt_*/PyString_* macros broke the generated wrapper.

Author: luhenry

.github/workflows/build-swmm-toolkit.yml

@@ -0,0 +1,118 @@
+# SPDX-FileCopyrightText: 2026 The RISE Project
+# SPDX-License-Identifier: MIT
+---
+# Based on the `build_wheels` job of
+# https://github.com/pyswmm/swmm-python/blob/v0.17.0/.github/workflows/build_wheel.yml
+name: Build swmm-toolkit wheels (riscv64)
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version glob to (re)build; empty builds every version of docs/packages/swmm-toolkit.yaml not released yet'
+        required: false
+        default: ''
+  pull_request:
+    branches: [main]
+    paths:
+      - '.github/workflows/build-swmm-toolkit.yml'
+      - 'docs/packages/swmm-toolkit.yaml'
+      - 'patches/swmm-toolkit/**'
+  push:
+    branches: [main]
+    paths:
+      - '.github/workflows/build-swmm-toolkit.yml'
+      - 'docs/packages/swmm-toolkit.yaml'
+      - 'patches/swmm-toolkit/**'
+
+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: swmm-toolkit
+      version: ${{ inputs.version }}
+
+  build_wheels:
+    needs: [setup]
+    if: needs.setup.outputs.versions != '[]'
+    name: Build swmm-toolkit ${{ matrix.version }} cp39-abi3-manylinux_riscv64
+    runs-on: ubuntu-24.04-riscv
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix:
+        version: ${{ fromJSON(needs.setup.outputs.versions) }}
+
+    env:
+      SWMM_TOOLKIT_VERSION: ${{ matrix.version }}
+
+    steps:
+      - name: Checkout pyswmm/swmm-python v${{ env.SWMM_TOOLKIT_VERSION }}
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          repository: pyswmm/swmm-python
+          ref: v${{ env.SWMM_TOOLKIT_VERSION }}
+          submodules: recursive
+          persist-credentials: false
+
+      - name: Checkout python-wheels
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          path: python-wheels
+          persist-credentials: false
+
+      # swig>=4.4.0 has no riscv64 build anywhere; swmm-toolkit's own .i files
+      # only need $action, which works on the 4.3.1 we do have (see the patch).
+      # license-files never names the statically-linked swmm-solver submodule's
+      # own MIT LICENSE.
+      - name: Patch swmm-toolkit source
+        run: git apply python-wheels/patches/swmm-toolkit/${{ env.SWMM_TOOLKIT_VERSION }}/00*.patch
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@1828c10ab37f080699c7b81cea34097c684a7074  # v4.2.0
+        with:
+          package-dir: swmm-toolkit
+          output-dir: wheelhouse/
+        env:
+          CIBW_ARCHS: riscv64
+          CIBW_BUILD: cp39-manylinux_riscv64 cp312-manylinux_riscv64 cp313-manylinux_riscv64 cp314-manylinux_riscv64
+          CIBW_MANYLINUX_RISCV64_IMAGE: ${{ env.MANYLINUX_RISCV64_IMAGE }}
+          CIBW_BEFORE_BUILD_LINUX: rm -f $(which swig) && rm -f $(which swig4.0)
+          CIBW_ENVIRONMENT: PIP_EXTRA_INDEX_URL=https://pypi.riseproject.dev/simple/
+          CIBW_BEFORE_TEST: pip install -r {package}/test-requirements.txt
+          CIBW_TEST_COMMAND: >-
+            python -c "import importlib.metadata as m; l = sorted(str(p).split('licenses/', 1)[1] for p in m.files('swmm-toolkit') if 'licenses/' in str(p)); assert 'swmm-solver/LICENSE' in l, l"
+            && pytest {package}/tests
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
+        with:
+          name: swmm-toolkit-${{ env.SWMM_TOOLKIT_VERSION }}-cp39-abi3-manylinux_riscv64
+          path: wheelhouse/*.whl
+          if-no-files-found: error
+
+  publish:
+    name: Publish swmm-toolkit ${{ 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: swmm-toolkit-${{ matrix.version }}-*-manylinux_riscv64

docs/packages/swmm-toolkit.yaml

@@ -0,0 +1,5 @@
+package-name: swmm-toolkit
+source-code: https://github.com/pyswmm/swmm-python
+license: CC0-1.0 AND (MIT OR Apache-2.0)
+versions:
+- version: 0.17.0

patches/swmm-toolkit/0.17.0/0001-lower-the-swig-build-floor-to-4.3.1-for-riscv64.patch

@@ -0,0 +1,41 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Ludovic Henry <git@ludovic.dev>
+Date: Tue, 13 Oct 2026 10:53:44 +0000
+Subject: [PATCH] pin the swig build dependency to 4.3.1 for riscv64
+
+Upstream-Status: Inappropriate [riscv64 build portability]
+
+pyproject.toml pins swig>=4.4.0 only because that is the version upstream
+happened to be on when it replaced the removed $function exception
+variable with $action (SWIG CHANGES, 2025-06-09: "$action (added in
+2001) ... has exactly the same value"). $action has worked since SWIG
+2001, so the project's own .i files (already migrated to $action in this
+release) build identically against an older SWIG that still recognizes it.
+
+pypi.riseproject.dev hosts swig 4.3.1 for riscv64. An unbounded floor of
+>=4.3.1 is not enough: PyPI itself now publishes a native riscv64 wheel
+for swig 4.5.1 (swig-4.5.1-py3-none-manylinux_2_31_riscv64.whl), and
+since CIBW_ENVIRONMENT only adds our registry via PIP_EXTRA_INDEX_URL
+(PyPI stays the default index), pip picks the newest version satisfying
+the constraint across both indexes -- 4.5.1, not our 4.3.1. SWIG 4.5
+dropped the PyInt_*/PyString_* Python-2 compatibility macros that
+outputPYTHON_wrap.c (SWIG-generated, not hand-written) still calls, so
+the build fails with "implicit declaration of function 'PyInt_FromLong'".
+An explicit upper bound keeps pip on the 4.3.1 we can actually supply.
+
+Signed-off-by: Ludovic Henry <git@ludovic.dev>
+---
+ swmm-toolkit/pyproject.toml | 2 +-
+ 1 file changed, 1 insertion(+), 1 deletion(-)
+
+diff --git a/swmm-toolkit/pyproject.toml b/swmm-toolkit/pyproject.toml
+index 564d84a..48c313b 100644
+--- a/swmm-toolkit/pyproject.toml
++++ b/swmm-toolkit/pyproject.toml
+@@ -1,5 +1,5 @@
+ [build-system]
+-requires = ["swig>=4.4.0", "scikit-build-core>=0.4.3"]
++requires = ["swig>=4.3.1,<4.4.0", "scikit-build-core>=0.4.3"]
+ build-backend = "scikit_build_core.build"
+
+ [project]

patches/swmm-toolkit/0.17.0/0002-bundle-the-vendored-swmm-solver-LICENSE-in-the-wheel.patch

@@ -0,0 +1,32 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Ludovic Henry <git@ludovic.dev>
+Date: Tue, 13 Oct 2026 10:53:51 +0000
+Subject: [PATCH] bundle the vendored swmm-solver LICENSE in the wheel
+
+Upstream-Status: To upstream [not yet submitted; the same gap exists in every swmm-toolkit wheel on PyPI, so this needs a maintainer discussion rather than a drive-by PR]
+
+The wheel statically links the swmm-solver git submodule
+(OpenWaterAnalytics/Stormwater-Management-Model, MIT), but license-files
+never lists its LICENSE file, so it never reaches
+*.dist-info/licenses/ and the built wheel ships only swmm-toolkit's own
+CC0/openmp notices. Add it so the MIT notice travels with the binary that
+statically embeds its code.
+
+Signed-off-by: Ludovic Henry <git@ludovic.dev>
+---
+ swmm-toolkit/pyproject.toml | 2 +-
+ 1 file changed, 1 insertion(+), 1 deletion(-)
+
+diff --git a/swmm-toolkit/pyproject.toml b/swmm-toolkit/pyproject.toml
+index 48c313b..e93562d 100644
+--- a/swmm-toolkit/pyproject.toml
++++ b/swmm-toolkit/pyproject.toml
+@@ -8,7 +8,7 @@ version = "0.17.0"
+ description = "PySWMM SWMM Python Toolkit"
+ readme = { file = "README.md", content-type = "text/markdown" }
+ license = "CC0-1.0 AND (MIT OR Apache-2.0)"
+-license-files = ["LICEN[CS]E*", "AUTHORS", "extern/openmp.LICENSE"]
++license-files = ["LICEN[CS]E*", "AUTHORS", "extern/openmp.LICENSE", "swmm-solver/LICENSE"]
+ authors = [{ name = "See AUTHORS" }]
+ maintainers = [{ email = "bemcdonnell@gmail.com" }]
+ keywords = ["swmm5", "swmm", "stormwater", "hydraulics", "hydrology"]