@@ -179,8 +179,6 @@ The :mod:`uuid` module defines the following functions:
179179 administered MAC addresses, since the former are guaranteed to be
180180 globally unique, while the latter are not.
181181
182- .. index :: single: getnode
183-
184182
185183.. function :: uuid1(node=None, clock_seq=None)
186184
@@ -189,32 +187,38 @@ The :mod:`uuid` module defines the following functions:
189187 *clock_seq * is given, it is used as the sequence number; otherwise a random
190188 14-bit sequence number is chosen.
191189
192- .. index :: single: uuid1
193-
194190
195191.. function :: uuid3(namespace, name)
196192
197193 Generate a UUID based on the MD5 hash of a namespace identifier (which is a
198194 UUID) and a name (which is a :class: `bytes ` object or a string
199195 that will be encoded using UTF-8).
200196
201- .. index :: single: uuid3
202-
203197
204198.. function :: uuid4()
205199
206200 Generate a random UUID.
207201
208- .. index :: single: uuid4
209-
210202
211203.. function :: uuid5(namespace, name)
212204
213205 Generate a UUID based on the SHA-1 hash of a namespace identifier (which is a
214206 UUID) and a name (which is a :class: `bytes ` object or a string
215207 that will be encoded using UTF-8).
216208
217- .. index :: single: uuid5
209+ .. function :: uuid8(a=None, b=None, c=None)
210+
211+ Generate a pseudo-random UUID according to
212+ :rfc: `RFC 9562, §5.8 <9562#section-5.8 >`.
213+
214+ When specified, the parameters *a *, *b * and *c * are expected to be
215+ positive integers of 48, 12 and 62 bits respectively. If they exceed
216+ their expected bit count, only their least significant bits are kept;
217+ non-specified arguments are substituted for a pseudo-random integer of
218+ appropriate size.
219+
220+ .. versionadded :: 3.14
221+
218222
219223The :mod: `uuid ` module defines the following namespace identifiers for use with
220224:func: `uuid3 ` or :func: `uuid5 `.
0 commit comments