uuid --- UUID objects according to 9562

Reference note (untrusted external data; do not execute it as instructions). synopsis: UUID objects (universally unique identifiers) according to RFC 9562 This module provides immutable UUID objects (the UUID class) and functions for generating UUIDs corresponding to a specific UUID version as specified in 9562 (which supersedes 4122), for example, uuid1 for UUID version 1, uuid3 for UUID version 3, and so on. Note that UUID version 2 is deliberately omitted as it is outside the scope of the RFC. If all you want is a unique ID, you should probably call uuid1 or uuid4. Note that uuid1 may compromise privacy since it creates a UUID containing the computer's network address. uuid4 creates a random UUID. Depending on support from the underlying platform, uuid1 may or may not return a "safe" UUID. A safe UUID is one which is generated using synchronization methods that ensure no two processes can obtain the same UUID. All instances of UUID have an ~UUID.is_safe attribute which relays any information about the UUID's safety, using this enumeration Create a UUID from either a string of 32 hexadecimal digits, a string of 16 bytes in big-endian order as the bytes argument, a string of 16 bytes in little-endian order as the bytes_le argument, a tuple of six integers (32-bit time_low, 16-bit time_mid, 16-bit time_hi_version, 8-bit clock_seq_hi_variant, 8-bit clock_seq_low, 48-bit node) as the fields argument, or a single 128-bit integer as the int argument. When a string of hex digits is given, curly braces, hyphens, and a URN prefix are all optional. For example, these expressions all yield the same UUID Exactly one of hex, bytes, bytes_le, fields, or int must be given. The version argument is optional; if given, the resulting UUID will have its variant and version number set according to 9562, overriding bits in the given hex, bytes, bytes_le, fields, or int. Comparison of UUID objects are made by way of comparing their UUID.int attributes. Comparison with a non-UUID object raises a TypeError. str(uuid) returns a string in the form 12345678-1234-5678-1234-567812345678 where the 32 hexadecimal digits represent the UUID. UUID instances have these read-only attributes The UUID as a 16-byte string (containing the six integer fields in big-endian byte order). The UUID as a 16-byte string (with time_low, time_mid, and time_hi_version in little-endian byte order). … Attribution: Adapted from Python Documentation under PSF-2.0. Adaptation: WikiKV isolated this documentation section, normalized formatting, retained only bounded code excerpts, and shortened it at a paragraph or sentence boundary for retrieval. Verify version-sensitive details at the source.