bMh78dZddlmZddlmZmZddlmZmZddl Z ddl m Z ddl mZmZedeeZed eedZd4d Zd4d Zd4dZd4dZd4dZd4dZ d5d6dZd7d8dZd9d Zed:d"Zed;d%Zdd.Zd?d2Z d4d3Z!dS)@zV Module that contains many useful utilities for validating data or function arguments ) annotations)IterableSequence)TypeVaroverloadN)lib)is_bool is_integerBoolishT BoolishNoneTreturnNonec |dkrtdt|t|krIt||z}t||z}|dkrdnd}t|d|d|d|d d S) 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 W/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/pandas/util/_validators.py_check_arg_lengthrs QEFFF 4yy3{####K((+>> t99'::!.!!3!3:: * *} * *x * *  * * *   $#c|D]{} ||}||}||||d}n||k}t|stdn #t$r||||u}YnwxYw|std|d|d|dS)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 :c"BS!B2:2:".b5>> = !;<<< =  : : : %S)99EEE : :::05:::  /s?AA#"A#ct||||tt||}t|||dS)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+WsK@eT#6 DDD #k4(( ) )FeV[99999rct|t|z }|r1tt|}t|d|ddS)z} 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_keysr3sc v;;[)) )D UtDzz""5SSSSSTTTUUrcr|}t|||t|||dS)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)copyr3r&)rr*rkwdss rvalidate_kwargsr7s;, ;;==DE6;777eT;77777rc0t||t|z||tt ||}|D]}||vrt |d|d||t|||dS)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)rupdater7)rrr*rr args_dictr"s rvalidate_args_and_kwargsr=sP teFMMOO,,,.A; Sd++,,I &==MMsMMM    MM)E6;/////rTFvaluearg_namestr none_allowedbool int_allowedct|}|r|p|du}|r|pt|t}|s(td|dt |jd|S)aR 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__)r>r?rArC good_values rvalidate_bool_kwargrKs<J32ETM :9:eS#9#9   ,X , ,KK( , , ,    Lrvalidate_scalar_dict_valuecddlm}||td|| ||}n[|F|D|rAt|tt fr%t dt|jdn||td||fS)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_methodNz(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.missingrNrrFlistr9rrHrI)r>methodrLrNs rvalidate_fillna_kwargsrSs&655555 }CDDD }+""6**  v~ % *UT5M*J*J 9!%e!5999   v1DEEE &=rqfloat | Iterable[float] np.ndarrayctj|}d}|jdkrd|cxkrdksnt|n(t d|Dst||S)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]rrc36K|]}d|cxkodkncVdS)rrN).0qss r z&validate_percentile..Ss600B1<<<z&validate_ascending..js, S S S k < r r?r@rArBrCrBr r )T)rLrB)rTrUr rV)rdr r r )rdrjr rk)rdrmr rn)rsrtr ru)r|rtr ru)rrGrrGr rG)"__doc__ __future__rcollections.abcrrtypingrrnumpyr] pandas._libsrpandas.core.dtypes.commonr r rBrGr r rr&r+r3r7r=rKrSrcrhr{rrrrYrrrsi#"""""  7:tS ) )w~tS$77     (####L&:&:&:&:R U U U U8888670707070z *****Z$$$$$ND    TTTT%%%%B    D$r