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

源代碼： Lib/uuid.py

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

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

根據(jù)底層平臺的支持，uuid1() 可能會也可能不會返回一個 "安全的" UUID。 安全的 UUID 是使用同步方法生成的，確保沒有兩個進(jìn)程可以獲得相同的 UUID。 所有 UUID 的實例都有一個 is_safe 屬性，使用這個枚舉來傳遞關(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)制數(shù)字、一串大端序16個字節(jié)作為*bytes*參數(shù)、一串16個小端序字節(jié)作為*bytes_le*參數(shù)、一個由六個整數(shù)組成的元組（32位*time_low*，16位*time_mid*，16位*time_hi_version*，8位*clock_seq_hi_variant*，8位*clock_seq_low*，48位*node*）作為*fields*參數(shù)，或者一個128位整數(shù)作為*int*參數(shù)創(chuàng)建一個UUID。當(dāng)給出一串十六進(jìn)制數(shù)字時，大括號、連字符和URN前綴都是可選的。 例如，這些表達(dá)式都產(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 中的唯一一個。 version 參數(shù)是可選的；如果給定，產(chǎn)生的UUID將根據(jù) RFC 4122 設(shè)置其變體和版本號，覆蓋給定的 hex、bytes、bytes_le、fields 或 int 中的位。

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

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

UUID 實例有這些只讀的屬性:

UUID.bytes?

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

UUID.bytes_le?

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

UUID.fields?

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

域	含意
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?

The UUID as a 32-character lowercase hexadecimal string.

UUID.int?

UUID是一個128位的整數(shù)。

UUID.urn?

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

UUID.variant?

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

UUID.version?

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

UUID.is_safe?

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

3.7 新版功能.

uuid 模塊定義了以下函數(shù)：

uuid.getnode()?

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

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

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

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

uuid.uuid3(namespace, name)?

根據(jù)命名空間標(biāo)識符（這是一個UUID）和名稱（這是一個字符串）的MD5哈希值，生成一個UUID。

uuid.uuid4()?

生成一個隨機的UUID。

uuid.uuid5(namespace, name)?

根據(jù)命名空間標(biāo)識符（這是一個UUID）和名稱（這是一個字符串）的SHA-1哈希值生成一個UUID。

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

uuid.NAMESPACE_DNS?

當(dāng)指定這個命名空間時，name 字符串是一個完全合格的域名。

uuid.NAMESPACE_URL?

當(dāng)指定這個命名空間時，name 字符串是一個 URL。

uuid.NAMESPACE_OID?

當(dāng)指定這個命名空間時，name 字符串是一個 ISO OID。

uuid.NAMESPACE_X500?

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

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

uuid.RESERVED_NCS?

為NCS兼容性保留。

uuid.RFC_4122?

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

uuid.RESERVED_MICROSOFT?

為微軟的兼容性保留。

uuid.RESERVED_FUTURE?

保留給未來的定義。

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