uuid --- RFC 4122 定義的UUID對(duì)象?

源代碼： Lib/uuid.py

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

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

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

class uuid.SafeUUID?

3.7 新版功能.

safe?

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

unsafe?

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

unknown?

該平臺(tái)不提供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個(gè)字節(jié)作為*bytes*參數(shù)、一串16個(gè)小端序字節(jié)作為*bytes_le*參數(shù)、一個(gè)由六個(gè)整數(shù)組成的元組（32位*time_low*，16位*time_mid*，16位*time_hi_version*，8位*clock_seq_hi_variant*，8位*clock_seq_low*，48位*node*）作為*fields*參數(shù)，或者一個(gè)128位整數(shù)作為*int*參數(shù)創(chuàng)建一個(gè)UUID。當(dāng)給出一串十六進(jìn)制數(shù)字時(shí)，大括號(hào)、連字符和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 中的唯一一個(gè)。 version 參數(shù)是可選的；如果給定，產(chǎn)生的UUID將根據(jù) RFC 4122 設(shè)置其變體和版本號(hào)，覆蓋給定的 hex、bytes、bytes_le、fields 或 int 中的位。

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

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

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

UUID.bytes?

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

UUID.bytes_le?

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

UUID.fields?

以元組形式存放的UUID的6個(gè)整數(shù)域，有六個(gè)單獨(dú)的屬性和兩個(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的總長(zhǎng)60位的時(shí)間戳
clock_seq	14位的序列號(hào)

UUID.hex?

The UUID as a 32-character lowercase hexadecimal string.

UUID.int?

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

UUID.urn?

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

UUID.variant?

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

UUID.version?

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

UUID.is_safe?

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

3.7 新版功能.

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

uuid.getnode()?

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

在 3.7 版更改: 普遍管理的MAC地址優(yōu)于本地管理的MAC地址，因?yàn)榍罢弑ＷC是全球唯一的，而后者則不是。

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

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

uuid.uuid3(namespace, name)?

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

uuid.uuid4()?

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

uuid.uuid5(namespace, name)?

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

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

uuid.NAMESPACE_DNS?

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

uuid.NAMESPACE_URL?

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

uuid.NAMESPACE_OID?

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

uuid.NAMESPACE_X500?

當(dāng)指定這個(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')