20.15. uuid —符合 RFC 4122 的 UUID 对象

2.5 版的新Function。

此模块提供不可变的UUID对象(UUID类)和函数uuid1()，uuid3()，uuid4()，uuid5()，以生成 RFC 4122中指定的版本 1、3、4 和 5 UUID。

如果您只需要一个唯一的 ID，则应该致电uuid1()或uuid4()。请注意，uuid1()可能会破坏隐私，因为它会创建一个包含计算机网络地址的 UUID。 uuid4()创建一个随机 UUID。

• • class * uuid. UUID([* * hex * [，* bytes * [，* bytes_le * [，* fields * [，* int * [，* version *]]]]]]]]]])
  • 使用 32 个十六进制数字的字符串，以 big-endianSequences 的 16 个字节的字符串作为* bytes 参数，以 little-endianSequences 的 16 个字节的字符串作为* bytes_le 参数，一个六 Tuples 来创建 UUID 整数(32 位 time_low ，16 位 time_mid ，16 位 time_hi_version ，8 位 clock_seq_hi_variant ，8 位 clock_seq_low ，48 位 node )作为 fields 参数，或单个 128 位整数作为 int *参数。当给出一串十六进制数字时，花括号，连字符和 URN 前缀都是可选的。例如，这些表达式都产生相同的 UUID：

UUID('{12345678-1234-5678-1234-567812345678}')
UUID('12345678123456781234567812345678')
UUID('urn:uuid:12345678-1234-5678-1234-567812345678')
UUID(bytes='\x12\x34\x56\x78'*4)
UUID(bytes_le='\x78\x56\x34\x12\x34\x12\x78\x56' +
              '\x12\x34\x56\x78\x12\x34\x56\x78')
UUID(fields=(0x12345678, 0x1234, 0x5678, 0x12, 0x34, 0x567812345678))
UUID(int=0x12345678123456781234567812345678)

必须给出* hex ， bytes ， bytes_le ， fields 或 int *之一。 * version 参数是可选的；如果给出，则所得的 UUID 将根据 RFC 4122 设置其变体和版本号，覆盖给定 hex ， bytes ， bytes_le ， fields 或 int *中的位。

UUID个实例具有以下只读属性：

• UUID. bytes

  • UUID 为 16 字节的字符串(包含按 big-endian 字节 Sequences 排列的六个整数字段)。

• UUID. bytes_le

  • UUID 为 16 字节的字符串(带有* time_low ， time_mid 和 time_hi_version *的字节序为 little-endian)。

• UUID. fields

  • UUID 的六个整数字段的 Tuples，也可以作为六个单独的属性和两个派生的属性使用：

• UUID. hex

  • UUID 为 32 个字符的十六进制字符串。

• UUID. int

  • UUID 为 128 位整数。

• UUID. urn

  • UUID 作为 RFC 4122 中指定的 URN。

• UUID. variant

  • UUID 变体，用于确定 UUID 的内部布局。这将是常量RESERVED_NCS，RFC_4122，RESERVED_MICROSOFT或RESERVED_FUTURE之一。

• UUID. version

  • UUID 版本号(1 到 5，仅在变体为RFC_4122时才有意义)。

uuid模块定义以下Function：

• uuid. getnode ( )
  • 以 48 位正整数的形式获取硬件地址。第一次运行时，它可能会启动一个单独的程序，这可能会很慢。如果所有try获取硬件地址的try均失败，我们将按照 RFC 4122 的建议选择一个随机的 48 位数字，将其第八位设置为 1.“硬件地址”表示网络接口的 MAC 地址，并且在具有多个网络接口可能会返回其中任何一个的 MAC 地址。

• uuid. uuid1([* node * [，* clock_seq *]])
  • 根据主机 ID，序列号和当前时间生成 UUID。如果未指定* node ，则使用getnode()获取硬件地址。如果给出了 clock_seq *，它将用作序列号；否则，选择一个随机的 14 位序列号。

• uuid. uuid3(* namespace ， name *)
  • 根据名称空间标识符(是 UUID)和名称(是字符串)的 MD5 哈希值生成 UUID。

• uuid. uuid4 ( )
  • 生成一个随机的 UUID。

• uuid. uuid5(* namespace ， name *)
  • 基于名称空间标识符(是 UUID)和名称(是字符串)的 SHA-1 哈希生成 UUID。

uuid模块定义以下用于uuid3()或uuid5()的名称空间标识符。

• uuid. NAMESPACE_DNS

  • 指定此名称空间后，* name *字符串是完全限定的域名。

• uuid. NAMESPACE_URL

  • 指定此名称空间后，* name *字符串是一个 URL。

• uuid. NAMESPACE_OID

  • 指定此名称空间后，* name *字符串是 ISO OID。

• uuid. NAMESPACE_X500

  • 指定此名称空间后，* name *字符串是 DER 或文本输出格式的 X.500 DN。

uuid模块为variant属性的可能值定义以下常量：

• uuid. RESERVED_NCS

  • 保留用于 NCS 兼容性。

• uuid. RFC_4122

  • 指定 RFC 4122中给出的 UUID 布局。

• uuid. RESERVED_MICROSOFT

  • 保留用于 Microsoft 兼容性。

• uuid. RESERVED_FUTURE

  • 保留以供将来定义。

20.15.1. Example

以下是uuid模块的典型用法的一些示例：

>>> import uuid

>>> # make a UUID based on the host ID and current time
>>> uuid.uuid1()
UUID('a8098c1a-f86e-11da-bd1a-00112444be1e')

>>> # make a UUID using an MD5 hash of a namespace UUID and a name
>>> uuid.uuid3(uuid.NAMESPACE_DNS, 'python.org')
UUID('6fa459ea-ee8a-3ca4-894e-db77e160355e')

>>> # make a random UUID
>>> uuid.uuid4()
UUID('16fd2706-8baf-433b-82eb-8c7fada847da')

>>> # make a UUID using a SHA-1 hash of a namespace UUID and a name
>>> uuid.uuid5(uuid.NAMESPACE_DNS, 'python.org')
UUID('886313e1-3b8a-5372-9b90-0c9aee199e5d')

>>> # make a UUID from a string of hex digits (braces and hyphens ignored)
>>> x = uuid.UUID('{00010203-0405-0607-0809-0a0b0c0d0e0f}')

>>> # convert a UUID to a string of hex digits in standard form
>>> str(x)
'00010203-0405-0607-0809-0a0b0c0d0e0f'

>>> # get the raw 16 bytes of the UUID
>>> x.bytes
'\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f'

>>> # make a UUID from a 16-byte string
>>> uuid.UUID(bytes=x.bytes)
UUID('00010203-0405-0607-0809-0a0b0c0d0e0f')