i-UdZddlmZddlmZmZmZmZmZddl Z ddl m Z ddl m Z mZddlmZddlmZmZmZerdd lmZmZed edZGd d Zd diZeedddZeedddZdTdZdUdZdUdZiZ de!d<de d<de d<de d<de d<de d<ee dddZ"iZ#d e!d!<de#d<de#d<de#d<ee#dddZ$dVd"Z%d diZ&d#e!d$<ee&d%dd&Z'edWd'Z(edXd(Z( dYd)Z(iZ)d#e!d*<de)d+<de)d <ee)dd,Z*ee)d-ddZ+dZd.Z,iZ-d/e!d0<de-d+<de-d <d1e-d2<de-d<ee-d3ddZ.ee-d4ddZ/dd1d5Z0ee0d67Z1dddd1d8Z2ee2d9ddZ3ee2d:ddZ4ddiZ5d#e!d;<ee5dddZ8iZ9d?e!d@<de9d+<de9d <e9juZ;de;d<d1e;d2<de;dA<e;juZd1e>dB<d1e>d2<d1e9d2<ee9d67Z?ee;dCddZ@eedFddZCiZDd/e!dG<deDd+<deDd <d1eDd2<eeDd67ZEiZFdHe!dI<deFd <dJeFdK<eeFdLd6MZGdNdiZHeeHdOddZId[d\dPZJd]d^dQZKeCeBe3e4e@eAdRZLd_dSZMy)`a For compatibility with numpy libraries, pandas functions or methods have to accept '*args' and '**kwargs' parameters to accommodate numpy arguments that are not actually used or respected in the pandas implementation. To ensure that users do not abuse these parameters, validation is performed in 'validators.py' to make sure that any extra parameters passed correspond ONLY to those in the numpy signature. Part of that validation includes whether or not the user attempted to pass in non-default values for these extraneous parameters. As we want to discourage users from relying on these parameters when calling the pandas implementation, we want them only to pass in the default values for these parameters. This module provides a set of commonly used default arguments for functions and methods that are spread throughout the codebase. This module will make it easier to adjust to future upstream changes in the analogous numpy signatures. ) annotations) TYPE_CHECKINGAnyTypeVarcastoverloadN)ndarray)is_bool is_integer)UnsupportedFunctionCall) validate_argsvalidate_args_and_kwargsvalidate_kwargs)AxisAxisInt AxisNoneTc8eZdZ d ddZ d ddZy)CompatValidatorNc<||_||_||_||_yN)fnamemethoddefaultsmax_fname_arg_count)selfrrrrs q/Volumes/fast/ai/experiments/voice-extract-mac/.venv/lib/python3.12/site-packages/pandas/compat/numpy/function.py__init__zCompatValidator.__init__5s!    #6 c>|s|sy| |jn|}| |jn|}| |jn|}|dk(rt||||jy|dk(rt |||jy|dk(rt |||||jytd|d)Nargskwargsbothzinvalid validation method '')rrrr rrr ValueError)rr r!rrrs r__call__zCompatValidator.__call__AsF#m #*  $ $$  !'F V  %':DMM J x  E64== 9 v  $tV%8$-- :6(!DE Er)NNN)rz str | NonereturnNone)__name__ __module__ __qualname__rr%rrrr4sM! 7 7  7  ! F  F Frroutargminr")rrrargmaxc>t|ts||g|}d}||fS)NT) isinstancer )skipnar s rprocess_skipnar3is*&'"fn 4<rc<t||\}}t|||S)a If 'Series.argmin' is called via the 'numpy' library, the third parameter in its signature is 'out', which takes either an ndarray or 'None', so check if the 'skipna' parameter is either an instance of ndarray or is None, since 'skipna' itself should be a boolean )r3validate_argminr2r r!s rvalidate_argmin_with_skipnar7q#"&$/LFDD&! Mrc<t||\}}t|||S)a If 'Series.argmax' is called via the 'numpy' library, the third parameter in its signature is 'out', which takes either an ndarray or 'None', so check if the 'skipna' parameter is either an instance of ndarray or is None, since 'skipna' itself should be a boolean )r3validate_argmaxr6s rvalidate_argmax_with_skipnar;}r8rzdict[str, int | str | None]ARGSORT_DEFAULTSaxis quicksortkindorderstableargsort)rrrzdict[str, int | None]ARGSORT_DEFAULTS_KINDclt|s||g|}d}t||dtt|}|S)a! If 'Categorical.argsort' is called via the 'numpy' library, the first parameter in its signature is 'axis', which takes either an integer or 'None', so check if the 'ascending' parameter has either integer type or is None, since 'ascending' itself should be a boolean T)r)r validate_argsort_kindrbool) ascendingr r!s rvalidate_argsort_with_ascendingrJsA) 1!D! $A>T9%I rzdict[str, Any] CLIP_DEFAULTScliprFcyrr+r>r r!s rvalidate_clip_with_axisrOsBErcyrr+rNs rrOrOsILrcNt|tr|g|}d}t|||S)a If 'NDFrame.clip' is called via the numpy library, the third parameter in its signature is 'out', which can takes an ndarray, so check if the 'axis' parameter is an instance of ndarray, since 'axis' itself should either be an integer or None N)r1r validate_cliprNs rrOrOs1$ }t}$ KrCUM_FUNC_DEFAULTSdtype)rrcumsumct|s |g|}d}n%t|tjr t |}t ||||S)z If this function is called via the 'numpy' library, the third parameter in its signature is 'dtype', which takes either a 'numpy' dtype or 'None', so check if the 'skipna' parameter is a boolean or not Tr)r r1npbool_rHvalidate_cum_func)r2r r!names rvalidate_cum_func_with_skipnar\sC 6? FBHH %fdF$/ Mrzdict[str, bool | None]ALLANY_DEFAULTSFkeepdimsallany)r,r^r!)r)r>rTr,r^minmaxREPEAT_DEFAULTSrepeatROUND_DEFAULTSroundzdict[str, Any | None]STAT_FUNC_DEFAULTSinitialoverwrite_inputsumprodmeanmedianSTAT_DDOF_FUNC_DEFAULTSzdict[str, str | None] TAKE_DEFAULTSraisemodetake)rraxes transposec|g}t|t|z }t|t|zdkDrtd|dy)z 'args' and 'kwargs' should be empty, except for allowed kwargs because all of their necessary parameters are explicitly listed in the function signature Nrz?numpy operations are not valid with groupby. Use .groupby(...).z () instead)setlenr )r[r r!alloweds rvalidate_groupby_funcryCsX  [3w< 'F 4y3v;"% !!%j 2  #rcN|y||k\s |dkr||zdkrtd|dyy)a Ensure that the axis argument passed to min, max, argmin, or argmax is zero or None, as otherwise it will be incorrectly ignored. Parameters ---------- axis : int or None ndim : int, default 1 Raises ------ ValueError Nrz4`axis` must be fewer than the number of dimensions ())r$)r>ndims rvalidate_minmax_axisr}UsA | t|qTD[1_OPTvUVWXX&5r)rmrlrarbrjrkcR|tvrt|||St|}|||S)NrW)_validation_funcsvalidate_stat_func)rr r!validation_funcs r validate_funcrss1 %%!$e<<'.O 4 ((r)r2bool | ndarray | Noner&ztuple[bool, Any])r2rr&rH)rIzbool | int | Noner&rH)r>r r&r')r>rr&r)r>zndarray | AxisNoneTr&zAxisNoneT | None)r2rHr&rHr)r[strr&r')r.)r>zAxisInt | Noner|intr&r')r&r')N__doc__ __future__rtypingrrrrrnumpyrXr pandas._libs.libr r pandas.errorsr pandas.util._validatorsr rrpandas._typingrrrrARGMINMAX_DEFAULTSr5r:r3r7r;r<__annotations__validate_argsortrDrGrJrKrRrOrSrZvalidate_cumsumr\r] validate_all validate_anyLOGICAL_FUNC_DEFAULTSvalidate_logical_funcMINMAX_DEFAULTS validate_min validate_maxrcvalidate_repeatrevalidate_roundrgcopy SUM_DEFAULTS PROD_DEFAULTS MEAN_DEFAULTSMEDIAN_DEFAULTSr validate_sum validate_prod validate_meanvalidate_medianrnvalidate_stat_ddof_funcro validate_takeTRANSPOSE_DEFAULTSvalidate_transposeryr}rrr+rrrs$#2   T40I)F)FXT]!hv1"hv1   13-2& !#I1V 02,1 "f!%g"&h'&  "' ~-A  E E L L *%'>&!'%#f!"Xf!  +-',# 5Q 5Q !%%8'(=hO$tO5Q 5Q $*4.0!8F#(. '&a-/)."7 5!&&(  V Z Y!!# !!# $))+%*!"# !&:$%7If!  A  A "8F35/4#' !%&+ #)*A(S') $) e f VHM d^$k&a  $Y*      )r