1- :mod: `!uuid ` --- UUID objects according to :rfc: `4122 `
1+ :mod: `!uuid ` --- UUID objects according to :rfc: `9562 `
22======================================================
33
44.. module :: uuid
5- :synopsis: UUID objects (universally unique identifiers) according to RFC 4122
5+ :synopsis: UUID objects (universally unique identifiers) according to RFC 9562
66..
moduleauthor ::
Ka-Ping Yee <[email protected] > 77..
sectionauthor ::
George Yoshida <[email protected] > 88
1212
1313This module provides immutable :class: `UUID ` objects (the :class: `UUID ` class)
1414and the functions :func: `uuid1 `, :func: `uuid3 `, :func: `uuid4 `, :func: `uuid5 ` for
15- generating version 1, 3, 4, 5, and 8 UUIDs as specified in :rfc: `4122 `.
15+ generating version 1, 3, 4, 5, and 8 UUIDs as specified in :rfc: `9562 `.
1616
1717If all you want is a unique ID, you should probably call :func: `uuid1 ` or
1818:func: `uuid4 `. Note that :func: `uuid1 ` may compromise privacy since it creates
@@ -65,7 +65,7 @@ which relays any information about the UUID's safety, using this enumeration:
6565
6666 Exactly one of *hex *, *bytes *, *bytes_le *, *fields *, or *int * must be given.
6767 The *version * argument is optional; if given, the resulting UUID will have its
68- variant and version number set according to :rfc: `4122 `, overriding bits in the
68+ variant and version number set according to :rfc: `9562 `, overriding bits in the
6969 given *hex *, *bytes *, *bytes_le *, *fields *, or *int *.
7070
7171 Comparison of UUID objects are made by way of comparing their
@@ -137,7 +137,7 @@ which relays any information about the UUID's safety, using this enumeration:
137137
138138.. attribute :: UUID.urn
139139
140- The UUID as a URN as specified in :rfc: `4122 `.
140+ The UUID as a URN as specified in :rfc: `9562 `.
141141
142142
143143.. attribute :: UUID.variant
@@ -172,7 +172,7 @@ The :mod:`uuid` module defines the following functions:
172172 runs, it may launch a separate program, which could be quite slow. If all
173173 attempts to obtain the hardware address fail, we choose a random 48-bit
174174 number with the multicast bit (least significant bit of the first octet)
175- set to 1 as recommended in :rfc: `4122 `. "Hardware address" means the MAC
175+ set to 1 as recommended in :rfc: `9562 `. "Hardware address" means the MAC
176176 address of a network interface. On a machine with multiple network
177177 interfaces, universally administered MAC addresses (i.e. where the second
178178 least significant bit of the first octet is *unset *) will be preferred over
@@ -266,7 +266,9 @@ of the :attr:`~UUID.variant` attribute:
266266
267267.. data :: RFC_4122
268268
269- Specifies the UUID layout given in :rfc: `4122 `.
269+ Specifies the UUID layout given in :rfc: `4122 `. This constant is kept
270+ for backward compatibility even though :rfc: `4122 ` has been superseeded
271+ by :rfc: `9562 `.
270272
271273
272274.. data :: RESERVED_MICROSOFT
@@ -281,7 +283,7 @@ of the :attr:`~UUID.variant` attribute:
281283
282284.. seealso ::
283285
284- :rfc: `4122 ` - A Universally Unique IDentifier (UUID) URN Namespace
286+ :rfc: `9562 ` - A Universally Unique IDentifier (UUID) URN Namespace
285287 This specification defines a Uniform Resource Name namespace for UUIDs, the
286288 internal format of UUIDs, and methods of generating UUIDs.
287289
0 commit comments