B
8?]V @ sv d Z ddlZddlZddlmZ dZddddg\ZZZZ e
Z e Z
G d d
d
eZG d d d Zd
d Zdd Zdd Zdd Zdd Zdd Zdd Zdd Zd d Zd d Zd aada y ddl Z W n e k
r dZ Y nX d!d" Z d#d$ Z d%d& Z!d'd( Z"da#e!eegZ$e eeeeegZ%dd)d*d+Z&da'd8d,d-Z(d.d/ Z)d0d1 Z*d2d3 Z+ed4Z,ed5Z-ed6Z.ed7Z/dS )9aQ 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')
N)EnumzKa-Ping Yee z reserved for NCS compatibilityzspecified in RFC 4122z$reserved for Microsoft compatibilityz reserved for future definitionc @ s e Zd ZdZdZdZdS )SafeUUIDr N)__name__
__module__ __qualname__ZsafeZunsafeunknown r r )/opt/alt/python37/lib64/python3.7/uuid.pyr ? s r c @ s6 e Zd ZdZd | B }|d"> | d#> B |
d$> B |d%> B |
B }|dk rDd| kr:d&d'> k sDn td(|dk rd&| krfdkspn td)|d*M }|d+O }|d,M }||d-> O }|| jd.< || jd/< dS )0aL 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'.
is_safe is an enum exposed as an attribute on the instance. It
indicates whether the UUID has been generated in a way that is safe
for multiprocessing applications, via uuid_generate_time_safe(3).
N zGone of the hex, bytes, bytes_le, fields, or int arguments must be givenzurn: zuuid:z{}- z$badly formed hexadecimal UUID string z bytes_le is not a 16-char string r z bytes is not a 16-char stringbig) byteorder zfields is not a 6-tupler l z*field 1 out of range (need a 32-bit value)i z*field 2 out of range (need a 16-bit value)z*field 3 out of range (need a 16-bit value) z*field 4 out of range (need an 8-bit value)z*field 5 out of range (need an 8-bit value)l z*field 6 out of range (need a 48-bit value)` P @ 0 z*int is out of range (need a 128-bit value)zillegal version numberl l l L intr ) count TypeErrorreplacestriplen
ValueErrorint_
from_bytes__dict__)selfhexbytesbytes_lefieldsr! versionr time_lowtime_midtime_hi_versionclock_seq_hi_variant
clock_seq_lownode clock_seqr r r
__init__y s\
6
$
z
UUID.__init__c C s. | j }| jtjkr$| jj|d< n|d= |S )Nr )r* copyr r r value)r+ stater r r
__getstate__ s
zUUID.__getstate__c C s0 | j | d|kr t|d ntj| j d< d S )Nr )r* updater r )r+ r; r r r
__setstate__ s zUUID.__setstate__c C s t |tr| j|jkS tS )N)
isinstancer r! NotImplemented)r+ otherr r r
__eq__ s
z UUID.__eq__c C s t |tr| j|jk S tS )N)r? r r! r@ )r+ rA r r r
__lt__ s
z UUID.__lt__c C s t |tr| j|jkS tS )N)r? r r! r@ )r+ rA r r r
__gt__ s
z UUID.__gt__c C s t |tr| j|jkS tS )N)r? r r! r@ )r+ rA r r r
__le__ s
z UUID.__le__c C s t |tr| j|jkS tS )N)r? r r! r@ )r+ rA r r r
__ge__ s
z UUID.__ge__c C s
t | jS )N)hashr! )r+ r r r
__hash__ s z
UUID.__hash__c C s | j S )N)r! )r+ r r r
__int__ s z UUID.__int__c C s d| j jt| f S )Nz%s(%r)) __class__r str)r+ r r r
__repr__ s z
UUID.__repr__c C s t dd S )NzUUID objects are immutable)r# )r+ namer: r r r
__setattr__ s zUUID.__setattr__c C sD d| j }d|d d |dd |dd |dd |dd f S )Nz%032xz%s-%s-%s-%s-%sr r )r! )r+ r, r r r
__str__
s
z UUID.__str__c C s | j ddS )Nr r )r! to_bytes)r+ r r r
r- s z
UUID.bytesc C s< | j }|dd d |ddd |ddd |dd S )Nr r r r r )r- )r+ r- r r r
r. s (z
UUID.bytes_lec C s | j | j| j| j| j| jfS )N)r1 r2 r3 r4 r5 r6 )r+ r r r
r/ s z UUID.fieldsc C s
| j d? S )Nr )r! )r+ r r r
r1 s z
UUID.time_lowc C s | j d? d@ S )Nr i )r! )r+ r r r
r2 " s z
UUID.time_midc C s | j d? d@ S )Nr i )r! )r+ r r r
r3 & s zUUID.time_hi_versionc C s | j d? d@ S )N8 )r! )r+ r r r
r4 * s zUUID.clock_seq_hi_variantc C s | j d? d@ S )Nr rT )r! )r+ r r r
r5 . s zUUID.clock_seq_lowc C s | j d@ d> | jd> B | jB S )Ni r r )r3 r2 r1 )r+ r r r
time2 s z UUID.timec C s | j d@ d> | jB S )N? r )r4 r5 )r+ r r r
r7 7 s zUUID.clock_seqc C s
| j d@ S )Nl )r! )r+ r r r
r6 < s z UUID.nodec C s
d| j S )Nz%032x)r! )r+ r r r
r, @ s zUUID.hexc C s dt | S )Nz urn:uuid:)rK )r+ r r r
urnD s zUUID.urnc C s2 | j d@ stS | j d@ s tS | j d@ s*tS tS d S )Nl l l )r! RESERVED_NCSRFC_4122RESERVED_MICROSOFTRESERVED_FUTURE)r+ r r r
variantH s
z UUID.variantc C s | j tkr t| jd? d@ S d S )Nr )r\ rY r! )r+ r r r
r0 S s
z UUID.version)NNNNNN)#r r r __doc__r r r8 r< r> rB rC rD rE rF rH rI rL rN rQ propertyr- r. r/ r1 r2 r3 r4 r5 rU r7 r6 r, rW r\ r0 r r r r
r E s> 2 T r c G s dd l }dd l}dd l}|| }|d krP|jd}|j| |d}|d krPd S t|j}d|d< |j|f| |j |j
|d}|S )Nr )z/sbinz /usr/sbin)pathCLC_ALL)stdoutstderrenv) osshutil
subprocessZwhichpathsepjoindictenvironPopenPIPEZDEVNULL) commandargsrf rg rh
executabler` re procr r r
_popenY s
rs c C s
| d@ S )Nl r )macr r r
_is_universal{ s ru c C s d }yt | f| }|s d S | x|jD ]}| }xptt|D ]`}|| |krPy6||| } t| ddd}
t |
r|
S |p|
}W qP t
t fk
r Y qPX qPW q.W W d Q R X W n t k
r Y nX |pd S )N : r )
rs splitrc lowerrstripranger& r! r$ ru r'
IndexErrorOSError) ro rp Zhw_identifiersZ get_indexfirst_local_macrr linewordsiwordrt r r r
_find_mac~ s* r c C s2 d} x(dD ] }t d|| dd }|r(|S dS W dS )z5Get the hardware address on Unix by running ifconfig.)s hwaddrs ethers address:s lladdr)r z-az-avZifconfigc S s | d S )Nr r )r r r r
rw z#_ifconfig_getnode..N)r )keywordsrp rt r r r
_ifconfig_getnode s
r c C s t dddgdd } | r | S dS )z/Get the hardware address on Unix by running ip.Ziplinks
link/etherc S s | d S )Nr r )r r r r
r rw z _ip_getnode..N)r )rt r r r
_ip_getnode s r c C s ddl } ddl}y|| }W n tk
r6 dS X tdd| |gdd }|rZ|S tdd| |gdd }|r||S tdd| d| gd d }|r|S dS )
z0Get the hardware address on Unix by running arp.r NZarpz-anc S s dS )Nr r )r r r r
r rw z _arp_getnode..c S s | d S )Nr r )r r r r
r rw z(%s)c S s | d S )N r )r r r r
r rw )rf socketZ
gethostbynameZ gethostnamer} r fsencode)rf r Zip_addrrt r r r
_arp_getnode s
r c C s t dddgdd S )z4Get the hardware address on Unix by running lanscan.Zlanscanz-ais lan0c S s dS )Nr r )r r r r
r rw z"_lanscan_getnode..)r r r r r
_lanscan_getnode s r c C s d} yt dd}|sdS | |j }y|d}W n tk
rR dS X x|jD ]v}yX| }|| }t|dkr|ddkrt |
ddd }t |r|S | p|} W q\ tt fk
r Y q\X q\W W dQ R X W n t
k
r Y nX | p dS )
z4Get the hardware address on Unix by running netstat.NZnetstatz-ias Address rv r rw r )rs rc readlinerz rx indexr' r& r" r! r$ ru r| r} )r~ rr r r r r rt r r r
_netstat_getnode s2
r c
C s. ddl } ddl}ddl}d}dddg}y:ddl}|d}|jj|d |d|j
d W n Y nX x|D ]}y$|j | j
|dd g|jd
d }W n tk
r wtY nX |b xZ|jD ]P} | d d
}
|d|
rt|
ddd} t| r| S |p| }qW W dQ R X qtW |p,dS )z
r c
s~ t dk r dS da tjdkr8tt jdd dk r8ntdk rPtj a
tj a dS yddl ddl
dg} tjds~| d x| D ]~}yj|}W n tk
r wY nX t|d
r|jfd d a
d
a P qt|dr|j d _ fdd a
P qW y jj}W n d}Y nX t|dt|ddaW n> tk
rx } z ddl }| d| t W dd}~X Y nX dS )zG
Try to load platform-specific functions for generating uuids.
NFdarwin.r Zuuidwincuuid_generate_time_safec s d} | }t| j|fS )Nr )r r- raw)_bufferZres)_uuid_generate_time_safer r r
_generate_time_safea s
r Tuuid_generate_timec s d} | t| jd fS )Nr )r r- r )r )_uuid_generate_timer r r
r l s
ZUuidCreateSequentialZ
UuidCreatez/Could not find fallback ctypes uuid functions: ) _has_uuid_generate_time_safesysplatformr! rf unamereleaserx _uuidZgenerate_time_safer Zhas_uuid_generate_time_safer Z ctypes.util
startswithappendZCDLLutilZ find_library Exceptionhasattrr r Zrestyper Zrpcrt4getattr _UuidCreatewarningswarn
ImportWarning)Z _libnamesZlibnamelibexcr r )r r r r
_load_system_functions3 sP &
r c C s t t \} }t| djS )zPGet the hardware address on Unix using the _uuid extension module
or ctypes.)r- )r r r r6 ) uuid_time_r r r
_unix_getnode s
r c C s: ddl } t | d}t|dkr6tt|jdjS dS )z1Get the hardware address on Windows using ctypes.r Nr )r- )r r r r r bytes_r r6 )r r r r r
_windll_getnode s
r c C s ddl } | ddB S )zGet a random node ID.r Nr l )random getrandbits)r r r r
_random_getnode s r )gettersc C sv t dk r t S tjdkr t} nt} xP| tg D ]B}y
| a W n w,Y nX t dk r,dt krfdk r,n q,t S q,W dS )a3 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.
NZwin32r l )_noder r _NODE_GETTERS_WIN32_NODE_GETTERS_UNIXr )r getterr r r
getnode s
r c C s t tdk rd| | kr"dkrdn n>t \}}y t|}W n tk
rV tj}Y nX t||dS ddl}t| d }t|d d }tdk r|tkrtd }|a|dkrddl }|
d}|d @ } |d
? d @ }
|d ? d
@ } |d@ } |d? d@ }
| dkrt } t| |
| |
| | fddS )a 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.N)r- r r g eAd l @'Hw
r l r i r i rT r rV )r/ r0 ) r r r r' r r rU r! _last_timestampr r r )r6 r7 r Zsafely_generatedr rU Z nanosecondsZ timestampr r1 r2 r3 r5 r4 r r r
uuid1 s4
r c C s8 ddl m} || jt|d }t|dd ddS )zAGenerate a UUID from the MD5 hash of a namespace UUID and a name.r )md5zutf-8Nr r )r- r0 )hashlibr r- digestr ) namespacerM r rG r r r
uuid3 s r c C s t tdddS )zGenerate a random UUID.r r
)r- r0 )r rf urandomr r r r
uuid4 s r c C s8 ddl m} || jt|d }t|dd ddS )zCGenerate a UUID from the SHA-1 hash of a namespace UUID and a name.r )sha1zutf-8Nr r )r- r0 )r r r- r r )r rM r rG r r r
uuid5 s r z$6ba7b810-9dad-11d1-80b4-00c04fd430c8z$6ba7b811-9dad-11d1-80b4-00c04fd430c8z$6ba7b812-9dad-11d1-80b4-00c04fd430c8z$6ba7b814-9dad-11d1-80b4-00c04fd430c8)NN)0r^ rf r enumr
__author__rX rY rZ r[ r! r( r- r r r rs ru r r r r r r r r r r r r ImportErrorr r r r r r r r r r r r r Z
NAMESPACE_DNSZ
NAMESPACE_URLZ
NAMESPACE_OIDZNAMESPACE_X500r r r r
- s\ "
$
T
'