o
    Û­jp ã                   @  sÐ  d dl mZ d dlZd dlmZ d dlZd dlmZ d dlZd dlm	Z	m
Z
mZmZmZ d dlZd dlZd dlmZ d dlmZ d dlmZ d d	lmZmZmZmZmZmZmZmZ d d
l m!Z! d dl"m#Z# d dl$m%Z% d dl&m'Z' d dl(m)Z) d dl*m+Z+m,Z,m-Z-m.Z.m/Z/ d dl0m1Z1m2Z2 d dl3m4Z4m5Z5m6Z6 d dl7m8Z8 d dl9m:  m;Z< d dl=m>Z> e	rÙd dl?m@Z@mAZAmBZBmCZCmDZD d dlEmFZFmGZGmHZH d dlImJZJ d dlKmLZL d dlMmNZN eOePe
f ZQ	 							drdsd.d/„ZRG d0d1„ d1ejSd2�ZTG d3d4„ d4eTƒZUG d5d-„ d-eUƒZVG d6d7„ d7eVƒZWG d8d9„ d9eVƒZXG d:d;„ d;eUƒZYG d<d=„ d=eTƒZZG d>d?„ d?eZƒZ[dtdBdC„Z\dudDdE„Z]dvdIdJ„Z^dwdMdN„Z_dxdWdX„Z`dydYdZ„Zadzd]d^„Zbd{dadb„Zcd|ddde„Zdd}djdk„Zed~dpdq„ZfdS )é    )ÚannotationsN)Údefaultdict)Úpartial)ÚTYPE_CHECKINGÚAnyÚCallableÚLiteralÚcast)Úoption_context)Úlib)ÚBlockValuesRefs)ÚAggFuncTypeÚAggFuncTypeBaseÚAggFuncTypeDictÚ
AggObjTypeÚAxisÚAxisIntÚNDFrameTÚnpt)Úimport_optional_dependency)ÚSpecificationError)Úcache_readonly)Úfind_stack_level)Úis_nested_object)Úis_dict_likeÚis_extension_array_dtypeÚis_list_likeÚis_numeric_dtypeÚis_sequence)ÚCategoricalDtypeÚExtensionDtype)ÚABCDataFrameÚ
ABCNDFrameÚ	ABCSeries)Úgenerate_apply_looper)Úensure_wrapped_if_datetimelike)Ú	GeneratorÚHashableÚIterableÚMutableMappingÚSequence)Ú	DataFrameÚIndexÚSeries)ÚGroupBy)Ú	Resampler)Ú
BaseWindowFÚcompatÚpythonÚobjr+   Úfuncr   Úaxisr   ÚrawÚboolÚresult_typeú
str | NoneÚby_rowúLiteral[False, 'compat']ÚengineÚstrÚengine_kwargsúdict[str, bool] | NoneÚreturnÚ
FrameApplyc
                 C  sb   |   |¡}|dkrt}
n|dkrt}
t|fi |	¤Ž\}}}}|dus$J ‚|
| ||||||||	d�	S )z=construct and return a row or column based frame apply objectr   é   N)r6   r8   r:   r<   r>   ÚargsÚkwargs)Ú_get_axis_numberÚFrameRowApplyÚFrameColumnApplyÚreconstruct_func)r3   r4   r5   r6   r8   r:   r<   r>   rC   rD   ÚklassÚ_© rK   úN/var/www/html/CropPilot/venv/lib/python3.10/site-packages/pandas/core/apply.pyÚframe_applyR   s$   
÷rM   c                   @  sæ   e Zd ZU ded< ddddœdRdd„ZejdSdd„ƒZejdTdd„ƒZejdTd d!„ƒZ	dUd#d$„Z
dSd%d&„ZdVd(d)„ZdSd*d+„ZdSd,d-„ZdWd3d4„ZdXd9d:„ZdSd;d<„ZdYd@dA„ZdZdFdG„ZdSdHdI„ZdSdJdK„Zd[dNdO„Zd\dPdQ„ZdS )]ÚApplyr   r5   r1   r2   N©r:   r<   r>   r3   r   r4   r   r6   r7   r8   r9   r:   ú#Literal[False, 'compat', '_compat']r<   r=   r>   r?   r@   ÚNonec          
      C  sr   || _ || _|du s|dv sJ ‚|| _|pd| _|	pi | _|| _|d u r&i n|| _|dvr1tdƒ‚|| _|| _	d S )NF)r1   Ú_compatrK   )NÚreduceÚ	broadcastÚexpandzUinvalid value for result_type, must be one of {None, 'reduce', 'broadcast', 'expand'})
r3   r6   r:   rC   rD   r<   r>   Ú
ValueErrorr8   r4   ©
Úselfr3   r4   r6   r8   r:   r<   r>   rC   rD   rK   rK   rL   Ú__init__y   s   

ÿ
zApply.__init__úDataFrame | Seriesc                 C  ó   d S ©NrK   ©rX   rK   rK   rL   Úapplyœ   ó   zApply.applyÚop_nameúLiteral['agg', 'apply']c                 C  r[   r\   rK   ©rX   r`   rK   rK   rL   Úagg_or_apply_list_like    ó   zApply.agg_or_apply_list_likec                 C  r[   r\   rK   rb   rK   rK   rL   Úagg_or_apply_dict_like¦   rd   zApply.agg_or_apply_dict_likeúDataFrame | Series | Nonec                 C  s„   | j }| j}| j}| j}t|tƒr|  ¡ S t|ƒr|  ¡ S t	|ƒr%|  
¡ S t|ƒr@t |¡}|r@|s@|s@t|||ƒ t||ƒƒ S dS )z»
        Provide an implementation for the aggregators.

        Returns
        -------
        Result of aggregation, or None if agg cannot be performed by
        this method.
        N)r3   r4   rC   rD   Ú
isinstancer=   Ú	apply_strr   Úagg_dict_liker   Úagg_list_likeÚcallableÚcomÚget_cython_funcÚwarn_alias_replacementÚgetattr)rX   r3   r4   rC   rD   ÚfrK   rK   rL   Úagg¬   s    	

z	Apply.aggc              
     sP  | j }| j‰ | j}| j}| j}|jdk}| |¡dkr.|rJ ‚|jjˆ dg|¢R i |¤ŽjS t	ˆ ƒrPt
ˆ ƒsPttt ˆ ƒ‰ |rGdd„ ˆ D ƒ‰ n	‡ fdd„|D ƒ‰ t
ˆ ƒr^ttˆ ƒ‰ |  ˆ ¡S ttˆ ƒ‰ z|  ˆ ¡}W n tyr   ‚  ty‚ } ztdƒ|‚d}~ww t|ttfƒr”|jr”|js”tdƒ‚t|ttfƒr¢|j |j¡s¦tdƒ‚|S )	aI  
        Transform a DataFrame or Series.

        Returns
        -------
        DataFrame or Series
            Result of applying ``func`` along the given axis of the
            Series or DataFrame.

        Raises
        ------
        ValueError
            If the transform function fails or does not transform.
        rB   r   c                 S  s   i | ]
}t  |¡p
||“qS rK   ©rl   Úget_callable_name©Ú.0ÚvrK   rK   rL   Ú
<dictcomp>ë   s    z#Apply.transform.<locals>.<dictcomp>c                   s   i | ]}|ˆ “qS rK   rK   )ru   Úcol©r4   rK   rL   rw   í   s    zTransform function failedNzFunction did not transform)r3   r4   r5   rC   rD   ÚndimrE   ÚTÚ	transformr   r   r	   Úlistr   r   Útransform_dict_likeÚtransform_str_or_callableÚ	TypeErrorÚ	ExceptionrV   rg   r#   r!   ÚemptyÚindexÚequals)rX   r3   r5   rC   rD   Ú	is_seriesÚresultÚerrrK   ry   rL   r|   Ì   sL   




€ÿÿþýÿzApply.transformr+   c           
      C  sœ   ddl m} | j}| j}| j}t|tƒsJ ‚t|ƒdkr tdƒ‚|  	d||¡}i }| 
