uuid --- RFC 4122 定義的UUID對象?

源代碼： Lib/uuid.py

這個(gè)模塊提供了不可變的 UUID 對象 (UUID 類(lèi)) 和 uuid1(), uuid3(), uuid4(), uuid5() 等函數用于生成 RFC 4122 所定義的第 1, 3, 4 和 5 版 UUID。

如果你想要的只是一個(gè)唯一的ID，你可能應該調用 uuid1() 或 uuid4()。 注意 uuid1() 可能會(huì )損害隱私，因為它創(chuàng )建了一個(gè)包含計算機網(wǎng)絡(luò )地址的UUID。 uuid4() 可以創(chuàng )建一個(gè)隨機UUID。

根據底層平臺的支持，uuid1() 可能會(huì )也可能不會(huì )返回一個(gè) "安全的" UUID。 安全的 UUID 是使用同步方法生成的，確保沒(méi)有兩個(gè)進(jìn)程可以獲得相同的 UUID。 所有 UUID 的實(shí)例都有一個(gè) is_safe 屬性，使用這個(gè)枚舉來(lái)傳遞關(guān)于 UUID 安全的任何信息:

class uuid.SafeUUID?

3.7 新版功能.

safe?

該UUID是由平臺以多進(jìn)程安全的方式生成的。

unsafe?

UUID不是以多進(jìn)程安全的方式生成的。

unknown?

該平臺不提供UUID是否安全生成的信息。

class uuid.UUID(hex=None, bytes=None, bytes_le=None, fields=None, int=None, version=None, *, is_safe=SafeUUID.unknown)?

用一串32位十六進(jìn)制數字、一串大端序16個(gè)字節作為*bytes*參數、一串16個(gè)小端序字節作為*bytes_le*參數、一個(gè)由六個(gè)整數組成的元組（32位*time_low*，16位*time_mid*，16位*time_hi_version*，8位*clock_seq_hi_variant*，8位*clock_seq_low*，48位*node*）作為*fields*參數，或者一個(gè)128位整數作為*int*參數創(chuàng )建一個(gè)UUID。當給出一串十六進(jìn)制數字時(shí)，大括號、連字符和URN前綴都是可選的。 例如，這些表達式都產(chǎn)生相同的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)

必須給出 hex、bytes、bytes_le、fields 或 int 中的唯一一個(gè)。 version 參數是可選的；如果給定，產(chǎn)生的UUID將根據 RFC 4122 設置其變體和版本號，覆蓋給定的 hex、bytes、bytes_le、fields 或 int 中的位。

UUID 對象的比較是通過(guò)比較它們的 UUID.int 屬性進(jìn)行的。 與非 UUID 對象的比較會(huì )引發(fā) TypeError。

str(uuid) 返回一個(gè) 12345678-1234-5678-1234-567812345678 形式的字符串，其中 32 位十六進(jìn)制數字代表 UUID。

UUID 實(shí)例有這些只讀的屬性:

UUID.bytes?

UUID是一個(gè)16字節的字符串（包含6個(gè)大端字節序的整數字段）。

UUID.bytes_le?

UUID 是一個(gè) 16 字節的字符串（其中 time_low、time_mid 和 time_hi_version 為小端字節順序）。

UUID.fields?

以元組形式存放的UUID的6個(gè)整數域，有六個(gè)單獨的屬性和兩個(gè)派生屬性：

域	含意
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的總長(cháng)60位的時(shí)間戳
clock_seq	14位的序列號

UUID.hex?

The UUID as a 32-character lowercase hexadecimal string.

UUID.int?

UUID是一個(gè)128位的整數。

UUID.urn?

在 RFC 4122 中定義的 URN 形式的 UUID。

UUID.variant?

UUID 的變體，它決定了 UUID 的內部布局。 這將是 RESERVED_NCS, RFC_4122, RESERVED_MICROSOFT 或 RESERVED_FUTURE 中的一個(gè)。

UUID.version?

UUID 版本號（1 到 5，只有當變體為 RFC_4122 時(shí)才有意義）。

UUID.is_safe?

一個(gè) SafeUUID 的枚舉，表示平臺是否以多進(jìn)程安全的方式生成 UUID。

3.7 新版功能.

uuid 模塊定義了以下函數：

uuid.getnode()?

獲取 48 位正整數形式的硬件地址。 第一次運行時(shí)，它可能會(huì )啟動(dòng)一個(gè)單獨的程序，這可能會(huì )相當慢。 如果所有獲取硬件地址的嘗試都失敗了，我們會(huì )按照 RFC 4122 中的建議，選擇一個(gè)隨機的 48 位數字，其多播位 (第一個(gè)八進(jìn)制數的最小有效位) 設置為 1。 “硬件地址”是指一個(gè)網(wǎng)絡(luò )接口的 MAC 地址。 在一臺有多個(gè)網(wǎng)絡(luò )接口的機器上，普遍管理的 MAC 地址 (即第一個(gè)八位數的第二個(gè)最小有效位是 未設置的) 將比本地管理的 MAC 地址優(yōu)先，但沒(méi)有其他排序保證。

在 3.7 版更改: 普遍管理的MAC地址優(yōu)于本地管理的MAC地址，因為前者保證是全球唯一的，而后者則不是。

uuid.uuid1(node=None, clock_seq=None)?

根據主機 ID、序列號和當前時(shí)間生成一個(gè) UUID。 如果沒(méi)有給出 node，則使用 getnode() 來(lái)獲取硬件地址。 如果給出了 clock_seq，它將被用作序列號；否則將選擇一個(gè)隨機的 14 比特位序列號。

uuid.uuid3(namespace, name)?

根據命名空間標識符（這是一個(gè)UUID）和名稱(chēng)（這是一個(gè)字符串）的MD5哈希值，生成一個(gè)UUID。

uuid.uuid4()?

生成一個(gè)隨機的UUID。

uuid.uuid5(namespace, name)?

根據命名空間標識符（這是一個(gè)UUID）和名稱(chēng)（這是一個(gè)字符串）的SHA-1哈希值生成一個(gè)UUID。

uuid 模塊定義了以下命名空間標識符，供 uuid3() 或 uuid5() 使用。

uuid.NAMESPACE_DNS?

當指定這個(gè)命名空間時(shí)，name 字符串是一個(gè)完全合格的域名。

uuid.NAMESPACE_URL?

當指定這個(gè)命名空間時(shí)，name 字符串是一個(gè) URL。

uuid.NAMESPACE_OID?

當指定這個(gè)命名空間時(shí)，name 字符串是一個(gè) ISO OID。

uuid.NAMESPACE_X500?

當指定這個(gè)命名空間時(shí)，name 字符串是 DER 或文本輸出格式的 X.500 DN。

uuid 模塊為 variant 屬性的可能值定義了以下常量:

uuid.RESERVED_NCS?

為NCS兼容性保留。

uuid.RFC_4122?

指定 RFC 4122 中給出的 UUID 布局。

uuid.RESERVED_MICROSOFT?

為微軟的兼容性保留。

uuid.RESERVED_FUTURE?

保留給未來(lái)的定義。

>>> 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')