use crate::prelude::*; 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_bytes`][from_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; /// /// let uuid = Uuid::new_v4(); /// ``` /// /// [`getrandom`]: https://crates.io/crates/getrandom /// [from_bytes]: struct.Builder.html#method.from_bytes pub fn new_v4() -> Uuid { let mut bytes = [0u8; 16]; getrandom::getrandom(&mut bytes).unwrap_or_else(|err| { // NB: getrandom::Error has no source; this is adequate display panic!("could not retreive random bytes for uuid: {}", err) }); crate::Builder::from_bytes(bytes) .set_variant(Variant::RFC4122) .set_version(Version::Random) .build() } } #[cfg(test)] mod tests { use crate::prelude::*; #[test] fn test_new() { let uuid = Uuid::new_v4(); assert_eq!(uuid.get_version(), Some(Version::Random)); assert_eq!(uuid.get_variant(), Some(Variant::RFC4122)); } #[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) } }