d, dZddlmZddlZejeZddlZddl Z ddl m Z ddl m Z ddlmZmZddlZddlmZdd lmZd d lmZerddlmZddlZdd lmZe dd6dZd7dZej 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/dZ0eed1de*DZdZ2d8dZ3d9dZ4d:d Z5d;d"Z6dd*Z9d>d+Z:d>d,Z;d?d.Z<eed5a?e Z@dS)Bz 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 c#"K|] }d|dV dSz* ``np.z``N.0xs r r0Ys+@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. Arg: obj (object) : the object to test Returns: bool : True if ``obj`` is a datetime type )tupler isinstance)r> _dt_tuples rr7r7ns(-//00I c9 % %%r!(TypeGuard[dt.timedelta | np.timedelta64]cNt|tjtjfS)z Whether an object is any timedelta type recognized by Bokeh. Arg: obj (object) : the object to test Returns: bool : True if ``obj`` is a timedelta type )rBr timedeltar timedelta64r>s rr8r8}s cBL".9 : ::r!dt.datefloatctj|dddditz dzS)z Convert a date object to a datetime Args: obj (date) : the object to convert Returns: datetime Ntzinfo)rr timetupleDT_EPOCH total_secondsrHs rr3r3sA K!, :T : :X E T T V VY] ]]r!dt.timedelta | np.timedelta64ct|tjr|dzSt|tjrt |tz Std|)z Convert any recognized timedelta value to floating point absolute milliseconds. Arg: obj (object) : the object to convert Returns: float : milliseconds @@zUnknown timedelta object: ) rBrrFrQrrGrJ NP_MS_DELTA ValueErrorrHs rr6r6sm#r|$$(  ""U** C ( ((S;&''' 9#99 : ::r!SAny | pd.Timestamp | pd.Timedelta | dt.datetime | dt.date | dt.time | np.datetime64c&ddl}||jur tjSt ||jr|jdz St ||jr |jdz St ||j r |jdz St |tj r5| dtz }|dzSt |tjrt!|St |tjr!|t$z }t'|t(z St |tjr+|jdz|jdzz|jzdz|jdz zSt5d |) z Convert any recognized date, time, or datetime value to floating point milliseconds since epoch. Arg: obj (object) : the object to convert Returns: float : milliseconds rNg.A)rMrNi<rTzunknown datetime object: )rrrnanrBr to_timestampvaluerrrrreplacerPrQdater3rNP_EPOCHrJrUrhourminutesecond microsecondrV)r>rdiff epoch_deltas rr5r5s bf}}v #ry!!2!!''11#r|$$ay7"" C & &ay7"" C % %a{{${''(2!!##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]int64rTmztimedelta64[us]Or)dtypekindastypelenrBrr^ Exceptionrfs rr4r4s {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 rr9r9soHAx   $ & & 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 )rnBINARY_ARRAY_TYPESrss rr2r2-s ;0 00r!z c#"K|] }d|dV dSr+r,r-s rr0r0As*$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 rfrgrn type[Any]rctj|}tj||jk|j|kzr|S||dS)Nunsafe)casting)riinfoanyminmaxrp)rfrninfos r _cast_if_canz%transform_array.._cast_if_canVsOx 6548#5(89 : : 9L<<x<88 8r! C_CONTIGUOUS)rfrgrnrrrg)r4rnrrkint32uint64uint32rBma MaskedArrayfilledrZflagsascontiguousarray)rfrs rr<r<Ds #5 ) )E 9999 {bhrx(((( UBH-- ++ + + UBI..%*++% RV$$ ;~ &,$U++ Lr!seriesrrr?)r>rrrD)r>rIrrJ)r>rRrrJ)r>rWrrJ)rfrgrrh)rr )rfrgrr)rfrgrrg)rrrrg)A__doc__ __future__rlogging getLogger__name__logrrrz functoolsr threadingrtypingrrnumpyr core.typesr r stringsr numpy.typingnptrrtyping_extensionsr r r'rnbool_uint8int8uint16int16rrfloat32float64rrr_rGrUutcfromtimestamprPjoin__all__r7r8r3r6r5r4r;r:r9r2r<r=rxrwr,r!rrs  #"""""g!! %%%%%%%%%%%%%%,++++++  4  BHRX BHRX BHRW BHRY BHRX BHRY BHRX BHRZ BHRZ  2=D ! !bnQ%% ; ' ' * *  7tyy@m@mZl@m@m@m7m7m n n n & & & & & ; ; ; ; ^ ^ ^ ^;;;;&0:0:0:0:f:))))* ! ! ! !1111(1111$#3"2#}}$Q$Q>P$Q$Q$QQQ### $$$$L8 $&&r!