.dg-FdZddlZddlZddlZddlZddlZddlZddlZ ddl Z ddl Z ddl Z ddl Z ddlZddlmZddlmZddlmZddlmZmZmZmZmZmZmZmZmZmZmZddl m!Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-d d d Z.d Z/efd Z0dZ1dZ2GddZ3GddeZ4GddeZ5GddZ6e6Z7Gdde5Z8Gdde8Z9Gdde8Z:Gdde8Z;Gd d!e8Z<Gd"d#eZ=Gd$d%e=Z>Gd&d'Z?e?Z@Gd(d)eZAGd*d+eAZBGd,d-eBZCGd.d/eBZDGd0d1eDZEGd2d3eDZFGd4d5eZGGd6d7eGZHGd8d9eZIGd:d;eZJGd<d=eKZLGd>d?ZMeMZNGd@dAZOeOZPGdBdCeZQGdDdEeJeQZRGdFdGeRZSGdHdIeRZTGdJdKeRZUGdLdMeUZVGdNdOeJZWGdPdQeWZXGdRdSeWZYGdTdUeWZZGdVdWeWZ[GdXdYeZ\GdZd[e\Z]Gd\d]eZ^e$e"^Gd_d`eZ_GdadbeZ`Gdcdde`ZaGdedfe`ZbGdgdheZcGdidjeZdy)ka Parameters are a kind of class attribute allowing special behavior, including dynamically generated parameter values, documentation strings, constant and read-only parameters, and type or range checking at assignment time. Potentially useful for any large Python program that needs user-modifiable object attributes; see the Parameter and Parameterized classes for more information. If you do not want to add a dependency on external code by importing from a separately installed param package, you can simply save this file as param.py and copy it and parameterized.py directly into your own package. This file contains subclasses of Parameter, implementing specific parameter types (e.g. Number), and also imports the definition of Parameters and Parameterized classes. N) OrderedDict)Iterable)contextmanager) Parameterized ParameterParameterizedFunctionParamOverridesString Undefined get_loggerinstance_descriptor _dt_types _int_types_identity_hook) ParamFutureWarning_deprecate_positional_args _deprecated_validate_error_prefix_deserialize_from_path _named_objs_produce_value_get_min_max_value _is_numberconcrete_descendents_abbreviate_paths _to_datetimeT)warnci}|D]J}|jD]9}|dk7s ||vr|rtjd|t||||<;L|S)a Given a set of Parameterized objects, returns a dictionary with the union of all param name,value pairs across them. Parameters ---------- warn : bool, optional Wether to warn if the same parameter have been given multiple values, otherwise use the last value, by default True Returns ------- dict Union of all param name,value pairs namezoverwriting parameter )paramr warninggetattr)rparameterizedsdoks 0lib/python3.12/site-packages/param/parameters.py param_unionr)=s_" A AF{6dL((+A!)EFq!}!  Hc Di}|jD] \}}t|d}t|tr|||<*t|trt d i|||<It|t rtd i|||<ht|trtd i|||<t|trtd i|||<t|trtd i|||<t|trtd i|||<t|trbt!d|Drt#d i|||<t%|dk(r"t!d|Drt'd i|||<Ft)d i|||<Vt|t*rt-d i|||<vdt.j0vr"ddlm}t||rt7d i|||<d t.j0vr@dd lm}m}t||rt;d i|||<t||rt=d i|||<td i|||< |S) zy Given a set of keyword literals, promote to the appropriate parameter type based on some simple heuristics. T)defaultconstantc32K|]}t|ywN)r.0els r( z$guess_param_types..os.Ab:b>Asc3<K|]}t|tywr/) isinstancerr0s r(r3z$guess_param_types..qs$K2ZI%>snumpyrndarraypandas) DataFrameSeries)itemsdictr6rrDateboolBooleanintIntegerfloatNumberstrr Dicttupleall NumericTuplelen DateRangeTuplelistListsysmodulesr7r9Arrayr:r;r<)kwargsparamsr'vkwsr9pdDFramepdSeriess r(guess_param_typesrZXs F 11t, a #F1I 9 % s F1I 4 #F1I 3 #F1I 5 !  F1I 3   F1I 4  s F1I 5 !.A..(/3/q Q1$K$K!K%,,q !LCLq 4  s F1I#++%)a) %  F1I3;;&a* ) 0C 0F1I8, &  F1I!(C(F1ISV Mr*c`t|ttfs|g}t|t||S)z Dynamically create a parameterized class with the given name and the supplied parameters, inheriting from the specified base(s). )r6rOrItype)r rUbasess r(parameterized_classr^s, edE] +g eElF ++r*c i}|jD]g\}}tj|}t|ttfr2||vr ||\}}nt dd|j \}}}||f|_|||<i|S)z Given a dictionary of Parameter instances, return a corresponding set of copies with the bounds appropriately set. If given a set of override keywords, use those numeric tuple bounds. N)value)r>copyr6rDrFrr,bounds) rU overridesguessedr p new_paramminvmaxv_s r( guess_boundsrjsG<<>aIIaL a'6* +y %dO T 24QYY O dA $d|I ! " Nr*c||d\}}n|\}}|d\}}n|\}}||||kr|}n|}|| ||kDr|}||fS|}||fS)z For each soft bound (upper and lower), if there is a defined bound (not equal to None) and does not exceed the hard bound, then it is returned. Otherwise it defaults to the hard bound. The hard bound could still be None. NNr=)rb softboundshlhuslsulus r(get_soft_boundsrts{~BBBB zbnB   zbnB  q6M  q6Mr*cdeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZy)Infinitya An instance of this class represents an infinite value. Unlike Python's float('inf') value, this object can be safely compared with gmpy numeric types across different gmpy versions. All operators on Infinity() return Infinity(), apart from the comparison and equality operators. Equality works by checking whether the two objects are both instances of this class. c.t||jSr/)r6 __class__selfothers r(__eq__zInfinity.__eq__sZdnn%EEr*c||k( Sr/r=rys r(__ne__zInfinity.__ne__s u_4r*cyNFr=rys r(__lt__zInfinity.__lt__Ur*cyrr=rys r(__le__zInfinity.__le__rr*cyNTr=rys r(__gt__zInfinity.__gt__Tr*cyrr=rys r(__ge__zInfinity.__ge__rr*c|Sr/r=rys r(__add__zInfinity.__add__Tkr*c|Sr/r=rys r(__radd__zInfinity.__radd__rr*c|Sr/r=rys r(__ladd__zInfinity.__ladd__rr*c|Sr/r=rys r(__sub__zInfinity.__sub__rr*c|Sr/r=rys r(__iadd__zInfinity.__iadd__sd{r*c|Sr/r=rys r(__isub__zInfinity.__isub__rr*cy)Nz Infinity()r=rzs r(__repr__zInfinity.__repr__s\r*ct|Sr/)reprrs r(__str__zInfinity.__str__s T$Z/r*N)__name__ __module__ __qualname____doc__r|r~rrrrrrrrrrrrr=r*r(rvrvs4F4**))))))*)1/r*rvceZdZdZdZeZeddZe e ddZ e ddZ e ed Z ed d Zfd Zd ZdZdZdZddZdZdZdZdZdZxZS)Timea= A callable object returning a number for the current time. Here 'time' is an abstract concept that can be interpreted in any useful way. For instance, in a simulation, it would be the current simulation time, while in a turn-taking game it could be the number of moves so far. The key intended usage is to allow independent Parameterized objects with Dynamic parameters to remain consistent with a global reference. The time datatype (time_type) is configurable, but should typically be an exact numeric type like an integer or a rational, so that small floating-point errors do not accumulate as time is incremented repeatedly. When used as a context manager using the 'with' statement (implemented by the __enter__ and __exit__ special methods), entry into a context pushes the state of the Time object, allowing the effect of changes to the time value to be explored by setting, incrementing or decrementing time as desired. This allows the state of time-dependent objects to be modified temporarily as a function of time, within the context's block. For instance, you could use the context manager to "see into the future" to collect data over multiple times, without affecting the global time state once exiting the context. Of course, you need to be careful not to do anything while in context that would affect the lasting state of your other objects, if you want things to return to their starting state when exiting the context. The starting time value of a new Time object is 0, converted to the chosen time type. Here is an illustration of how time can be manipulated using a Time object: >>> time = Time(until=20, timestep=1) >>> 'The initial time is %s' % time() 'The initial time is 0' >>> 'Setting the time to %s' % time(5) 'Setting the time to 5' >>> time += 5 >>> 'After incrementing by 5, the time is %s' % time() 'After incrementing by 5, the time is 10' >>> with time as t: # Entering a context ... 'Time before iteration: %s' % t() ... 'Iteration: %s' % [val for val in t] ... 'Time after iteration: %s' % t() ... t += 2 ... 'The until parameter may be exceeded outside iteration: %s' % t() 'Time before iteration: 10' 'Iteration: [10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20]' 'Time after iteration: 20' 'The until parameter may be exceeded outside iteration: 22' >>> 'After exiting the context the time is back to %s' % time() 'After exiting the context the time is back to 10' Tz The label given to the Time object. Can be used to convey more specific notions of time as appropriate. For instance, the label could be 'Simulation Time' or 'Duration'.)r,doca Callable that Time will use to convert user-specified time values into the current time; all times will be of the resulting numeric type. By default, time is of integer type, but you can supply any arbitrary-precision type like a fixed-point decimal or a rational, to allow fractional times. Floating-point times are also allowed, but are not recommended because they will suffer from accumulated rounding errors. For instance, incrementing a floating-point value 0.0 by 0.05, 20 times, will not reach 1.0 exactly. Instead, it will be slightly higher than 1.0, because 0.05 cannot be represented exactly in a standard floating point numeric type. Fixed-point or rational types should be able to handle such computations exactly, avoiding accumulation issues over long time intervals. Some potentially useful exact number classes: - int: Suitable if all times can be expressed as integers. - Python's decimal.Decimal and fractions.Fraction classes: widely available but slow and also awkward to specify times (e.g. cannot simply type 0.05, but have to use a special constructor or a string). - fixedpoint.FixedPoint: Allows a natural representation of times in decimal notation, but very slow and needs to be installed separately. - gmpy.mpq: Allows a natural representation of times in decimal notation, and very fast because it uses the GNU Multi-Precision library, but needs to be installed separately and depends on a non-Python library. gmpy.mpq is gmpy's rational type. )r,r-r?z Stepsize to be used with the iterator interface. Time can be advanced or decremented by any value, not just those corresponding to the stepsize, and so this value is only a default.z Declaration of an expected end to time values, if any. When using the iterator interface, iteration will end before this value is exceeded.Na The units of the time dimensions. The default of None is set as the global time function may on an arbitrary time base. Typical values for the parameter are 'seconds' (the SI unit for time) or subdivisions thereof (e.g. 'milliseconds').c lt|di||jd|_d|_g|_y)Nrr=)super__init__ time_type_time _exhausted _pushed_state)rzrUrxs r(rz Time.__init___s2 "6"^^A& r*ct|tsy|j|jf}|j|jf}||k7ryy)NFT)r6rtimestepuntil)rzr{ self_params other_paramss r(r|z Time.__eq__fsA%&}}TZZ0 u{{3 , &r*c||k( Sr/r=rys r(r~z Time.__ne__psEM""r*c|Sr/r=rs r(__iter__z Time.__iter__tst r*c |j|j}|jd|_|jS|j|z|jkr!|xj|z c_|jSd|_t r)rrrrr StopIteration)rzrs r(__next__z Time.__next__wsq>>$--0 ?? "#DO zz jj8# 2 JJ( "Jzz#DO r*c|r | td|r?|jjdjd}d|_||_d|_||j ||_|j S)a When called with no arguments, returns the current time value. When called with a specified val, sets the time to it. When called with a specified time_type, changes the time_type and sets the current time to the given val (which *must* be specified) converted to that time type. To ensure that the current state remains consistent, this is normally the only way to change the time_type of an existing Time instance. z-Please specify a value for the new time_type.existingrFT) Exceptionr!objectsgetr-rr)rzvalr type_params r(__call__z Time.__call__so KL L ++J7;;KHJ"'J &DN"&J  ?,DJzzr*c||z }yr/r=rzrs r(advancez Time.advances   r*cL|j|j|z|_|Sr/rrrys r(rz Time.__iadd__ ZZ$.."77  r*cL|j|j|z |_|Sr/rrys r(rz Time.__isub__rr*c|jj|j|j|jfd|_|S)z-Enter the context and push the current state.T)rappendrrr in_contextrs r( __enter__zTime.__enter__s5 !!4::t}}djj"IJ r*c|jj\|_|_|_t |jdk7|_|turyy)z Exit from the current context, restoring the previous state. The StopIteration exception raised in context will force the context to exit. Any other exception exc that is raised in the block will not be caught. rTN)rpoprrrrLrr)rzexcargss r(__exit__z Time.__exit__sL372D2D2H2H2J/T]DJd001Q6 -  r*rl)rrrr_infinitely_iterablervforeverr labelrrCrrrunitrr|r~rrrrrrrr __classcell__rxs@r(rrs5n jG &'@ AE ##; # IJ*H g+ E $%D ED #$ 2   r*rceZdZdZeZdZej ddddddddddddd dZ e ffd Z ddZ fd Z e fd Zdd Zdfd Zdfd Zdfd ZxZS)Dynamica Parameter whose value can be generated dynamically by a callable object. If a Parameter is declared as Dynamic, it can be set a callable object (such as a function or callable class), and getting the parameter's value will call that callable. Note that at present, the callable object must allow attributes to be set on itself. If set as time_dependent, setting the Dynamic.time_fn allows the production of dynamic values to be controlled: a new value will be produced only if the current value of time_fn is different from what it was the last time the parameter value was requested. By default, the Dynamic parameters are not time_dependent so that new values are generated on every call regardless of the time. The default time_fn used when time_dependent is a single Time instance that allows general manipulations of time. It may be set to some other callable as required so long as a number is returned on each call. FNT) rr precedence instantiater-readonlypickle_default_value allow_None per_instance allow_refs nested_refsc yr/r=) rzr,rrrrr-rrrrrrs r(rzDynamic.__init__s r*c t|dd|i|t|jr-|j d|j |jyy)zl Call the superclass's __init__ and set instantiate=True if the default is dynamic. r,TNr=)rrcallabler,_set_instantiate_initialize_generatorrzr,rUrxs r(rzDynamic.__init__sK 33F3 DLL !  ! !$ '  & &t|| 4 "r*cvt|dr|j|_d|_d|_g|_g|_y)z=Add 'last time' and 'last value' attributes to the generator._Dynamic_time_fnN)hasattrr _Dynamic_last _Dynamic_time_saved_Dynamic_last_saved_Dynamic_time)rzgenobjs r(rzDynamic._initialize_generators? 3) *##7C  "$"$r*cbt|||}t|ds|S|j|S)z Call the superclass's __get__; if the result is not dynamic return that result, otherwise ask that result to produce a value and return it. rr__get__rrrzrobjtyperrxs r(rzDynamic.__get__s5 goc'*s?+J&&s+ +r*ct|||t|}|r|j||||j |yy)z Call the superclass's set and keep this parameter's instantiate value up to date (dynamic parameters must be instantiated). If val is dynamic, initialize it as a generator. N)r__set__rrr)rzrrdynamicrxs r(rzDynamic.__set__sB C 3- D..s37 ;--g6;r*ct|dr |j}n |j}| |jst |}||_|S|}|s||j k7rt |}||_||_|S|j }|S)a Return a value from gen. If there is no time_fn, then a new value will be returned (i.e. gen will be asked to produce a new value). If force is True, or the value of time_fn() is different from what it was was last time _produce_value was called, a new value will be produced and returned. Otherwise, the last value gen produced will be returned. r)rrtime_fntime_dependentrrr)rzrforcerr`times r(rzDynamic._produce_value$s 3) ***GllG OT%8%8"3'E %C  9Dc///&s+$)!$(! )) r*c8tt| ||dS)zo Return True if the parameter is actually dynamic (i.e. the value is being generated). r)rrr)rzrrrxs r(_value_is_dynamiczDynamic._value_is_dynamicFs uws73ODDr*cXt|||}t|dr |jS|S)z3Return the last generated value for this parameter.r)rrrrrs r(_inspectzDynamic._inspectNs. GOC ( 3 '$$ $Jr*cft|||}t|dr|j|dS|S)z1Force a new value to be generated, and return it.rT)rrrs r(_forcezDynamic._forceXs8 GOC ( 3 '&&s&6 6Jr*r/F)rrrrrrrtypingoverloadrr rrrrrrrrrrs@r(rrs0fGN __ 55TeRVe    ) 5 % , 7 7DEr*rc,eZdZdZdZdZedZy)__compute_set_hookzRemove when set_hook is removedctSr/)rrzres r(rz__compute_set_hook.__call__esr*c,t|jSr/rsigrs r(rz__compute_set_hook.__repr__hDHH~r*cyr/r=rs r(r z__compute_set_hook.sigkr*Nrrrrrrpropertyr r=r*r(rrbs#)r*rceZdZdZgdZeejdddddeZe j dddddddddddddddddd d Z e e fe e e e e d fd Z fd ZfdZdZdZdZdZdZdZfdZxZS)rFao A numeric Dynamic Parameter, with a default value and optional bounds. There are two types of bounds: ``bounds`` and ``softbounds``. ``bounds`` are hard bounds: the parameter must have a value within the specified range. The default bounds are (None,None), meaning there are actually no hard bounds. One or both bounds can be set by specifying a value (e.g. bounds=(None,10) means there is no lower bound, and an upper bound of 10). Bounds are inclusive by default, but exclusivity can be specified for each bound by setting inclusive_bounds (e.g. inclusive_bounds=(True,False) specifies an exclusive upper bound). Number is also a type of Dynamic parameter, so its value can be set to a callable to get a dynamically generated number (see Dynamic). When not being dynamically generated, bounds are checked when a Number is created or set. Using a default value outside the hard bounds, or one that is not numeric, results in an exception. When being dynamically generated, bounds are checked when the value of a Number is requested. A generated value that is not numeric, or is outside the hard bounds, results in an exception. As a special case, if allow_None=True (which is true by default if the parameter has a default of None when declared) then a value of None is also allowed. A separate function set_in_bounds() is provided that will silently crop the given value into the legal range, for use in, for instance, a GUI. ``softbounds`` are present to indicate the typical range of the parameter, but are not enforced. Setting the soft bounds allows, for instance, a GUI to know what values to display on sliders for the Number. Example of creating a Number:: AB = Number(default=0.5, bounds=(None,10), softbounds=(0,1), doc='Distance from A to B.') )rbrminclusive_boundsset_hookstepNTTr,rbrmrrrFTrbrmrrrrrrrrr-rrrrrcyr/r=rzr,rbrmrrrrrrrrr-rrrrrs r(rzNumber.__init__ r*rbrmrrrc t|dd|i|||_||_||_||_||_|j|jy)z Initialize this parameter object and store the bounds. Non-dynamic default values are checked against the bounds. r,Nr=) rrrrbrrmr _validater, rzr,rbrmrrrrUrxs r(rzNumber.__init__sN 33F3   0$  t||$r*cnt|||}|j||r|j||S)zy Same as the superclass's __get__, but if the value was dynamically generated, check the bounds. )rrrr)rzrrresultrxs r(rzNumber.__get__s8 g.  ! !#w / NN6 " r*cdt|s|j|}n|}t| ||y)z Set to the given value, but cropped to be within the legal bounds. All objects are accepted, and no exceptions will be raised. See crop_to_bounds for details on how cropping is done. N)rcrop_to_boundsrr)rzrr bounded_valrxs r( set_in_boundszNumber.set_in_boundss/ }--c2KK [)r*ct|r1|j|S|j\}}|||kr|S|||kDr|S|S|jr||S|jS)a Return the given value cropped to be within the hard bounds for this parameter. If a numeric value is passed in, check it is within the hard bounds. If it is larger than the high bound, return the high bound. If it's smaller, return the low bound. In either case, the returned value could be None. If a non-numeric value is passed in, set to be the default value (which could be None). In no case is an exception raised; all values are accepted. As documented in https://github.com/holoviz/param/issues/80, currently does not respect exclusive bounds, which would strictly require setting to one less for integer values or an epsilon less for floats. )rrbrr,)rzrvminvmaxs r(r$zNumber.crop_to_boundssp& c?{{" JD$: L:K __J<< r*c||| |js t|ry|\}}|\}}|H|dur"||ks?tt|d|d|d||kstt|d|d|d|J|dur#||k\stt|d|d|dy||kDstt|d|d|dyy)NTz must be at most , not .z must be less than z must be at least z must be greater than )rr ValueErrorr)rzrrbrr(r)incminincmaxs r(_validate_boundszNumber._validate_boundss+ >ckdoo(3-  d)  ~d{$1$788I&se1. Tz$1$788K&se1.  ~d{$1$788J&se1.# Tz$1$788N&se1." r*c|r| t|rtj|syt|s#t t |dt |dyNz only takes numeric values, not r,)rinspectisgeneratorfunctionrr-rr\rzrrs r(_validate_valuezNumber._validate_value$sY 3;HSM'B]B]^aBb #)$/01Cyk$ r*ch|0t|s$tt|ddt|dyy)Nr* can only be None or a numeric value, not r,rr-rr\rzrrs r(_validate_stepzNumber._validate_step.sF  Jt$4)$789004T |1> %5 r*c|j||j|j||j|j ||j |j y Checks that the value is numeric and that it is within the hard bounds; if not, an exception is raised. N)r6rr;rr0rbrrs r(rzNumber._validate5sH S$//2 C+ c4;;0E0EFr*cBt|j|jSr/rtrbrmrs r(rtzNumber.get_soft_bounds>t{{DOO<Nz) only takes datetime and date types, not r,)rr6rr-rr\r5s r(r6zDate._validate_valuesY ??s{ #y):#+)$/01##'9+Q0 CN)r*cr|5t|ts$tt|ddt |dyy)Nrz0 can only be None, a datetime or date type, not r,r6rr-rr\r:s r(r;zDate._validate_stepsI  JtY$?)$789004T |1> %@ r*cdt|}|dntt|}t| |||Sr/)rmaprr0)rzrrbrrxs r(r0zDate._validate_boundss43Sv-Fw'V5EFFr*c|yt|tjtjfs|j tj}|j dS)N%Y-%m-%dT%H:%M:%S.%f)r6dtdatetimedateastypestrftimeclsr`s r( serializezDate.serializesC =%"++rww!78LL-E~~455r*cR|dk(s|ytjj|dS)Nnullr`)rarbstrptimerfs r( deserializezDate.deserializes( F?em{{##E+ABBr*r/)rrrrr?rFrGrrrr r6r;r0 classmethodrhrlrrs@r(r@r@zs2&//>N __ $ Z^im 55TeRVe    )4 G 66CCr*r@ceZdZdZeej dZej dddddddddddddddddddZ e ffd Z d Z d Z e d Ze d ZxZS) CalendarDatez6Parameter specifically allowing dates (not datetimes).NrJrFTrScyr/r=rUs r(rzCalendarDate.__init__rr*c (t|dd|i|yrWrQrXs r(rzCalendarDate.__init__rYr*c|jr|yt|tjrt|tjr|r|t t |dyy)r>Nz only takes date types.)rr6rarcrbr-rr5s r(r6zCalendarDate._validate_values^ ??s{ 3(JsBKK,HS]bebm)$/00GH cn,Hr*c|?t|tjs$tt |ddt |dyy)Nrz& can only be None or a date type, not r,r6rarcr-rr\r:s r(r;zCalendarDate._validate_stepsL  JtRWW$=)$789$$(J r*c*|y|jdSN%Y-%m-%drerfs r(rhzCalendarDate.serializes =~~j))r*cn|dk(s|ytjj|djSNrjrw)rarbrkrcrfs r(rlzCalendarDate.deserializes0 F?em{{##E:6;;==r*r/)rrrrr?rFrGrrrr r6r;rmrhrlrrs@r(roros@&//>N __ $ Z^im 55TeRVe    )4 ** >>r*roceZdZdZeej dZej d dddddddddddd dZ e e ffd Z d Z d Z xZS) rBz%Binary or tristate Boolean Parameter.FrJNT rrrrrr-rrrrrc yr/r= rzr,rrrrrr-rrrrrs r(rzBoolean.__init__rr*c ^t|dd|i||j|jyrWrrrr,rs r(rzBoolean.__init__( 33F3 t||$r*c|r.t|ts|tt|d|dyyt|tstt|d|dy)Nz) only takes a boolean value or None, not r,z must be True or False, not )r6rAr-rr5s r(r6zBoolean._validate_values~ c4(S_ -d345225;.=( C&)$/01gQ  'r*c<|j||jyr/r6rrs r(rzBoolean._validate  S$//2r*r)rrrrr?rrGrrrrr r6rrrs@r(rBrBsu/)22EBN __ d$4UTPTe    (% % 3r*rBceZdZdZgdZej d dddddddddddd dZed fd Zd Z e fd Z xZ S) Eventa An Event Parameter is one whose value is intimately linked to the triggering of events for watchers to consume. Event has a Boolean value, which when set to True triggers the associated watchers (as any Parameter does) and then is automatically set back to False. Conversely, if events are triggered directly via `.trigger`, the value is transiently set to True (so that it's clear which of many parameters being watched may have changed), then restored to False when the triggering completes. An Event parameter is thus like a momentary switch or pushbutton with a transient True value that serves only to launch some other action (e.g. via a param.depends decorator), rather than encapsulating the action itself as param.Action does. )_autotrigger_value_mode_autotrigger_reset_valueFNTr|c yr/r=r~s r(rzEvent.__init__%rr*c Rd|_d|_d|_t|dd|i|y)NTF set-resetr,r=)rrrrrrs r(rzEvent.__init__/s1"&(-%  2262r*cd}|||_n#||jj|j<|j ||yr)r,_param__privatevaluesr _post_setter)rzrrs r( _reset_eventzEvent._reset_eventEs= ;DL47C   & &tyy 1 #s#r*c|jdvrt| |||jdvr|j||yy)N)rset)rreset)rrrr)rzrrrxs r(rz Event.__set__Ms@ ::- - GOC % ::/ /   c3 ' 0r*r) rrrrrFrrrrrrrrrs@r(rrsy $LI __ d$4UTPTe    3 3*$((r*rc(eZdZdZdZedZy)__compute_length_of_defaultc,t|jSr/)rLr,r s r(rz$__compute_length_of_default.__call__Ys199~r*c,t|jSr/r rs r(rz$__compute_length_of_default.__repr__\r r*cyr/r=rs r(r z__compute_length_of_default.sig_rr*Nrrrrrrr r=r*r(rrXs r*rceZdZdZdgZeejdeZe j dddddddddddddd d Z e e fe d fd Z d Zd ZdZedZedZxZS)rNzCA tuple Parameter (e.g. ('a',7.6,[3,5])) with a fixed tuple length.lengthrrr,rNFT) rrrrrr-rrrrrrc yr/r=)rzr,rrrrrr-rrrrrrs r(rzTuple.__init__nrr*)rc t|dd|i||tur$|jt t |dd|tur|rt ||_n||_|j|jy)a Initialize a tuple parameter with a fixed length (number of elements). The length is determined by the initial default value, if any, and must be supplied explicitly otherwise. The length is not allowed to change after instantiation. r,Nrz- must be specified if no default is supplied.r=) rrr r,r-rrLrr)rzr,rrUrxs r(rzTuple.__init__xs} 33F3 Y 4<<#7)$9:;77 I %'g,DK DK t||$r*ct||ryt|ts#tt|dt |dy)N only takes a tuple value, not r,)r6rIr-rr\r5s r(r6zTuple._validate_valuesH ;: #u%)$/01Cyk$ &r*c| |jryt||k(s'tt|ddt|d|dy)Nrz is not of the correct length (z instead of ).rrLr-r)rzrrs r(_validate_lengthzTuple._validate_lengthsW ;4?? 3x6!)$9:;**-c(<xrK "r*ct|j||j|j||jyr/)r6rrrrs r(rzTuple._validates* S$//2 c4;;/r*c|yt|Sr/)rOrfs r(rhzTuple.serializes =E{r*c(|dk(s|yt|S)Nrj)rIrfs r(rlzTuple.deserializes F?emU|r*)r)rrrrrFr?rrG_compute_length_of_defaultrrrrr r6rrrmrhrlrrs@r(rNrNgsM I)22EJdeN __ !% 55TeRVe    (%I% %&0 r*rNc"eZdZdZfdZxZS)rKzGA numeric tuple Parameter (e.g. (4.5,7.6,3)) with a fixed tuple length.ct||||r|y|D]0}t|rtt |dt |dyr2)rr6rr-rr\)rzrrnrxs r(r6zNumericTuple._validate_values] Z0 #+ A!})$/01#Awiq* r*)rrrrr6rrs@r(rKrKsQ  r*rKceZdZdZeej dZej d ddddddddddddd dZ e ffd Z xZ S) XYCoordinatesz%A NumericTuple for an X,Y coordinate.rrrJNFT) rrrrrrr-rrrrrc yr/r=)rzr,rrrrrrr-rrrrrs r(rzXYCoordinates.__init__rr*c *t|d|dd|yNr4rr=rQrs r(rzXYCoordinates.__init__s ==f=r*)r) rrrrr?rKrGrrrr rrs@r(rrsd/,55zJN __ &*d$4UTPTe    )>>r*rceZdZdZgdZeejdddddZej ddddddddddddddddddd Z e e fe e e e d fd Z fd Z d ZdZdZdZdZdZxZS)Rangez4A numeric range with optional bounds and softbounds.)rbrrmrNr)r,rbrrmrFT)rbrmrrrrrrrr-rrrrrrcyr/r=)rzr,rbrmrrrrrrrr-rrrrrrs r(rzRange.__init__rr*)rbrmrrc b||_||_||_||_t |d|dd|yr)rbrrmrrr)rzr,rbrmrrrUrxs r(rzRange.__init__s9 0$  ;;F;r*cLt|||j||j|jd|j||j |jd|j ||j|j||j|jy)Nbound softbound)r) rrr0rbrrmr;r_validate_orderrrzrrxs r(rzRange._validates} # c4;;0E0EwO c4??D4I4I;W C+ S$))Hr*c|Mt|s$tt|ddt|d|dk(rtt|ddyy)Nrr8r,rz cannot be 0.r9r:s r(r;zRange._validate_stepsq  d# -dF;<=//3Dzl!= -dF;ckdoo  d)Wg.4HE14'P&a$ha4iGD(Q6q4xqDyH( -d34AeW=!]]_-VA3a9 5r*cBt|j|jSr/r@rs r(rtzRange.get_soft_bounds3rAr*cl|j\}}|j\}}|rdnd}|rdnd}||d||S)N[(]), )rbr)rzr(r)r.r/s r(rzRange.rangestr6sI[[ d..CC$r$x00r*r/)rrrrrFr?rKrGrrrrr rr;rrr0rtrrrs@r(rrs>DI##T$$DN  __ $ Z^gk 55TeRVe    (Er*cB|r|yt|ts#tt|dt |d|D]5}t|t rtt|dt |d|\}}||k\s#tt|d|dd|ddy)Nrr,z& only takes date/datetime values, not z end datetime rz is before start datetime r)r6rIr-rr\rrzrrrrrs r(r6zDateRange._validate_valueQs #+ #u%)$/01Cyk$ A!Y')$/01#Awiq*  se|)$/0s1vhG,,/F816 r*cN|yg}|D]}t|tjtjfs|j tj}t |tjur|j d}n|j d}|j||S)Nrwr`)r6rarbrcrdr\rer)rgr` serializedrVs r(rhzDateRange.serializels = Aa"++rww!78HHR[[)Aw"''!JJz*JJ56   a r*c|dk(s|yg}|D]p}t|dk(r/tjj|dj }n tjj|d}|j |rt |S)Nrj rwr`)rLrarbrkrcrrI)rgr` deserializedrVs r(rlzDateRange.deserialize}s} F?em A1v|KK((J7<<>KK((,BC    "\""r*) rrrrrr0r6rmrhrlrrs@r(rMrM>s1 F 6 #r*rMc<eZdZdZdZdZedZedZy)CalendarDateRangez1A date range specified as (start_date, end_date).c|r|y|D]6}t|tjrtt |d|d|\}}||k\s#tt |d|dd|ddy)Nz only takes date types, not r,z end date rz is before start date r)r6rarcr-rrs r(r6z!CalendarDateRange._validate_values #+ Aa) -d345%q" se|)$/0 3q6(C!!fXQ( r*c t|tjs)tt |d|d|dt |dy)Nrz' can only be None or a date value, not r,rtrs r(rz&CalendarDateRange._validate_bound_typesO%))$/0(1TFC--1%[M< *r*cP|y|Dcgc]}|jdc}Scc}wrvrxrgr`rVs r(rhzCalendarDateRange.serializes+ =0561 :&666s#c |dk(s|yt|Dcgc]0}tjj|dj 2c}Scc}wrz)rIrarbrkrcrs r(rlzCalendarDateRange.deserializesG F?em%P%Qbkk**1j9>>@%PQQPs5AN) rrrrr6rrmrhrlr=r*r(rrs9;$77 RRr*rc~eZdZdZej d dddddddddddd dZeeffd ZdZ d Z xZ S) CallableaW Parameter holding a value that is a callable object, such as a function. A keyword argument instantiate=True should be provided when a function object is used that might have state. On the other hand, regular standalone functions cannot be deepcopied as of Python 2.4, so instantiate must be False for those values. NFTr|c yr/r=r~s r(rzCallable.__init__rr*c ^t|dd|i||j|jyrWrrs r(rzCallable.__init__rr*ch|r| t|rytt|dt|d)Nz. only takes a callable object, not objects of r,)rr-rr\r5s r(r6zCallable._validate_values? 3;8C= %d+,-"3i[ +  r*c<|j||jyr/rrs r(rzCallable._validaterr*r/) rrrrrrrrr r6rrrs@r(rrsg __ d$4UTPTe    (% % 3r*rceZdZdZy)Actionz A user-provided function that can be invoked like a class or object method using (). In a GUI, this might be mapped to a button, but it can be invoked directly as well. N)rrrrr=r*r(rrsr*rceZdZdZddgZej ddddddddddddd dZee d fd Zd Z d Z d Z dZ xZS) Compositea) A Parameter that is a composite of a set of other attributes of the class. The constructor argument 'attribs' takes a list of attribute names, which may or may not be Parameters. Getting the parameter returns a list of the values of the constituents of the composite, in the order specified. Likewise, setting the parameter takes a sequence of values and sets the value of the constituent attributes. This Parameter type has not been tested with watchers and dependencies, and may not support them properly. attribsrNFT) rrrrrrr-rrrrrc yr/r=) rzrrrrrrr-rrrrrs r(rzComposite.__init__rr*)rc R|turg}t|ddti|||_yrW)r rrr)rzrkwrxs r(rzComposite.__init__s, i G 11b1 r*c|$|jDcgc]}t||c}S|jDcgc]}t||c}Scc}wcc}w)z0Return the values of all the attribs, as a list.)rr#)rzrras r(rzComposite.__get__ sN ;15>AGGQ'> >-1\\:\GCO\: :?:s A Ac t|t|k(rytt|dt|dt|d)Nz( got the wrong number of values (needed z , but got r)rLr-r)rzrrs r(_validate_attribszComposite._validate_attribssM s8s7| # %d+,-!!$WjS " F  r*c<|j||jyr/)rrrs r(rzComposite._validates sDLL1r*c|6t|j|D]\}}t|j||yt|j|D]\}}t|||yr/)rrsetattrr)rzrrrrVs r(rzComposite._post_settersW ;DLL#.1 a+/DLL#.1Q"/r*)rrrrrFrrrrr rrrrrrs@r(rrst I&I __d$4UTPTe    "+  ; 2#r*rceZdZdZdZdZy) SelectorBasezx Parameter whose value must be chosen from a list of possibilities. Subclasses must implement get_range(). Tctd)Nz.get_range() must be implemented in subclasses.)NotImplementedErrorrs r( get_rangezSelectorBase.get_range4s!"RSSr*N)rrrr_SelectorBase__abstractrr=r*r(rr+s JTr*rceZdZdZdfd ZdZeddZfdZdfd Z fdZ dZ fd Z d Z fd Zfd Zdd ZfdZdZdZfdZfdZdZdZxZS) ListProxyz Container that supports both list-style and dictionary-style updates. Useful for replacing code that originally accepted lists but needs to support dictionary access (typically for naming items). c2t||||_yr/)rr _parameter)rziterable parameterrxs r(rzListProxy.__init__@s "#r*ct|jj}tj dj ||y)Nz{clsname}.objects{method} is deprecated if objects attribute was declared as a dictionary. Use `{clsname}.objects[label] = value` instead.)clsnamemethod)r\rrr r"format)rzr r s r(_warnzListProxy._warnDs9t'00  &wv F r*c#hKd|jjvxr|}t|jjxst |jj }d|rL|jjxs|jj }|jj d||yyw)Nr)rwatchersr?namesrO_objects_trigger_event)rztriggeroldr`s r(_triggerzListProxy._triggerLst777CG4??(()KT$//2J2J-K OO))ET__-E-EE OO * *9c5 A sB0B2c|jjr|jj|St| |Sr/)rrr __getitem__)rzindexrxs r(rzListProxy.__getitem__Us5 ?? ??((/ /w"5))r*c@t|ttfrj|jjr|j d|j 5t|!||||jj|<dddy|r0|jjst||j_|j |5||jjvrT|jj|}|j|}t|!||||jj|<n4t|1||jjj|||jj|<dddy#1swYyxYw#1swYyxYw)Nz[index] = object) r6rCslicerrr rr __setitem__rrrr)rzrobjectrridxrxs r(rzListProxy.__setitem__Zs7 ec5\ *$$ -.#E6228((/!  --$/$5DOO ! ]]7 #---oo++E2jjo#C006((-v&((//7+1DOO ! !% ($ # ! $ #s*FB:FFFct||}|jjr4|tur,t t |jj||k(S|Sr/)rr|rrNotImplementedr?r)rzr{eqrxs r(r|zListProxy.__eq__osK W^E " ?? R>%9DOO11489UB B r*c&|j| Sr/)r|rys r(r~zListProxy.__ne__us;;u%%%r*c|jjr|jd|j5t|||jj j |dddy#1swYyxYwNz.append)rrr rrrr)rzrrxs r(rzListProxy.appendxsS ?? JJy ! ]]_ GN6 " OO $ $ + +F 3__ 5A77Bc|jjr$|jjjSt|Sr/)rrrarOrs r(razListProxy.copys2 ?? ??((--/ /Dzr*c|j5t| |jjj|jj jdddy#1swYyxYwr/)rrclearrrrrzrxs r(r'zListProxy.clearsK ]]_ GMO OO $ $ * * , OO ! ! ' ' )__s AA22A;c|jjr|jd|j5t|||jj j |dddy#1swYyxYwr#)rrr rrextendr)rzrrxs r(r*zListProxy.extendsS ?? JJy ! ]]_ GN7 # OO $ $ + +G 4__r$c|jjr&|jjj||St|j||Sr/)rrrr)rzkeyr,s r(rz ListProxy.getsD ?? ??((,,S': :4 $$S'22r*c |jjr|jd|j5t||||jj j ||dddy#1swYyxYw)Nz.insert)rrr rrinsertr)rzrrrxs r(r.zListProxy.insertsW ?? JJy ! ]]_ GN5& ) OO $ $ + +E6 :__s 7A99Bc|jjr$|jjjSt|jSr/)rrr>rrs r(r>zListProxy.itemss< ?? ??((..0 04 &&((r*c|jjr$|jjjSt|jSr/)rrkeysrrs r(r1zListProxy.keyss< ?? ??((--/ /4 %%''r*c|r|dnd}t|tr|j5t|||j j j |}|j jrK|j jjDcic] \}}||ur||c}}|j _dddy|r!|j js td|j5|j jj|}t|)||j j j|ddd|Scc}}w#1swYyxYw#1swYSxYw)NrrzXCannot pop an object from {clsname}.objects if objects was not declared as a dictionary.) r6rCrrrrrrr>r-remove)rzrrrr'rVrxs r(rz ListProxy.pops;QR eS ! E"1155e<??(()-)>)>)D)D)F-)FA;1)F-DOO) !  --< ]]_.T__**..5F GN6 " OO $ $ + +F 3 - !   s+A2E%E.E%=AE1E%%E.1E;c |j5t| ||jjj||jj r|jj j }|jj j|jj j|jDcic] \}}||us ||c}}dddycc}}w#1swYyxYwr/) rrr3rrrrar'updater>)rzrrar'rVrxs r(r3zListProxy.removes ]]_ GN6 " OO $ $ + +F 3$$,,113%%++-%%,,%/TZZ\.%1TQQf_AqD\. _ . _s$CD C; %C; *D;DD c d|jjst||j_t|tr|j n|}|j 5t|D]~\}}t|tjjstd|dt|}t|}|dk7rtd|d|d|\}}|j||d|j D]\}}|j||d dddy#1swYyxYw) Nz3cannot convert dictionary update sequence element #z to a sequencer4z$dictionary update sequence element #z has length z; 2 is requiredF)r)rrrr6r?r>r enumerate collectionsabcSequence TypeErrorrIrLr-r)rzrr>ir&rr'rVs r(r5zListProxy.updates$$$/$5DOO !%/%>'--/G ]]_!'*1!![__%=%=>#MaSP^_!HF6$>qcaSP_`1  Au 5+ 1  Au 5&__s #B9D&&D/c|jjr$|jjjSt|jSr/)rrrrrs r(rzListProxy.valuess< ?? ??((//1 14 ''))r*r/)T)rrrrrr rrrrr|r~rrar'r*rr.r>r1rr3r5rrrs@r(rr8sx$ BB* 2* &4 * 53 ;) ( . 6**r*rc,eZdZdZdZdZedZy)__compute_selector_defaultaK Using a function instead of setting default to [] in _slot_defaults, as if it were modified in place later, which would happen with check_on_set set to False, then the object in _slot_defaults would itself be updated and the next Selector instance created wouldn't have [] as the default but a populated list. cgSr/r=r s r(rz#__compute_selector_default.__call__s r*c,t|jSr/r rs r(rz#__compute_selector_default.__repr__r r*cgSr/r=rs r(r z__compute_selector_default.sigs r*Nrr=r*r(r?r?s%r*r?c(eZdZdZdZedZy)#__compute_selector_checking_defaultc2t|jdk7S)Nr)rLrr s r(rz,__compute_selector_checking_default.__call__s199~""r*c,t|jSr/r rs r(rz,__compute_selector_checking_default.__repr__r r*cyr/r=rs r(r z'__compute_selector_checking_default.sigrr*Nrr=r*r(rDrDs #r*rDc ZeZdZeej ededddZefdZ xZ S)_SignatureSelectorNF)rcompute_default_fn check_on_setrrr,cLt|}|jd|d<|S)Nrr)r_modified_slots_defaultsr)rgdefaultsrxs r(rMz+_SignatureSelector._modified_slots_defaultss(735&ll:6r*) rrrr?rrG_compute_selector_default"_compute_selector_checking_defaultrmrMrrs@r(rIrIs:##.G.PUDN r*rIceZdZdZgdZej gdddddddddddddddddZee e e e e e ddfd Zd Z e d Z e jd Z d ZdZdZdZdZxZS)Selectora Parameter whose value must be one object from a list of possible objects. By default, if no default is specified, picks the first object from the provided set of objects, as long as the objects are in an ordered data collection. check_on_set restricts the value to be among the current list of objects. By default, if objects are initially supplied, check_on_set is True, whereas if no objects are initially supplied, check_on_set is False. This can be overridden by explicitly specifying check_on_set initially. If check_on_set is True (either because objects are supplied initially, or because it is explicitly specified), the default (initial) value must be among the list of objects (unless the default value is None). The list of objects can be supplied as a list (appropriate for selecting among a set of strings, or among a set of objects with a "name" parameter), or as a (preferably ordered) dictionary from names to objects. If a dictionary is supplied, the objects will need to be hashable so that their names can be looked up from the object value. empty_default is an internal argument that does not have a slot. )rrJrKrNFT)rr,rrJrKr empty_defaultrrrr-rrrrrcyr/r=)rzrr,rrJrKrrSrrrr-rrrrrs r(rzSelector.__init__5rr*)rr,rrJrKrrSc t} |turD|rBt|trt|j d} nt|tr|d} |s |tur| n|}||_||_||_t |$d||d||tur|jd|_ n||_ |j|j|j|jy)Nrr,rrr=)r r6r?rOrrrJrKrrrGrr,r6 _update_state) rzrr,rrJrKrrSrU autodefaultrxs r(rzSelector.__init__As  ) #'4("7>>#34Q7 GT*%aj &398L+SZ "4(  @ @8> @  ""11,?DO(DO << #   . r*cr|jdur)|j|j|jyyyrrKr,_ensure_value_is_in_objectsrs r(rWzSelector._update_state^s4    %$,,*B  , ,T\\ :+C %r*c.t|j|Sr/)rrrs r(rzSelector.objectsbs--r*ct|tjjr&||_t |j |_yi|_||_yr/)r6r8r9MappingrrOrr)rzrs r(rzSelector.objectsfs> g{66 7 DJ !12DMDJ#DMr*c|jGt|jr1|j|_|j|jyyy)z If this parameter's compute_default_fn is callable, call it and store the result in self.default. Also removes None from the list of objects (if the default is no longer None). N)r,rrJr[rs r(compute_defaultzSelector.compute_defaultrsF << HT-D-D$E224DL  , ,T\\ :%F r*cb|js|j|y|j|yr/)rKr[r6rs r(rzSelector._validate~s*   , ,S 1  S!r*cR|jr|jr|||jvr}g}d}d}|jD]5}t|}|t |z }|dkr|j |3d}nddj |z|z}tt|d|d|yyy) Nrrz, ...]rrz does not accept z; valid options include: ) rKrrrGrLrjoinr-r)rzrr>limiterritemstrings r(r6zSelector._validate_values   doo#+3VZVbVbKbEGF T#f+%C<LL(&G%$))E**W4E)$/00A#I**/4 Lc+ r*cX||jvr|jj|yy)z Make sure that the provided value is present on the objects list. Subclasses can override if they support multiple items on a list, to check each item instead. N)rrrrs r(r[z$Selector._ensure_value_is_in_objectss' dll " MM  % #r*cBt|j|jS)z Return the possible objects to which this parameter could be set. (Returns the dictionary {object.name: object}.) )rrrrs r(rzSelector.get_ranges 4==$**55r*)rrrrrFrrrrr rWrrsetterr`rr6r[rrrs@r(rRrRs8LI __t4d% !TY    "+YI$-I%U 8;.. ^^$$ ;"&&6r*rRceZdZdZej d gddddddddddddddddZeefedfd ZxZ S) ObjectSelectorzd Deprecated. Same as Selector, but with a different constructor for historical reasons. NFTrrrJrKrrSrrrr-rrrrrcyr/r=rzr,rrrJrKrrSrrrr-rrrrrs r(rzObjectSelector.__init__rr*rc ,t|d||dd|yNT)rr,rSr=rQrzr,rrTrxs r(rzObjectSelector.__init__s$  7''+ 7/5 7r*r/) rrrrrrrrr rrs@r(rlrlsk  __ !#4d% !TY    (7Y7 7r*rlceZdZdZdgZeejdZej ddgdddddddddddddddd Z e e fe dfd Z fd Z e fd Zfd ZxZS) FileSelectorzFGiven a path glob, allows one file to be selected from those matching.pathrvNFT)rvrrrJrKrrSrrrr-rrrrrcyr/r=)rzr,rvrrrJrKrrSrrrr-rrrrrs r(rzFileSelector.__init__rr*c ||_||_|j||tur||_t |d|j|j d|yNrx)r,rr=)r,rvr5r rrrrzr,rvrTrxs r(rzFileSelector.__init__sM     ) #"DL Ot}}OOr*cXt|||||dk(r|j|yyNrvrxr_on_setr5rz attributernewrxs r(rzFileSelector._on_set.  3,   KKSK ! r*c^|tur |j}|dk(rg|_nKtjt j |}ttj||_|j|jvry|jr|jd|_ yd|_ y)Nrwr) r rvrosfspathpathlibPathsortedglobr,)rzrv pathpatterns r(r5zFileSelector.updates} 9 99D 2:DL))GLL$67K!$))K"89DL <<4<< ' *.,,t||A D r*cHt|jt| Sr/rrvrrr(s r(rzFileSelector.get_range 57+<+>??r*r/rrrrrFr?rRrGrrrrr rr5rrrs@r(rurusPIbN __  "%TXd% !TY    (P)P P" $ A@@r*ruceZdZdZej dgddddddddddddddddZeefedfd Zd Z d Z d Z fd Z d Z xZS) ListSelectorzj Variant of Selector where the value can be multiple objects from a list of possible objects. NFTrmcyr/r=ros r(rzListSelector.__init__rr*rpc ,t|d||dd|yrrrQrss r(rzListSelector.__init__s'  LWD LDJ Lr*c|jgt|jrQ|j|_|jD],}||jvs|jj |.yyyr/)r,rrJrrrzr&s r(r`zListSelector.compute_defaults^ << HT-D-D$E224DL\\DLL(LL''*"%F r*c| |jry|j||jr|j|y|D]}|j |yr/)r_validate_typerKr6r[)rzrrVs r(rzListSelector._validatesM KDOO  C      %003r*cXt|tstt|d|dy)Nz only takes list types, not r,)r6rOr-rrs r(rzListSelector._validate_types:#t$)$/01gQ  %r*cZ|j|||D]}t| |yyr/)rrr6)rzrr&rxs r(r6zListSelector._validate_value!s2 C ?'* r*c|jdur0|j#|jD]}|j|yyyrrZrs r(rWzListSelector._update_state's>    %$,,*B\\003"+C %r*r/)rrrrrrrrr r`rrr6rWrrs@r(rrs  __ !#4d% !TY    (LYL L+ 4+ 4r*rceZdZdZdgZeejdZej ddgdddddddddddddddd Z e e fe dfd Z fd Z e fd Zfd ZxZS)MultiFileSelectorzQGiven a path glob, allows multiple files to be selected from the list of matches.rvrwrxNFT)rvrrJrKrrSrrrrr-rrrrrcyr/r=)rzr,rvrrJrKrrSrrrrr-rrrrrs r(rzMultiFileSelector.__init__6s r*c ~||_||_|j|t|d||j d|yr{)r,rvr5rrrr|s r(rzMultiFileSelector.__init__As:     J$--J6Jr*cXt|||||dk(r|j|yyr~rrs r(rzMultiFileSelector._on_setHrr*c0|tur |j}ttj||_|j r0t |j Dcgc]}||jvc}ry|j sy|j|_ycc}wr/)r rvrrrr,rJ)rzrvr&s r(r5zMultiFileSelector.updateMso 9 99Ddiio. <.s1O""++sz value must be z an instancez a subclassz of r+r,) rr6 issubclassrr rdrr-r)rzrrr class_names r(rzClassSelector._validate_class_|s KDOO  JsF3[ZX[]cMd  fh ' -- 1O1O(OPJJ%d+,O +}>d:,fUXT[[\ ^  r*ct|jtr |jn |jf}i}|D]}|jt |t d|j D}|jrd|d<|S)a% Return the possible types for this parameter's value. (I.e. return `{name: }` for all classes that are concrete_descendents() of `self.class_`.) Only classes from modules that have been imported are added (see concrete_descendents()). c3*K|] \}}||f ywr/r=)r1r rs r(r3z*ClassSelector.get_range..sN:M;4v:MsNNone)r6rrIr5rrr>r)rzclasses all_classesrgr%s r(rzClassSelector.get_rangess",DKK!?$++dkk^ C   3C8 9 N+:K:K:MN N ??AfIr*)rrrrrFr?rrGrrrrr rrrrrs@r(rr[s=)I,554UYZN __ Ttd$4TPTe    *3Xa% % B r*rcjeZdZdZej dddddddddddddd dZeffd ZxZS) rHz&Parameter whose value is a dictionary.NTF rrrrrrr-rrrrrc yr/r=rzr,rrrrrrr-rrrrrs r(rz Dict.__init__rr*c 2t|d|td|y)Nr,rr=)rrr?rs r(rz Dict.__init__s @@@r*r/) rrrrrrrr rrs@r(rHrHsT0 __ %)d$4TTPTe    )AAr*rHceZdZdZej d ddddddddddddd dZeffd ZedZ ed Z xZ S) rSz'Parameter whose value is a numpy array.NTFrc yr/r=rs r(rzArray.__init__rr*c 6ddlm}t| d||d|y)Nrr8rr=)r7r9rr)rzr,rUr9rxs r(rzArray.__init__s! CCFCr*c(|y|jSr/)tolistrfs r(rhzArray.serializes =||~r*c|dk(s|yddlt|trtjfdd|dSj |S)Nrjrc8jt|Sr/)loadtxtrG)xr7s r(z#Array.deserialize..su}}SV7Lr*)z.npyz.txtrS)r7r6rGrloadasarray)rgr`r7s @r(rlzArray.deserializesN F?em eS !)-LMw  ==' 'r*r/) rrrrrrrr rmrhrlrrs@r(rSrSsv1 __ %)d$4TTPTe    )D  ( (r*rSceZdZdZgdZeejdddZej d dddddddddddddddddZ e e fe e e dfd Z d Z fd Zed Zed ZxZS)r;a Parameter whose value is a pandas DataFrame. The structure of the DataFrame can be constrained by the rows and columns arguments: rows: If specified, may be a number or an integer bounds tuple to constrain the allowable number of rows. columns: If specified, may be a number, an integer bounds tuple, a list or a set. If the argument is numeric, constrains the number of columns using the same semantics as used for rows. If either a list or set of strings, the column names will be validated. If a set is used, the supplied DataFrame must contain the specified columns and if a list is given, the supplied DataFrame must contain exactly the same columns and in the same order and no other columns. )rowscolumnsorderedNTF)rrrrrrrrrr-rrrrrcyr/r=)rzr,rrrrrrrrrr-rrrrrs r(rzDataFrame.__init__rr*c ddlm}||_||_||_t |d||d||j|jy)Nr)r;rr=) r:r;rrrrrrr,)rzr,rrrrUrXrxs r(rzDataFrame.__init__sB0    DDVD t||$r*c|d|d|}t|ts||k7rtt|d|y|\}}|duxr||kxs |duxr||kD}|rtt|d|yNz length z# does not match declared bounds of z: r6rIr-rrzrbrr messagerrfailures r(_length_bounds_checkzDataFrame._length_bounds_check F(6(*MfXV&%(&  $:4$@#AG9!MNN%:6E>=D(;Ve^   6t <=RyIJ J r*c 4t||t|jtr%|j durt t|d|jr|y|jnt|jtrft|jdk(rNtd|jDr2|j|jt|jdnt|jttfr|j t|jtn |j |_t |j|jDchc] }t|c}z }|rrt t|dt|jdt|j|j|jt|jd|j rdt|jt|jk7r9t t|dt|jd |j|j '|j|j t|d yycc}w) NTz3: columns cannot be ordered when specified as a setr4c3fK|])}t|tdtjf+ywr/)r6r\numbersrF)r1rVs r(r3z&DataFrame._validate.. s%X.L sfooaTo&Br*) z.csvz.dtaz.featherz.h5z.hdf5z.jsonz.odsz.parquetz.pklz.tsvz.xlsmz.xlsxr;) r:r6rGrr read_stata read_featherread_hdf read_json read_excel read_parquet read_pickler;)rgr`r:s @r(rlzDataFrame.deserialize; s F?em eS !)"OO"-- & 3 3!??#__#--"-- & 3 3"..B#..#.. +' ' ##E* *r*r/)rrrrrFr?rrGrrrrr rrrmrhrlrrs@r(r;r;s$/I$$4tN __ "D$Dd$4TTPTe    (%)YXa% % K$BL(( ++r*r;ceZdZdZdgZeejddZej d dddddddddddddd dZ e e fe e dfd Z d Z fd ZxZS) r<z Parameter whose value is a pandas Series. The structure of the Series can be constrained by the rows argument which may be a number or an integer bounds tuple to constrain the allowable number of rows. rNF)rrT) rrrrrrrr-rrrrrc yr/r=)rzr,rrrrrrrr-rrrrrs r(rzSeries.__init__c rr*c |ddlm}||_t|d|||d||j |j y)Nr)r<)r,rrr=)r:r<rrrrr,)rzr,rrrUrYrxs r(rzSeries.__init__m s=-   #j #! # t||$r*c|d|d|}t|ts||k7rtt|d|y|\}}|duxr||kxs |duxr||kD}|rtt|d|yrrrs r(rzSeries._length_bounds_checku rr*ct|||jr|y|j'|j |jt |dyy)Nr)rrrrrrLrs r(rzSeries._validate sG # ??s{  99  % %diiS5 A !r*r/)rrrrrFr?rrGrrrrr rrrrs@r(r<r<T sI$$4EN __ "u$ 4TPTe    (%) % % KBBr*r<ceZdZdZgdZeejddddgZejgfdddddddddddddddd Z e e fe e e e d d Z d Z d ZdZdZy)rPa Parameter whose value is a list of objects, usually of a specified type. The bounds allow a minimum and/or maximum length of list to be enforced. If the item_type is non-None, all items in the list are checked to be of that type. `class_` is accepted as an alias for `item_type`, but is deprecated due to conflict with how the `class_` slot is used in Selector classes. )rb item_typerN)rNT)rrrbrr,F)rrrrbrrrrr-rrrrrcyr/r=)rzr,rrrrbrrrrr-rrrrrs r(rz List.__init__ rr*)rrrrbc F|turtjdtd|tur|tur||_n|tus|||_n||_|j|_||_tj|f||d||j|jy)NzGThe 'class_' attribute on 'List' is deprecated. Use instead 'item_type')rcategory stacklevelrV) r warningsr_ParamFutureWarningrrrbrrrr,)rzr,rrrrbrUs r(rz List.__init__ s  " MMa,  I %& *A&DN ) #y'8#DN&DNnn  4 %k %# % t||$r*c|j||j|j||j|j ||j yr=)r6rr0rb_validate_item_typerrs r(rzList._validate s@ S$//2 c4;;/   dnn5r*c >|| |jry|\}}t|}|0|.||cxkr|ks"ntt|d|d|d|dy|#||kstt|d|d|dy|#||kstt|d|d|dyy) zGChecks that the list is of the right length and has the right contents.Nz length must be between z and z (inclusive), not r,z length must be at least r+z length must be at most r)rzrrb min_length max_lengthrrs r(r0zList._validate_bounds s >ckdoo !' J H  !j&<!1z1 -d344L!l% |3EaSK2  #? -d345'Lqc4#  # ? -d345&>AmmpstqAADGGH Hr*N) rrrrrPrr r rBr rr=r*r(rr sE  EPL4e&*1L Hr*r) warning_catcLeZdZdZeej ddZddZy)normalize_patha? Convert a UNIX-style path to the current OS's format, typically for creating a new file or directory. If the path is not already absolute, it will be made absolute (using the prefix parameter). Should do the same as Python's os.path.abspath(), except using prefix rather than os.getcwd). FzO Prepended to the specified path, if that path is not absolute.rc $t||}tjj|sGtjj tjj |j |}tjj |Sr/)r rrvr rdrr)rzrvrUres r(rznormalize_path.__call__g sZ 4 'ww}}T"77<< 0 0 :4@Dww%%r*N)rw) rrrrr rr rrr=r*r(rrV s* IBIIKUHF&r*rceZdZdZddgZeejdZej ddddddddddddddd d Z e e fe e d fd Z d Z d ZfdZfdZxZS)rak Parameter that can be set to a string specifying the path of a file or folder. The string should be specified in UNIX style, but it will be returned in the format of the user's operating system. Please use the Filename or Foldername Parameters if you require discrimination between the two possibilities. The specified path can be absolute, or relative to either: * any of the paths specified in the search_paths attribute (if search_paths is not None); or * any of the paths searched by resolve_path() (if search_paths is None). Parameters ---------- search_paths : list, default=[os.getcwd()] List of paths to search the path from check_exists: boolean, default=True If True (default) the path must exist on instantiation and set, otherwise the path can optionally exist. r  check_existsT)rNF) r rrrrrrr-rrrrrc yr/r=)rzr,r rrrrrrr-rrrrrs r(rz Path.__init__ rr*)r rc |turg}||_|turt|ts t d||_t ||fi||j|jy)Nz0'check_exists' attribute value must be a boolean) r r r6rAr-rrrrr,)rzr,r rrUrxs r(rz Path.__init__ s_ 9 $L( y (L$1OOP P( *6* t||$r*c2t|d|jS)Nr r rr rzrvs r(_resolvez Path._resolve Dt$BSBSTTr*cX|$|jstt|dyt|tt j fstt|d |j|y#t$r/}|jrt|jddYd}~yd}~wwxYw)Nz does not accept Nonez$ only take str or pathlib.Path typesr) rr-rr6rGrrr"rrr)rzres r(rzPath._validate s ;?? $:4$@#AAV!WXX#cC#67 $:4$@#AAe!fgg 7 c" 7$$!!&&),$6% 7sA11 B):%B$$B)ct|||}|d}|S |j|}|S#t$r|jr|}Y|SwxYw)z7Return an absolute, normalized path (see resolve_path).N)rrr"rr)rzrrraw_pathrvrxs r(rz Path.__get__ sf7?3w/  D  $}}X.   $$$#D  $s,AAc6t|}d|vrg|d<|S)Nr )r __getstate__rDs r(r)zPath.__getstate__ s'$& U "$&E. ! r*r/)rrrrrFr?rrGrrrrr r"rrr)rrs@r(rrq s8 0I  tN __ &*d$4UTPTe    ( %)R[ %  %U 7 r*rceZdZdZdZy)Filenamea Parameter that can be set to a string specifying the path of a file. The string should be specified in UNIX style, but it will be returned in the format of the user's operating system. The specified path can be absolute, or relative to either: * any of the paths specified in the search_paths attribute (if search_paths is not None); or * any of the paths searched by resolve_path() (if search_paths is None). c2t|d|jS)NTrr r!s r(r"zFilename._resolve r#r*Nrrrrr"r=r*r(r+r+ s "Ur*r+ceZdZdZdZy) Foldernamea Parameter that can be set to a string specifying the path of a folder. The string should be specified in UNIX style, but it will be returned in the format of the user's operating system. The specified path can be absolute, or relative to either: * any of the paths specified in the search_paths attribute (if search_paths is not None); or * any of the paths searched by resolve_dir_path() (if search_paths is None). c2t|d|jS)NFrr r!s r(r"zFoldername._resolve sDu4CTCTUUr*Nr-r=r*r(r/r/ s "Vr*r/ceZdZdZgdZdgZeejdZe j dddddddddddddd d Z e e fe dfd Z d Zd Zd ZxZS)Colorzy Color parameter defined as a hex RGB string with an optional # prefix or (optionally) as a CSS3 color name. ) aliceblue antiquewhiteaqua aquamarineazurebeigebisqueblackblanchedalmondblue bluevioletbrown burlywood cadetblue chartreuse chocolatecoralcornflowerbluecornsilkcrimsoncyandarkbluedarkcyan darkgoldenroddarkgraydarkgrey darkgreen darkkhaki darkmagentadarkolivegreen darkorange darkorchiddarkred darksalmon darkseagreen darkslateblue darkslategray darkslategrey darkturquoise darkvioletdeeppink deepskybluedimgraydimgrey dodgerblue firebrick floralwhite forestgreenfuchsia gainsboro ghostwhitegold goldenrodgraygreygreen greenyellowhoneydewhotpink indianredindigoivorykhakilavender lavenderblush lawngreen lemonchiffon lightblue lightcoral lightcyanlightgoldenrodyellow lightgray lightgrey lightgreen lightpink lightsalmon lightseagreen lightskybluelightslategraylightslategreylightsteelblue lightyellowlime limegreenlinenmagentamaroonmediumaquamarine mediumblue mediumorchid mediumpurplemediumseagreenmediumslatebluemediumspringgreenmediumturquoisemediumvioletred midnightblue mintcream mistyrosemoccasin navajowhitenavyoldlaceolive olivedraborange orangeredorchid palegoldenrod palegreen paleturquoise palevioletred papayawhip peachpuffperupinkplum powderbluepurplered rosybrown royalblue saddlebrownsalmon sandybrownseagreenseashellsiennasilverskyblue slateblue slategray slategreysnow springgreen steelbluetantealthistletomato turquoisevioletwheatwhite whitesmokeyellow yellowgreen allow_namedT)rNF) rrrrrrr-rrrrrc yr/r=)rzr,rrrrrrr-rrrrrs r(rzColor.__init__2 rr*c lt|dd|i|||_|j|jyrW)rrrrr,)rzr,rrTrxs r(rzColor.__init__< s0 33F3& t||$r*ct|j||j|j||jyr/)r6r_validate_allow_namedrrs r(rzColor._validateB s, S$//2 ""3(8(89r*ct|r|yt|ts#tt|dt |dy)Nz* expects a string value, not an object of r,)r6rGr-rr\r5s r(r6zColor._validate_valueF sH 3; #s#)$/01$$(I;a1 $r*c| |jrytjd|}|jr:|s7|j |j vrt t|d|dyy|st t|d|dy)Nz*^#?(([0-9a-fA-F]{2}){3}|([0-9a-fA-F]){3})$z5 only takes RGB hex codes or named colors, received 'z'.z, only accepts valid RGB hex codes, received r,)rrematchrr _named_colorsr-r)rzrris_hexs r(rzColor._validate_allow_namedO s KDOO FL   ciik1C1CC -d345225b:D6 )$/01##&', r*r/)rrrrrrFr?rrGrrrrr rr6rrrs@r(r2r2 s "/MHI)22EN __ %)d$4UTPTe    (%% % :r*r2ceZdZdZdgZeejdddZej dddddddddddddd d Z e e fe e d fd Z d Z d ZdZxZS)Bytesz A Bytes Parameter, with a default value and optional regular expression (regex) matching. Similar to the String parameter, but instead of type string this parameter only allows objects of type bytes (e.g. b'bytes'). regexr*NF)r,rrT) rrrrrrr-rrrrrc yr/r=)rzr,rrrrrrr-rrrrrs r(rzBytes.__init__s rr*)rrc lt|dd|i|||_|j|jyrW)rrrrr,)rzr,rrrTrxs r(rzBytes.__init__} s/ 33F3  t||$r*c| |jry|4tj||tt |d|d|dyy)Nz value z does not match regex r,)rrrr-r)rzrrs r(_validate_regexzBytes._validate_regex s] KDOO   %!5!=)$/0w?((-y3 "> r*ct|r|yt|ts#tt|dt |dy)Nz. only takes a byte string value, not value of r,)r6bytesr-rr\r5s r(r6zBytes._validate_value sH #+ #u%)$/01 $S {!- &r*ct|j||j|j||jyr/)r6rrrrs r(rzBytes._validate s* S$//2 S$**-r*)r*)rrrrrFr?rrGrrrrr rr6rrrs@r(rrc s I  #TeN  __ "u 5TPTe    (%9% % .r*r)err8rarbrarr3ros.pathrrrrQrrrcollections.abcr contextlibr parameterizedrrr r r r r rrrr_utilsrrrrrrrrrrrrrr)rZr^rjrtrvrrrrHrFrDrNr@rorBrrrrNrKrrrMrrrrrrOrr?rOrDrPrIrRrlrurrrrHrSr;r<rPrrrrr+r/r2rr=r*r(rs)$   #$%    ('+ 61h-:,*<008V=VBYiYx  '(R$WR$lf4  .8C68Cv0>60>l"3i"3JB(GB(P  9:GIGT 5  >L>&g1Lg1TL#L#^(R(R\"3y"3JX:# :#@ T9 Ti*i*X$78  &I%J"  Q6|/Q6h7X7,0@80@f74874t+@ +@\BLBJA=A""(M"(J{+ {+|5B]5Bvh9hVtB7H(7Hv ,-&*&.&4_9_FUtU,VV2ZIZ@4.I4.r*