-e, ,dZddlmZddlZejeZddlZddl Z ddl m Z ddl m Z ddlmZmZddlZddlmZdd lmZd d lmZerddlmZddlZdd lmZe dd7dZd8dZej ej!ej ej"ej ej#ej ej$ej ej%ej ej&ej ej'ej ej(ej ej)h Z*ej+ddZ,ej-d dZ.ej/dej0j1Z2eed3de*DZdZ4d9dZ5d:dZ6d;d!Z7dd)Z:d?d+Z;d?d,Zee>jd03d1e*De>_dAd2Z?dBd5Z@d6aAe ZBdS)Cz Functions for helping with serialization and deserialization of Bokeh objects. Certain NumPy array dtypes can be serialized to a binary format for performance and efficiency. The list of supported dtypes is: {binary_array_types} ) annotationsN) lru_cache)Lock) TYPE_CHECKINGAny)ID)settings)format_docstring) TypeGuardreturn set[type]c>ddl}tjtjtjh}||j||j||j |t|j |S)Nr) pandasdttimedatetimenp datetime64add Timestamp TimedeltaPeriodtypeNaT)pdresults 8lib/python3.11/site-packages/bokeh/util/serialization.py_compute_datetime_typesr 6s{gr{BM 2F JJr| JJr| JJry JJtBF|| Mnamestrrc8|dkrtSt)NDATETIME_TYPES)r AttributeError)r"s r __getattr__r'As  &((( r!ms)tz c#"K|] }d|dV dSz* ``np.z``N.0xs r r1Ys+@m@mUV1@m@m@m@m@m@mr!)binary_array_types) array_encoding_disabledconvert_date_to_datetimeconvert_datetime_arrayconvert_datetime_typeconvert_timedelta_typeis_datetime_typeis_timedelta_type make_globally_unique_css_safe_idmake_globally_unique_idmake_idtransform_arraytransform_seriesobj0TypeGuard[dt.time | dt.datetime | np.datetime64]cXtt}t||S)z Whether an object is any date, time, or datetime type recognized by Bokeh. Args: obj (object) : the object to test Returns: bool : True if ``obj`` is a datetime type )tupler isinstance)r? _dt_tuples rr8r8ns(-//00I c9 % %%r!(TypeGuard[dt.timedelta | np.timedelta64]cNt|tjtjfS)z Whether an object is any timedelta type recognized by Bokeh. Args: obj (object) : the object to test Returns: bool : True if ``obj`` is a timedelta type )rCr timedeltar timedelta64r?s rr9r9}s cBL".9 : ::r!dt.datefloatctj|dddtjjit z dzS)z Convert a date object to a datetime Args: obj (date) : the object to convert Returns: datetime Ntzinfo)rr timetupletimezoneutcDT_EPOCH total_secondsrIs rr4r4sE K!, ER[_ E E P _ _ a adh hhr!dt.timedelta | np.timedelta64ct|tjr|dzSt|tjrt |tz Std|)z Convert any recognized timedelta value to floating point absolute milliseconds. Args: obj (object) : the object to convert Returns: float : milliseconds @@zUnknown timedelta object: ) rCrrGrTrrHrK NP_MS_DELTA ValueErrorrIs rr7r7sm#r|$$(  ""U** C ( ((S;&''' 9#99 : ::r!SAny | pd.Timestamp | pd.Timedelta | dt.datetime | dt.date | dt.time | np.datetime64cDddl}||jur tjSt ||jr|jdz St ||jr |jdz St ||j r |jdz St |tj rD| tj jtz }|dzSt |tjrt%|St |tjr!|t(z }t+|t,z St |tjr+|jdz|jdzz|jzdz|jdz zSt9d |) z Convert any recognized date, time, or datetime value to floating point milliseconds since epoch. Args: obj (object) : the object to convert Returns: float : milliseconds rNg.A)rNrOi<rWzunknown datetime object: )rrrnanrCr to_timestampvaluerrrrreplacerQrRrSrTdater4rNP_EPOCHrKrXrhourminutesecond microsecondrY)r?rdiff epoch_deltas rr6r6s bf}}v #ry!!2!!''11#r|$$ay7"" C & &ay7"" C % %a{{"+/{22X=!!##d** C ! ! a',,, C ' 'aHn [;./// C ! !a4#*r/1CJ>$F[`I``` 888 9 99r!arraynpt.NDArray[Any]npt.NDArray[np.floating[Any]]c|jjdkr+|dddz S|jjdkr+|dddz S|jjdkrot|dkr\t |dt jr< |dddz S#t$rYnwxYw|S) a Convert NumPy datetime arrays to arrays to milliseconds since epoch. Args: array : (obj) A NumPy array of datetime to convert If the value passed in is not a NumPy array, it will be returned as-is. Returns: array Mzdatetime64[us]int64rWmztimedelta64[us]Or)dtypekindastypelenrCrra Exceptionris rr5r5s {3||,--44W==FF  S ||-..55g>>GG  S SZZ!^^ 58RW8U8U^ << 01188AAFJ J    D  Ls;*C&& C32C3r ctjrBt5tdz at dtcdddS#1swxYwYdSt S)a Return a new unique ID for a Bokeh object. Normally this function will return simple monotonically increasing integer IDs (as strings) for identifying Bokeh objects within a Document. However, if it is desirable to have globally unique for every object, this behavior can be overridden by setting the environment variable ``BOKEH_SIMPLE_IDS=no``. Returns: str r pN)r simple_ids_simple_id_lock _simple_idr r;r-r!rr<r<s)  ( ( !OJ&*&&'' ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ( ('(((s!A  A A c\tttjS)z Return a globally unique UUID. Some situations, e.g. id'ing dynamically created Divs in HTML documents, always require globally unique IDs. Returns: str )r r#uuiduuid4r-r!rr;r; s  c$*,,  r!cd}td|D].}t}|dr|cS/tdtS)a Return a globally unique CSS-safe UUID. Some situations, e.g. id'ing dynamically created Divs in HTML documents, always require globally unique IDs. ID generated with this function can be used in APIs like ``document.querySelector("#id")``. Returns: str drzbk-)ranger;isalphar )max_iter_iids rr:r:soHAx   $ & & a5==?? III  /+--// 0 00r!boolc|jtvS)z Determine whether an array may be binary encoded. The NumPy array dtypes that can be encoded are: {binary_array_types} Args: array (np.ndarray) : the array to check Returns: bool )rqBINARY_ARRAY_TYPESrvs rr3r3-s ;0 00r!z c#"K|] }d|dV dSr,r-r.s rr1r1As*$Q$Q_q___$Q$Q$Q$Q$Q$Qr!ct|}dd}|jtjtjkr||tj}n=|jtjtjkr||tj}t|tjj r| tj }|j dstj |}|S) z Transform a ndarray into a serializable ndarray. Converts un-serializable dtypes and returns JSON serializable format Args: array (np.ndarray) : a NumPy array to be transformed Returns: ndarray rirjrq type[Any]rctj|}tj||jk|j|kzr|S||dS)Nunsafe)casting)riinfoanyminmaxrs)rirqinfos r _cast_if_canz%transform_array.._cast_if_canVsOx 6548#5(89 : : 9L<<x<88 8r! C_CONTIGUOUS)rirjrqrrrj)r5rqrrnint32uint64uint32rCma MaskedArrayfilledr]flagsascontiguousarray)rirs rr=r=Ds #5 ) )E 9999 {bhrx(((( UBH-- ++ + + UBI..%*++% RV$$ ;~ &,$U++ Lr!seriesr>jsP&".))!""$$+   Kr!i)rr)r"r#rr)r?rrr@)r?rrrE)r?rJrrK)r?rUrrK)r?rZrrK)rirjrrk)rr )rirjrr)rirjrrj)rrrrj)C__doc__ __future__rlogging getLogger__name__logrrr} functoolsr threadingrtypingrrnumpyr core.typesr r stringsr numpy.typingnptrrtyping_extensionsr r r'rqbool_uint8int8uint16int16rrfloat32float64rrrbrHrX fromtimestamprQrRrSjoin__all__r8r9r4r7r6r5r<r;r:r3r=r>r{rzr-r!rrs  #"""""g!! %%%%%%%%%%%%%%,++++++  4  BHRX BHRX BHRW BHRY BHRX BHRY BHRX BHRZ BHRZ  2=D ! !bnQ%% ; $ $Q2;? $ ; ;  7tyy@m@mZl@m@m@m7m7m n n n & & & & & ; ; ; ; i i i i;;;;&0:0:0:0:f:))))* ! ! ! !1111(1111$#3"2#}}$Q$Q>P$Q$Q$QQQ### $$$$L8 $&&r!