¡ D ]\}}|j|dd�}	|	j|dg|¢R i |¤Ž||< q-||dd�S )zC
        Compute transform in the case of a dict-like func
        r   ©Úconcatz$No transform functions were providedr|   rB   ©rz   ©r5   )Úpandas.core.reshape.concatr‰   r3   rC   rD   rg   r"   ÚlenrV   Únormalize_dictlike_argÚitemsÚ_gotitemr|   )
rX   r4   r‰   r3   rC   rD   ÚresultsÚnameÚhowÚcolgrK   rK   rL   r~     s    zApply.transform_dict_likec                 C  s¦   | j }| j}| j}t|tƒr| j||g|¢R i |¤ŽS |s2|s2t |¡}|r2t|||ƒ t	||ƒƒ S z|j
|fd|i|¤ŽW S  tyR   ||g|¢R i |¤Ž Y S w )zL
        Compute transform in the case of a string or callable func
        rC   )r3   rC   rD   rg   r=   Ú
_apply_strrl   rm   rn   ro   r^   r�   )rX   r4   r3   rC   rD   rp   rK   rK   rL   r   '  s   

ÿzApply.transform_str_or_callablec                 C  ó   | j dd�S )zŠ
        Compute aggregation in the case of a list-like argument.

        Returns
        -------
        Result of aggregation.
        rq   ©r`   )rc   r]   rK   rK   rL   rj   >  ó   zApply.agg_list_likeÚselected_objúSeries | DataFramerD   údict[str, Any]ú(tuple[list[Hashable] | Index, list[Any]]c                 C  s>  t tt | jƒ}| j}g }g }|jdkrT|D ]9}|j|jd|d�}	t||	ƒr-| j	g| j
¢n| j
}
t|	|ƒ|g|
¢R i |¤Ž}| |¡ t |¡pI|}| |¡ q||fS g }t|ƒD ]:\}}|j|d|jdd…|f d�}	t||	ƒry| j	g| j
¢n| j
}
t|	|ƒ|g|
¢R i |¤Ž}| |¡ | |¡ qZ|j |¡}||fS )aF  
        Compute agg/apply results for like-like input.

        Parameters
        ----------
        op_name : {"agg", "apply"}
            Operation being performed.
        selected_obj : Series or DataFrame
            Data to perform operation on.
        kwargs : dict
            Keyword arguments to pass to the functions.

        Returns
        -------
        keys : list[Hashable] or Index
            Index labels for result.
        results : list
            Data for result. When aggregating with a Series, this can contain any
            Python objects.
        rB   )rz   ÚsubsetN)r	   r}   r   r4   r3   rz   r�   r’   Úinclude_axisr5   rC   ro   Úappendrl   rs   Ú	enumerateÚilocÚcolumnsÚtake)rX   r`   r™   rD   r4   r3   r‘   ÚkeysÚar”   rC   Únew_resr’   Úindicesrƒ   rx   rK   rK   rL   Úcompute_list_likeH  s8   
ÿý
ñÿý
zApply.compute_list_liker¤   úIterable[Hashable]r‘   úlist[Series | DataFrame]c              
   C  s|   ddl m} | j}z	|||ddd�W S  ty= } zddlm} ||||jd�}t|ƒr1tdƒ|‚|W  Y d }~S d }~ww )	Nr   rˆ   rB   F)r¤   r5   Úsort©r-   ©rƒ   r’   z3cannot combine transform and aggregation operations)	rŒ   r‰   r3   r€   Úpandasr-   r’   r   rV   )rX   r¤   r‘   r‰   r3   r‡   r-   r†   rK   rK   rL   Úwrap_results_list_likeŠ  s    ÿþ€özApply.wrap_results_list_likec                 C  r–   )zŠ
        Compute aggregation in the case of a dict-like argument.

        Returns
        -------
        Result of aggregation.
        rq   r—   )re   r]   rK   rK   rL   ri   Ÿ  r˜   zApply.agg_dict_likeÚ	selectionúHashable | Sequence[Hashable]ú tuple[list[Hashable], list[Any]]c                   st  ddl m}m} | j‰tˆ||fƒ}tt| jƒ}|  ˆˆ|¡}ˆj	dko-ˆj
 ¡ tˆj
ƒk }	ˆj	dkrQˆj|dd�‰ ‡ ‡‡fdd„| ¡ D ƒ}
t| ¡ ƒ}||
fS |s£|	r£g }
g }| ¡ D ]A\}‰ˆj
 |g¡}ˆj
 |¡}ttƒ}t||ƒD ]\}}||  |¡ qw‡‡‡‡fdd„| ¡ D ƒ}||gt|ƒ 7 }|
