Merge branch 'main' into vrongmeal/upgrade-proto

.github/workflows/ci.yml

@@ -64,6 +64,13 @@ jobs:
         with:
           crate: cargo-sort
           version: "^1.0"
+      - name: check proto build up-to-date
+        run: |
+          cargo build --features prost-build
+          git diff --exit-code src/api.rs && echo "Up-to-date" || {
+              echo "Not up-to-date"
+              exit 1
+          }
       - name: check documentation
         env:
           RUSTDOCFLAGS: -D warnings

Cargo.toml

@@ -18,6 +18,7 @@ hyper = "1.5.0"
 hyper-util = "0.1.10"
 prost = "0.13.3"
 prost-types = "0.13.3"
+rand = "0.8.5"
 regex = "1.11.1"
 secrecy = "0.8.0"
 sync_docs = "0.2.0"

src/types.rs

@@ -3,6 +3,7 @@
 use std::{ops::Deref, str::FromStr, sync::OnceLock, time::Duration};
 
 use bytes::Bytes;
+use rand::{distributions::Uniform, Rng};
 use regex::Regex;
 use sync_docs::sync_docs;
 
@@ -849,6 +850,16 @@ impl FencingToken {
             Ok(Self(bytes))
         }
     }
+
+    /// Generate a random fencing token with `n` bytes.
+    pub fn generate(n: usize) -> Result<Self, ConvertError> {
+        Self::new(
+            rand::thread_rng()
+                .sample_iter(&Uniform::new_inclusive(0, u8::MAX))
+                .take(n)
+                .collect::<Bytes>(),
+        )
+    }
 }
 
 impl AsRef<Bytes> for FencingToken {