Debian Codegraph @

.cargo/vendor/uuid/src/v3.rs

raw
1 use crate::Uuid;
2
3 impl Uuid {
4 /// Creates a UUID using a name from a namespace, based on the MD5
5 /// hash.
6 ///
7 /// A number of namespaces are available as constants in this crate:
8 ///
9 /// * [`NAMESPACE_DNS`]
10 /// * [`NAMESPACE_OID`]
11 /// * [`NAMESPACE_URL`]
12 /// * [`NAMESPACE_X500`]
13 ///
14 /// Note that usage of this method requires the `v3` feature of this crate
15 /// to be enabled.
16 ///
17 /// # Examples
18 ///
19 /// Generating a MD5 DNS UUID for `rust-lang.org`:
20 ///
21 /// ```
22 /// # use uuid::{Uuid, Version};
23 /// let uuid = Uuid::new_v3(&Uuid::NAMESPACE_DNS, b"rust-lang.org");
24 ///
25 /// assert_eq!(Some(Version::Md5), uuid.get_version());
26 /// ```
27 ///
28 /// # References
29 ///
30 /// * [Version 3 and 5 UUIDs in RFC4122](https://www.rfc-editor.org/rfc/rfc4122#section-4.3)
31 ///
32 /// [`NAMESPACE_DNS`]: #associatedconstant.NAMESPACE_DNS
33 /// [`NAMESPACE_OID`]: #associatedconstant.NAMESPACE_OID
34 /// [`NAMESPACE_URL`]: #associatedconstant.NAMESPACE_URL
35 /// [`NAMESPACE_X500`]: #associatedconstant.NAMESPACE_X500
36 pub fn new_v3(namespace: &Uuid, name: &[u8]) -> Uuid {
37 crate::Builder::from_md5_bytes(crate::md5::hash(namespace.as_bytes(), name)).into_uuid()
38 }
39 }
40
41 #[cfg(test)]
42 mod tests {
43 use super::*;
44
45 #[cfg(all(
46 target_arch = "wasm32",
47 target_vendor = "unknown",
48 target_os = "unknown"
49 ))]
50 use wasm_bindgen_test::*;
51
52 use crate::{std::string::ToString, Variant, Version};
53
54 static FIXTURE: &'static [(&'static Uuid, &'static str, &'static str)] = &[
55 (
56 &Uuid::NAMESPACE_DNS,
57 "example.org",
58 "04738bdf-b25a-3829-a801-b21a1d25095b",
59 ),
60 (
61 &Uuid::NAMESPACE_DNS,
62 "rust-lang.org",
63 "c6db027c-615c-3b4d-959e-1a917747ca5a",
64 ),
65 (
66 &Uuid::NAMESPACE_DNS,
67 "42",
68 "5aab6e0c-b7d3-379c-92e3-2bfbb5572511",
69 ),
70 (
71 &Uuid::NAMESPACE_DNS,
72 "lorem ipsum",
73 "4f8772e9-b59c-3cc9-91a9-5c823df27281",
74 ),
75 (
76 &Uuid::NAMESPACE_URL,
77 "example.org",
78 "39682ca1-9168-3da2-a1bb-f4dbcde99bf9",
79 ),
80 (
81 &Uuid::NAMESPACE_URL,
82 "rust-lang.org",
83 "7ed45aaf-e75b-3130-8e33-ee4d9253b19f",
84 ),
85 (
86 &Uuid::NAMESPACE_URL,
87 "42",
88 "08998a0c-fcf4-34a9-b444-f2bfc15731dc",
89 ),
90 (
91 &Uuid::NAMESPACE_URL,
92 "lorem ipsum",
93 "e55ad2e6-fb89-34e8-b012-c5dde3cd67f0",
94 ),
95 (
96 &Uuid::NAMESPACE_OID,
97 "example.org",
98 "f14eec63-2812-3110-ad06-1625e5a4a5b2",
99 ),
100 (
101 &Uuid::NAMESPACE_OID,
102 "rust-lang.org",
103 "6506a0ec-4d79-3e18-8c2b-f2b6b34f2b6d",
104 ),
105 (
106 &Uuid::NAMESPACE_OID,
107 "42",
108 "ce6925a5-2cd7-327b-ab1c-4b375ac044e4",
109 ),
110 (
111 &Uuid::NAMESPACE_OID,
112 "lorem ipsum",
113 "5dd8654f-76ba-3d47-bc2e-4d6d3a78cb09",
114 ),
115 (
116 &Uuid::NAMESPACE_X500,
117 "example.org",
118 "64606f3f-bd63-363e-b946-fca13611b6f7",
119 ),
120 (
121 &Uuid::NAMESPACE_X500,
122 "rust-lang.org",
123 "bcee7a9c-52f1-30c6-a3cc-8c72ba634990",
124 ),
125 (
126 &Uuid::NAMESPACE_X500,
127 "42",
128 "c1073fa2-d4a6-3104-b21d-7a6bdcf39a23",
129 ),
130 (
131 &Uuid::NAMESPACE_X500,
132 "lorem ipsum",
133 "02f09a3f-1624-3b1d-8409-44eff7708208",
134 ),
135 ];
136
137 #[test]
138 #[cfg_attr(
139 all(
140 target_arch = "wasm32",
141 target_vendor = "unknown",
142 target_os = "unknown"
143 ),
144 wasm_bindgen_test
145 )]
146 fn test_new() {
147 for &(ref ns, ref name, _) in FIXTURE {
148 let uuid = Uuid::new_v3(*ns, name.as_bytes());
149 assert_eq!(uuid.get_version(), Some(Version::Md5));
150 assert_eq!(uuid.get_variant(), Variant::RFC4122);
151 }
152 }
153
154 #[test]
155 #[cfg_attr(
156 all(
157 target_arch = "wasm32",
158 target_vendor = "unknown",
159 target_os = "unknown"
160 ),
161 wasm_bindgen_test
162 )]
163 fn test_hyphenated_string() {
164 for &(ref ns, ref name, ref expected) in FIXTURE {
165 let uuid = Uuid::new_v3(*ns, name.as_bytes());
166 assert_eq!(uuid.hyphenated().to_string(), *expected);
167 }
168 }
169 }