|7 }
q]||
fS ‡‡‡fd	d„| ¡ D ƒ}
t| ¡ ƒ}||
fS )
aË  
        Compute agg/apply results for dict-like input.

        Parameters
        ----------
        op_name : {"agg", "apply"}
            Operation being performed.
        selected_obj : Series or DataFrame
            Data to perform operation on.
        selection : hashable or sequence of hashables
            Used by GroupBy, Window, and Resample if selection is applied to the object.
        kwargs : dict
            Keyword arguments to pass to the functions.

        Returns
        -------
        keys : list[hashable]
            Index labels for result.
        results : list
            Data for result. When aggregating with a Series, this can contain any
            Python object.
        r   ©ÚDataFrameGroupByÚSeriesGroupByé   rB   rŠ   c                   s&   g | ]\}}t ˆ ˆƒ|fi ˆ¤Ž‘qS rK   )ro   )ru   rJ   r“   )r”   rD   r`   rK   rL   Ú
<listcomp>Ø  s   & z+Apply.compute_dict_like.<locals>.<listcomp>c                   s:   g | ]\}}|D ]}t ˆj|d d�ˆƒˆ fi ˆ¤Ž‘qqS )rB   r‹   )ro   Ú_ixs)ru   Úlabelr§   Úindice)r“   rD   r`   r™   rK   rL   r·   æ  s    ýþÿc                   s0   g | ]\}}t ˆj|d d�ˆƒ|fi ˆ ¤Ž‘qS )rB   rŠ   )ro   r�   )ru   Úkeyr“   )rD   r3   r`   rK   rL   r·   ð  s    ÿÿ)Úpandas.core.groupby.genericr´   rµ   r3   rg   r	   r   r4   rŽ   rz   r¢   Únuniquer�   r�   r�   r}   r¤   Úget_indexer_forr£   r   ÚziprŸ   )rX   r`   r™   r°   rD   r´   rµ   Ú
is_groupbyr4   Úis_non_unique_colr‘   r¤   r»   r§   ÚlabelsÚlabel_to_indicesrƒ   r¹   Úkey_datarK   )r”   r“   rD   r3   r`   r™   rL   Úcompute_dict_like©  sB   
þ
äþ
	úþzApply.compute_dict_likeÚresult_indexúlist[Hashable]Úresult_datar}   c                   s  ddl m} ddlm} | j}dd„ |D ƒ}t|ƒr]tt||ƒƒ‰ ‡ fdd„|D ƒ}|g kr0|n|}|jdkrD||ƒ}	|	 	|j
j¡ |	}t|tƒrKdnd}
|‡ fd	d
„|D ƒ|
|d�}|S t|ƒretdƒ‚ddl m} |jdkrytd|ƒ}|j}nd }||||d�}|S )Nr   ©r,   rˆ   c                 S  s   g | ]}t |tƒ‘qS rK   )rg   r"   )ru   ÚrrK   rK   rL   r·     ó    z0Apply.wrap_results_dict_like.<locals>.<listcomp>c                   s   g | ]	}ˆ | j s|‘qS rK   )r‚   ©ru   Úk©r‘   rK   rL   r·   	  s    r¶   rB   c                   s   i | ]}|ˆ | “qS rK   rK   rÌ   rÎ   rK   rL   rw     rË   z0Apply.wrap_results_dict_like.<locals>.<dictcomp>)r5   r¤   zLcannot perform both aggregation and transformation operations simultaneouslyr¬   r-   r­   )r®   r,   rŒ   r‰   r3   ÚallÚdictr¿   rz   Ú
_set_namesr¢   Únamesrg   r#   ÚanyrV   r-   r	   r’   )rX   r™   rÆ   rÈ   r,   r‰   r3   Ú
is_ndframeÚkeys_to_useÚktur5   r†   r-   r’   rK   rÎ   rL   Úwrap_results_dict_likeø  s<   
ýìÿ

zApply.wrap_results_dict_likec           	      C  sè   t t| jƒ}| j}ddlm}m} t||dƒ}t|ƒret	 
|¡}g |j¢|j¢R }| jdkr>d|vs6|dv r>td|› d�ƒ‚d|v ret|||fƒr_d}|dv rS| jj}|| jkr^| j| jd< n| j| jd< | j||g| j¢R i | j¤ŽS )	zy
        Compute apply in case of a string.

        Returns
        -------
        result: Series or DataFrame
        r   r³   Nr5   )ÚcorrwithÚskewz
Operation z does not support axis=1)ÚidxmaxÚidxmin)r	   r=   r4   r3   r¼   r´   rµ   ro   rk   ÚinspectÚgetfullargspecrC   Ú
kwonlyargsr5   rV   rg   rD   r•   )	rX   r4   r3   r´   rµ   ÚmethodÚsigÚ	arg_namesÚdefault_axisrK   rK   rL   rh   .  s(   	


€zApply.apply_strc                 C  s�   | j dkr	tdƒ‚| jdkr&t| jtƒr&| jjj| jdfd| j	i| j
¤ŽjS | j}| j
}t|ƒr7| jdd�}n| jdd�}t||fi |¤Ž}|S )zß
        Compute apply in case of a list-like or dict-like.

        Returns
        -------
        result: Series, DataFrame, or None
            Result when self.func is a list-like or dict-like, None otherwise.
        ÚnumbazIThe 'numba' engine doesn't support list-like/dict likes of callables yet.rB   r   rC   r^   r—   )r<   ÚNotImplementedErrorr5   rg   r3   r!   r{   r^   r4   rC   rD   r   re   rc   Úreconstruct_and_relabel_result)rX   r4   rD   r†   rK   rK   rL   Úapply_list_or_dict_like]  s   

ÿ$zApply.apply_list_or_dict_liker“   r   c           	        s  |dv sJ ‚|dkrt |tƒrtdd„ | ¡ D ƒƒs%tdd„ | ¡ D ƒƒr)tdƒ‚|jdkrRdd	lm} |t| 	¡ ƒƒj
|jd
d�}t|ƒdkrRtdt|ƒ› d�ƒ‚tttf‰ t‡ fdd„| ¡ D ƒƒr€i }| ¡ D ]\}}t |ˆ ƒsy|g||< qj|||< qj|}|S )a  
        Handler for dict-like argument.

        Ensures that necessary columns exist if obj is a DataFrame, and
        that a nested renamer is not passed. Also normalizes to all lists
        when values consists of a mix of list and non-lists.
        )r^   rq   r|   rq   c                 s  ó   � | ]	\}}t |ƒV  qd S r\   )r   ©ru   rJ   rv   rK   rK   rL   Ú	<genexpr>Œ  ó   € z/Apply.normalize_dictlike_arg.<locals>.<genexpr>c                 s  rç   r\   )r   rè   rK   rK   rL   ré   �  rê   znested renamer is not supportedrB   r   rÉ   T)r«   z
Column(s) z do not existc                 3  s   � | ]
\}}t |ˆ ƒV  qd S r\   )rg   )ru   rJ   Úx©Úaggregator_typesrK   rL   ré   Ÿ  s   € )rg   r#   rÓ   r�   r   rz   r®   r,   r}   r¤   Ú
differencer¢   r�   ÚKeyErrorÚtuplerÐ   )	rX   r“   r3   r4   r,   ÚcolsÚnew_funcrÍ   rv   rK   rì   rL   rŽ   |  s.   
ÿþý



zApply.normalize_dictlike_argc                 O  sº   t |tƒsJ ‚t||ƒr3t||ƒ}t|ƒr||i |¤ŽS t|ƒdks$J ‚tdd„ |D ƒƒdks1J ‚|S tt|ƒrMt|dƒrMtt|ƒ}||g|¢R i |¤ŽS d|› dt|ƒj› d�}t	|ƒ‚)z®
        if arg is a string, then try to operate on it:
        - try to find a function (or attribute) on obj
        - try to find a numpy function
        - raise
        r   c                 S  s   g | ]}|d vr|‘qS )r‹   rK   )ru   ÚkwargrK   rK   rL   r·   º  s    z$Apply._apply_str.<locals>.<listcomp>Ú	__array__ú'z' is not a valid function for 'z' object)
rg   r=   Úhasattrro   rk   r�   ÚnpÚtypeÚ__name__ÚAttributeError)rX   r3   r4   rC   rD   rp   ÚmsgrK   rK   rL   r•   ©  s   


zApply._apply_str)r3   r   r4   r   r6   r7   r8   r9   r:   rP   r<   r=   r>   r?   r@   rQ   ©r@   rZ   ©r`   ra   r@   rZ   )r@   rf   )r@   r+   )r`   ra   r™   rš   rD   r›   r@   rœ   )r¤   r©   r‘   rª   )
r`   ra   r™   rš   r°   r±   rD   r›   r@   r²   )r™   rš   rÆ   rÇ   rÈ   r}   )r“   r=   r3   rZ   r4   r   r@   r   )r4   r=   )rù   Ú
__module__Ú__qualname__Ú__annotations__rY   ÚabcÚabstractmethodr^   rc   re   rq   r|   r~   r   rj   r¨   r¯   ri   rÅ   r×   rh   ræ   rŽ   r•   rK   rK   rK   rL   rN   v   s4   
 	÷#

 
C




B



O
6
/
-rN   )Ú	metaclassc                   @  sJ   e Zd ZU dZded< eddd„ƒZeddd	„ƒZddd„Zddd„Z	dS )ÚNDFrameApplyzg
    Methods shared by FrameApply and SeriesApply but
    not GroupByApply or ResamplerWindowApply
    rZ   r3   r@   r,   c                 C  ó   | j jS r\   )r3   rƒ   r]   rK   rK   rL   rƒ   Í  ó   zNDFrameApply.indexc                 C  s   | j  | j¡S r\   )r3   Ú_get_agg_axisr5   r]   rK   rK   rL   Úagg_axisÑ  s   zNDFrameApply.agg_axisr`   ra   c                 C  sŽ   | j }| j}|dkr*t| tƒr| j}nt| tƒr | jrdnd}nd}i |¥d|i¥}t|ddƒdkr6tdƒ‚|  |||¡\}}|  	||¡}|S )	Nr^   rR   Fr:   r5   r   rB   ú"axis other than 0 is not supported)
r3   rD   rg   rA   r:   ÚSeriesApplyro   rä   r¨   r¯   )rX   r`   r3   rD   r:   r¤   r‘   r†   rK   rK   rL   rc   Õ  s   

