hKj* dZdZddlZddlZddlZddlZddlmZmZm Z ddl Z ejZ dde gdgdfdee dee dege fd e e je e effd Zddee d e fd Z dd eege fd e fd Z dde e e je fd ee fdZ dde e e je fd eejfdZy)z Implementation of UUID v7 per the October 2021 draft update to RFC4122 from 2005: https://datatracker.ietf.org/doc/html/draft-peabody-dispatch-new-uuid-format Stephen Simmons, v0.1.0, 2021-12-27 )uuid7uuid7strtime_nscheck_timing_precisionuuid_to_datetimeN)CallableOptionalUnion)rrrrnsas_type time_funcreturnc | |}|}n |}t|}|dk(r dx}x}x}} d} nd} t|| \}} t| dz| \}} t| dz| \}}|dz}||dk(r&||dk(r||d k(r|d d kr|d xxdz cc<n |||df|ddd |d z} tjd } |dk(r"|dd|dd|dd| dd| j Stj | d}|dz|dzz|dzz| dzz|z}|dk(r|S|dk(r|dS|dk(r|j ddStj|S)u- UUID v7, following the proposed extension to RFC4122 described in https://www.ietf.org/id/draft-peabody-dispatch-new-uuid-format-02.html. All representations (string, byte array, int) sort chronologically, with a potential time resolution of 50ns (if the system clock supports this). Parameters ---------- ns - Optional integer with the whole number of nanoseconds since Unix epoch, to set the "as of" timestamp. As a special case, uuid7(ns=0) returns the zero UUID. as_type - Optional string to return the UUID in a different format. A uuid.UUID (version 7, variant 0x10) is returned unless this is one of 'str', 'int', 'hex' or 'bytes'. time_func - Set the time function, which must return integer nanoseconds since the Unix epoch, midnight on 1-Jan-1970. Defaults to time.time_ns(). This is exposed because time.time_ns() may have a low resolution on Windows. _last and _last_as_of - Used internally to trigger incrementing a sequence counter when consecutive calls have the same time values. The values [t1, t2, t3, seq] are described below. Returns ------- A UUID object, or if as_type is specified, a string, int or bytes of length 16. Implementation notes -------------------- The 128 bits in the UUID are allocated as follows: - 36 bits of whole seconds - 24 bits of fractional seconds, giving approx 50ns resolution - 14 bits of sequential counter, if called repeatedly in same time tick - 48 bits of randomness plus, at locations defined by RFC4122, 4 bits for the uuid version (0b111) and 2 bits for the uuid variant (0b10). 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ t1 | unixts (secs since epoch) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ t2/t3 |unixts | frac secs (12 bits) | ver | frac secs (12 bits) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ t4/rand |var| seq (14 bits) | rand (16 bits) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ rand | rand (32 bits) | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Indicative timings: - uuid.uuid4() 2.4us - uuid7() 3.7us - uuid7(as_type='int') 1.6us - uuid7(as_type='str') 2.5us Examples -------- >>> uuid7() UUID('061cb26a-54b8-7a52-8000-2124e7041024') >>> uuid7(0) UUID('00000000-0000-0000-0000-00000000000') >>> for fmt in ('bytes', 'hex', 'int', 'str', 'uuid', None): ... print(fmt, repr(uuid7(as_type=fmt))) bytes b'¸þ |9€ jt…³»' hex '061cb8fe0f0b7c3980011863b956b758' int 8124504378724980906989670469352026642 str '061cb8fe-0f0b-7c39-8003-d44a7ee0bdf6' uuid UUID('061cb8fe-0f0b-7c39-8004-0489578299f6') None UUID('061cb8fe-0f0f-7df2-8000-afd57c2bf446') Nrsl Ys ip?istrz>08x-z>04xbig`P@0inthexz>032xbytes)r) rdivmodosurandomr from_bytesto_bytesuuidUUID)r r r _last _last_as_oflastt1t2t3t4rand sixteen_secsrest1rest2_ruuid_ints f/Users/ahmed/devFolder/Ultron/claude-voice/.venv/lib/python3.12/site-packages/uuid_extensions/uuid7.pyrrsn z [ W QwR"r& 2|, E5B; 5 Eu{L1A g  a=R47]rT!W} AwQ1 2r1oDGa zz!}%T!Bt9AbYa4y$((*FF tU#AbR2X&"(3rRx@1DH% E 5!" G   U++yyX&&ct|dS)z9uuid7() as a string without creating a UUID object first.r)r )r)r s r6rrs U ##r7 timing_funccdtjfdtjfddfg}||jd|fg}|D]\}}tj}t }d} |j ||dz }tj|z }|dkDst |d k\rnG|t |z } ||z } |j|d | d d | d d |ddt |dd|dz dd dj|S)aL Message indicating the timing precision from various time/clock functions that might be used for UUIDv7 generation. This tests time.time_ns(), time.perf_counter_ns() and datetime.datetime.utcnow converted to ns. A user-supplied timing function may also be provided. It must return the number of ns since the Unix Epoch (midnight at 1-Jan-1970). Note that time.time_ns() updates every 200us under Linux and potentially as infrequently as every 5ms under Windows. Usage: >>> check_timing_precision() # Under Linux time.time_ns() has a timing precision of 221ns rather than 221ns (1,000 distinct samples in 0.00s) time.perf_counter_ns() has a timing precision of 215ns rather than 215ns (1,000 distinct samples in 0.00s) datetime.datetime.utcnow has a timing precision of 1,046ns rather than 679ns (1,000 distinct samples in 0.00s) # Under Windows time.time_ns() has a timing precision of 4,950,500ns rather than 709ns (705,068 samples of which 101 are distinct, in 0.50s) time.perf_counter_ns() has a timing precision of 823ns rather than 823ns (1,000 samples of which 1,000 are distinct, in 0.00s) datetime.datetime.utcnow has a timing precision of 5,882,365ns rather than 2,812ns (177,792 samples of which 85 are distinct, in 0.50s) ztime.time_ns()ztime.perf_counter_ns()zdatetime.datetime.utcnowcrttjjjdzS)Nʚ;)rdatetimeutcnow timestampr7r6z(check_timing_precision..s*S    $ $ & 0 0 2] B.Dr7z user-suppliedrrieiz has a timing precision of z0,.0fzns rather than zns (,z samples of which z are distinct, in r<z0.2fzs) )timerperf_counter_nsappendsetaddlenjoin) r9 timing_funcslinesdescfn started_nsvaluesctr elapsed_ns precision_nsideal_precision_nss r6rrsH: 4<<( !4#7#78 #&D EL _k:; E b))+  JJrt  1HC--/*  "CK/ '#- f/ U/CD  &d3q'2VQ!*}"t t |jddd}tj |dd}|dd z }|d k(rntjd |}|d d z dz}|dd z|dd z z}|ddzdz|d dzdzz|ddzz}t|dzd\}} |dz|z} | S|rytt |d|d)a\ Recover the timestamp from a UUIDv7, passed in as a string, integer or a UUID object. If the UUID is not a version 7 UUID, either raise a ValueError or return None, depending on suppress_error. Usage: >>> uuid_to_datetime("1eb22fe4-3f0c-62b1-a88c-8dc55231702f") datetime.datetime(2020, 11, 10, 2, 41, 42, 182162) srr)length byteorderr)baserz>IHHHHIrrrrirrr<lNz is a version z1 UUID, not v7 so we cannot extract the timestamp.) isinstancer&r'r rr%rreplacestructunpackr! ValueError) rUsuppress_errorxint_uuid uuid_versionbits whole_secs frac_binaryfrac_nsr3ns_since_epochs r6 timestamp_nsrnsV!TYY GG   As  LL2L 7s1v~~c2.R8 LL"L >Q419Lq}}Y*Q2 , 1gltAw"}5 1g2 %Q& R' )Q&  #  K-7A #m3g= 1vhn\N3+ ,  r7ct||}|ytjj|dz tjjS)N)rer<)tz)rnr= fromtimestamptimezoneutc)rUrerms r6rrsN"!NCN  .. ] *  $$/  r7)N)T)__doc____all__r=r"rbrDtypingrr r r&rrrr'r rrrrnrr@r7r6rws>  ,,  ,,!#*  M' M' c]M'C M'  499c3 %& M'`$#$#$ 048(2s7+,88z-  S$))S !- c]- d   S$))S !  h   r7