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

Source code: Lib/uuid.py

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

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

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

class uuid.SafeUUID?

3.7 新版功能.

safe?

該UUID是由平臺以多進程安全的方式生成的。

unsafe?

UUID不是以多進程安全的方式生成的。

unknown?

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

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

用一串32位十六進制數字、一串大端序16個字節作為*bytes*參數、一串16個小端序字節作為*bytes_le*參數、一個由六個整數組成的元組（32位*time_low*，16位*time_mid*，16位*time_hi_version*，8位*clock_seq_hi_variant*，8位*clock_seq_low*，48位*node*）作為*fields*參數，或者一個128位整數作為*int*參數創建一個UUID。當給出一串十六進制數字時，大括號、連字符和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)

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

UUID 對象的比較是通過比較它們的 UUID.int 屬性進行的。 與非 UUID 對象的比較會引發 TypeError。

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

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

UUID.bytes?

UUID 是一個 16 字節的字符串（包含 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?

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

UUID.variant?

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

UUID.version?

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

UUID.is_safe?

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

3.7 新版功能.

uuid 模塊定義了以下函數：

uuid.getnode()?

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

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

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

根據主機 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?

為微軟的兼容性保留。

uuid.RESERVED_FUTURE?

保留給未來的定義。

參見

RFC 4122 - 通用唯一標識符（UUID）URN命名空間

本規范定義了UUID的統一資源名稱空間，UUID的內部格式，以及生成UUID的方法。

示例?

下面是一些 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')