Ë
    (�£ju;  ã            	      ó>  — d dl mZ d dlmZmZmZ d dlmZmZm	Z	 d dl
mZ erd dlmZmZ i dd“dd“d	d
“dd
“dd“dd“dd“dd“dd“dd“dd“dd“dd“dd“dd“dd“d d!“d"d#d#d$d$d%d%d&œ¥Zd1d'„Zd2d(„Zd3d)„Z ed*«       G d+„ d,«      «       Z ed-«      d4d.„«       Zd,d/gZy0)5é    )Úannotations)ÚCallableÚHashableÚSequence)ÚTYPE_CHECKINGÚAnyÚNoReturn)Ú
set_module)Ú	DataFrameÚSeriesÚ__add__Ú+Ú__radd__Ú__sub__Ú-Ú__rsub__Ú__mul__Ú*Ú__rmul__Ú__truediv__Ú/Ú__rtruediv__Ú__floordiv__z//Ú__rfloordiv__Ú__mod__Ú%Ú__rmod__Ú__ge__z>=Ú__gt__Ú>Ú__le__z<=Ú__lt__Ú<Ú__eq__z==z!=Ú&Ú|Ú^)Ú__ne__Ú__and__Ú__rand__Ú__or__Ú__ror__Ú__xor__Ú__rxor__c                ó,   ‡ — t        ˆ fd„|D «       «      S )Nc              3  ód   •K  — | ]'  }t        |t        «      r|j                  ‰«      n|–— Œ) y ­w©N)Ú
isinstanceÚ
ExpressionÚ_eval_expression)Ú.0ÚxÚdfs     €ú1C:\FundamentalWorkbench\vendor\pandas\core\col.pyÚ	<genexpr>z_parse_args.<locals>.<genexpr>6   s.   øè ø€ ð ÙLPÀq¤*¨Q´
Ô";ˆ×Ñ˜2ÔÀÓBÉDùs   ƒ-0)Útuple)r7   Úargss   ` r8   Ú_parse_argsr<   4   s   ø€ äó ÙLPóó ð ó    c           	     ó˜   — |j                  «       D ��ci c])  \  }}|t        |t        «      r|j                  | «      n|“Œ+ c}}S c c}}w r1   )Úitemsr2   r3   r4   )r7   ÚkwargsÚkeyÚvals       r8   Ú_parse_kwargsrC   ;   sN   € ð Ÿ™œôá&‰HˆC�ð 	¬°C¼Ô)DˆS×!Ñ! "Ô%È#ÑMØ&òð ùó s   ”.Ac                 óð   — dj                  d„ | D «       «      }dj                  d„ |j                  «       D «       «      }g }|r|j                  |«       |r|j                  |«       dj                  |«      S )Nz, c              3  ó2   K  — | ]  }t        |«      –— Œ y ­wr1   )Úrepr)r5   Úargs     r8   r9   z,_pretty_print_args_kwargs.<locals>.<genexpr>D   s   è ø€ Ð6±¨#œD ŸI±ùs   ‚c              3  ó0   K  — | ]  \  }}|› d |›�–— Œ y­w)Ú=N© )r5   ÚkÚvs      r8   r9   z,_pretty_print_args_kwargs.<locals>.<genexpr>E   s   è ø€ ÐD±^©T¨Q°˜q˜c  1 %œL±^ùs   ‚)Újoinr?   Úappend)r;   r@   Úinputs_reprÚkwargs_reprÚall_argss        r8   Ú_pretty_print_args_kwargsrR   C   sb   € Ø—)‘)Ñ6±Ó6Ó6€KØ—)‘)ÑD°V·\±\´^ÓDÓD€Kà€HÙØ�‰˜Ô$ÙØ�‰˜Ô$à�9‰9�XÓÐr=   zpandas.api.typingc                  óÄ  — e Zd ZdZ	 d2	 	 	 	 	 	 	 d3d„Zd4d„Z	 d5	 	 	 	 	 	 	 	 	 d6d„Zd7d„Zd8d„Zd8d„Z	d8d„Z
d8d	„Zd8d
„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Zd9d„Zd9d„Zd8d„Zd8d„Zd8d„Zd8d„Zd8d„Z d8d„Z!d8d „Z"d8d!„Z#d:d"„Z$d:d#„Z%d:d$„Z&d:d%„Z'	 	 	 	 	 	 	 	 	 	 d;d&„Z(d<d'„Z)d=d(„Z*d>d)„Z+d?d*„Z,d@d+„Z-dAd,„Z.dBd-„Z/dBd.„Z0dBd/„Z1dCd0„Z2y1)Dr3   z„
    Class representing a deferred column.

    This is not meant to be instantiated directly. Instead, use :meth:`pandas.col`.
    c                ó.   — || _         || _        || _        y r1   )Ú_funcÚ	_repr_strÚ_needs_parentheses)ÚselfÚfuncÚrepr_strÚneeds_parentheses       r8   Ú__init__zExpression.__init__X   s   € ð ˆŒ
