Adding upstream version 115.7.0esr.upstream/115.7.0esr

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 63 insertions, 0 deletions

diff --git a/third_party/rust/uuid/src/v4.rs b/third_party/rust/uuid/src/v4.rs
new file mode 100644
index 0000000000..e78fb1e69a
--- /dev/null
+++ b/third_party/rust/uuid/src/v4.rs
@@ -0,0 +1,63 @@
+use crate::Uuid;
+
+impl Uuid {
+    /// Creates a random UUID.
+    ///
+    /// This uses the [`getrandom`] crate to utilise the operating system's RNG
+    /// as the source of random numbers. If you'd like to use a custom
+    /// generator, don't use this method: generate random bytes using your
+    /// custom generator and pass them to the
+    /// [`uuid::Builder::from_random_bytes`][from_random_bytes] function
+    /// instead.
+    ///
+    /// Note that usage of this method requires the `v4` feature of this crate
+    /// to be enabled.
+    ///
+    /// # Examples
+    ///
+    /// Basic usage:
+    ///
+    /// ```
+    /// # use uuid::{Uuid, Version};
+    /// let uuid = Uuid::new_v4();
+    ///
+    /// assert_eq!(Some(Version::Random), uuid.get_version());
+    /// ```
+    ///
+    /// # References
+    ///
+    /// * [Version 4 UUIDs in RFC4122](https://www.rfc-editor.org/rfc/rfc4122#section-4.4)
+    ///
+    /// [`getrandom`]: https://crates.io/crates/getrandom
+    /// [from_random_bytes]: struct.Builder.html#method.from_random_bytes
+    pub fn new_v4() -> Uuid {
+        crate::Builder::from_random_bytes(crate::rng::bytes()).into_uuid()
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::{Variant, Version};
+
+    #[cfg(target_arch = "wasm32")]
+    use wasm_bindgen_test::*;
+
+    #[test]
+    #[cfg_attr(target_arch = "wasm32", wasm_bindgen_test)]
+    fn test_new() {
+        let uuid = Uuid::new_v4();
+
+        assert_eq!(uuid.get_version(), Some(Version::Random));
+        assert_eq!(uuid.get_variant(), Variant::RFC4122);
+    }
+
+    #[test]
+    #[cfg_attr(target_arch = "wasm32", wasm_bindgen_test)]
+    fn test_get_version() {
+        let uuid = Uuid::new_v4();
+
+        assert_eq!(uuid.get_version(), Some(Version::Random));
+        assert_eq!(uuid.get_version_num(), 4)
+    }
+}