源代码: Lib/uuid.py
这个模块提供了不可变的UUID对象(UUID类)和函数uuid1()、uuid3()、uuid4()、uuid5()，用于生成RFC 4122中指定的版本1、3、4和5 UUID。
如果您想要的只是一个唯一的ID，那么可能应该调用uuid1()或uuid4()。注意，uuid1()可能会损害隐私，因为它创建了一个包含计算机网络地址的UUID。uuid4()创建一个随机的UUID。
- class uuid.UUID(hex=None, bytes=None, bytes_le=None, fields=None, int=None, version=None)
创建一个UUID从32个十六进制数字的字符串,字符串16字节的高位优先顺序的字节,16字节的字符串在低位优先顺序bytes_le论点,六元组整数(32位time_low, 16位time_mid、16位time_hi_version 8位clock_seq_hi_variant, 8位clock_seq_low, 48比特位节点)作为字段的参数,或一个128位整数作为int参数。当给定一串十六进制数字时，花括号、连字符和URN前缀都是可选的。
例如，这些表达式都产生相同的UUID:
UUID('{12345678-1234-5678-1234-567812345678}')
UUID('12345678123456781234567812345678')
UUID('urn:uuid:12345678-1234-5678-1234-567812345678')
UUID(bytes=b'\x12\x34\x56\x78'*4)
UUID(bytes_le=b'\x78\x56\x34\x12\x34\x12\x78\x56' +
b'\x12\x34\x56\x78\x12\x34\x56\x78')
UUID(fields=(0x12345678, 0x1234, 0x5678, 0x12, 0x34, 0x567812345678))
UUID(int=0x12345678123456781234567812345678)
必须给出十六进制、字节、bytes_le、字段或int中的一个。版本参数是可选的;如果给定，结果UUID将根据RFC 4122设置其变体和版本号，覆盖给定十六进制、字节、bytes_le、字段或int中的位。
UUID对象的比较是通过比较它们的UUID.int属性进行的。与非uuid对象进行比较会引发类型错误。
str(uuid)返回格式为12345678-1234-5678-1234-567812345678的字符串，其中32个十六进制数字表示uuid。
UUID实例有以下只读属性:
- UUID.bytes
UUID是一个16字节的字符串(以big-endian字节顺序包含6个整数字段)。
- UUID.bytes_le
UUID是一个16字节的字符串(time_low、time_mid和time_hi_version按低位字节顺序排列)。
- UUID.fields
以元组形式存放的UUID的6个整数域，有六个单独的属性和两个派生属性：
域 含义
time_low UUID的前32位
time_mid 接前一域的16位
time_hi_version 接前一域的16位
clock_seq_hi_variant 接前一域的8位
clock_seq_low 接前一域的8位
node UUID的最后48位
time UUID的总长60位的时间戳
clock_seq 14位的序列号
- 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模块定义了以下功能:
- uuid.getnode()
获取48位正整数的硬件地址。第一次运行时，它可能会启动一个单独的程序，这个程序可能会非常慢。如果所有获取硬件地址的尝试都失败了，我们将随机选择一个48位的数字，并按照RFC 4122中的建议将其8位设置为1。“硬件地址”是指一个网络接口的MAC地址，在具有多个网络接口的机器上，可以返回其中任何一个网络接口的MAC地址。
- uuid.uuid1(node=None, clock_seq=None)
从主机ID、序列号和当前时间生成UUID。如果没有给出节点，则使用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
指定此名称空间时，名称字符串是完全限定的域名。
- uuid.NAMESPACE_URL
当指定此名称空间时，名称字符串是一个URL。
- uuid.NAMESPACE_OID
当指定此名称空间时，名称字符串是一个ISO OID。
- uuid.NAMESPACE_X500
指定此名称空间时，名称字符串是DER或文本输出格式的X.500 DN。
uuid模块为变体属性的可能值定义了以下常量:
- uuid.RESERVED_NCS
为NCS兼容性保留。
- uuid.RFC_4122
指定RFC 4122中给出的UUID布局。
- uuid.RESERVED_MICROSOFT
保留微软兼容性。
- uuid.RESERVED_FUTURE
预留给以后的定义。
示例
下面是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
b'\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')