ó
|
M\¬Qc @ s= d Z d Z d d d d g \ Z Z Z Z d e f d YZ d Z d Z d
|
Z
|
d Z d Z Z Z y3d d l Z d d l Z xv d d g D]h Z y e j e j j e Z Wn
|
q n Xe e d rç e j Z n e e d r e j Z q q Wd d l Z e j d k rfd d l Z e e j d j d d d k rfd Z Z qfn y e j j! Z Wn d Z n Xe" e d e" e d d Z Wn n Xd Z# d Z$ d Z% d a& d Z' d a( d d d Z) d Z* d Z+ d Z, e d! Z- e d" Z. e d# Z/ e d$ Z0 d S(% s( 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()
|
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
|
'\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')
|
s Ka-Ping Yee <ping@zesty.ca>s reserved for NCS compatibilitys specified in RFC 4122s$ reserved for Microsoft compatibilitys reserved for future definitiont UUIDc B s e Z d Z d d d d d d d Z d Z d Z d Z d Z d Z d Z
|
d Z e e Z d Z e e Z d
|
Z e e Z d Z e e Z d Z e e Z d Z e e Z d Z e e Z d Z e e Z d Z e e Z d Z e e Z d Z e e Z! d Z" e e" Z# d Z$ e e$ Z% d Z& e e& Z' d Z( e e( Z) RS( sÚ 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 r%t | d
|
k rØ t d n | d | d | d | d | d | d | d | d | d } n | d, k r{t | d
|
k rRt d n t d d
|
t t t
|
| d
|
} n | d, k rùt | d k r¨t d n | \ } } } }
|
} } d | k o×d- k n sët d n d | k od. k n st d n d | k o-d/ k n sAt d n d |
|
k oXd0 k n slt d n d | k od1 k n st d n d | k o®d2 k n sÂt d n |
|
d >| B} | d! >| d" >B| d# >B| d >B| B} n | d, k r3d | k o d3 k n s3t d% q3n | d, k rd | k oVd k n sjt d& n | d5 M} | d6 O} | d8 M} | | d* >O} n | | j d+ <d, S(9 sm Create a UUID from either a string of 32 hexadecimal digits,
|
a string of 16 bytes as the 'bytes' argument, a string of 16 bytes
|
in little-endian order as the 'bytes_le' argument, a tuple of six
|
integers (32-bit time_low, 16-bit time_mid, 16-bit time_hi_version,
|
8-bit clock_seq_hi_variant, 8-bit clock_seq_low, 48-bit node) as
|
the 'fields' argument, or a single 128-bit integer as the 'int'
|
argument. When a string of hex digits is given, curly braces,
|
hyphens, and a URN prefix are all optional. For example, these
|
expressions all yield the same UUID:
|
|
UUID('{12345678-1234-5678-1234-567812345678}')
|
UUID('12345678123456781234567812345678')
|
UUID('urn:uuid:12345678-1234-5678-1234-567812345678')
|
UUID(bytes='\x12\x34\x56\x78'*4)
|
UUID(bytes_le='\x78\x56\x34\x12\x34\x12\x78\x56' +
|
'\x12\x34\x56\x78\x12\x34\x56\x78')
|
UUID(fields=(0x12345678, 0x1234, 0x5678, 0x12, 0x34, 0x567812345678))
|
UUID(int=0x12345678123456781234567812345678)
|
|
Exactly one of 'hex', 'bytes', 'bytes_le', 'fields', or 'int' must
|
be given. The 'version' argument is optional; if given, the resulting
|
UUID will have its variant and version set according to RFC 4122,
|
overriding the given 'hex', 'bytes', 'bytes_le', 'fields', or 'int'.
|
i s0 need one of hex, bytes, bytes_le, fields, or ints urn:t s uuid:s {}t -i s$ badly formed hexadecimal UUID stringi s bytes_le is not a 16-char stringi i i i i i i i s bytes is not a 16-char strings %02xs fields is not a 6-tuplel s* field 1 out of range (need a 32-bit value)l s* field 2 out of range (need a 16-bit value)s* field 3 out of range (need a 16-bit value)l s* field 4 out of range (need an 8-bit value)s* field 5 out of range (need an 8-bit value)l 0 s* field 6 out of range (need a 48-bit value)l ` l P l @ l s* int is out of range (need a 128-bit value)s illegal version numberi À i i ð l L t intNl l l l l l l l lûÿÿÿ l l lúÿÿÿ ( t countt Nonet TypeErrort replacet stript lent
|
ValueErrort longt tuplet mapt ordt __dict__( t selft hext bytest bytes_let fieldsR t versiont time_lowt time_midt time_hi_versiont clock_seq_hi_variantt clock_seq_lowt nodet clock_seq( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt __init__e s\ $ ? ) )
|
|
|
c C s& t | t r" t | j | j St S( N( t
|
isinstanceR t cmpR t NotImplemented( R t other( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt __cmp__´ s c C s t | j S( N( t hashR ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt __hash__¹ s c C s | j S( N( R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt __int__¼ s c C s d t | S( Ns UUID(%r)( t str( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt __repr__¿ s c C s t d d S( Ns UUID objects are immutable( R ( R t namet value( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt __setattr__Â s c C sA d | j } d | d | d d !| d d !| d d !| d f S( Ns %032xs %s-%s-%s-%s-%si i i i ( R ( R R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt __str__Å s c C sB d } x5 t d d d D]! } t | j | ?d @ | } q W| S( NR i i i iÿ ( t ranget chrR ( R R t shift( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_bytesÊ s c C sQ | j } | d | d | d | d | d | d | d | d | d S(
|
Ni i i i i i i i i ( R ( R R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_bytes_leÒ s c C s( | j | j | j | j | j | j f S( N( R R R R R R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt
|
get_fieldsÙ s c C s | j d ?S( Nl ` ( R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_time_lowß s c C s | j d ?d @S( Nl P iÿÿ ( R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_time_midä s c C s | j d ?d @S( Nl @ iÿÿ ( R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_time_hi_versioné s c C s | j d ?d @S( Nl 8 iÿ ( R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_clock_seq_hi_variantî s c C s | j d ?d @S( Nl 0 iÿ ( R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_clock_seq_lowó s c C s! | j d @d >| j d >B| j BS( Nl ÿl 0 l ( R R R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_timeø s c C s | j d @d >| j BS( Nl ? l ( R R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_clock_seqþ s c C s | j d @S( NIÿÿÿÿÿÿ ( R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_node s c C s d | j S( Ns %032x( R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_hex s c C s d t | S( Ns urn:uuid:( R& ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_urn s c C s; | j d @s t S| j d @s" t S| j d @s3 t St Sd S( Ni l 0 i @ i l l l ( R t RESERVED_NCSt RFC_4122t RESERVED_MICROSOFTt RESERVED_FUTURE( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_variant s c C s( | j t k r$ t | j d ?d @ Sd S( Nl L i ( t variantR= R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt get_version s N(* t __name__t
|
__module__t __doc__R R R" R$ R% R' R* R+ R/ t propertyR R0 R R1 R R2 R R3 R R4 R R5 R R6 R R7 t timeR8 R R9 R R: R R; t urnR@ RA RB R ( ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyR 5 sN . N
|
c C s d d l } xú d d d g D]é } | j j | | } | j j | sO q n y d | | f } | j | z } xp | D]h } | j j }
|
xM t t |
|
D]9 } |
|
| | k r¦ t |
|
| | j
|
d d d Sq¦ Wq{ WWd QXWq t k
|
rq q Xq Wd S( NiÿÿÿÿR s /sbin/s /usr/sbins LC_ALL=C %s %s 2>/dev/nullt :i ( t ost patht joint existst popent lowert splitR, R R R t IOErrorR ( t commandt argst hw_identifierst get_indexRJ t dirt
|
executablet cmdt pipet linet wordst i( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt _find_mac& s" 2 c C s¨ x6 d D]. } t d | d d g d } | r | Sq Wd d l } | j | j } t d
|
d | g d } | r | St d d d g d } | r¤ | Sd S( s5 Get the hardware address on Unix by running ifconfig.R s -as -avt ifconfigt hwaddrt etherc S s | d S( Ni ( ( R\ ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt <lambda>A s iÿÿÿÿNt arps -anc S s d S( Niÿÿÿÿ( ( R\ ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyRa I s t lanscans -ait lan0c S s d S( Ni ( ( R\ ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyRa N s ( R s -as -av( R] t sockett gethostbynamet gethostnameR ( RS t macRe t ip_addr( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt _ifconfig_getnode< s c C sA 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 n Xx¸ | D]° } z y& | j
|
| j j | d d
|
} Wn t k
|
rÎ w n\ XxX | D]P } | j d d j j } | j d | rÖ t | j d d d SqÖ WWd | j Xq Wd S( s< Get the hardware address on Windows by running ipconfig.exe.iÿÿÿÿNR s c:\windows\system32s c:\winnt\system32i, i t mbcst ipconfigs /allRI s& ([0-9a-f][0-9a-f]-){5}[0-9a-f][0-9a-f]R i ( RJ t ret ctypest create_string_buffert windllt kernel32t GetSystemDirectoryAt insertR) t decodeRN RK RL RQ RP R RO t matchR R t close( RJ Rm t dirsRn t bufferRV RY RZ R) ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt _ipconfig_getnodeT s( & !c 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 t t | j } | d d >| d d >| d d
|
>| d d >| d d >| d SWd S( st Get the hardware address on Windows using NetBIOS calls.
|
See http://support.microsoft.com/kb/118623 for details.iÿÿÿÿNi t *i l ( i l i l i l i l i ( t win32wnett netbiost NCBt NCBENUMt Commandt LANA_ENUMt Buffert _packt Netbiost _unpackR, t lengtht Resett NCBRESETR t lanat Lana_numt NCBASTATt ljustt Callnamet ADAPTER_STATUSR t adapter_address( R{ R| t ncbt adaptersR\ t statusR ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt _netbios_getnodel s0
|
|
|
|
|
iÿÿÿÿNt uuidt ct uuid_generate_randomt uuid_generate_timet darwini t .i i t UuidCreateSequentialt
|
UuidCreatec C s, t j d } t | t d | j j S( s. Get the hardware address on Unix using ctypes.i R ( Rn Ro t _uuid_generate_timeR t rawR ( t _buffer( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt _unixdll_getnodeº s
|
c C s8 t j d } t | d k r4 t d | j j Sd S( s1 Get the hardware address on Windows using ctypes.i i R N( Rn Ro t _UuidCreateR R R ( R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt _windll_getnodeÀ s c C s d d l } | j d d d BS( sC Get a random node ID, with eighth bit set as suggested by RFC 4122.iÿÿÿÿNi i l 0 l l ( t randomt randrange( R¡ ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt _random_getnodeÆ s c 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]0 } y | a Wn
|
qW n Xt d k rW t SqW Wd S( s3 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ÿÿÿÿNt win32(
|
t _nodeR t syst platformR R Ry R Rj R£ ( R¦ t getterst getter( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt getnodeÍ s
|
c C sQ t rK | | k o d k n rK t j d } t | t d | 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 r,t } n t d | | | | |
|
| f d d S( s 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 R iÿÿÿÿNg eÍÍAid l @'Hw i l l ÿÿ l l ÿ l 0 l ÿl ÿ l l ? R R l @( R R Rn Ro R R RG R t _last_timestampR¡ R¢ Rª ( R R R RG t nanosecondst timestampR¡ R R R R R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt uuid1ê s, "
|
|
|
c C s@ d d l m } | | j | j } t d | d d d S( sA Generate a UUID from the MD5 hash of a namespace UUID and a name.iÿÿÿÿ( t md5R i R i ( t hashlibR¯ R t digestR ( t namespaceR( R¯ R# ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt uuid3 s c C s³ t r/ t j d } t | t d | j Sy, d d l } t d | j d d d SWnQ d d l } g t d D] } t | j
|
d ^ qz } t d | d d SXd S( s Generate a random UUID.i R iÿÿÿÿNR i i ( t _uuid_generate_randomRn Ro R R RJ t urandomR¡ R, R- R¢ ( R RJ R¡ R\ R ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt uuid4 s
|
.c C s@ d d l m } | | j | j } t d | d d d S( sC Generate a UUID from the SHA-1 hash of a namespace UUID and a name.iÿÿÿÿ( t sha1R i R i ( R° R· R R± R ( R² R( R· R# ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt uuid5% s s$ 6ba7b810-9dad-11d1-80b4-00c04fd430c8s$ 6ba7b811-9dad-11d1-80b4-00c04fd430c8s$ 6ba7b812-9dad-11d1-80b4-00c04fd430c8s$ 6ba7b814-9dad-11d1-80b4-00c04fd430c8(1 RE t
|
__author__R< R= R> R? t objectR R] Rj Ry R R R´ R R Rn t ctypes.utilt libnamet CDLLt utilt find_libraryt libt hasattrR R R¦ R§ RJ R t unameRP Rp t rpcrt4t getattrR R R£ R¥ Rª R« R® R³ R¶ R¸ t NAMESPACE_DNSt NAMESPACE_URLt NAMESPACE_OIDt NAMESPACE_X500( ( ( sL /tmp/ndk-User/buildhost/install/prebuilt/darwin-x86_64/lib/python2.7/uuid.pyt <module>- s^ ñ )
|
|
#
|
