Introduce Rust bindings (#2221)

* add Rust bindings

* clang-format

* pre-commit fix

* windows static builds

* Rust prefers MD on windows

* check in lock file to avoid source poisoning

* use a rust crate name that isn't taken

* add CMake target for running Rust binding tests and integrate into CI

* complete crate rename

* enable test dependency downloads in Rust bindings CI

Author: dmah42

.github/workflows/test_bindings.yml

@@ -14,7 +14,7 @@ permissions:
 
 jobs:
   python_bindings:
-    name: Test GBM Python ${{ matrix.python-version }} bindings on ${{ matrix.os }}
+    name: Test Python ${{ matrix.python-version }} bindings on ${{ matrix.os }}
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
@@ -30,7 +30,31 @@ jobs:
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
         with:
           python-version: ${{ matrix.python-version }}
-      - name: Install GBM Python bindings on ${{ matrix.os }}
+      - name: Install Python bindings on ${{ matrix.os }}
         run: python -m pip install .
       - name: Run example on ${{ matrix.os }} under Python ${{ matrix.python-version }}
         run: python bindings/python/google_benchmark/example.py
+
+  rust_bindings:
+    name: Test Rust bindings on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ ubuntu-latest, macos-latest, windows-latest ]
+    steps:
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          fetch-depth: 0
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+      - name: Install Ninja (macOS)
+        if: runner.os == 'macOS'
+        run: brew install ninja
+      - name: Run Rust tests natively via Cargo
+        run: cargo test
+        working-directory: bindings/rust
+      - name: Run Rust tests via CMake target
+        run: |
+          cmake -S . -B build -DBENCHMARK_ENABLE_RUST_BINDINGS=ON -DBENCHMARK_DOWNLOAD_DEPENDENCIES=ON
+          cmake --build build --target test_rust_bindings

.gitignore

@@ -67,3 +67,6 @@ CMakeSettings.json
 dist/
 *.egg-info*
 uv.lock
+
+# Rust build stuff
+/bindings/rust/target/

CMakeLists.txt

@@ -41,6 +41,7 @@ option(BENCHMARK_ENABLE_GTEST_TESTS "Enable building the unit tests which depend
 option(BENCHMARK_USE_BUNDLED_GTEST "Use bundled GoogleTest. If disabled, the find_package(GTest) will be used." ON)
 
 option(BENCHMARK_ENABLE_LIBPFM "Enable performance counters provided by libpfm" OFF)
+option(BENCHMARK_ENABLE_RUST_BINDINGS "Enable testing of the Rust bindings" OFF)
 
 # Export only public symbols
 set(CMAKE_CXX_VISIBILITY_PRESET hidden)

bindings/rust/Cargo.lock

@@ -0,0 +1,13 @@
+[package]
+name = "google-benchmark-rs"
+version = "1.9.5"
+edition = "2021"
+description = "Rust bindings for google/benchmark"
+license = "Apache-2.0"
+
+[dependencies]
+cxx = "1.0"
+
+[build-dependencies]
+cmake = "0.1"
+cxx-build = "1.0"