Ø!ˆŒØ"2ˆÕr=   c                ó$   — | j                  |«      S r1   )rU   )rX   r7   s     r8   r4   zExpression._eval_expressionb   s   € Ø�z‰z˜"‹~Ðr=   c                ót   ‡ ‡‡— t        ‰t        «      rt        ˆˆˆ fd„||¬«      S t        ˆˆˆ fd„||¬«      S )Nc                ód   •—  t        ‰j                  | «      ‰«      ‰j                  | «      «      S r1   ©Úgetattrr4   ©r7   ÚopÚotherrX   s    €€€r8   Ú<lambda>z%Expression._with_op.<locals>.<lambda>j   s-   ø€ ÐAœ7 4×#8Ñ#8¸Ó#<¸bÓAØ×*Ñ*¨2Ó.ôr=   ©r[   c                óF   •—  t        ‰j                  | «      ‰«      ‰«      S r1   r`   rb   s    €€€r8   re   z%Expression._with_op.<locals>.<lambda>r   s   ø€ ÐAœ7 4×#8Ñ#8¸Ó#<¸bÓAÀ%ÔHr=   )r2   r3   )rX   rc   rd   rZ   Úneeds_parenthesess   ```  r8   Ú_with_opzExpression._with_ope   sA   ú€ ô �eœZÔ(Üõð Ø!2ôð ô ÝHØØ!2ôð r=   c                óˆ   — | j                   rd| ›d�}n| ›}t        |t        «      r|j                   r
d|›d�}||fS |›}||fS )NÚ(Ú))rW   r2   r3   ©rX   rd   Ú	self_reprÚ
other_reprs       r8   Ú_maybe_wrap_parenthesesz"Expression._maybe_wrap_parenthesesw   s_   € Ø×"Ò"Ø˜D˜8 1˜‰Ià˜(ˆIÜ�eœZÔ(¨U×-EÒ-EØ˜U˜I Q˜ˆJð ˜*Ð$Ð$ð "˜9ˆJØ˜*Ð$Ð$r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   ú + ©rp   ri   rm   s       r8   r   zExpression.__add__ƒ   ó5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜Y¨°)°¸CÀ
¸|Ð/LÓMÐMr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   rr   rs   rm   s       r8   r   zExpression.__radd__‡   ó5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜Z¨°:°,¸cÀ)ÀÐ0MÓNÐNr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   ú - rs   rm   s       r8   r   zExpression.__sub__‹   rt   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   rx   rs   rm   s       r8   r   zExpression.__rsub__�   rv   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   ú * rs   rm   s       r8   r   zExpression.__mul__“   rt   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   r{   rs   rm   s       r8   r   zExpression.__rmul__—   rv   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )NÚ
__matmul__ú @ rs   rm   s       r8   r~   zExpression.__matmul__›   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜\¨5°Y°K¸sÀ:À,Ð2OÓPÐPr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )NÚ__rmatmul__r   rs   rm   s       r8   r�   zExpression.__rmatmul__Ÿ   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜]¨E°j°\ÀÀYÀKÐ3PÓQÐQr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )NÚ__pow__ú ** rs   rm   s       r8   rƒ   zExpression.__pow__£   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜Y¨°)°¸DÀÀÐ/MÓNÐNr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )NÚ__rpow__r„   rs   rm   s       r8   r†   zExpression.__rpow__§   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜Z¨°:°,¸dÀ9À+Ð0NÓOÐOr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   ú / rs   rm   s       r8   r   zExpression.__truediv__«   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜]¨E°i°[ÀÀJÀ<Ð3PÓQÐQr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   rˆ   rs   rm   s       r8   r   zExpression.__rtruediv__¯   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜^¨U°z°lÀ#ÀiÀ[Ð4QÓRÐRr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   ú // rs   rm   s       r8   r   zExpression.__floordiv__³   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜^¨U°y°kÀÀjÀ\Ð4RÓSÐSr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   r‹   rs   rm   s       r8   r   zExpression.__rfloordiv__·   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜_¨e¸
°|À4È	À{Ð5SÓTÐTr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   z >= rs   rm   s       r8   r   zExpression.__ge__»   ó5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜X u°°¸4À
¸|Ð.LÓMÐMr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   z > rs   rm   s       r8   r   zExpression.__gt__¿   ó5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜X u°°¸3¸z¸lÐ.KÓLÐLr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr!   z <= rs   rm   s       r8   r!   zExpression.__le__Ã   rŽ   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr"   z < rs   rm   s       r8   r"   zExpression.__lt__Ç   r�   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr$   z == rs   rm   s       r8   r$   zExpression.__eq__Ë   rŽ   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr(   z != rs   rm   s       r8   r(   zExpression.__ne__Ï   rŽ   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   ú % rs   rm   s       r8   r   zExpression.__mod__Ó   rt   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr   r–   rs   rm   s       r8   r   zExpression.__rmod__×   rv   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr)   ú & rs   rm   s       r8   r)   zExpression.__and__Ü   rt   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr*   r™   rs   rm   s       r8   r*   zExpression.__rand__à   rv   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr+   ú | rs   rm   s       r8   r+   zExpression.__or__ä   r�   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr,   rœ   rs   rm   s       r8   r,   zExpression.__ror__è   s5   € Ø $× <Ñ <¸UÓ CÑˆ	�:Ø�}‰}˜Y¨°*°¸SÀÀÐ/LÓMÐMr=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr-   ú ^ rs   rm   s       r8   r-   zExpression.__xor__ì   rt   r=   c                óZ   — | j                  |«      \  }}| j                  d||› d|› �«      S )Nr.   rŸ   rs   rm   s       r8   r.   zExpression.__rxor__ð   rv   r=   c                ó@   ‡ — t        ˆ fd„d‰ j                  › �d¬«      S )Nc                ó(   •— ‰j                  | «       S r1   ©r4   ©r7   rX   s    €r8   re   z'Expression.__invert__.<locals>.<lambda>ö   ó   ø€ ˜×-Ñ-¨bÓ1Ñ1r=   Ú~Trf   ©r3   rV   ©rX   s   `r8   Ú
__invert__zExpression.__invert__ô   s%   ø€ ÜÛ1Ø�—‘ÐÐ Ø!ô
ð 	
r=   c                ó~   ‡ — ‰ j                   rd‰ j                  › d�}nd‰ j                  › �}t        ˆ fd„|d¬«      S )Nz-(rl   r   c                ó(   •— ‰j                  | «       S r1   r£   r¤   s    €r8   re   z$Expression.__neg__.<locals>.<lambda>  r¥   r=   Trf   ©rW   rV   r3   ©rX   rZ   s   ` r8   Ú__neg__zExpression.__neg__û   óF   ø€ Ø×"Ò"Ø˜DŸN™NÐ+¨1Ð-‰Hà˜4Ÿ>™>Ð*Ð+ˆHÜÛ1ØØ!ô
ð 	
r=   c                ó~   ‡ — ‰ j                   rd‰ j                  › d�}nd‰ j                  › �}t        ˆ fd„|d¬«      S )Nz+(rl   r   c                ó(   •— ‰j                  | «      ­S r1   r£   r¤   s    €r8   re   z$Expression.__pos__.<locals>.<lambda>  r¥   r=   Trf   r¬   r­   s   ` r8   Ú__pos__zExpression.__pos__  r¯   r=   c                óB   ‡ — t        ˆ fd„d‰ j                  › d�d¬«      S )Nc                ó8   •— t        ‰j                  | «      «      S r1   )Úabsr4   r¤   s    €r8   re   z$Expression.__abs__.<locals>.<lambda>  s   ø€ ”s˜4×0Ñ0°Ó4Ô5r=   zabs(rl   Trf   r§   r¨   s   `r8   Ú__abs__zExpression.__abs__  s'   ø€ ÜÛ5Ø�4—>‘>Ð" !Ð$Ø!ô
ð 	
r=   c                ój   ‡‡‡— dˆˆˆfd„}t        ‰i ‰¤Ž}‰j                  › d|› d�}t        ||«      S )Nc                óD   •— t        | g‰¢­Ž }t        | g‰¢­Ž } ‰|i |¤ŽS r1   )r<   rC   )r7   Úparsed_inputsÚparsed_kwargsÚinputsr@   Úufuncs      €€€r8   rY   z(Expression.__array_ufunc__.<locals>.func  s1   ø€ Ü'¨Ð4¨VÒ4ˆMÜ)¨"Ð6¨vÒ6ˆMÙ˜-Ð9¨=Ñ9Ð9r=   rk   rl   ©r7   r   Úreturnr   ©rR   Ú__name__r3   )rX   r¼   Úmethodr»   r@   rY   Úargs_strrZ   s    ` ``   r8   Ú__array_ufunc__zExpression.__array_ufunc__  s=   ú€ ÷	:ô
 -¨fÐ?¸Ñ?ˆØ—n‘nÐ% Q x j°Ð2ˆä˜$ Ó)Ð)r=   c                ó8   — | j                  d|| ›d|›d�d¬«      S )NÚ__getitem__Ú[Ú]T)rh   )ri   )rX   Úitems     r8   rÅ   zExpression.__getitem__%  s.   € Ø�}‰}Ø˜4 D 8¨1¨T¨H°AÐ!6È$ð ó 
