ž
§ÿ fMW c @ s d Z d Z d d d d g \ Z Z Z Z e Z e Z Gd d „ d e
ƒ Z d d „ Z d
d „ Z
d d
„ Z d d „ Z e Z Z Z yDd d l Z d d l Z x‡ d d g D]y Z y e j e j j e ƒ ƒ Z Wn w² Yn Xe e d ƒ r e j Z n e e d ƒ r+e j Z e e k r(Pn n q² Wd d l Z e j d k rŽd d l Z e e j! ƒ j" j# d ƒ d ƒ d k r‹e Z Z n n y e j$ j% Z Wn e Z Yn Xe& e d e& e d e ƒ ƒ Z Wn Yn Xd d „ Z' d d „ Z( d d „ Z) e a* d! d" „ Z+ e a, e e d# d$ „ Z- d% d& „ Z. d' d( „ Z/ d) d* „ Z0 e d+ ƒ Z1 e d, ƒ Z2 e d- ƒ Z3 e d. ƒ Z4 d S(/ uQ UUID objects (universally unique identifiers) according to RFC 4122.
This module provides immutable UUID objects (class UUID) and the functions
uuid1(), uuid3(), uuid4(), uuid5() for generating version 1, 3, 4, and 5
UUIDs as specified in RFC 4122.
If all you want is a unique ID, you should probably call uuid1() or uuid4().
Note that uuid1() may compromise privacy since it creates a UUID containing
the computer's network address. uuid4() creates a random UUID.
Typical usage:
>>> import uuid
# make a UUID based on the host ID and current time
>>> uuid.uuid1() # doctest: +SKIP
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() # doctest: +SKIP
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')
u Ka-Ping Yee u reserved for NCS compatibilityu specified in RFC 4122u$ reserved for Microsoft compatibilityu reserved for future definitionc B sÊ | Ee Z d Z d Z d8 d8 d8 d8 d8 d8 d d „ Z d d „ Z d d „ Z d d „ Z d
d „ Z d d
„ Z
d d „ Z d d „ Z d d „ Z
d d „ Z d d „ Z d d „ Z e d d „ ƒ Z e d d „ ƒ Z e d d „ ƒ Z e d d! „ ƒ Z e d" d# „ ƒ Z e d$ d% „ ƒ Z e d& d' „ ƒ Z e d( d) „ ƒ Z e d* d+ „ ƒ Z e d, d- „ ƒ Z e d. d/ „ ƒ Z e d0 d1 „ ƒ Z e d2 d3 „ ƒ Z e d4 d5 „ ƒ Z e d6 d7 „ ƒ Z d8 S(9 u UUIDuÚ Instances of the UUID class represent UUIDs as specified in RFC 4122.
UUID objects are immutable, hashable, and usable as dictionary keys.
Converting a UUID to a string with str() yields something in the form
'12345678-1234-1234-1234-123456789abc'. The UUID constructor accepts
five possible forms: a similar string of hexadecimal digits, or a tuple
of six integer fields (with 32-bit, 16-bit, 16-bit, 8-bit, 8-bit, and
48-bit values respectively) as an argument named 'fields', or a string
of 16 bytes (with all the integer fields in big-endian order) as an
argument named 'bytes', or a string of 16 bytes (with the first three
fields in little-endian order) as an argument named 'bytes_le', or a
single 128-bit integer as an argument named 'int'.
UUIDs have these read-only attributes:
bytes the UUID as a 16-byte string (containing the six
integer fields in big-endian byte order)
bytes_le the UUID as a 16-byte string (with time_low, time_mid,
and time_hi_version in little-endian byte order)
fields a tuple of the six integer fields of the UUID,
which are also available as six individual attributes
and two derived attributes:
time_low the first 32 bits of the UUID
time_mid the next 16 bits of the UUID
time_hi_version the next 16 bits of the UUID
clock_seq_hi_variant the next 8 bits of the UUID
clock_seq_low the next 8 bits of the UUID
node the last 48 bits of the UUID
time the 60-bit timestamp
clock_seq the 14-bit sequence number
hex the UUID as a 32-character hexadecimal string
int the UUID as a 128-bit integer
urn the UUID as a URN as specified in RFC 4122
variant the UUID variant (one of the constants RESERVED_NCS,
RFC_4122, RESERVED_MICROSOFT, or RESERVED_FUTURE)
version the UUID version number (1 through 5, meaningful only
when the variant is RFC_4122)
c C sµ | | | | | g j d ƒ d k r3 t d ƒ ‚ n | d k r« | j d d ƒ j d d ƒ } | j d ƒ j d d ƒ } t | ƒ d k r™ t d ƒ ‚ n t | d
ƒ } n | d k r9t | ƒ d
k rØ t d ƒ ‚ n t t | d d … ƒ ƒ t t | d d
… ƒ ƒ t t | d
d … ƒ ƒ | d d … } n | d k r†t | ƒ d
k rft d ƒ ‚ n t d d
t
| ƒ d
ƒ } n | d k rt | ƒ d
k r³t d ƒ ‚ n | \ } } } }
} } d | k oâd' k n söt d ƒ ‚ n d | k o
d( k n s!t d ƒ ‚ n d | k o8d) k n sLt d ƒ ‚ n d |
k ocd* k n swt d ƒ ‚ n d | k oŽd+ k n s¢t d ƒ ‚ n d | k o¹d, k n sÍt d ƒ ‚ n |
d >| B}
| d >| d >B| d >B|
d >B| B} n | d k r>d | k o'd- k n s>t d ƒ ‚ q>n | d k r¤d | k oad k n sut d! ƒ ‚ n | d/ M} | d0 O} | d2 M} | | d% >O} n | | j d& | j d >B| j BS( Niÿ i0 i ( u time_hi_versionu time_midu time_low( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu time s u UUID.timec C s | j d @d >| j BS( Ni? i ( u clock_seq_hi_variantu
clock_seq_low( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu clock_seq s u UUID.clock_seqc C s | j d @S( Nl ÿÿÿ ( u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu node s u UUID.nodec C s d | j S( Nu %032x( u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu hex! s u UUID.hexc C s d t | ƒ S( Nu urn:uuid:( u str( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu urn% s u UUID.urnc C s; | j d @s t S| j d @s" t S| j d @s3 t St Sd S( Ni € i0 i @ i l l l ( u intu RESERVED_NCSu RFC_4122u RESERVED_MICROSOFTu RESERVED_FUTURE( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu variant) s
u UUID.variantc C s( | j t k r$ t | j d ?d @ƒ Sd S( NiL i ( u variantu RFC_4122u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu version4 s u UUID.versionN(! u __name__u
__module__u __qualname__u __doc__u Noneu __init__u __eq__u __ne__u __lt__u __gt__u __le__u __ge__u __hash__u __int__u __repr__u __setattr__u __str__u propertyu bytesu bytes_leu fieldsu time_lowu time_midu time_hi_versionu clock_seq_hi_variantu
clock_seq_lowu timeu clock_sequ nodeu hexu urnu variantu version( u
__locals__( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu UUID8 s: . P u UUIDc
C sG d d l } d d l } | j | ƒ } | d k rm | j j d ƒ } | j | d | ƒ} | d k rm d Sn yÁ d | | f } | j | ƒ œ } x’ | D]Š }
|
j ƒ j ƒ } xo t t
| ƒ ƒ D][ } | | | k rÄ y' t | | | ƒ j d d ƒ d ƒ SWq t
t f k
rYq XqÄ qÄ Wq™ WWd QXWn t k
rBYn Xd S(
Ni u /sbinu /usr/sbinu pathu LC_ALL=C %s %s 2>/dev/nullu :u i ( u /sbinu /usr/sbin( u osu shutilu whichu Noneu pathsepu joinu popenu loweru splitu rangeu lenu intu replaceu
ValueErroru
IndexErroru IOError(
u commandu argsu hw_identifiersu get_indexu osu shutilu
executableu pathu cmdu pipeu lineu wordsu i( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu _find_mac: s*
$
u _find_macc C s± x9 d D]1 } t d | d d g d d „ ƒ } | r | Sq Wd d
l } | j | j ƒ ƒ } t d d | g d
d „ ƒ } | r… | St d d d g d d „ ƒ } | r | Sd
S( u5 Get the hardware address on Unix by running ifconfig.u u -au -avu ifconfigu hwaddru etherc S s | d S( Ni ( ( u i( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu ^ s u# _ifconfig_getnode..i Nu arpu -anc S s d S( Ni iÿÿÿÿ( ( u i( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu f s u lanscanu -aiu lan0c S s d S( Ni ( ( u i( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu k s ( u u -au -av( u _find_macu socketu
gethostbynameu gethostnameu None( u argsu macu socketu ip_addr( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu _ifconfig_getnodeY s
! u _ifconfig_getnodec C sC d d l } d d l } d d d g } yQ d d l } | j d ƒ } | j j j | d ƒ | j d | j j d ƒ ƒ Wn Yn Xx¹ | D]± } z y& | j
| j j | d ƒ d ƒ } Wn t
k
rÐ wŠ Yn\ XxX | D]P } | j d
ƒ d j ƒ j ƒ } | j d | ƒ rØ t | j d
d ƒ d ƒ SqØ WWd | j ƒ XqŠ Wd S( u< Get the hardware address on Windows by running ipconfig.exe.i Nu u c:\windows\system32u c:\winnt\system32i, u mbcsu ipconfigu /allu :i u& ([0-9a-f][0-9a-f]-){5}[0-9a-f][0-9a-f]u -i iÿÿÿÿ( u osu reu ctypesu create_string_bufferu windllu kernel32u GetSystemDirectoryAu insertu valueu decodeu popenu pathu joinu IOErroru splitu stripu loweru matchu intu replaceu close( u osu reu dirsu ctypesu bufferu diru pipeu lineu value( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu _ipconfig_getnodeq s&
&
!u _ipconfig_getnodec C s• d d l } d d l } | j ƒ } | j | _ | j ƒ | _ } | j ƒ | j | ƒ d k rf d S| j ƒ x t
| j ƒ D]
} | j ƒ | j
| _ t | j | ƒ | _ | j | ƒ d k rÍ q€ n | j ƒ | j | _ t | j | ƒ | _ d j d ƒ | _ | j ƒ | _ } | j | ƒ d k r9q€ n | j ƒ | j } | d d >| d d >| d d >| d
d >| d d >| d
SWd S( ut Get the hardware address on Windows using NetBIOS calls.
See http://support.microsoft.com/kb/118623 for details.i Nu *i i( i i i i i i i i ( u win32wnetu netbiosu NCBu NCBENUMu Commandu LANA_ENUMu Bufferu _packu Netbiosu _unpacku rangeu lengthu Resetu NCBRESETu ordu lanau Lana_numu NCBASTATu ljustu Callnameu ADAPTER_STATUSu adapter_address( u win32wnetu netbiosu ncbu adaptersu iu statusu bytes( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu _netbios_getnode‰ s0
u _netbios_getnodei Nu uuidu cu uuid_generate_randomu uuid_generate_timeu darwinu .i u UuidCreateSequentialu
UuidCreatec C s2 t j d ƒ } t | ƒ t d t | j ƒ ƒ j S( u. Get the hardware address on Unix using ctypes.i u bytes( u ctypesu create_string_bufferu _uuid_generate_timeu UUIDu bytes_u rawu node( u _buffer( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu _unixdll_getnodeÚ s
u _unixdll_getnodec C s> t j d ƒ } t | ƒ d k r: t d t | j ƒ ƒ j Sd S( u1 Get the hardware address on Windows using ctypes.i i u bytesN( u ctypesu create_string_bufferu _UuidCreateu UUIDu bytes_u rawu node( u _buffer( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu _windll_getnodeà s u _windll_getnodec C s d d l } | j d d ƒ d BS( uC Get a random node ID, with eighth bit set as suggested by RFC 4122.i Ni i0 l l ( u randomu randrange( u random( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu _random_getnodeæ s u _random_getnodec
C s t d k r t Sd d l } | j d k r= t t t g } n t t g } x@ | t g D]1 } y
| ƒ a Wn wW Yn Xt d k rW t SqW Wd S( u3 Get the hardware address as a 48-bit positive integer.
The first time this runs, it may launch a separate program, which could
be quite slow. If all attempts to obtain the hardware address fail, we
choose a random 48-bit number with its eighth bit set to 1 as recommended
in RFC 4122.
i Nu win32(
u _nodeu Noneu sysu platformu _windll_getnodeu _netbios_getnodeu _ipconfig_getnodeu _unixdll_getnodeu _ifconfig_getnodeu _random_getnode( u sysu gettersu getter( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu getnodeí s
u getnodec C sW t rQ | | k o d k n rQ t j d ƒ } t | ƒ t d t | j ƒ ƒ Sd d l } t | j ƒ d ƒ } t | d ƒ d } t d k r¬ | t k r¬ t d } n | a | d k rÜ d d l
} | j d ƒ } n | d
@} | d ?d @} | d
?d @} | d @}
| d ?d @} | d k r2t ƒ } n t d | | | | |
| f d d ƒ S( u Generate a UUID from a host ID, sequence number, and the current time.
If 'node' is not given, getnode() is used to obtain the hardware
address. If 'clock_seq' is given, it is used as the sequence number;
otherwise a random 14-bit sequence number is chosen.i u bytesi Ng eÍÍAid l @'Hw
i i l ÿÿ i iÿÿ i0 iÿ iÿ i i? u fieldsu versioni @ (
u _uuid_generate_timeu Noneu ctypesu create_string_bufferu UUIDu bytes_u rawu timeu intu _last_timestampu randomu randrangeu getnode( u nodeu clock_sequ _bufferu timeu nanosecondsu timestampu randomu time_lowu time_midu time_hi_versionu
clock_seq_lowu clock_seq_hi_variant( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu uuid1
s, "
u uuid1c C sO d d l m } | | j t | d ƒ ƒ j ƒ } t d | d d … d d ƒ S( uA Generate a UUID from the MD5 hash of a namespace UUID and a name.i ( u md5u utf-8u bytesNi u versioni ( u hashlibu md5u bytesu digestu UUID( u namespaceu nameu md5u hash( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu uuid3- s "u uuid3c s´ t r5 t j d ƒ } t | ƒ t d t | j ƒ ƒ Sy, d d l } t d | j d ƒ d d ƒ SWnL d d l ‰ t ‡ f d d † t d ƒ Dƒ ƒ } t d | d d ƒ SYn Xd S( u Generate a random UUID.i u bytesi Nu versioni c 3 s | ] } ˆ j d ƒ Vq d S( i N( u randrange( u .0u i( u random( u) /opt/alt/python33/lib64/python3.3/uuid.pyu B s u uuid4..(
u _uuid_generate_randomu ctypesu create_string_bufferu UUIDu bytes_u rawu osu urandomu randomu range( u _bufferu osu bytes( ( u randomu) /opt/alt/python33/lib64/python3.3/uuid.pyu uuid43 s
%u uuid4c C sO d d l m } | | j t | d ƒ ƒ j ƒ } t d | d d … d d ƒ S( uC Generate a UUID from the SHA-1 hash of a namespace UUID and a name.i ( u sha1u utf-8u bytesNi u versioni ( u hashlibu sha1u bytesu digestu UUID( u namespaceu nameu sha1u hash( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu uuid5E s "u uuid5u$ 6ba7b810-9dad-11d1-80b4-00c04fd430c8u$ 6ba7b811-9dad-11d1-80b4-00c04fd430c8u$ 6ba7b812-9dad-11d1-80b4-00c04fd430c8u$ 6ba7b814-9dad-11d1-80b4-00c04fd430c8(5 u __doc__u
__author__u RESERVED_NCSu RFC_4122u RESERVED_MICROSOFTu RESERVED_FUTUREu intu int_u bytesu bytes_u objectu UUIDu _find_macu _ifconfig_getnodeu _ipconfig_getnodeu _netbios_getnodeu Noneu _uuid_generate_randomu _uuid_generate_timeu _UuidCreateu ctypesu ctypes.utilu libnameu CDLLu utilu find_libraryu libu hasattru uuid_generate_randomu uuid_generate_timeu sysu platformu osu unameu releaseu splitu windllu rpcrt4u getattru _unixdll_getnodeu _windll_getnodeu _random_getnodeu _nodeu getnodeu _last_timestampu uuid1u uuid3u uuid4u uuid5u
NAMESPACE_DNSu
NAMESPACE_URLu
NAMESPACE_OIDu NAMESPACE_X500( ( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu - sh ÿ ! (
#