!LeqB@ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddlm Z m Z ddl mZddlmZddlmZddlmZddlmZejejdejjejd ejjgZGd d eZGd d eeZGddeeZGddee Z!defdZ"dZ#d4dZ$dZ%dZ&d5dZ'dZ(dZ)dfdZ*dZ+dZ,d Z-d!Z.e"d"Z/e"d#Z0e"d$Z1d%Z2e"d&Z3d5d'Z4e"d5d(Z5d6d)Z6d*Z7d+Z8d,Z9d-Z:d.Z;d/Z<e"d0Z=d1Z>ed2Z?d3Z@dS)7N) defaultdict OrderedDict)contextmanager)Real)dedent) get_ident)abcselfparamsceZdZdZdS) ParamWarningzBase Param WarningN__name__ __module__ __qualname____doc__,lib/python3.11/site-packages/param/_utils.pyr r srr ceZdZdZdS)ParamPendingDeprecationWarningzParam PendingDeprecationWarning This warning type is useful when the warning is not meant to be displayed to REPL/notebooks users, as DeprecationWarning are displayed when triggered by code in __main__ (__name__ == '__main__' in a REPL). NrrrrrrsrrceZdZdZdS)ParamDeprecationWarningz_Param DeprecationWarning Ignored by default except when triggered by code in __main__ Nrrrrrr$rrceZdZdZdS)ParamFutureWarningz/Param FutureWarning Always displayed. Nrrrrrr+rrrcfd}|S)NcLtjfd}|S)z@Internal decorator used to mark functions/methods as deprecated.cjd}r?t}|dd}|dz|z}t j|d|i|S)Nz= has been deprecated and will be removed in a future version.  )category stacklevel)rrstripreplacewarningswarn)argskwargsmsgem extra_msgfunc warning_cats rinnerz-_deprecated..decorator..inner5s~]cccC %I&&XXZZ''c22Ci"n M#  B B B B4((( (r functoolswraps)r/r1r.r0s` r decoratorz_deprecated..decorator3sC    ) ) ) ) ) )   ) rr)r.r0r5s`` r _deprecatedr62s*       rctj}gg|jD]s\}}|jtjjtjjfvr|D|jtjj kr|ttj fd}|S)aInternal decorator for methods that issues warnings for positional arguments Using the keyword-only argument syntax in pep 3102, arguments after the ``*`` will issue a warning when passed as a positional argument. Adapted from scikit-learn cjdd}t|tz }|dkrdd|}t jd|d|dt dtd||| d}|d |D|d| i|S|i|S) N.r, z Passing 'z&' as positional argument(s) to 'param.z{' has been deprecated since Param 2.0.0 and will raise an error in a future version, please pass them as keyword arguments.r#)r%ci|]\}}|| Srr).0nameargs r z=_deprecate_positional_args..inner..bs???s4???r) rsplitlenjoinr(r)rzipupdate) r*r+r= n_extra_args extra_argszip_argsr/ kwonly_argspos_or_kw_argss rr1z)_deprecate_positional_args..innerRs &&s++A.4yy3~#6#66 !  ;} }#=>>J M9J99d999/     ;} }5t\MNN7KLLH MM??h??? @ @ @4n }n-888 8tT$V$$$r) inspect signature parametersitemskind ParameterPOSITIONAL_OR_KEYWORDPOSITIONAL_ONLYappend KEYWORD_ONLYr3r4)r/rKr=paramr1rHrIs` @@r_deprecate_positional_argsrUBs !$''INK +1133%% e :'+A7CTCde e e  ! !$ ' ' ' ' Z7,9 9 9   t $ $ $_T%%%%%%%* Lr...cfd}|S)zGDecorator to make a repr function return fillvalue for a recursive callc6tfd}|S)Nct|tf}|vrS| |g|Ri|}|n#|wxYw|SN)idradddiscard)r r*r+keyresult fillvalue repr_running user_functions rwrapperz=_recursive_repr..decorating_function..wrapperrsT((IKK'Cl""    S ! ! ! *&t=d===f==$$S)))) $$S))))Ms AA4)set)rbrcrar`s` @rdecorating_functionz,_recursive_repr..decorating_functionos8uu        rr)r`res` r_recursive_reprrfls$      rc8tjd|zdz|S)N^z [0-9]{5}$)rematch) class_name instance_names r _is_auto_namerms 8C N;. > >>rctj}|D];}tjd|zdz|j}|r|dcSF SS  ";;q>> ! ! ! """rc ddlm}t|j}|j=t|j|ur |jj}nt|jj}nd}|j}g}|r|d|d||d|r#|r|d|}n|}||n9 t|}|r||n#t$rYnwxYwd |S) a  Generate an error prefix suitable for Parameters when they raise a validation error. - unbound and name can't be found: "Number parameter" - unbound and name can be found: "Number parameter 'x'" - bound parameter: "Number parameter 'P.x'" r)ParameterizedMetaclassNz Attribute z ofz parameterr9r") param.parameterizedrytyperownerr=rRrw ExceptionrB) parameter attributeryrtpownerpnameoutdescs r_validate_error_prefixrsT;::::: )__ %F"   $: : :_-FF)/**3FF NE C2 0 000111JJ&$$$%%%   &&u&&DDD d; ''E ) e<(((    D  88C==s'C++ C87C8c~tt|tjtjtjfS)zTTrue for mutable containers, which typically need special handling when being copied) issubclassr{r MutableSequence MutableSetMutableMapping)values r_is_mutable_containerrs' d5kkC$7I[#\ ] ]]rc X|}|||S)zR Small utility to update a copy of a dict with the provided keyword args. )copyrD) dictionaryr+ds r _dict_updaters* AHHV Hrc|SrZrxs rrs!rctt}|D]&}||||'|S)zD Groupby implementation which does not require a prior sort )rlistrRrM)lr^ritems r full_groupbyrsQ DA"" ##d)) D!!!! 7799rcttdsdSddl} tj|p||S#t $rYdSwxYw)zE Whether the function is an asynchronous coroutine function. iscoroutinefunctionFrN)hasattrrJasyncioisasyncgenfunctionrAttributeError)functionrs rrrsw 71 2 2uNNN  &x 0 0 2  ' ' 1 1  uus(A AAc#K|D]ItfdtttfDrt Ed{VEVJdS)a- Flatten an arbitrarily nested sequence. Inspired by: pd.core.common.flatten Parameters ---------- line : sequence The sequence to flatten Notes ----- This only flattens list, tuple, and dict sequences. Returns ------- flattened : generator c38K|]}t|VdSrZ) isinstance)r<tpelements r zflatten..s-EE2z'2&&EEEEEErN)anyrtupledictflatten)rrrs @rrrs|& EEEE$t1DEEE E E w'' ' ' ' ' ' ' ' 'MMMM rcFtjfd}|S)z8 Decorator for decorators that accept arguments cfdS)Nc|gRiSrZr)actual_fr*fr+s rrz.accept_arguments.._f..s!( ._fs<<<<<<z_hashable..Ds 111!qe111r)r collectionsr rrrrMrs r _hashabler8sg![_455Qxx A{5 6 611qwwyy111222rc t|S)a Return a hashable version of the given object x, with lists and dictionaries converted to tuples. Allows mutable objects to be used as a lookup key in cases where the object has not actually been mutated. Lookup will fail (appropriately) in cases where some part of the object has changed. Does not (currently) recursively replace mutable subobjects. .. deprecated:: 2.0.0 )rrs rhashablerJs Q<<rct}i}g}|T|D]?\}} ||t|<#t$r|||fY.ns+44fq!444444rc"g|] \}}|u | Srr)r<rrrs rrz_named_objs..os"999v1Srrr=r) rrMr TypeErrorrRrrr=rr)objlist namesdictobjs objtoname unhashablesrrrs @r _named_objsrYs] ==DIKOO%% + +DAq +*+ )A,,'' + + +""Aq6***** +    3944)C..)AA 4444 444 4 4 9999999!.gz.xz.bz2.ziprozrCould not parse file '{}' as {}: no deserialization method for files with '{}' extension. Supported extensions: {}r:) ospathisfileFileNotFoundErrorformatsplitextrrBsorted)ext_to_routiner type_namerootexts r_deserialize_from_pathrs 7>>$  ( vdI&&(( (  &&ID# ,,,gt$$Q' n"~c"4(((  6$ 3 &2H2H(I(I J J L LLrct|tjrdSt|drt|drdSt|drdSdS)NT__int____add__qdivF)rnumbersNumberrrs r _is_numberrs^#w~&&tt #y ! !gc9&=&=tt f  ddrc4 |jS#t$rYdSwxYw)NF)abstractr)class_s r _is_abstractrs1 uus  cJt|tsJ|g}g}t|rn|d}|d||D]}||vr||vr|| t|n|dddS)z Return a list of the class hierarchy below (and including) the given class. The list is ordered from least- to most-specific. Can be useful for printing the contents of an entire class hierarchy. rN)rr{rApopinsert__subclasses__rR)rqrrbs r descendentsr s fT " """" A C a&& EE!HH 1Q!!##  Azzasll a&& ttt9rc4dt|DS)a^ Return a dictionary containing all subclasses of the specified parentclass, including the parentclass. Only classes that are defined in scripts that have been run or modules that have been imported are included, so the caller will usually first do ``from package import *``. Only non-abstract classes will be included. c<i|]}t||j|Sr)rr)r<cs rr?z(concrete_descendents..s6 $ $ $Q?? $AJq $ $ $r)r ) parentclasss rconcrete_descendentsrs* $ $+k":": $ $ $$rcddlm}mm|fd|D|gzt fd|DS)z Given a dict of (pathname,path) pairs, removes any prefix shared by all pathnames. Helps keep menu items short yet unambiguous. r) commonprefixdirnamesepc,g|]}|zSrr)r<r=rrs rrz%_abbreviate_paths..s&LLL774==,LLLrcHg|]\}}|td|fSrZ)rA)r<r=rprefixs rrz%_abbreviate_paths..s1WWWid4c&kkll+D1WWWr)os.pathrrrkeysrrM)pathspec named_pathsrrrrs @@@r_abbreviate_pathsrs 3222222222 \LLLLL9I9I9K9KLLLhZW X XF WWWW;CTCTCVCVWWW X XXrc"t||S)z Given a dict of (pathname,path) pairs, removes any prefix shared by all pathnames. Helps keep menu items short yet unambiguous. .. deprecated:: 2.0.0 )r)rrs rabbreviate_pathsrs X{ 3 33rct|tjrBt|tjs(tj|ddS|S)z Internal function that will convert date objs to datetime objs, used for comparing date and datetime objects without error. Nr)rdtdatedatetime timetuplers r _to_datetimer%sN !RW/jBK&@&@/{AKKMM"1"-.. Hrc#K dVdS#t$r;ddl}|j\}}}t|jd||jYdSwxYw)zUseful utility for writing docs that need to show expected errors. Shows exception only, concisely, without a traceback. Nrz: )file)r}rexc_infoprintrstderr)retypertbs rexceptions_summarizedr-s~ =  === '3<>>ub **5**<<<<<<<=s AAAcF tdS#t$rYdSwxYw)NTF) get_ipython NameErrorrrr _in_ipythonr1's7 t uus   )rVrZ)NN)Arr#r!rJr3rrrirrpr(rr contextlibrrtextwrapr threadingrr SignaturerOrP VAR_KEYWORDDEFAULT_SIGNATUREWarningr PendingDeprecationWarningrDeprecationWarningr FutureWarningrr6rUrfrmrwrrrrrrrrrrrrrrrrrrrr rrrr%r-r1rrrr<sl 00000000%%%%%%%G%Gfg/EFFGh 1 =>>' 7\3Ll,>}*A     &&&T*??? " " "%%%%P^^^    $     4    %%%   T T T$    D  5 5 5 5""""JLLL4( $ $ $YYY 444    = = =r