Add Rust to the CI suite

Signed-off-by: Scott Wilson <scott@propersquid.com>

Author: scott-wilson

.github/workflows/build-steps.yml

@@ -66,6 +66,8 @@ on:
         type: string
       nametag:
         type: string
+      rust:
+        type: string
     secrets:
         PASSED_GITHUB_TOKEN:
           required: false
@@ -149,6 +151,13 @@ jobs:
         if: inputs.clang_format == '1'
         shell: bash
         run: src/build-scripts/run-clang-format.bash
+      - name: Rust Install Toolchain
+        if: inputs.rust == '1'
+        uses: dtolnay/rust-toolchain@4305c38b25d97ef35a8ad1f985ccf2d2242004f2 # stable
+      - name: Rust Test
+        if: inputs.rust == '1'
+        shell: bash
+        run: src/build-scripts/ci-rust-test.bash
       - name: Code coverage
         if: inputs.coverage == '1'
         run: src/build-scripts/ci-coverage.bash

.github/workflows/ci.yml

@@ -274,6 +274,7 @@ jobs:
       ctest_test_timeout: ${{ matrix.ctest_test_timeout }}
       coverage: ${{ matrix.coverage || 0 }}
       sonar: ${{ matrix.sonar || 0 }}
+      rust: ${{ matrix.rust || 0 }}
     strategy:
       fail-fast: false
       matrix:
@@ -287,6 +288,7 @@ jobs:
             fmt_ver: 10.1.1
             pybind11_ver: v2.10.0
             setenvs: PUGIXML_VERSION=v1.13
+            rust: 1
           - desc: VFX2023 icc/C++17 py3.10 exr3.1 ocio2.1 qt5.15
             nametag: linux-vfx2023.icc
             runner: ubuntu-latest
@@ -301,6 +303,7 @@ jobs:
                             OIIO_EXTRA_CPP_ARGS="-fp-model=precise"
                             FREETYPE_VERSION=VER-2-13-0
                             DISABLE_libuhdr=1
+            rust: 1
             # For icc, use fp-model precise to eliminate needless LSB errors
             # that make test results differ from other platforms.
           - desc: VFX2023 icx/C++17 py3.10 exr3.1 ocio2.2 qt5.15
@@ -316,6 +319,7 @@ jobs:
                             xOPENCOLORIO_CXX=g++
                             UHDR_CMAKE_C_COMPILER=gcc
                             UHDR_CMAKE_CXX_COMPILER=g++
+            rust: 1
             # Building libuhdr with icx results in test failures
             # so we force using gcc/g++.
           - desc: VFX2024 gcc11/C++17 py3.11 exr3.2 ocio2.3
@@ -327,6 +331,7 @@ jobs:
             fmt_ver: 10.1.1
             pybind11_ver: v2.12.0
             setenvs: PUGIXML_VERSION=v1.14
+            rust: 1
           - desc: VFX2024 clang/C++17 py3.11 exr3.2 ocio2.3
             nametag: linux-vfx2024.clang
             runner: ubuntu-latest
@@ -338,6 +343,7 @@ jobs:
             fmt_ver: 10.1.1
             pybind11_ver: v2.12.0
             setenvs: PUGIXML_VERSION=v1.14
+            rust: 1
           - desc: VFX2025 gcc11/C++17 py3.11 exr3.3 ocio2.4
             nametag: linux-vfx2025
             runner: ubuntu-latest
@@ -347,6 +353,7 @@ jobs:
             fmt_ver: 11.1.4
             pybind11_ver: v2.13.6
             setenvs: PUGIXML_VERSION=v1.15
+            rust: 1
           - desc: Sanitizers
             nametag: sanitizer
             runner: ubuntu-latest
@@ -419,6 +426,7 @@ jobs:
                             WEBP_VERSION=v1.5.0
                             FREETYPE_VERSION=VER-2-13-3
                             USE_OPENVDB=0
+            rust: 1
           - desc: bleeding edge gcc14 C++20 py3.12 OCIO/libtiff/exr-main avx2
             nametag: linux-bleeding-edge
             runner: ubuntu-24.04
@@ -431,6 +439,7 @@ jobs:
             pybind11_ver: master
             python_ver: "3.12"
             simd: avx2,f16c
+            rust: 1
             setenvs: export LIBJPEGTURBO_VERSION=main
                             LIBRAW_VERSION=master
                             LIBTIFF_VERSION=master
@@ -445,7 +454,7 @@ jobs:
                             FREETYPE_VERSION=master
                             QT_VERSION=0 INSTALL_OPENCV=0
                             # The installed OpenVDB has a TLS conflict with Python 3.8
-                            # Disabling the `apt-get update` in gh-installdeps.bash 
+                            # Disabling the `apt-get update` in gh-installdeps.bash
                             # addresses a job killing problem in the GHA Ubuntu
                             # 24.04 runners that cropped up circa May 29 2024. Maybe
                             # it will be fixed and we can do the update again later?