ð 	
r=   c                ól   ‡‡— dˆˆfd„}t        di ‰¤Ž}‰j                  dz   |z   dz   }t        ||«      S )Nc                ó,   •— t        | fi ‰¤Ž} ‰di |¤ŽS )NrJ   )rC   )r7   rº   rY   r@   s     €€r8   Úwrappedz+Expression._call_with_func.<locals>.wrapped+  s    ø€ Ü)¨"Ñ7°Ñ7ˆMÙÑ(˜-Ñ(Ð(r=   rk   rl   r½   rJ   r¿   )rX   rY   r@   rË   rÂ   rZ   s    ``   r8   Ú_call_with_funczExpression._call_with_func*  s<   ù€ ö	)ô -Ñ6¨vÑ6ˆØ—=‘= 3Ñ&¨Ñ1°CÑ7ˆä˜' 8Ó,Ð,r=   c                ór   ‡ ‡‡‡— dˆ fd„Št        ‰i ‰¤Ž}‰ j                  › d|› d�}t        ˆˆˆfd„|«      S )Nc                ób   •— t        | g|¢­Ž }t        | fi |¤Ž} ‰j                  | «      |i |¤ŽS r1   )r<   rC   r4   )r7   r;   r@   Úparsed_argsrº   rX   s        €r8   rY   z!Expression.__call__.<locals>.func5  s>   ø€ Ü% bÐ0¨4Ò0ˆKÜ)¨"Ñ7°Ñ7ˆMØ,�4×(Ñ(¨Ó,¨kÐK¸]ÑKÐKr=   rk   rl   c                ó   •—  ‰| g‰¢­i ‰¤ŽS r1   rJ   )r7   r;   rY   r@   s    €€€r8   re   z%Expression.__call__.<locals>.<lambda><  s   ø€ ¡T¨"Ð%>¨tÒ%>°vÒ%>r=   )r7   r   r;   r   r@   r   r¾   r   )rR   rV   r3   )rX   r;   r@   rÂ   rZ   rY   s   ```  @r8   Ú__call__zExpression.__call__4  s?   û€ õ	Lô
 -¨dÐ=°fÑ=ˆØ—n‘nÐ% Q x j°Ð2ˆÜÕ>ÀÓIÐIr=   c               ó`   ‡ ‡— ‰ ›}‰ j                   rd|› d�}|d‰› �z  }t        ˆˆ fd„|«      S )Nrk   rl   Ú.c                ó:   •— t        ‰j                  | «      ‰«      S r1   r`   )r7   ÚnamerX   s    €€r8   re   z(Expression.__getattr__.<locals>.<lambda>C  s   ø€ ¤W¨T×-BÑ-BÀ2Ó-FÈÔ%Mr=   )rW   r3   )rX   rÕ   rZ   s   `` r8   Ú__getattr__zExpression.__getattr__>  s>   ù€ Ø�XˆØ×"Ò"Ø˜8˜* A�ˆHØ�a˜�v�JÑˆÜÔMÈxÓXÐXr=   c                ó6   ‡ ‡— dˆˆ fd„}‰ ›d�}t        ||«      S )aB  
        Create an expression that evaluates :meth:`Series.case_when` in a DataFrame
        context.

        This is intended to enable patterns like::

            df.assign(result=pd.col("a").case_when([(pd.col("b") > 0, 1)]))

        where conditions/replacements may reference other columns via ``pd.col``.
        c                ó
  •— ‰j                  | «      }g }‰D ]Z  \  }}t        |t        «      r|j                  | «      }t        |t        «      r|j                  | «      }|j                  ||f«       Œ\ |j	                  |«      S r1   )r4   r2   r3   rN   Ú	case_when)r7   ÚserÚ	evaluatedÚ	conditionÚreplacementÚcaselistrX   s        €€r8   rY   z"Expression.case_when.<locals>.funcQ  s   ø€ Ø×'Ñ'¨Ó+ˆCØˆIÛ*2Ñ&�	˜;Ü˜i¬Ô4Ø )× :Ñ :¸2Ó >�IÜ˜k¬:Ô6Ø"-×">Ñ">¸rÓ"B�KØ× Ñ  )¨[Ð!9Õ:ð +3ð —=‘= Ó+Ð+r=   z.case_when(...)r½   )r3   )rX   rÞ   rY   rZ   s   ``  r8   rÙ   zExpression.case_whenE  s#   ù€ ö		,ð �X˜_Ð-ˆÜ˜$ Ó)Ð)r=   c                ó"   — | j                   xs dS )Nz	Expr(...))rV   r¨   s    r8   Ú__repr__zExpression.__repr__`  s   € Ø�~‰~Ò, Ð,r=   c                ó   — t        d«      ‚)Nz+boolean value of an expression is ambiguous©Ú	TypeErrorr¨   s    r8   Ú__bool__zExpression.__bool__d  s   € ÜÐEÓFÐFr=   c                ó   — t        d«      ‚)Nz#Expression objects are not iterablerâ   r¨   s    r8   Ú__iter__zExpression.__iter__g  ó   € ÜÐ=Ó>Ð>r=   c                ó   — t        d«      ‚©Nz#Expression objects are not copiablerâ   r¨   s    r8   Ú__copy__zExpression.__copy__j  rç   r=   c                ó   — t        d«      ‚ré   râ   )rX   Úmemos     r8   Ú__deepcopy__zExpression.__deepcopy__m  rç   r=   N)F)rY   zCallable[[DataFrame], Any]rZ   Ústrr[   Úboolr¾   ÚNoner½   )T)
rc   rî   rd   r   rZ   rî   rh   rï   r¾   r3   )rd   r   r¾   ztuple[str, str])rd   r   r¾   r3   )rd   Úobjectr¾   r3   )r¾   r3   )
r¼   zCallable[..., Any]rÁ   rî   r»   r   r@   r   r¾   r3   )rÈ   r   r¾   r3   )rY   r   r@   r   r¾   r3   )r;   r   r@   r   r¾   r3   )rÕ   rî   r¾   r   )rÞ   zSequence[tuple[Any, Any]]r¾   r3   )r¾   rî   )r¾   r	   )rì   zdict[int, Any] | Noner¾   r	   )3rÀ   Ú
__module__Ú__qualname__Ú__doc__r\   r4   ri   rp   r   r   r   r   r   r   r~   r�   rƒ   r†   r   r   r   r   r   r   r!   r"   r$   r(   r   r   r)   r*   r+   r,   r-   r.   r©   r®   r²   r¶   rÃ   rÅ   rÌ   rÑ   rÖ   rÙ   rà   rä   ræ   rê   rí   rJ   r=   r8   r3   r3   P   s“  „ ñð "'ð	3à(ð3ð ð3ð ð	3ð
 
ó3óð MQðØðØ!ðØ-0ðØEIðà	óó$	%óNóOóNóOóNóOóQóRóOóPóRóSóTóUóNóMóNóMóNóNóNóOó
NóOóMóNóNóOó
ó	
ó	
ó
ð*Ø'ð*Ø14ð*Ø?Bð*ØNQð*à	ó*ó
ó
-óJóYó*ó6-óGó?ó?ô?r=   r3   Úpandasc                ó‚   ‡ — t        ‰ t        «      sdt        ‰ «      › �}t        |«      ‚dˆ fd„}t	        |d‰ ›d�«      S )aï  
    Generate deferred object representing a column of a DataFrame.

    Any place which accepts ``lambda df: df[col_name]``, such as
    :meth:`DataFrame.assign` or :meth:`DataFrame.loc`, can also accept
    ``pd.col(col_name)``.

    .. versionadded:: 3.0.0

    Parameters
    ----------
    col_name : Hashable
        Column name.

    Returns
    -------
    `pandas.api.typing.Expression`
        A deferred object representing a column of a DataFrame.

    See Also
    --------
    DataFrame.query : Query columns of a dataframe using string expressions.

    Examples
    --------

    You can use `col` in `assign`.

    >>> df = pd.DataFrame({"name": ["beluga", "narwhal"], "speed": [100, 110]})
    >>> df.assign(name_titlecase=pd.col("name").str.title())
          name  speed name_titlecase
    0   beluga    100         Beluga
    1  narwhal    110        Narwhal

    You can also use it for filtering.

    >>> df.loc[pd.col("speed") > 105]
          name  speed
    1  narwhal    110
    zExpected Hashable, got: c                óÈ   •— ‰| j                   vrOt        | j                   j                  «       «      }d}t        |«      |kD  r|d | dz   }d‰› d|› d�}t	        |«      ‚| ‰   S )NéZ   z...]zColumn 'z;' not found in given DataFrame.

Hint: did you mean one of z	 instead?)Úcolumnsrî   ÚtolistÚlenÚ
ValueError)r7   Úcolumns_strÚmax_lenÚmsgÚcol_names       €r8   rY   zcol.<locals>.funcŸ  s   ø€ Ø˜2Ÿ:™:Ñ%Ü˜bŸj™j×/Ñ/Ó1Ó2ˆKØˆGÜ�;Ó 'Ò)Ø)¨(¨7Ð3°fÑ<�ð ˜8˜*ð %-Ø-8¨M¸ðDð ô ˜S“/Ð!Ø�(‰|Ðr=   zcol(rl   )r7   r   r¾   r   )r2   r   Útyperã   r3   )r   rÿ   rY   s   `  r8   Úcolr  q  sH   ø€ ôT �h¤Ô)Ø(¬¨h«Ð(8Ð9ˆÜ˜‹nÐõô �d˜d 8 ,¨aÐ0Ó1Ð1r=   r  N)r7   r   r;   r   r¾   ztuple[Any, ...])r7   r   r@   r   r¾   zdict[str, Any])r;   r   r@   r   r¾   rî   )r   r   r¾   r3   )Ú
__future__r   Úcollections.abcr   r   r   Útypingr   r   r	   Úpandas.util._decoratorsr
   rõ   r   r   Ú_OP_SYMBOLSr<   rC   rR   r3   r  Ú__all__rJ   r=   r8   Ú<module>r	     sl  ðÝ "÷ñ ÷
ñ õ /á÷ðØˆsðà�ðð ˆsðð �ð	ð
 ˆsðð �ðð �3ðð �Cðð �Dðð �Tðð ˆsðð �ðð ˆdðð ˆcðð ˆdðð  ˆcð!ð" ˆdð#ð$ ØØØØØØò1€ó8óó
ñ ÐÓ ÷]?ð ]?ó !ð]?ñ@	 ˆHÓò;2ó ð;2ð| ˜Ð
�r=   