+ NV-jF:xRt^RIHt^RIHtHt^RIHtHt^RI t ^RI H t ^RI Ht^RIHtHt]!R]]4t]!R ]]R4tR R ltR R ltRRltRRltRRltRRltR,RRlltRRltR-RRlltRRlt]RRl4t ]R R!l4t R"R#lt R$R%lt!R&R'lt"R(R)lt#R*R+lt$R#).zV Module that contains many useful utilities for validating data or function arguments ) annotations)IterableSequence)TypeVaroverloadN)lib)NA)is_bool is_integerBoolishT BoolishNoneTcV^8dQhRR/#returnNone)formats"h/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/pandas/util/_validators.py __annotate__rs   c V^8d \R4h\V4\V48dG\V4V,p\V4V,pV^8XdRMRp\V RV RV RV R24hR#) z Checks whether 'args' has length of at most 'compat_args'. Raises a TypeError if that is not the case, similar to in Python when a function is called with too many arguments. z*'max_fname_arg_count' must be non-negativeargument argumentsz() takes at most  z (z given)N) ValueErrorlen TypeError)fnameargsmax_fname_arg_count compat_args max_arg_countactual_arg_countrs&&&& r_check_arg_lengthr$s QEFF 4y3{##K(+>> t9'::!.!!3:g&}oQxjA ! *  $rcV^8dQhRR/#rr)rs"rrr3s##4#rcVFbpW,pW#,pVeVe VfVeRpMWE8Hp\V4'g \R4hV'dKR\RV RV R24h R# \dY,Y#,JpL=i;i)z Check that the keys in `arg_val_dict` are mapped to their default values as specified in `compat_args`. Note that this function is to be called only when it has been checked that arg_val_dict.keys() is a subset of compat_args NFz'match' is not a booleanzthe 'z=' parameter is not supported in the pandas implementation of z())r r)r arg_val_dictr!keyv1v2matchs&&& r_check_for_default_valuesr,3s :"B!B2:2:".5>> !;<<"uu005wb: 1( : %)99E :sAA++B B cV^8dQhRR/#rr)rs"rrrYs&:&:D&:rcb\WW#4\\W1RR74p\WV4R#)a Checks whether the length of the `*args` argument passed into a function has at most `len(compat_args)` arguments and whether or not all of these elements in `args` are set to their default values. Parameters ---------- fname : str The name of the function being passed the `*args` parameter args : tuple The `*args` parameter passed into a function max_fname_arg_count : int The maximum number of arguments that the function `fname` can accept, excluding those in `args`. Used for displaying appropriate error messages. Must be non-negative. compat_args : dict A dictionary of keys and their associated default values. In order to accommodate buggy behaviour in some versions of `numpy`, where a signature displayed keyword arguments but then passed those arguments **positionally** internally when calling downstream implementations, a dict ensures that the original order of the keyword arguments is enforced. Raises ------ TypeError If `args` contains more values than there are `compat_args` ValueError If `args` contains values that do not correspond to those of the default values specified in `compat_args` FstrictN)r$dictzipr,)rrr r!kwargss&&&& r validate_argsr4Ys-@e#6D #k6 7Fe[9rcV^8dQhRR/#rr)rs"rrrs U U4 Urc\V4\V4, pV'd&\\V44p\V RV R24hR#)zq Checks whether 'kwargs' contains any keys that are not in 'compat_args' and raises a TypeError if there is one. z'() got an unexpected keyword argument ''N)setnextiterr)rr3r!diffbad_args&&& r_check_for_invalid_keysr=sG v;[) )D tDz"5'!H QRSTT rcV^8dQhRR/#rr)rs"rrrs8848rcVVP4p\WV4\WV4R#)a Checks whether parameters passed to the **kwargs argument in a function `fname` are valid parameters as specified in `*compat_args` and whether or not they are set to their default values. Parameters ---------- fname : str The name of the function being passed the `**kwargs` parameter kwargs : dict The `**kwargs` parameter passed into `fname` compat_args: dict A dictionary of keys that `kwargs` is allowed to have and their associated default values Raises ------ TypeError if `kwargs` contains keys not in `compat_args` ValueError if `kwargs` contains keys in `compat_args` that do not map to the default values specified in `compat_args` N)copyr=r,)rr3r!kwdss&&& rvalidate_kwargsrBs#, ;;=DE;7e;7rcV^8dQhRR/#rr)rs"rrrs7070 70rc\W\VP44,W44\\ WARR74pVFpWb9gK \ V RV R24h VP V4\WV4R#)a Checks whether parameters passed to the *args and **kwargs argument in a function `fname` are valid parameters as specified in `*compat_args` and whether or not they are set to their default values. Parameters ---------- fname: str The name of the function being passed the `**kwargs` parameter args: tuple The `*args` parameter passed into a function kwargs: dict The `**kwargs` parameter passed into `fname` max_fname_arg_count: int The minimum number of arguments that the function `fname` requires, excluding those in `args`. Used for displaying appropriate error messages. Must be non-negative. compat_args: dict A dictionary of keys that `kwargs` is allowed to have and their associated default values. Raises ------ TypeError if `args` contains more values than there are `compat_args` OR `kwargs` contains keys not in `compat_args` ValueError if `args` contains values not at the default value (`None`) `kwargs` contains keys in `compat_args` that do not map to the default value as specified in `compat_args` See Also -------- validate_args : Purely args validation. validate_kwargs : Purely kwargs validation. Fr/z-() got multiple values for keyword argument 'r7N)r$tuplevaluesr1r2rupdaterB)rrr3r r! args_dictr(s&&&&& rvalidate_args_and_kwargsrIs{P eFMMO,,.A S59:I ='Fse1M   MM)E;/rc ,V^8dQhRRRRRRRRRR/#) rvaluer arg_namestr none_allowedbool int_allowedrr)rs"rrrs:** *** *  *rc\V4pV'dT;'gVRJpV'dT;'g\V\4pV'g&\RV R\ V4P R24hV#)a Ensure that argument passed in arg_name can be interpreted as boolean. Parameters ---------- value : bool Value to be validated. arg_name : str Name of the argument. To be reflected in the error message. none_allowed : bool, default True Whether to consider None to be a valid boolean. int_allowed : bool, default False Whether to consider integer value to be a valid boolean. Returns ------- value The same value as input. Raises ------ ValueError If the value is not a valid boolean. NzFor argument "z$" expected type bool, received type .)r isinstanceintrtype__name__)rKrLrNrP good_values&&&& rvalidate_bool_kwargrXsr<J22ETM 99:eS#9 XJ'K(() ,   LrcV^8dQhRR/#)rnamerMr)rs"rrrsYYYrcV\PJg]\V\4'gGVeCV\Jg9\P !V4'd\ P!V4'dR#\V RV 24h)z Validate na arguments. Parameters ---------- value : object Value to validate. name : str Name of the argument, used to raise an informative error message. Raises ______ ValueError When ``value`` is determined to be invalid. Nz2 must be None, pd.NA, np.nan, True, or False; got ) r no_defaultrSrOris_floatnpisnanr)rKrZs&&rvalidate_na_argr`s_"  eT " " = B; LL  BHHUOO vOPUwW XXrcV^8dQhRR/#)rvalidate_scalar_dict_valuerOr)rs"rrr,s$$d$rc(^RIHpVfVf \R4hVfVe V!V4pW3#VeNVfJV'd?\V\\ 34'd#\ R\V4P R24hW3#VeVe \R4hW3#)a Validate the keyword arguments to 'fillna'. This checks that exactly one of 'value' and 'method' is specified. If 'method' is specified, this validates that it's a valid method. Parameters ---------- value, method : object The 'value' and 'method' keyword arguments for 'fillna'. validate_scalar_dict_value : bool, default True Whether to validate that 'value' is a scalar or dict. Specifically, validate that it is not a list or tuple. Returns ------- value, method : object )clean_fill_methodz(Must specify a fill 'value' or 'method'.z>"value" parameter must be a scalar or dict, but you passed a ""z)Cannot specify both 'value' and 'method'.) pandas.core.missingrdrrSlistrErrUrV)rKmethodrbrds&&& rvalidate_fillna_kwargsri,s&6 }CDD }+"6* =  v~ %*UT5M*J*J!!%e!5!5 6a9  =  v1DEE =rc V^8dQhRRRR/#)rqzfloat | Iterable[float]rz np.ndarrayr)rs"rrrSs2zrc \P!V4pRpVP^8Xd ^Tu;8:d^8:gM\V4hV#\;QJdRV4F 'dK RM RM !RV44'g \V4hV#)a Validate percentiles (used by describe and quantile). This function checks if the given float or iterable of floats is a valid percentile otherwise raises a ValueError. Parameters ---------- q: float or iterable of floats A single percentile or an iterable of percentiles. Returns ------- ndarray An ndarray of the percentiles if valid. Raises ------ ValueError if percentiles are not in given interval([0, 1]). z0percentiles should all be in the interval [0, 1]c3N"TFp^Tu;8*;'d^8*MuxK R#5i)Nr).0qss& r &validate_percentile..os."bAs%%FT)r^asarrayndimrall)rkq_arrmsgs& rvalidate_percentilerxSsv* JJqME =C zzQEQS/ ! LS..SSS.. . .o Lrc V^8dQhRRRR/#)r ascendingr rr)rs"rrrus<<(+rr)T)%__doc__ __future__rcollections.abcrrtypingrrnumpyr^ pandas._libsrpandas._libs.missingrpandas.core.dtypes.commonr r rOrTr r r$r,r4r=rBrIrXr`rirxr~rrrrrrrrs # # :tS )~tS$7  (#L&:R U8670t*ZY6$NB < < L LT%B D$r