← Back
Editing: uuid.cpython-33.pyc
� �� 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 <ping@zesty.ca>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 | t � s�t t | � � � t d d t | � d � } n | d k r%t | � d k r�t d � � n | \ } } } } } } d | k od' k n st d � � n d | k o.d( k n sBt d � � n d | k oYd) k n smt d � � n d | k o�d* k n s�t 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 oHd- k n s_t d � � q_n | d k r�d | k o�d k n s�t d! � � n | d/ M} | d0 O} | d2 M} | | d% >O} n | | j d& <d S(3 um 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 u0 need one of hex, bytes, bytes_le, fields, or intu urn:u u uuid:u {}u -i u$ badly formed hexadecimal UUID stringi u bytes_le is not a 16-char stringi i i Nu bytes is not a 16-char stringu %02xu fields is not a 6-tuplei u* field 1 out of range (need a 32-bit value)u* field 2 out of range (need a 16-bit value)u* field 3 out of range (need a 16-bit value)u* field 4 out of range (need an 8-bit value)u* field 5 out of range (need an 8-bit value)i0 u* field 6 out of range (need a 48-bit value)i` iP i@ i� u* int is out of range (need a 128-bit value)i u illegal version numberi � i � i � iL u intl i i i i l l l l���� l l l���� ( u countu Noneu TypeErroru replaceu stripu lenu ValueErroru int_u bytes_u reversedu isinstanceu AssertionErroru repru tupleu __dict__( u selfu hexu bytesu bytes_leu fieldsu intu versionu time_lowu time_midu time_hi_versionu clock_seq_hi_variantu clock_seq_lowu nodeu clock_seq( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __init__h s^ $ M ! ) u UUID.__init__c C s# t | t � r | j | j k St S( N( u isinstanceu UUIDu intu NotImplemented( u selfu other( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __eq__� s u UUID.__eq__c C s# t | t � r | j | j k St S( N( u isinstanceu UUIDu intu NotImplemented( u selfu other( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __ne__� s u UUID.__ne__c C s# t | t � r | j | j k St S( N( u isinstanceu UUIDu intu NotImplemented( u selfu other( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __lt__� s u UUID.__lt__c C s# t | t � r | j | j k St S( N( u isinstanceu UUIDu intu NotImplemented( u selfu other( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __gt__� s u UUID.__gt__c C s# t | t � r | j | j k St S( N( u isinstanceu UUIDu intu NotImplemented( u selfu other( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __le__� s u UUID.__le__c C s# t | t � r | j | j k St S( N( u isinstanceu UUIDu intu NotImplemented( u selfu other( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __ge__� s u UUID.__ge__c C s t | j � S( N( u hashu int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __hash__� s u UUID.__hash__c C s | j S( N( u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __int__� s u UUID.__int__c C s d t | � S( Nu UUID(%r)( u str( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __repr__� s u UUID.__repr__c C s t d � � d S( Nu UUID objects are immutable( u TypeError( u selfu nameu value( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __setattr__� s u UUID.__setattr__c C sV d | j } d | d d � | d d � | d d � | d d � | d d � f S( Nu %032xu %s-%s-%s-%s-%si i i i ( u int( u selfu hex( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu __str__� s u UUID.__str__c C sK t � } x5 t d d d � D]! } | j d | j | ?d @� q Wt | � S( Ni i� i i� ( u bytearrayu rangeu insertu intu bytes_( u selfu bytesu shift( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu bytes� s u UUID.bytesc C se | j } t t | d d � � � t t | d d � � � t t | d d � � � | d d � S( Ni i i i ( u bytesu bytes_u reversed( u selfu bytes( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu bytes_le� s Mu UUID.bytes_lec C s( | j | j | j | j | j | j f S( N( u time_lowu time_midu time_hi_versionu clock_seq_hi_variantu clock_seq_lowu node( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu fields� s u UUID.fieldsc C s | j d ?S( Ni` ( u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu time_low� s u UUID.time_lowc C s | j d ?d @S( NiP i�� ( u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu time_mid s u UUID.time_midc C s | j d ?d @S( Ni@ i�� ( u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu time_hi_version s u UUID.time_hi_versionc C s | j d ?d @S( Ni8 i� ( u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu clock_seq_hi_variant s u UUID.clock_seq_hi_variantc C s | j d ?d @S( Ni0 i� ( u int( u self( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu clock_seq_low s u UUID.clock_seq_lowc C s! | j d @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 <lambda>^ s u# _ifconfig_getnode.<locals>.<lambda>i Nu arpu -anc S s d S( Ni i����( ( u i( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu <lambda>f s u lanscanu -aiu lan0c S s d S( Ni ( ( u i( ( u) /opt/alt/python33/lib64/python3.3/uuid.pyu <lambda>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 <genexpr>B s u uuid4.<locals>.<genexpr>( 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 <module>- sh � ! ( #
Save File
Cancel