@@ -464,6 +473,7 @@ jobs:
                             PTEX_VERSION=v2.4.2
                             PUGIXML_VERSION=v1.14
                             WEBP_VERSION=v1.4.0
+            rust: 1
 
           - desc: clang15 C++17 avx2 exr3.1 ocio2.2
             nametag: linux-clang14
@@ -477,6 +487,7 @@ jobs:
             pybind11_ver: v2.12.0
             python_ver: "3.10"
             simd: avx2,f16c
+            rust: 1
           - desc: debug gcc9/C++17, sse4.2, exr3.1
             nametag: linux-gcc9-cpp17-debug
             runner: ubuntu-22.04
@@ -489,6 +500,7 @@ jobs:
             pybind11_ver: v2.7.0
             ctest_test_timeout: 1200
             setenvs: export PUGIXML_VERSION=v1.9
+            rust: 1
           - desc: static libs gcc9 C++17 exr3.1
             nametag: linux-static
             runner: ubuntu-22.04
@@ -501,6 +513,7 @@ jobs:
             depcmds: |
               sudo rm -rf /usr/local/include/OpenEXR
               sudo rm -rf /usr/local/lib64/cmake/{IlmBase,OpenEXR}
+            rust: 1
 
 
   #
@@ -536,6 +549,7 @@ jobs:
       ctest_test_timeout: ${{ matrix.ctest_test_timeout || '800' }}
       coverage: ${{ matrix.coverage || 0 }}
       sonar: ${{ matrix.sonar || 0 }}
+      rust: ${{ matrix.rust || 0 }}
     strategy:
       fail-fast: false
       matrix:
@@ -550,20 +564,23 @@ jobs:
             simd: sse4.2,avx2
             ctest_test_timeout: 1200
             setenvs: export MACOSX_DEPLOYMENT_TARGET=12.0
+            rust: 1
           - desc: MacOS-14-ARM aclang15/C++20/py3.12
             runner: macos-14
             nametag: macos14-arm-py312
             cc_compiler: clang
             cxx_compiler: clang++
             cxx_std: 20
             python_ver: "3.12"
+            rust: 1
           - desc: MacOS-15-ARM aclang16/C++20/py3.13
             runner: macos-15
             nametag: macos15-arm-py313
             cc_compiler: clang
             cxx_compiler: clang++
             cxx_std: 20
             python_ver: "3.13"
+            rust: 1
 
 
   #
@@ -599,6 +616,7 @@ jobs:
       ctest_test_timeout: ${{ matrix.ctest_test_timeout }}
       coverage: ${{ matrix.coverage || 0 }}
       sonar: ${{ matrix.sonar || 0 }}
+      rust: ${{ matrix.rust || 0 }}
     strategy:
       fail-fast: false
       matrix:
@@ -610,23 +628,27 @@ jobs:
             generator: "Visual Studio 16 2019"
             python_ver: "3.9"
             setenvs: export OPENIMAGEIO_PYTHON_LOAD_DLLS_FROM_PATH=1
+            rust: 1
           - desc: Windows-2022 VS2022
             runner: windows-2022
             nametag: windows-2022
             vsver: 2022
             generator: "Visual Studio 17 2022"
             python_ver: "3.9"
             setenvs: export OPENIMAGEIO_PYTHON_LOAD_DLLS_FROM_PATH=1
+            rust: 1
           - desc: Windows-2025 VS2022
             runner: windows-2025
             nametag: windows-2025
             vsver: 2022
             generator: "Visual Studio 17 2022"
             python_ver: "3.9"
             setenvs: export OPENIMAGEIO_PYTHON_LOAD_DLLS_FROM_PATH=1
+            rust: 1
           - desc: Windows-2025 VS2022
             runner: windows-2025
             vsver: 2022
             generator: "Visual Studio 17 2022"
             python_ver: "3.9"
             setenvs: export OPENIMAGEIO_PYTHON_LOAD_DLLS_FROM_PATH=1
+            rust: 1

src/build-scripts/ci-rust-test.bash

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+# Copyright Contributors to the OpenImageIO project.
+# SPDX-License-Identifier: Apache-2.0
+# https://github.com/AcademySoftwareFoundation/OpenImageIO
+
+# Important: set -ex causes this whole script to terminate with error if
+# any command in it fails. This is crucial for CI tests.
+# (Though we let it run all the way through for code coverage workflows.)
+if [[ "${CODECOV}" == "" ]]; then
+    set -ex
+fi
+
+export LD_LIBRARY_PATH=$OpenImageIO_ROOT/lib
+export PKG_CONFIG_PATH=$OpenImageIO_ROOT/lib/pkgconfig
+
+echo "Running Rust oiio-sys tests"
+
+pushd src/rust/oiio-sys
+time cargo test --all-features
+popd
+
+echo "Running Rust oiio tests"
+
+pushd src/rust
+time cargo test --all-features
+popd