Ë
|
oñúhÜ7 ã ó< d Z ddlmZ ddlmZmZ ddlmZmZ ddl Z
|
ddl m Z ddl mZmZ edee« Z ed eed« Zdd
|
Zdd Zdd Zdd ZddZ ddZ d d dZd d dZd dZ ed d« Z ed!d« Z d"dZ d#dZ d$dZ d%dZ ddZ!y)&zV
|
Module that contains many useful utilities
|
for validating data or function arguments
|
é )Ú annotations)ÚIterableÚSequence)ÚTypeVarÚoverloadN)Úlib)Úis_boolÚ
|
is_integerÚBoolishTÚ BoolishNoneTc
|
óÊ |dk r t d« t |« t |« kD r<t |« |z }t |« |z }|dk( rdnd}t | d| d| d| d « y
|
) 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.
|
r z*'max_fname_arg_count' must be non-negativeé ÚargumentÚ argumentsz() takes at most ú z (z given)N)Ú
|
ValueErrorÚlenÚ TypeError)ÚfnameÚargsÚmax_fname_arg_countÚ compat_argsÚ max_arg_countÚactual_arg_countr s úJH:\Change_password\venv_build\Lib\site-packages\pandas/util/_validators.pyÚ_check_arg_lengthr s ð QÒ ÜÐEÓFÐFä
|
4y3{Ó#Ò#ÜKÓ(Ð+>Ñ> Ü t9Ð':Ñ:ÐØ!.°!Ò!3:¸äØgÐ& } o°Q°x°jð AØ Ð! ð *ó
|
ð
|
ð $ó c óÐ |D ]H } || }|| }||||d}n||k( }t |« s t d« |r8t d| d| d« y# t $ r || || u }Y ,w xY w)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 ÚkeyÚv1Úv2Úmatchs r Ú_check_for_default_valuesr$ 1 s´ ð ò ð :Ø cÑ"BØ SÑ!Bð 2 :°2°:À"À.Ø àbä5>Ü Ð!;Ó<Ð<ð "ò Ü Øuð 0Ø05¨w°bð:óð ñ1øô( ò :Ø Ñ%¨°SÑ)9Ð9Eð :ús 0AÁA%Á$A%c ód t | |||« t t ||« « }t | ||« y)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)r ÚdictÚzipr$ )r r r r Úkwargss r Ú validate_argsr) W s3 ô@ eTÐ#6¸ ÔDô
|
#k 4Ó(Ó )FÜ e V¨[Õ9r c ó t |« t |« z
|
}|r%t t |« « }t | d| d« y)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)ÚsetÚnextÚiterr )r r( r ÚdiffÚbad_args r Ú_check_for_invalid_keysr1 sG ô v;[Ó)Ñ )Dá ÜtDzÓ"Ü5'Ð!HÈÈ ÐQRÐSÓTÐTð r c óX |j « }t | ||« t | ||« y)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)Úcopyr1 r$ )r r( r Úkwdss r Úvalidate_kwargsr5 s' ð, ;;=DÜE 6¨;Ô7Ü e T¨;Õ7r c óò t | |t |j « « z ||« t t ||« « }|D ] }||v st | d| d« |j |« t | ||« y)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)r ÚtupleÚvaluesr& r' r Úupdater5 )r r r( r r Ú args_dictr s r Úvalidate_args_and_kwargsr; ¨ s ôP Ø teFMMOÓ,Ñ,Ð.AÀ;ôô S dÓ+Ó,Iàò Ø &=ÜØ'ÐFÀsÀeÈ1ÐMóð ðð MM)Ô ÜE6 ;Õ/r c óª t | « }|r|xs | du }|r|xs t | t « }|s%t d| dt | « j
|
d« | 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 Ú
|
isinstanceÚintr ÚtypeÚ__name__)ÚvalueÚarg_nameÚ none_allowedÚ int_allowedÚ
|
good_values r Úvalidate_bool_kwargrG â sl ô< JÙØ Ò2 E¨T M
|
áØ Ò9¤:¨e´SÓ#9
|
á ÜØ XJð 'ÜK×(Ñ(Ð)¨ð ,ó
|
ð
|
ð Lr c óö ddl m} | | t d« | | ||« }| |fS | @|>|r8t | t t
|
f« r"t dt | « j d« | |fS | | t d« | |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_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.missingrI r r> Úlistr7 r r@ rA )rB ÚmethodÚvalidate_scalar_dict_valuerI s r Úvalidate_fillna_kwargsrO s° õ& 6à } ÜÐCÓDÐDØ }Ð+Ù" 6Ó*ð &=Ðð
|
Ð v~Ù %¬*°U¼TÄ5¸MÔ*JÜð!Ü!% e£×!5Ñ!5Ð 6°að9óð ð &=Ðð
|
Ð vÐ 1ÜÐDÓEÐEà &=Ðr c óÔ t j | « }d}|j dk( r$d|cxk rdk st |« t |« |S t d |D « « s t |« |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]r r c 3 ó< K | ] }d |cxk xr dk nc yw)r r N© )Ú.0Úqss r ú <genexpr>z&validate_percentile.<locals>.<genexpr>S s è ø Ò0 B1<a<<Ñ0ùs )ÚnpÚasarrayÚndimr Úall)ÚqÚq_arrÚmsgs r Úvalidate_percentiler] 6 sm ô* JJqMEð =CØ zzQØEQÜ S/Ð !ð Ü S/Ð !ð Lô Ñ0¨%Ô0Ô0Ü S/Ð !Ø Lr c ó y ©NrR ©Ú ascendings r Úvalidate_ascendingrb X ó àr c ó y r_ rR r` s r rb rb ] rc r c ó ddd}t | t « s t | dfi |¤S | D cg c] }t |dfi |¤ c}S c c}w )z8Validate ``ascending`` kwargs for ``sort_index`` method.FT)rD rE ra )r> r rG )ra r( Úitems r rb rb b sK ð $°DÑ 9FÜ i¤Ô *Ü" 9¨kÑD¸VÑDÐDàIRÖ SÀÔ kÑ <°VÓ <Ò SÐSùÒ Ss §>c ó` d}d}| d}d}||fS | dk( rd}||fS | dk( rd}||fS t d« )a%
|
Check that the `closed` argument is among [None, "left", "right"]
|
|
Parameters
|
----------
|
closed : {None, "left", "right"}
|
|
Returns
|
-------
|
left_closed : bool
|
right_closed : bool
|
|
Raises
|
------
|
ValueError : if argument is not among valid values
|
FTÚleftÚrightz/Closed has to be either 'left', 'right' or None)r )ÚclosedÚ left_closedÚ right_closeds r Úvalidate_endpointsrm m sp ð" KØLà ~Ø Ø ð Ð $Ð$ð
|
6Ò Ø ð Ð $Ð$ð
|
7Ò Ø ð Ð $Ð$ô ÐJÓKÐKr c óp d}t | t « rdddddj | « }| t d« |S )aD
|
Check that the `inclusive` argument is among {"both", "neither", "left", "right"}.
|
|
Parameters
|
----------
|
inclusive : {"both", "neither", "left", "right"}
|
|
Returns
|
-------
|
left_right_inclusive : tuple[bool, bool]
|
|
Raises
|
------
|
ValueError : if argument is not among valid values
|
N)TT©TF)FT)FF)Úbothrh ri Úneitherz?Inclusive has to be either 'both', 'neither', 'left' or 'right')r> ÚstrÚgetr )Ú inclusiveÚleft_right_inclusives r Úvalidate_inclusiverv sU ð 6:Ðä)SÔ!à Ø!Ø"Ø%ñ
|
÷
|
#i.ð ð Ð#ÜØ Mó
|
ð
|
ð Ð r c ó t | « st d| d| « | dk r| |z } d| cxk r|k sn t d| d| « | S )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)ÚlocÚlengths r Úvalidate_insert_locr{ ° s_ ô c?ÜÐ:¸6¸(À%ÈÀxÐPÓQÐQà
|
QwØ v Ø Ô vÔ ÜÐ;¸F¸8À5ÈÈÐQÓRÐRØ Jr c óP | t j ur| dvrt d| d« y y )N)Únumpy_nullableÚpyarrowzdtype_backend z= is invalid, only 'numpy_nullable' and 'pyarrow' are allowed.)r Ú
|
no_defaultr )Ú dtype_backends r Úcheck_dtype_backendr  s? ØCNNÑ*Ø Ð =Ñ =Ü Ø ð 0)ð *óð ð >ð +r )ÚreturnÚNonero )
|
rB r rC rr rD ÚboolrE r r r )T)rN r )rZ zfloat | Iterable[float]r z
|
np.ndarray)ra r r r )ra zSequence[BoolishT]r zlist[BoolishT])ra z bool | int | Sequence[BoolishT]r zbool | int | list[BoolishT])rj ú
|
str | Noner útuple[bool, bool])rt r
r r )ry r? rz r? r r? )"Ú__doc__Ú
|
__future__r Úcollections.abcr r Útypingr r ÚnumpyrV Ú pandas._libsr Úpandas.core.dtypes.commonr r
|
r r? r r r r$ r) r1 r5 r; rG rO r] rb rm rv r{ r rR r r ú<module>r s ðñõ #÷÷ó
|
å ÷ñ
|
:t SÓ )Ù~ t¨S°$Ó7 ó
|
ó(#óL&:óR
|
Uó8ð670à ó70ðz Ø ð *Ø ð*àð*ð ð*ð ð *ð
|
ó *ôZ$óN ðD
|
òó
|
ðð
|
òó
|
ððTØ.ðTà óTó %óB óDô$r
|