z#NDFrameApply.agg_or_apply_list_likec           	      C  s|   |dv sJ ‚| j }i }|dkr| jrdnd}| d|i¡ t|ddƒdkr)td	ƒ‚d }|  ||||¡\}}|  |||¡}|S )
N©rq   r^   r^   rR   Fr:   r5   r   rB   r	  )r3   r:   Úupdatero   rä   rÅ   r×   )	rX   r`   r3   rD   r:   r°   rÆ   rÈ   r†   rK   rK   rL   re   ì  s   ÿz#NDFrameApply.agg_or_apply_dict_likeN©r@   r,   rý   )
rù   rþ   rÿ   Ú__doc__r   Úpropertyrƒ   r  rc   re   rK   rK   rK   rL   r  Å  s   
 
r  c                      s>  e Zd ZU ded< ddddœdJ‡ fdd„ZeejdKdd„ƒƒZeejdKdd„ƒƒZ	eejdLdd„ƒƒZ
eejej	dMdNd"d#„ƒƒƒZejd$d%„ ƒZd&d'„ ZejdOd,d-„ƒZedKd.d/„ƒZedKd0d1„ƒZed2d3„ ƒZdPd4d5„Z‡ fd6d7„Zd8d9„ ZdQd:d;„ZdRd=d>„Zd?d@„ ZdSdBdC„ZdDdE„ ZdOdFdG„ZdP‡ fdHdI„Z‡  Z S )TrA   r+   r3   Fr2   NrO   r   r4   r   r6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rQ   c          
        sB   |dur|dkrt d|› d�ƒ‚tƒ j|||||||||	d�	 d S )NFr1   zby_row=z not allowed)r:   r<   r>   rC   rD   )rV   ÚsuperrY   rW   ©Ú	__class__rK   rL   rY     s   
÷zFrameApply.__init__r,   c                 C  r[   r\   rK   r]   rK   rK   rL   rÆ   #  ó   zFrameApply.result_indexc                 C  r[   r\   rK   r]   rK   rK   rL   Úresult_columns(  r  zFrameApply.result_columnsúGenerator[Series, None, None]c                 C  r[   r\   rK   r]   rK   rK   rL   Úseries_generator-  r  zFrameApply.series_generatorTú5Callable[[npt.NDArray, Index, Index], dict[int, Any]]c                 C  r[   r\   rK   )r4   ÚnogilÚnopythonÚparallelrK   rK   rL   Úgenerate_numba_apply_func2  s   z$FrameApply.generate_numba_apply_funcc                 C  r[   r\   rK   r]   rK   rK   rL   Úapply_with_numba:  r_   zFrameApply.apply_with_numbac                 C  sP   | j j ¡ D ]\}}t|ƒstd|› d|› d�ƒ‚t|ƒr%td|› d�ƒ‚qd S )NzColumn z# must have a numeric dtype. Found 'z	' insteadzM is backed by an extension array, which is not supported by the numba engine.)r3   Údtypesr�   r   rV   r   )rX   ÚcolnameÚdtyperK   rK   rL   Úvalidate_values_for_numba>  s   ÿÿ
ÿÿúz$FrameApply.validate_values_for_numbar‘   ÚResTypeÚ	res_indexrZ   c                 C  r[   r\   rK   ©rX   r‘   r"  rK   rK   rL   Úwrap_results_for_axisL  rd   z FrameApply.wrap_results_for_axisc                 C  ó   | j S r\   )r  r]   rK   rK   rL   Úres_columnsT  ó   zFrameApply.res_columnsc                 C  r  r\   )r3   r¢   r]   rK   rK   rL   r¢   X  r  zFrameApply.columnsc                 C  r  r\   )r3   Úvaluesr]   rK   rK   rL   r(  \  r  zFrameApply.valuesc                 C  s<  t | jƒr| jdkrtdƒ‚|  ¡ S t| jƒdkr$t| jƒdkr$|  ¡ S t	| jt
ƒr7| jdkr3tdƒ‚|  ¡ S t	| jtjƒrp| jdkrGtdƒ‚tjdd�� | jjjd| jd	�}W d
  ƒ n1 sbw   Y  | jj||jd�S | jdkr„| jdkr~tdƒ‚|  | j¡S t| jjƒsŽ|  ¡ S | jrš| j| j| jd�S |  ¡ S )zcompute the resultsrã   z9the 'numba' engine doesn't support lists of callables yetr   zJthe 'numba' engine doesn't support using a string as the callable functionzOthe 'numba' engine doesn't support using a numpy ufunc as the callable functionÚignore©rÏ   r^   ry   N)ÚaxesrT   z:the 'numba' engine doesn't support result_type='broadcast'©r<   r>   )r   r4   r<   rä   ræ   r�   r¢   rƒ   Úapply_empty_resultrg   r=   rh   r÷   ÚufuncÚerrstater3   Ú_mgrr^   Ú_constructor_from_mgrr+  r8   Úapply_broadcastrÏ   Úshaper6   Ú	apply_rawr>   Úapply_standard©rX   r‘   rK   rK   rL   r^   `  sD   

ÿ
ÿ
ÿÿ

ÿzFrameApply.applyc                   s    | j }| j}| jdkr| j n| j j| _ d| _d }ztƒ  ¡ }W || _ || _n|| _ || _w |dkr:|d ur8|jn|}|d u rN| j j| j|fd| ji| j¤Ž}|S )Nr   rB   rC   )	r3   r5   r{   r  rq   r^   r4   rC   rD   )rX   r3   r5   r†   r  rK   rL   rq   –  s    ÿ zFrameApply.aggc                 C  s  t | jƒsJ ‚| jdvr| j ¡ S | jdk}ddlm} |s]z/| jdkr8| j|g tj	d�g| j
¢R i | j¤Ž}n| j|| jtj	d�g| j
¢R i | j¤Ž}W n	 tyV   Y nw t||ƒ }|r„t| jƒrx| j|g tj	d�g| j
¢R i | j¤Ž}ntj}| jj|| jd�S | j ¡ S )zµ
        we have an empty result; at least 1 axis is 0

        we will try to apply the function to an empty
        series in order to see if this is a reduction function
        )rS   NrS   r   r¬   ©r  )rƒ   r  ©rƒ   )rk   r4   r8   r3   Úcopyr®   r-   r5   r÷   Úfloat64rC   rD   r¢   r�   rg   r�   r  ÚnanÚ_constructor_sliced)rX   Úshould_reducer-   rÊ   rK   rK   rL   r-  ­  sB   



ÿÿÿÿþý€ÿ
(
zFrameApply.apply_empty_resultc                 C  s¨   dd„ }|dkr&|du ri n|}t | jfi |¤Ž}|| j| jƒ}t |¡}ntj|| jƒ| j| jg| j¢R i | j¤Ž}|j	dkrK| j
j|| j| jd�S | j
j|| jd�S )z$apply to the values as a numpy arrayc                   s   ‡ fdd„}|S )z�
            Wrap user supplied function to work around numpy issue.

            see https://github.com/numpy/numpy/issues/8352
            c                    s*   ˆ | i |¤Ž}t |tƒrtj|td�}|S )Nr7  )rg   r=   r÷   ÚarrayÚobject)rC   rD   r†   ry   rK   rL   Úwrapperå  s   
z<FrameApply.apply_raw.<locals>.wrap_function.<locals>.wrapperrK   )r4   r@  rK   ry   rL   Úwrap_functionÞ  s   z+FrameApply.apply_raw.<locals>.wrap_functionrã   Nr¶   ©rƒ   r¢   r8  )r$   r4   r(  r5   r÷   ÚsqueezeÚapply_along_axisrC   rD   rz   r3   Ú_constructorrƒ   r¢   r<  r  )rX   r<   r>   rA  Ú	nb_looperr†   rK   rK   rL   r4  Û  s,   ÿÿýüû
	zFrameApply.apply_rawÚtargetc           	      C  sº   t | jƒsJ ‚t |j¡}|jd }t|jƒD ]8\}}| j|| g| j¢R i | j	¤Ž}t 
|¡j}|dkr9tdƒ‚|dkrG|t|ƒkrGtdƒ‚||d d …|f< q| jj||j|jd�}|S )Nr   rB   ztoo many dims to broadcastzcannot broadcast resultrB  )rk   r4   r÷   Ú
empty_liker(  r3  r    r¢   rC   rD   Úasarrayrz   rV   r�   r3   rE  rƒ   )	rX   rG  Úresult_valuesÚresult_compareÚirx   ÚresÚaresr†   rK   rK   rL   r2  	  s    
 
