Mh7`SrSSKJr SSKJrJr SSKJrJr SSK r SSK J r SSK JrJr \"S\\5r\"S \\S5rSS jrSS jrSS jrSS jrSSjrSSjrSSSjjrSSSjjrSSjr\S Sj5r\S!Sj5rS"SjrS#SjrS$SjrS%Sjr SSjr!g)&zV Module that contains many useful utilities for validating data or function arguments ) annotations)IterableSequence)TypeVaroverloadN)lib)is_bool is_integerBoolishT BoolishNoneTc US:a [S5e[U5[U5:a=[U5U-n[U5U-nUS:XaSOSn[USUSUSUS 35eg ) 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. rz*'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 I/var/www/html/env/lib/python3.13/site-packages/pandas/util/_validators.py_check_arg_lengthrs QEFF 4y3{##K(+>> t9'::!.!!3:g&}oQxjA ! *  $cUHTnXnX#nUbUbUcUbSnOXE:Hn[U5(d [S5eU(aMD[SUSUS35e g![a XX#LnN2f=f)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_dictrkeyv1v2matchs r_check_for_default_valuesr$1s :"B!B2:2:".5>> !;<<"uu005wb: 1( : %)99E :s6AA10A1c\[XX#5 [[X155n[XU5 g)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` N)rdictzipr$)rrrrkwargss r validate_argsr)Ws+@e#6D #k( )Fe[9rc[U5[U5- nU(a%[[U55n[USUS35eg)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)rr(rdiffbad_args r_check_for_invalid_keysr1sG v;[) )D tDz"5'!H QRSTT rcTUR5n[XU5 [XU5 g)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)copyr1r$)rr(rkwdss rvalidate_kwargsr5s#, ;;=DE;7e;7rc[X[UR55-X45 [[ XA55nUHnXb;dM [ USUS35e UR U5 [XU5 g)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. z-() got multiple values for keyword argument 'r+N)rtuplevaluesr&r'rupdater5)rrr(rr args_dictr s rvalidate_args_and_kwargsr;syP eFMMO,,.A S+,I ='Fse1M   MM)E;/rc[U5nU(a U=(d USLnU(aU=(d [U[5nU(d%[SUS[ U5R S35eU$)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__)valuearg_name none_allowed int_allowed good_values rvalidate_bool_kwargrGsl<J2ETM 9:eS#9 XJ'K(() ,   LrcSSKJn UcUc [S5eUcUb U"U5nX4$UbJUcGU(a=[U[[ 45(a"[ S[U5RS35eX4$UbUb [S5eX4$)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 r)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.missingrIrr>listr7rr@rA)rBmethodvalidate_scalar_dict_valuerIs rvalidate_fillna_kwargsrOs&6 }CDD }+"6* =  v~ %*UT5M*J*J!!%e!5!5 6a9  =  v1DEE =rc[R"U5nSnURS:XaSUs=::aS::d O [U5eU$[ SU55(d [U5eU$)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]rrc3L# UHnSUs=:*=(a S:*Os v M g7f)rrN).0qss r &validate_percentile..Ss0%B1<rrG)rbr(items rrcrcbsR$D 9F i * *"9kDVDDIR S k strgetr) inclusiveleft_right_inclusives rvalidate_inclusiverwsX 6:)S!! !"%  #i. # M   rc[U5(d[SUSU35eUS:aX- nSUs=::aU::dO [SUSU35eU$)z Check that we have an integer between -length and length, inclusive. Standardize negative loc to within [0, length]. The exceptions we raise on failure match np.insert. z loc must be an integer between -z and r)r r IndexError)loclengths rvalidate_insert_locr|s_ c??:6(%xPQQ Qw   v ;F85QRR JrcVU[RLaUS;a[SUS35egg)N)numpy_nullablepyarrowzdtype_backend z= is invalid, only 'numpy_nullable' and 'pyarrow' are allowed.)r no_defaultr) dtype_backends rcheck_dtype_backendrs?CNN*  = = 0)*  >+r)returnNonerp) rBr rCrsrDboolrErrr )T)rNr)r[zfloat | Iterable[float]rz np.ndarray)rbr rr )rbzSequence[BoolishT]rzlist[BoolishT])rbzbool | int | Sequence[BoolishT]rzbool | int | list[BoolishT])rk str | Nonertuple[bool, bool])rurrr)rzr?r{r?rr?)"__doc__ __future__rcollections.abcrrtypingrrnumpyrW pandas._libsrpandas.core.dtypes.commonr r rr?r r rr$r)r1r5r;rGrOr^rcrnrwr|rrRrrrs#  :tS )~tS$7  (#L&:R U8670 70z * *** *  *Z$ND    T.T T%B D$r