1 | use crate::Uuid; |
2 | |
3 | impl Uuid { |
4 | /// Creates a random UUID. |
5 | /// |
6 | /// This uses the [`getrandom`] crate to utilise the operating system's RNG |
7 | /// as the source of random numbers. If you'd like to use a custom |
8 | /// generator, don't use this method: generate random bytes using your |
9 | /// custom generator and pass them to the |
10 | /// [`uuid::Builder::from_random_bytes`][from_random_bytes] function |
11 | /// instead. |
12 | /// |
13 | /// Note that usage of this method requires the `v4` feature of this crate |
14 | /// to be enabled. |
15 | /// |
16 | /// # Examples |
17 | /// |
18 | /// Basic usage: |
19 | /// |
20 | /// ``` |
21 | /// # use uuid::{Uuid, Version}; |
22 | /// let uuid = Uuid::new_v4(); |
23 | /// |
24 | /// assert_eq!(Some(Version::Random), uuid.get_version()); |
25 | /// ``` |
26 | /// |
27 | /// # References |
28 | /// |
29 | /// * [Version 4 UUIDs in RFC4122](https://www.rfc-editor.org/rfc/rfc4122#section-4.4) |
30 | /// |
31 | /// [`getrandom`]: https://crates.io/crates/getrandom |
32 | /// [from_random_bytes]: struct.Builder.html#method.from_random_bytes |
33 | pub fn new_v4() -> Uuid { |
34 | crate::Builder::from_random_bytes(crate::rng::bytes()).into_uuid() |
35 | } |
36 | } |
37 | |
38 | #[cfg (test)] |
39 | mod tests { |
40 | use super::*; |
41 | use crate::{Variant, Version}; |
42 | |
43 | #[cfg (all( |
44 | target_arch = "wasm32" , |
45 | target_vendor = "unknown" , |
46 | target_os = "unknown" |
47 | ))] |
48 | use wasm_bindgen_test::*; |
49 | |
50 | #[test ] |
51 | #[cfg_attr ( |
52 | all( |
53 | target_arch = "wasm32" , |
54 | target_vendor = "unknown" , |
55 | target_os = "unknown" |
56 | ), |
57 | wasm_bindgen_test |
58 | )] |
59 | fn test_new() { |
60 | let uuid = Uuid::new_v4(); |
61 | |
62 | assert_eq!(uuid.get_version(), Some(Version::Random)); |
63 | assert_eq!(uuid.get_variant(), Variant::RFC4122); |
64 | } |
65 | |
66 | #[test ] |
67 | #[cfg_attr ( |
68 | all( |
69 | target_arch = "wasm32" , |
70 | target_vendor = "unknown" , |
71 | target_os = "unknown" |
72 | ), |
73 | wasm_bindgen_test |
74 | )] |
75 | fn test_get_version() { |
76 | let uuid = Uuid::new_v4(); |
77 | |
78 | assert_eq!(uuid.get_version(), Some(Version::Random)); |
79 | assert_eq!(uuid.get_version_num(), 4) |
80 | } |
81 | } |
82 | |