%edUdZddlmZddlZddlZddlZddlZddlZddlZddl m Z m Z m Z m Z mZmZmZmZddlmZddlmZdZded <d Zd ed <ejd krddiniZded<dZdZdZdZd5dZedZ d6d Z!ed!e""Z#d7d&Z$Gd'd(e%Z&d8d+Z'd9d/Z(d:d4Z)dS);zA bunch of useful utilities.) annotationsN)AnyDictIterableListMappingSetTypeVarUnion)Final)env_utilzhttps://docs.streamlit.io/r HELP_DOCgdy=z Final[float]FLOAT_EQUALITY_EPSILON) usedforsecurityFDict[str, Any]HASHLIB_KWARGScNgtjfd}|S)z2Decorator to memoize the result of a no-args func.cRsdSNr)append)funcresults.lib/python3.11/site-packages/streamlit/util.py wrapped_funczmemoize..wrapped_func.s- " MM$$&& ! ! !ay) functoolswraps)rrrs` @rmemoizer *sDF_T rcNtjrt|dStjr7tjdrt d|dSt|dStjrt d|dSddl}td| z)aOpen a web browser pointing to a given URL. We use this function instead of Python's `webbrowser` module because this way we can capture stdout/stderr to avoid polluting the terminal with the browser's messages. For example, Chrome always prints things like "Created new window in existing browser session", and those get on the user's way. url : str The URL. Must include the protocol. Nzxdg-openopenrz$Cannot open browser in platform "%s") r IS_WINDOWS_open_browser_with_webbrowserIS_LINUX_OR_BSDis_executable_in_path_open_browser_with_command IS_DARWINplatformErrorsystem)urlr)s r open_browserr-7s0%c***  )* 5 5  &z3 7 7 7 F%c***"63///OOO 69J9JJ K KKrc8ddl}||dSr) webbrowserr")r,r/s rr$r$as&OOCrc||g}ttjd5}tj||tjddddS#1swxYwYdS)Nw)stdoutstderr)r"osdevnull subprocessPopenSTDOUT)commandr,cmd_liner5s rr'r'gs~H bj#  M''*:KLLLLMMMMMMMMMMMMMMMMMMs"AAAselfrreturnstrcbjj}dddgttgt jr"fdt jD}n%fdjD}d d|D}|d|d S) zA clean repr for a class, excluding both values that are likely defaults, and those explicitly default for dataclasses. NFc3K|]\}|jrSt|j|jkr5t|jv>|jt|jfV]dSN)reprgetattrnamedefault).0fdefaultsr;s r zrepr_..vs  v af%%22af%%X55 VWT16** +6555   rc3.K|]\}}|v ||fVdSrA)rFrGvrHs rrIzrepr_..~s5WW&1aQhEVEV1vEVEVEVEVWWrz, c3*K|]\}}|d|VdS)=NrK)rFfieldvalues rrIzrepr_..s4QQ\UEu00u00QQQQQQr()) __class____name__setdict dataclasses is_dataclassfields__dict__itemsjoin)r; classname fields_vals field_reprsrHs` @rrepr_r`ms'I UBtvv>H%% X      '--   XWWWDM,?,?,A,AWWW ))QQ[QQQQQK ( (+ ( ( ((r_ValueiterableIterable[_Value]xintc0t|D]X\}}||kr|cSt|tr4t|trt||z tkr|cSYt dt|)aReturn zero-based index of the first item whose value is equal to x. Raises a ValueError if there is no such item. We need a custom implementation instead of the built-in list .index() to be compatible with NumPy array and Pandas Series. Parameters ---------- iterable : list, tuple, numpy.ndarray, pandas.Series x : Any Returns ------- int z{} is not in iterable) enumerate isinstancefloatabsr ValueErrorformatr=)rbrdirPs rindex_rns h''5 ::HHH u % % *Q*>*> 1u9~~ 666 ,33CFF;; < <d|DS)Ncbi|],\}}||-SrK)lowerstrip)rFkrLs r z)lower_clean_dict_keys..s0 : : :TQAGGIIOO  q : : :rr[)rVs rlower_clean_dict_keysrzs : :TZZ\\ : : ::rceZdZdS)r*N)rT __module__ __qualname__rKrrr*r*sDrr*sUnion[bytes, str]ctjdit}t|tr|dn|}|||S)z(Return the md5 hash of the given string.md5zutf-8)r)hashlibnewrrhr=encodeupdate hexdigest)r~hbs rcalc_md5rsY ,,^,,A'3//6QAHHQKKK ;;==rdkeys_to_exclude List[str]cDfd|DS)z>Returns new object but without keys defined in keys_to_excludecHi|]\}}|v||SrKru)rFkeyrPrs rrxz(exclude_keys_in_dict..s8   !sE#))++_2T2TU2T2T2Trry)rrs `rexclude_keys_in_dictrs6    %&WWYY   r query_paramsDict[str, List[str]] param_keySet[str]cvtdfdDDS)zWExtracts key (case-insensitive) query params from Dict, and returns them as Set of str.c@g|]}|D]}|SrKr)rFsublistitems r z,extract_key_query_params..sI        JJLL    rcg|]A}|k|/d|DBS)c6g|]}|SrKr)rFrPs rrz7extract_key_query_params...s >>>5>>>r)ruget)rFrrrs rrz,extract_key_query_params..s\99;;)++ 0@0@0E0E+?>L,=>>>+++r)rUkeys)rrs``rextract_key_query_paramsrsh   ',,..      r)r;rr<r=)rbrcrdrar<re)rVrqr<rr)r~rr<r=)rrrrr<r)rrrr=r<r)*__doc__ __future__rrWrrr4r6systypingrrrrrr r r typing_extensionsr streamlitr r__annotations__r version_inforr r-r$r'r`rarnr=rorz Exceptionr*rrrrKrrrs2#""""""""  JJJJJJJJJJJJJJJJJJJJ######/....'55555 #&"2f"<"<"   'L'L'LT MMM )))).   ====2wvS!!!;;;;      I   r