ÿzFrameApply.apply_broadcastc                 C  s0   | j dkr|  ¡ \}}n|  ¡ \}}|  ||¡S )Nr2   )r<   Úapply_series_generatorÚapply_series_numbaÚwrap_resultsr#  rK   rK   rL   r5  %  s   
zFrameApply.apply_standardútuple[ResType, Index]c                 C  sª   t | jƒsJ ‚| j}| j}i }tdd ƒ�5 t|ƒD ]%\}}| j|g| j¢R i | j¤Ž||< t|| t	ƒr>|| j
dd�||< qW d   ƒ ||fS 1 sLw   Y  ||fS )Nzmode.chained_assignmentF)Údeep)rk   r4   r  rÆ   r
   r    rC   rD   rg   r#   r9  )rX   Ú
series_genr"  r‘   rL  rv   rK   rK   rL   rO  .  s    €ú
ÿ	÷	z!FrameApply.apply_series_generatorc                 C  sJ   | j  dd¡rtdƒ‚| jjjr| jjstdƒ‚|  ¡  |  ¡ }|| j	fS )Nr  FzAParallel apply is not supported when raw=False and engine='numba'zBThe index/columns must be unique when raw=False and engine='numba')
r>   Úgeträ   r3   rƒ   Ú	is_uniquer¢   r   r  rÆ   r6  rK   rK   rL   rP  A  s   ÿÿ
zFrameApply.apply_series_numbac                 C  sv   ddl m} t|ƒdkrd|v rt|d ƒr|  ||¡S | jj}t|ƒdkr2||u r2||tjd�}n||ƒ}||_	|S )Nr   r¬   r7  )
r®   r-   r�   r   r$  r3   r<  r÷   r:  rƒ   )rX   r‘   r"  r-   Úconstructor_slicedr†   rK   rK   rL   rQ  N  s    zFrameApply.wrap_resultsc                   s6   | j dkr| j}|j| j }|j|| jd�S tƒ  ¡ S )NÚsizer8  )r4   r3   r3  r5   r<  r  r  rh   )rX   r3   Úvaluer  rK   rL   rh   c  s
   

zFrameApply.apply_str)r3   r   r4   r   r6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rQ   r  ©r@   r  ©TTF©r@   r  ©r‘   r!  r"  r,   r@   rZ   rü   )r2   N©rG  r+   r@   r+   )r@   rR  )!rù   rþ   rÿ   r   rY   r  r  r  rÆ   r  r  ÚstaticmethodÚ	functoolsÚcacher  r  r   r$  r&  r¢   r   r(  r^   rq   r-  r4  r2  r5  rO  rP  rQ  rh   Ú__classcell__rK   rK   r  rL   rA     sR   
 	÷ÿ


6
.
.
	
c                   @  sp   e Zd ZU dZded< eddd„ƒZeej			dddd„ƒƒZ
ddd„Zed dd„ƒZed dd„ƒZd!dd„ZdS )"rF   r   r   r5   r@   r  c                   s   ‡ fdd„t tˆ jƒƒD ƒS )Nc                 3  s    � | ]}ˆ j j|d d�V  qdS )rB   r‹   N)r3   r¸   )ru   rL  r]   rK   rL   ré   s  s   € z1FrameRowApply.series_generator.<locals>.<genexpr>)Úranger�   r¢   r]   rK   r]   rL   r  q  s   zFrameRowApply.series_generatorTFr  c                   óP   t dƒ}ddlm‰  ddlm‰ |j | ¡‰|j|||d�‡ ‡‡fdd„ƒ}|S )Nrã   r   r¬   ©Úmaybe_cast_str©r  r  r  c                   sJ   i }t | jd ƒD ]}ˆ | d d …|f |ˆ|| ƒd�}ˆ|ƒ||< q	|S )NrB   r­   )rc  r3  )r(  Ú	col_namesÚdf_indexr‘   ÚjÚser©r-   Ú
jitted_udfrf  rK   rL   Ú
numba_func…  s   ÿz;FrameRowApply.generate_numba_apply_func.<locals>.numba_func©r   r®   r-   Úpandas.core._numba.extensionsrf  Ú	extendingÚregister_jitableÚjit©r4   r  r  r  rã   rn  rK   rl  rL   r  u  s   
z'FrameRowApply.generate_numba_apply_funcúdict[int, Any]c              	   C  s°   | j tt| jƒfi | j¤Ž}ddlm} | jj}| jj	}||ƒ�.}||ƒ�}t
|| j||ƒƒ}W d   ƒ n1 s9w   Y  W d   ƒ |S W d   ƒ |S 1 sQw   Y  |S ©Nr   )Úset_numba_data©r  r	   r   r4   r>   rp  rw  r3   rƒ   r¢   rÐ   r(  ©rX   Únb_funcrw  rƒ   r¢   rM  rK   rK   rL   r  ’  s    
ÿÿ(ÿþþzFrameRowApply.apply_with_numbar,   c                 C  r%  r\   ©r¢   r]   rK   rK   rL   rÆ   ¡  r'  zFrameRowApply.result_indexc                 C  r%  r\   r8  r]   rK   rK   rL   r  ¥  r'  zFrameRowApply.result_columnsr‘   r!  r"  rZ   c              
   C  sø   | j dkr| j |¡}||_|S | j du r+tdd„ | ¡ D ƒƒr+| j |¡}||_|S z	| jj|d�}W n$ tyX } zdt|ƒv rS| j |¡}||_|W  Y d}~S ‚ d}~ww t	|d t
ƒsnt|jƒt| jƒkrn| j|_t|jƒt|ƒkrz||_|S )zreturn the results for the rowsrS   Nc                 s  s   � | ]}t |tƒV  qd S r\   )rg   rÐ   )ru   rë   rK   rK   rL   ré   ´  s   € 

ÿz6FrameRowApply.wrap_results_for_axis.<locals>.<genexpr>©Údataz%All arrays must be of the same lengthr   )r8   r3   r<  rƒ   rÏ   r(  rE  rV   r=   rg   r#   r�   r&  r¢   )rX   r‘   r"  rM  r†   r‡   rK   rK   rL   r$  ©  s4   
ÿ€ø
z#FrameRowApply.wrap_results_for_axisNrZ  r[  r\  ©r@   ru  r  r]  )rù   rþ   rÿ   r5   r   r  r  r_  r`  ra  r  r  rÆ   r  r$  rK   rK   rK   rL   rF   n  s   
 ÿ
rF   c                      sŒ   e Zd ZU dZded< d!‡ fdd„Zed"d
d„ƒZee	j
	d#d$dd„ƒƒZd%dd„Zed&dd„ƒZed&dd„ƒZd'dd„Zd(dd „Z‡  ZS ))rG   rB   r   r5   rG  r+   r@   c                   s   t ƒ  |j¡}|jS r\   )r  r2  r{   )rX   rG  r†   r  rK   rL   r2  Ö  s   z FrameColumnApply.apply_broadcastr  c           	      c  sÖ   � | j }t|ƒ}t|ƒdksJ ‚| jjddd�}|j}|jd j ¡ }t	|j
tƒr?| j}tt|ƒƒD ]
}|j|dd�V  q2d S t|| jƒD ]#\}}||_| |¡ t |d|¡ |set|jd ƒ|jd _|V  qEd S )Nr   r‹   Ú_name)r(  r%   r�   r3   r¸   r0  ÚblocksÚrefsÚhas_referencerg   r  r    rc  r¿   rƒ   Ú
set_valuesr?  Ú__setattr__r   )	rX   r(  rk  ÚmgrÚis_viewr3   rL  Úarrr’   rK   rK   rL   r  Ú  s(   €ÿ
óz!FrameColumnApply.series_generatorTFr  c                   rd  )Nrã   r   r¬   re  rg  c                   sF   i }t | jd ƒD ]}ˆ | |  ¡ |ˆ|| ƒd�}ˆ|ƒ||< q	|S )Nr   r­   )rc  r3  r9  )r(  Úcol_names_indexrƒ   r‘   rL  rk  rl  rK   rL   rn  	  s   

ýz>FrameColumnApply.generate_numba_apply_func.<locals>.numba_funcro  rt  rK   rl  rL   r  þ  s   z*FrameColumnApply.generate_numba_apply_funcru  c              	   C  s¦   | j tt| jƒfi | j¤Ž}ddlm} || jjƒ�/}|| j	ƒ�}t
|| j||ƒƒ}W d   ƒ n1 s4w   Y  W d   ƒ |S W d   ƒ |S 1 sLw   Y  |S rv  rx  ry  rK   rK   rL   r    s"   
ÿÿÿ(ýûûz!FrameColumnApply.apply_with_numbar,   c                 C  r%  r\   r8  r]   rK   rK   rL   rÆ   ,  r'  zFrameColumnApply.result_indexc                 C  r%  r\   r{  r]   rK   rK   rL   r  0  r'  zFrameColumnApply.result_columnsr‘   r!  r"  rZ   c                 C  sN   | j dkr|  ||¡}|S t|d tƒs| j |¡}||_|S |  ||¡}|S )z"return the results for the columnsrU   r   )r8   Úinfer_to_same_shaperg   r#   r3   r<  rƒ   ©rX   r‘   r"  r†   rK   rK   rL   r$  4  s   
øþz&FrameColumnApply.wrap_results_for_axisc                 C  s*   | j j|d�}|j}||_|jdd�}|S )z7infer the results to the same shape as the input objectr|  F©r9  )r3   rE  r{   rƒ   Úinfer_objectsrŠ  rK   rK   rL   r‰  I  s
   z$FrameColumnApply.infer_to_same_shaper^  rZ  r[  r\  r~  r  r]  )r‘   r!  r"  r,   r@   r+   )rù   rþ   rÿ   r5   r   r2  r  r  r_  r`  ra  r  r  rÆ   r  r$  r‰  rb  rK   rK   r  rL   rG   Ó  s    
 #ÿ

rG   c                      sx   e Zd ZU ded< dZded< ded< ejdd	œd‡ fdd„Zddd„Z‡ fdd„Z	ddd„Z
dd„ Zddd„Z‡  ZS ) r
  r-   r3   r   r   r5   rP   r:   r1   )Úconvert_dtyper:   r4   r   r�  úbool | lib.NoDefaultr@   rQ   c             	     sF   |t ju rd}n	tjdttƒ d� || _tƒ j||dd |||d� d S )NTz¢the convert_dtype parameter is deprecated and will be removed in a future version.  Do ``ser.astype(object).apply()`` instead if you want ``convert_dtype=False``.©Ú
stacklevelF)r6   r8   r:   rC   rD   )	r   Ú
no_defaultÚwarningsÚwarnÚFutureWarningr   r�  r  rY   )rX   r3   r4   r�  r:   rC   rD   r  rK   rL   rY   \  s"   

û
ùzSeriesApply.__init__rZ   c                 C  sZ   | j }t|ƒdkr|  ¡ S t| jƒr|  ¡ S t| jtƒr |  ¡ S | j	dkr)|  
¡ S |  ¡ S )Nr   rR   )r3   r�   r-  r   r4   ræ   rg   r=   rh   r:   Úapply_compatr5  ©rX   r3   rK   rK   rL   r^   |  s   

zSeriesApply.applyc              
     s¸   t ƒ  ¡ }|d u rZ| j}| j}t|ƒsJ ‚z|j|fd| ji| j¤Ž}W n tt	t
fy>   ||g| j¢R i | j¤Ž}Y |S w d|› dt|ƒj› dt|ƒj› d�}tj|ttƒ d� |S )NrC   zusing z in z3.agg cannot aggregate and has been deprecated. Use z&.transform to keep behavior unchanged.r�  )r  rq   r3   r4   rk   r^   rC   rD   rV   rú   r€   rø   rù   r’  r“  r”  r   )rX   r†   r3   r4   rû   r  rK   rL   rq   �  s"   
	öÿÿzSeriesApply.aggc                 C  s"   | j }|j|j|jd�j|dd�S )N)r  rƒ   r^   ©rß   )r3   rE  r  rƒ   Ú__finalize__r–  rK   rK   rL   r-  ©  s   ÿzSeriesApply.apply_empty_resultc              
   C  sz   | j }| j}t|ƒrt |¡}|r| js| js|j|dd�S z
|j|dd�}W |S  tt	t
fy<   |j|dd�}Y |S w )zõcompat apply method for funcs in listlikes and dictlikes.

         Used for each callable when giving listlikes and dictlikes of callables to
         apply. Needed for compatibility with Pandas < v2.1.

        .. versionadded:: 2.1.0
        F)r:   r1   )r3   r4   rk   rl   rm   rC   rD   r^   rV   rú   r€   )rX   r3   r4   rp   r†   rK   rK   rL   r•  ¯  s   
þþzSeriesApply.apply_compatc                   s  t tˆjƒ‰ ˆj}tˆ tjƒr3tjdd�� ˆ |gˆj¢R i ˆj	¤ŽW  d   ƒ S 1 s-w   Y  nˆj
sCˆ |gˆj¢R i ˆj	¤ŽS ˆjsIˆj	rQ‡ ‡fdd„}nˆ }t|jtƒr[dnd }|j||ˆjd�}t|ƒr{t|d tƒr{|jt|ƒ|jd�S |j||jd�j|dd	�S )
Nr)  r*  c                   s   ˆ | gˆj ¢R i ˆj¤ŽS r\   )rC   rD   )rë   ©r4   rX   rK   rL   ÚcurriedÒ  s   z+SeriesApply.apply_standard.<locals>.curried)ÚmapperÚ	na_actionÚconvertr   r8  r^   r—  )r	   r   r4   r3   rg   r÷   r.  r/  rC   rD   r:   r  r   Ú_map_valuesr�  r�   r#   Ú_constructor_expanddimr}   rƒ   rE  r˜  )rX   r3   rš  ÚactionÚmappedrK   r™  rL   r5  Å  s(   "ÿÿÿzSeriesApply.apply_standard)
r3   r-   r4   r   r�  rŽ  r:   rP   r@   rQ   rü   )r@   r-   )rù   rþ   rÿ   r   r5   r   r‘  rY   r^   rq   r-  r•  r5  rb  rK   rK   r  rL   r
  W  s   
 ú
 
r
  c                      sL   e Zd ZU ded< d‡ fdd	„Zd
d„ Zdd„ Zddd„Zddd„Z‡  Z	S )ÚGroupByApplyz GroupBy | Resampler | BaseWindowr3   úGroupBy[NDFrameT]r4   r   r@   rQ   c                  s:   |  ¡ }|j | dd¡¡| _tƒ j||dd ||d� d S )Nr5   r   F©r6   r8   rC   rD   )r9  r3   rE   rU  r5   r  rY   ©rX   r3   r4   rC   rD   r  rK   rL   rY   ï  s   
úzGroupByApply.__init__c                 C  ó   t ‚r\   ©rä   r]   rK   rK   rL   r^     ó   zGroupByApply.applyc                 C  r¦  r\   r§  r]   rK   rK   rL   r|     r¨  zGroupByApply.transformr`   ra   rZ   c                 C  s°   | j }| j}|dkri |¥ddi¥}t|ddƒdkrtdƒ‚|jjdkr(|j}n|j}tj|dd	t	|dƒd
�� |  
|||¡\}}W d   ƒ n1 sKw   Y  |  ||¡}|S )Nr^   r:   Fr5   r   rB   r	  Úas_indexT©Ú	condition)r3   rD   ro   rä   Ú_selected_objrz   Ú_obj_with_exclusionsrl   Útemp_setattrrö   r¨   r¯   )rX   r`   r3   rD   r™   r¤   r‘   r†   rK   rK   rL   rc     s    ÿýz#GroupByApply.agg_or_apply_list_likec                 C  s
  ddl m}m} |dv sJ ‚| j}i }|dkr%| jrdnd}| d|i¡ t|ddƒd	kr1td
ƒ‚|j}|j	}t
|||fƒ}	|	rV| j dd ¡}
| j dd ¡}| |
|dœ¡ tj|ddt|dƒd�� |  ||||¡\}}W d   ƒ n1 sww   Y  |  |||¡}|S )Nr   r³   r  r^   rR   Fr:   r5   rB   r	  r<   r>   r,  r©  Trª  )r¼   r´   rµ   r3   r:   r  ro   rä   r¬  Ú
_selectionrg   rD   rU  rl   r®  rö   rÅ   r×   )rX   r`   r´   rµ   r3   rD   r:   r™   r°   rÀ   r<   r>   rÆ   rÈ   r†   rK   rK   rL   re   "  s2   ÿ
ÿýz#GroupByApply.agg_or_apply_dict_like)r3   r£  r4   r   r@   rQ   rý   )
rù   rþ   rÿ   r   rY   r^   r|   rc   re   rb  rK   rK   r  rL   r¢  ì  s   
 
r¢  c                      sD   e Zd ZU dZded< ded< d‡ fd
d„Zdd„ Zdd„ Z‡  ZS )ÚResamplerWindowApplyr   r   r5   úResampler | BaseWindowr3   r4   r   r@   rQ   c                  s    t t| ƒj||dd ||d� d S )NFr¤  )r  r¢  rY   r¥  r  rK   rL   rY   N  s   

úzResamplerWindowApply.__init__c                 C  r¦  r\   r§  r]   rK   rK   rL   r^   _  r¨  zResamplerWindowApply.applyc                 C  r¦  r\   r§  r]   rK   rK   rL   r|   b  r¨  zResamplerWindowApply.transform)r3   r±  r4   r   r@   rQ   )	rù   rþ   rÿ   r5   r   rY   r^   r|   rb  rK   rK   r  rL   r°  J  s   
 r°  úAggFuncType | NoneúMtuple[bool, AggFuncType, tuple[str, ...] | None, npt.NDArray[np.intp] | None]c                 K  s‚   | du o
t di |¤Ž}d}d}|s,t| tƒr$t| ƒtt| ƒƒkr$tdƒ‚| du r,tdƒ‚|r5t|ƒ\} }}| dus;J ‚|| ||fS )aÆ  
    This is the internal function to reconstruct func given if there is relabeling
    or not and also normalize the keyword to get new order of columns.

    If named aggregation is applied, `func` will be None, and kwargs contains the
    column and aggregation function information to be parsed;
    If named aggregation is not applied, `func` is either string (e.g. 'min') or
    Callable, or list of them (e.g. ['min', np.max]), or the dictionary of column name
    and str/Callable/list of them (e.g. {'A': 'min'}, or {'A': [np.min, lambda x: x]})

    If relabeling is True, will return relabeling, reconstructed func, column
    names, and the reconstructed order of columns.
    If relabeling is False, the columns and order will be None.

    Parameters
    ----------
    func: agg function (e.g. 'min' or Callable) or list of agg functions
        (e.g. ['min', np.max]) or dictionary (e.g. {'A': ['min', np.max]}).
    **kwargs: dict, kwargs used in is_multi_agg_with_relabel and
        normalize_keyword_aggregation function for relabelling

    Returns
    -------
    relabelling: bool, if there is relabelling or not
    func: normalized and mangled func
    columns: tuple of column names
    order: array of columns indices

    Examples
    --------
    >>> reconstruct_func(None, **{"foo": ("col", "min")})
    (True, defaultdict(<class 'list'>, {'col': ['min']}), ('foo',), array([0]))

    >>> reconstruct_func("min")
    (False, 'min', None, None)
    NzFFunction names must be unique if there is no new column names assignedz4Must provide 'func' or tuples of '(column, aggfunc).rK   )Úis_multi_agg_with_relabelrg   r}   r�   Úsetr   r€   Únormalize_keyword_aggregation)r4   rD   Ú
relabelingr¢   ÚorderrK   rK   rL   rH   f  s    'ÿ
ÿrH   c                  K  s"   t dd„ |  ¡ D ƒƒot| ƒdkS )ax  
    Check whether kwargs passed to .agg look like multi-agg with relabeling.

    Parameters
    ----------
    **kwargs : dict

    Returns
    -------
    bool

    Examples
    --------
    >>> is_multi_agg_with_relabel(a="max")
    False
    >>> is_multi_agg_with_relabel(a_max=("a", "max"), a_min=("a", "min"))
    True
    >>> is_multi_agg_with_relabel()
    False
    c                 s  s&   � | ]}t |tƒot|ƒd kV  qdS )r¶   N)rg   rð   r�   rt   rK   rK   rL   ré   À  s   €$ z,is_multi_agg_with_relabel.<locals>.<genexpr>r   )rÏ   r(  r�   )rD   rK   rK   rL   r´  «  s   
ÿr´  rD   rÐ   ú]tuple[MutableMapping[Hashable, list[AggFuncTypeBase]], tuple[str, ...], npt.NDArray[np.intp]]c                 C  sš   ddl m} ttƒ}g }tt|  ¡ Ž ƒ\}}|D ]\}}||  |¡ | |t |¡p,|f¡ qt	|ƒ}dd„ | ¡ D ƒ}	t	|	ƒ}
||
ƒ 
|¡}|||fS )aR  
    Normalize user-provided "named aggregation" kwargs.
    Transforms from the new ``Mapping[str, NamedAgg]`` style kwargs
    to the old Dict[str, List[scalar]]].

    Parameters
    ----------
    kwargs : dict

    Returns
    -------
    aggspec : dict
        The transformed kwargs.
    columns : tuple[str, ...]
        The user-provided keys.
    col_idx_order : List[int]
        List of columns indices.

    Examples
    --------
    >>> normalize_keyword_aggregation({"output": ("input", "sum")})
    (defaultdict(<class 'list'>, {'input': ['sum']}), ('output',), array([0]))
    r   rÉ   c                 S  s,   g | ]\}}|D ]}|t  |¡p|f‘qqS rK   rr   )ru   ÚcolumnÚaggfuncsÚaggfuncrK   rK   rL   r·   ö  s    ýþÿz1normalize_keyword_aggregation.<locals>.<listcomp>)Úpandas.core.indexes.baser,   r   r}   r¿   r�   rŸ   rl   rs   Ú_make_unique_kwarg_listÚget_indexer)rD   r,   Úaggspecr¸  r¢   Úpairsrº  r¼  Úuniquified_orderÚaggspec_orderÚuniquified_aggspecÚcol_idx_orderrK   rK   rL   r¶  Å  s   þ
r¶  ÚseqúSequence[tuple[Any, Any]]c                   s   ‡ fdd„t ˆ ƒD ƒS )a  
    Uniquify aggfunc name of the pairs in the order list

    Examples:
    --------
    >>> kwarg_list = [('a', '<lambda>'), ('a', '<lambda>'), ('b', '<lambda>')]
    >>> _make_unique_kwarg_list(kwarg_list)
    [('a', '<lambda>_0'), ('a', '<lambda>_1'), ('b', '<lambda>')]
    c                   sJ   g | ]!\}}ˆ   |¡d kr!|d |d  › dˆ d|…   |¡› �fn|‘qS )rB   r   rJ   N)Úcount)ru   rL  Úpair©rÆ  rK   rL   r·     s    8ÿÿz+_make_unique_kwarg_list.<locals>.<listcomp>)r    rÊ  rK   rÊ  rL   r¾    s   
þr¾  r†   rZ   údict[str, list[Callable | str]]r¢   r©   r¸  úIterable[int]údict[Hashable, Series]c                 C  sÐ   ddl m} dd„ tt||ƒdd„ d�D ƒ}i }d}t| tƒ o&t| jƒdk}| ¡ D ]:\}	}
| |	  	¡ }|rKd	d„ |
D ƒ}
||j
ƒ |
¡}|j| }|||t|
ƒ … |_
|j|d
d�||	< |t|
ƒ }q+|S )aº  
    Internal function to reorder result if relabelling is True for
    dataframe.agg, and return the reordered result in dict.

    Parameters:
    ----------
    result: Result from aggregation
    func: Dict of (column name, funcs)
    columns: New columns name for relabelling
    order: New order for relabelling

    Examples
    --------
    >>> from pandas.core.apply import relabel_result
    >>> result = pd.DataFrame(
    ...     {"A": [np.nan, 2, np.nan], "C": [6, np.nan, np.nan], "B": [np.nan, 4, 2.5]},
    ...     index=["max", "mean", "min"]
    ... )
    >>> funcs = {"A": ["max"], "C": ["max"], "B": ["mean", "min"]}
    >>> columns = ("foo", "aab", "bar", "dat")
    >>> order = [0, 1, 2, 3]
    >>> result_in_dict = relabel_result(result, funcs, columns, order)
    >>> pd.DataFrame(result_in_dict, index=columns)
           A    C    B
    foo  2.0  NaN  NaN
    aab  NaN  6.0  NaN
    bar  NaN  NaN  4.0
    dat  NaN  NaN  2.5
    r   rÉ   c                 S  s   g | ]}|d  ‘qS )r   rK   )ru   rÉ  rK   rK   rL   r·   9  s    ÿz"relabel_result.<locals>.<listcomp>c                 S  s   | d S )NrB   rK   )ÚtrK   rK   rL   Ú<lambda>:  s    z relabel_result.<locals>.<lambda>)r»   rB   c                 S  s$   g | ]}t |tƒst |¡n|‘qS rK   )rg   r=   rl   rs   )ru   rp   rK   rK   rL   r·   X  s    ÿFr‹  )r½  r,   Úsortedr¿   rg   r#   r�   r¢   r�   Údropnarƒ   r¿  r¡   Úreindex)r†   r4   r¢   r¸  r,   Úreordered_indexesÚreordered_result_in_dictÚidxÚreorder_maskrx   ÚfunÚsrÅ  rK   rK   rL   Úrelabel_result  s&   #ÿÿ
rÙ  c                 K  s^   ddl m} t|fi |¤Ž\}}}}|r-|d usJ ‚|d us J ‚t| |||ƒ}|||d�} | S )Nr   )r+   r8  )r®   r+   rH   rÙ  )r†   r4   rD   r+   r·  r¢   r¸  Úresult_in_dictrK   rK   rL   rå   f  s   rå   r»  úSequence[Any]c                 C  s\   t | ƒdkr| S d}g }| D ]}t |¡dkr&t|ƒ}d|› d�|_|d7 }| |¡ q|S )aJ  
    Possibly mangle a list of aggfuncs.

    Parameters
    ----------
    aggfuncs : Sequence

    Returns
    -------
    mangled: list-like
        A new AggSpec sequence, where lambdas have been converted
        to have unique names.

    Notes
    -----
    If just one aggfunc is passed, the name will not be mangled.
    rB   r   z<lambda>z<lambda_ú>)r�   rl   rs   r   rù   rŸ   )r»  rL  Úmangled_aggfuncsr¼  rK   rK   rL   Ú_managle_lambda_list�  s   rÞ  Úagg_specr   c                 C  sn   t | ƒ}|st| ƒs| S t| ƒƒ }|r1|  ¡ D ]\}}t|ƒr(t |ƒs(t|ƒ}n|}|||< q|S t| ƒ}|S )aZ  
    Make new lambdas with unique names.

    Parameters
    ----------
    agg_spec : Any
        An argument to GroupBy.agg.
        Non-dict-like `agg_spec` are pass through as is.
        For dict-like `agg_spec` a new spec is returned
        with name-mangled lambdas.

    Returns
    -------
    mangled : Any
        Same type as the input.

    Examples
    --------
    >>> maybe_mangle_lambdas('sum')
    'sum'
    >>> maybe_mangle_lambdas([lambda: 1, lambda: 2])  # doctest: +SKIP
    [<function __main__.<lambda_0>,
     <function pandas...._make_lambda.<locals>.f(*args, **kwargs)>]
    )r   r   rø   r�   rÞ  )rß  Úis_dictÚmangled_aggspecr»   r»  rÝ  rK   rK   rL   Úmaybe_mangle_lambdas¢  s   


þrâ  ú0tuple[list[str], list[str | Callable[..., Any]]]c                 C  sf   d}t | ƒ}g }|  ¡ D ]}t|tƒs!t|ƒs!t| t|ƒj¡ƒ‚| 	|¡ q|s/d}t|ƒ‚||fS )aÜ  
    Validates types of user-provided "named aggregation" kwargs.
    `TypeError` is raised if aggfunc is not `str` or callable.

    Parameters
    ----------
    kwargs : dict

    Returns
    -------
    columns : List[str]
        List of user-provided keys.
    func : List[Union[str, callable[...,Any]]]
        List of user-provided aggfuncs

    Examples
    --------
    >>> validate_func_kwargs({'one': 'min', 'two': 'max'})
    (['one', 'two'], ['min', 'max'])
    z-func is expected but received {} in **kwargs.z2Must provide 'func' or named aggregation **kwargs.)
r}   r(  rg   r=   rk   r€   Úformatrø   rù   rŸ   )rD   Útuple_given_messager¢   r4   Úcol_funcÚno_arg_messagerK   rK   rL   Úvalidate_func_kwargsÎ  s   rè  r`   ra   r”   rš   c                 C  s   t |tƒpt |tƒo| dkS )Nrq   )rg   r!   r#   )r`   r”   rK   rK   rL   rž   ò  s   
ÿrž   r   r   ÚaliasrQ   c                 C  sZ   |  d¡r|}nt| ƒj› d|› �}d|› d�}tjd|› d|› d|› d�ttƒ d� d S )	Nznp.Ú.ú"zThe provided callable z is currently using zw. In a future version of pandas, the provided callable will be used directly. To keep current behavior pass the string z	 instead.)Úcategoryr�  )Ú
startswithrø   rù   r’  r“  r”  r   )r3   r4   ré  Ú
full_aliasrK   rK   rL   rn   ø  s   
ÿý
úrn   )r   FNr1   r2   NNN)r3   r+   r4   r   r5   r   r6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   )r4   r²  r@   r³  )r@   r7   )rD   rÐ   r@   r¹  )rÆ  rÇ  r@   rÇ  )
r†   rZ   r4   rË  r¢   r©   r¸  rÌ  r@   rÍ  rü   )r»  rÛ  r@   rÛ  )rß  r   r@   r   )rD   rÐ   r@   rã  )r`   ra   r”   rš   r@   r7   )r3   r   r4   r   ré  r=   r@   rQ   )gÚ
__future__r   r  Úcollectionsr   r`  r   rÜ   Útypingr   r   r   r   r	   r’  Únumpyr÷   Úpandas._configr
   Úpandas._libsr   Úpandas._libs.internalsr   Úpandas._typingr   r   r   r   r   r   r   r   Úpandas.compat._optionalr   Úpandas.errorsr   Úpandas.util._decoratorsr   Úpandas.util._exceptionsr   Úpandas.core.dtypes.castr   Úpandas.core.dtypes.commonr   r   r   r   r   Úpandas.core.dtypes.dtypesr   r    Úpandas.core.dtypes.genericr!   r"   r#   Úpandas.core._numba.executorr$   Úpandas.core.commonÚcoreÚcommonrl   Úpandas.core.constructionr%   Úcollections.abcr&   r'   r(   r)   r*   r®   r+   r,   r-   Úpandas.core.groupbyr.   Úpandas.core.resampler/   Úpandas.core.window.rollingr0   rÐ   Úintr!  rM   ÚABCMetarN   r  rA   rF   rG   r
  r¢  r°  rH   r´  r¶  r¾  rÙ  rå   rÞ  râ  rè  rž   rn   rK   rK   rK   rL   Ú<module>   s†    (
ö$    S=  ne  ^

E

=

R

!
,
$