Ë
    7Ò^jx”  ã                  óT  — U 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
 d dlZd dlmZmZ d dlmZ d dlmZmZmZ d dlmZmZ d d	lmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z% d d
l&m'Z(m)Z* d dl+m,Z,m-Z- d dl.m/Z0 d dl1m2Z2m3Z3m4Z4 d dl5m6Z7 d dl8m9Z: d dl;m<Z<m=Z=m>Z> d dl?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\ d dl]m^Z^m_Z_m`Z`maZambZbmcZcmdZdmeZe d dlfmgZgmhZhmiZi er�d dljmkZkmlZlmmZmmnZn d dlompZp d dlqmrZrmsZsmtZt d dlmuZu d dlvmwZxmyZzm{Z|m}Z~mZ€m�Z‚mƒZ„m…Z†m‡Z‡mˆZˆm‰Z‰mŠZ‹mŒZ�mŽZ�m�Z‘ d dl’m“Z“m”Z”m•Z•m–Z–m—Z—m˜Z˜m™Z™ d dl&mšZšm›Z› d dlœm�Z�mžZžmŸZŸm Z m¡Z¡m¢Z¢m£Z£m¤Z¤m¥Z¥m¦Z¦  ede¬«      Z§ erd«      Z¨ ed«      Z© G d „ d!e(e_   «      Z' G d"„ d#e*ea   «      Z) G d$„ d%e:ec   «      Z9 G d&„ d'e0«      Z/ G d(„ d)e7«      Z6e
dˆd*„«       Zªe
d‰d+„«       Zªe
dŠd,„«       Zªe
d‹d-„«       Zª	 	 	 	 dŒd.„Zªe
d�d/„«       Z«e
dŽd0„«       Z«e
d�d1„«       Z«e
d�d2„«       Z«e
	 	 	 	 	 	 d‘d3„«       Z«e
	 	 	 	 	 	 d’d4„«       Z«e
d“d5„«       Z«e
	 	 	 	 	 	 d”d6„«       Z«e
	 	 	 	 	 	 d•d7„«       Z«e
	 	 	 	 	 	 d–d8„«       Z«e
	 	 	 	 	 	 d—d9„«       Z«e
	 	 	 	 	 	 d˜d:„«       Z«e
	 	 	 	 	 	 d™d;„«       Z«e
	 	 	 	 	 	 dšd<„«       Z«e
	 	 	 	 	 	 d›d=„«       Z«e
	 	 	 	 	 	 dœd>„«       Z«e
	 	 	 	 	 	 d�d?„«       Z«e
	 	 	 	 	 	 džd@„«       Z«e
	 	 	 	 	 	 dŸdA„«       Z«e
	 	 	 	 	 	 d dB„«       Z«e
d¡dC„«       Z«e
d¢dD„«       Z«e
dEdFœ	 	 	 	 	 	 	 	 	 	 	 	 	 d£dG„«       Z«dddEdEdEddHœ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d¤dI„Z«e
dJdKœ	 	 	 	 	 d¥dL„«       Z¬e
dJdKœ	 	 	 	 	 d¦dM„«       Z¬e
dJdKœ	 	 	 	 	 d§dN„«       Z¬e
d¨dO„«       Z¬e
dJdPœ	 	 	 	 	 d©dQ„«       Z¬e
dJdPœ	 	 	 	 	 dªdR„«       Z¬e
dJdPœ	 	 	 	 	 d«dS„«       Z¬e
d¬dT„«       Z¬dddUœ	 	 	 	 	 	 	 d­dV„Z¬	 d®dddEdEdEdWdHœ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d¯dX„Z­d°dY„Z®d±dZ„Z¯d±d[„Z°d²d\„Z±d°d]„Z²d®d³d^„Z³d´d_„Z´d´d`„Zµd´da„Z¶d´db„Z·d´dc„Z¸dµdd„Z¹dEdeœ	 	 	 	 	 d¶df„ZºdEdeœ	 	 	 	 	 d¶dg„Z»dµdh„Z¼dµdi„Z½dµdj„Z¾	 d·	 	 	 	 	 	 	 d¸dk„Z¿dldmœd¹dn„ZÀdodEdpœ	 	 	 	 	 	 	 	 	 dºdq„ZÁd»dr„ZÂd¼ds„ZÃ	 	 	 	 d½dt„ZÄ G du„ dve�jŠ                  «      ZÅ G dw„ dxe�jŒ                  e/«      ZÆd¾dy„ZÇ edW¬z«      	 d®ddd{œ	 	 	 	 	 	 	 	 	 	 	 d¿d|„«       ZÈ edW¬z«      ddd{œ	 	 	 	 	 	 	 dÀd}„«       ZÉ e«       	 d®ddd{œ	 	 	 	 	 	 	 	 	 dÁd~„«       ZÊe'�j–                  ZËdeÌd€<    edW¬z«      	 d®ddd{œ	 	 	 	 	 	 	 	 	 dÂd�„«       ZÍ edW¬z«      ddd{œ	 	 	 	 	 	 	 	 	 dÃd‚„«       ZÎ edW¬z«      ddd{œ	 	 	 	 	 	 	 	 	 dÄdƒ„«       ZÏ edW¬z«      ddd{œ	 	 	 	 	 	 	 	 	 dÃd„„«       ZÐ edW¬z«      ddd{œ	 	 	 	 	 	 	 	 	 dÄd…„«       ZÑdÅd†„ZÒg d‡¢ZÓy)Æé    )Úannotations©Úwraps)ÚTYPE_CHECKINGÚAnyÚFinalÚLiteralÚcastÚoverloadN)Ú
exceptionsÚ	functions)Úissue_warning)ÚExprKindÚExprNodeÚis_expr)ÚTypeVarÚassert_never)ÚImplementationÚVersionÚdeprecate_native_namespaceÚgenerate_temporary_column_nameÚinherit_docÚis_ordered_categoricalÚmaybe_align_indexÚmaybe_convert_dtypesÚmaybe_get_indexÚmaybe_reset_indexÚmaybe_set_indexÚvalidate_strict_and_pass_though)Ú	DataFrameÚ	LazyFrame)ÚInvalidIntoExprErrorÚNarwhalsUnstableWarning)ÚExpr)Ú_new_series_implÚconcatÚshow_versions)ÚSchema)ÚSeries)ÚdependenciesÚdtypesÚ	selectors)ÚArrayÚBinaryÚBooleanÚCategoricalÚDateÚDatetimeÚDecimalÚDurationÚEnumÚFieldÚFloat16ÚFloat32ÚFloat64ÚInt8ÚInt16ÚInt32ÚInt64ÚInt128ÚListÚObjectÚStringÚStructÚTimeÚUInt8ÚUInt16ÚUInt32ÚUInt64ÚUInt128ÚUnknown)Ú
DataFrameTÚIntoDataFrameTÚ	IntoFrameÚIntoLazyFrameTÚ
IntoSeriesÚIntoSeriesTÚ
LazyFrameTÚSeriesT)Ú_from_native_implÚget_native_namespaceÚto_py_scalar)ÚCallableÚIterableÚMappingÚSequence)Ú
ModuleType)Ú	ParamSpecÚSelfÚUnpack)ÚExprMetadata)ÚAllowAnyStrictV1Ú
AllowAnyV1ÚAllowLazyStrictV1ÚAllowLazyV1ÚAllowSeriesStrictV1ÚAllowSeriesV1ÚExcludeSeriesStrictV1ÚExcludeSeriesV1ÚIntoArrowTableÚOnlyEagerOrInterchangeÚOnlyEagerOrInterchangeStrictÚOnlySeriesStrictV1ÚOnlySeriesV1ÚPassThroughUnknownV1ÚStrictUnknownV1)ÚArrowÚBackendÚEagerAllowedÚIntoBackendÚLazyAllowedÚPandasÚPolars)ÚMultiColSelectorÚMultiIndexSelector)
Ú
FileSourceÚ	IntoDTypeÚIntoExprÚ
IntoSchemaÚNonNestedLiteralÚPythonLiteralÚSingleColSelectorÚSingleIndexSelectorÚ_1DArrayÚ_2DArrayÚT)ÚdefaultÚPÚRc                  ó  ‡ — e Zd Zej                  Z ee«      dˆ fd„«       Ze		 	 	 	 	 	 dˆ fd„«       Z
e		 dddœ	 	 	 	 	 	 	 dˆ fd„«       Ze		 d	 	 	 	 	 	 	 dˆ fd„«       Ze		 d	 	 	 	 	 	 	 d ˆ fd„«       Zed!d„«       Zed"d	„«       Zed#d
„«       Ze	 	 	 	 d$d„«       Ze	 	 	 	 d%d„«       Z	 	 	 	 d&ˆ fd„Zd'ˆ fd„Z	 dddœ	 	 	 	 	 d(ˆ fd„Zeddœd)d„«       Zed*d„«       Zeddœ	 	 	 d+d„«       Zddœ	 	 	 d+ˆ fd„Zd,ˆ fd„Zd,ˆ fd„Zd-d„Zˆ xZS ).r    c               ód   •— |j                   t        j                  u sJ ‚t        ‰| �  ||¬«       y ©N)Úlevel©Ú_versionr   ÚV1ÚsuperÚ__init__©ÚselfÚdfr‡   Ú	__class__s      €úf/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/narwhals/stable/v1/__init__.pyrŒ   zDataFrame.__init__ƒ   ó+   ø€ à�{‰{œgŸj™jÑ(Ð(Ð(Ü‰Ñ˜ 5ÐÕ)ó    c               ó>   •— t         ‰| �  ||¬«      }t        d|«      S ©N©ÚbackendúDataFrame[Any])r‹   Ú
from_arrowr
   )ÚclsÚnative_framer—   Úresultr�   s       €r‘   r™   zDataFrame.from_arrow‹   s'   ø€ ô ‘Ñ# L¸'Ð#ÓBˆÜÐ$ fÓ-Ð-r“   Nr–   c               ó@   •— t         ‰| �  |||¬«      }t        d|«      S r•   )r‹   Ú	from_dictr
   ©rš   ÚdataÚschemar—   rœ   r�   s        €r‘   rž   zDataFrame.from_dict’   s)   ø€ ô ‘Ñ" 4¨¸Ð"ÓAˆÜÐ$ fÓ-Ð-r“   c               ó@   •— t         ‰| �  |||¬«      }t        d|«      S r•   )r‹   Ú
from_dictsr
   rŸ   s        €r‘   r£   zDataFrame.from_dicts�   ó)   ø€ ô ‘Ñ# D¨&¸'Ð#ÓBˆÜÐ$ fÓ-Ð-r“   c               ó@   •— t         ‰| �  |||¬«      }t        d|«      S r•   ©r‹   Ú
from_numpyr
   rŸ   s        €r‘   r§   zDataFrame.from_numpy¨   r¤   r“   c                ó"   — t        dt        «      S )Nútype[Series[Any]])r
   r)   ©rŽ   s    r‘   Ú_serieszDataFrame._series³   s   € äÐ'¬Ó0Ð0r“   c                ó"   — t        dt        «      S )Nútype[LazyFrame[Any]])r
   r!   rª   s    r‘   Ú
_lazyframezDataFrame._lazyframe·   s   € äÐ*¬IÓ6Ð6r“   c                 ó   — y ©N© ©rŽ   Úitems     r‘   Ú__getitem__zDataFrame.__getitem__»   ó   € ØWZr“   c                 ó   — y r°   r±   r²   s     r‘   r´   zDataFrame.__getitem__¾   s   € ð r“   c                 ó   — y r°   r±   r²   s     r‘   r´   zDataFrame.__getitem__Ã   s   € ð r“   c                ó"   •— t         ‰| �  |«      S r°   )r‹   r´   )rŽ   r³   r�   s     €r‘   r´   zDataFrame.__getitem__Î   s   ø€ ô ‰wÑ" 4Ó(Ð(r“   c                ó"   •— t         ‰| �  |«      S r°   )r‹   Ú
get_column)rŽ   Únamer�   s     €r‘   rº   zDataFrame.get_columnÝ   s   ø€ ô ‰wÑ! $Ó'Ð'r“   )Úsessionc               ó8   •— t        t        ‰| �	  ||¬«      «      S )N)r—   r¼   )Ú
_stableifyr‹   Úlazy)rŽ   r—   r¼   r�   s      €r‘   r¿   zDataFrame.lazyâ   s   ø€ ô œ%™'™,¨wÀ˜,ÓHÓIÐIr“   .©Ú	as_seriesc                ó   — y r°   r±   ©rŽ   rÁ   s     r‘   Úto_dictzDataFrame.to_dictê   s   € ØTWr“   c                ó   — y r°   r±   rÃ   s     r‘   rÄ   zDataFrame.to_dictì   s   € ØMPr“   Tc                ó   — y r°   r±   rÃ   s     r‘   rÄ   zDataFrame.to_dictî   s   € ð 9<r“   c               ó$   •— t         ‰| �  |¬«      S )NrÀ   )r‹   rÄ   )rŽ   rÁ   r�   s     €r‘   rÄ   zDataFrame.to_dictò   s   ø€ ô
 ‰w‰¨ˆÓ3Ð3r“   c                ó2   •— t        t        ‰| �	  «       «      S r°   )r¾   r‹   Úis_duplicated©rŽ   r�   s    €r‘   rÉ   zDataFrame.is_duplicatedù   s   ø€ Üœ%™'Ñ/Ó1Ó2Ð2r“   c                ó2   •— t        t        ‰| �	  «       «      S r°   )r¾   r‹   Ú	is_uniquerÊ   s    €r‘   rÌ   zDataFrame.is_uniqueü   s   ø€ Üœ%™'Ñ+Ó-Ó.Ð.r“   c                óP   — | j                  t        «       j                  «       «      S r°   ©ÚselectÚallÚ_l1_normrª   s    r‘   rÑ   zDataFrame._l1_normÿ   ó   € à�{‰{œ3›5Ÿ>™>Ó+Ó,Ð,r“   ©r�   r   r‡   ú&Literal['full', 'lazy', 'interchange']ÚreturnÚNone)r›   rf   r—   úIntoBackend[EagerAllowed]rÕ   r˜   r°   )r    úMapping[str, Any]r¡   ú2IntoSchema | Mapping[str, IntoDType | None] | Noner—   ú IntoBackend[EagerAllowed] | NonerÕ   r˜   )r    zSequence[Any]r¡   rÙ   r—   r×   rÕ   r˜   )r    r   r¡   ú!IntoSchema | Sequence[str] | Noner—   r×   rÕ   r˜   )rÕ   r©   )rÕ   r­   )r³   z-tuple[SingleIndexSelector, SingleColSelector]rÕ   r   )r³   z2str | tuple[MultiIndexSelector, SingleColSelector]rÕ   úSeries[Any])r³   z˜SingleIndexSelector | MultiIndexSelector | MultiColSelector | tuple[SingleIndexSelector, MultiColSelector] | tuple[MultiIndexSelector, MultiColSelector]rÕ   r[   )r³   a  SingleIndexSelector | SingleColSelector | MultiColSelector | MultiIndexSelector | tuple[SingleIndexSelector, SingleColSelector] | tuple[SingleIndexSelector, MultiColSelector] | tuple[MultiIndexSelector, SingleColSelector] | tuple[MultiIndexSelector, MultiColSelector]rÕ   zSeries[Any] | Self | Any)r»   ÚstrrÕ   r)   )r—   zIntoBackend[LazyAllowed] | Noner¼   z
Any | NonerÕ   úLazyFrame[Any])rÁ   zLiteral[True]rÕ   zdict[str, Series[Any]])rÁ   zLiteral[False]rÕ   zdict[str, list[Any]])rÁ   ÚboolrÕ   z-dict[str, Series[Any]] | dict[str, list[Any]])rÕ   rÜ   ©rÕ   r[   )Ú__name__Ú
__module__Ú__qualname__r   rŠ   r‰   r   ÚNwDataFramerŒ   Úclassmethodr™   rž   r£   r§   Úpropertyr«   r®   r   r´   rº   r¿   rÄ   rÉ   rÌ   rÑ   Ú__classcell__©r�   s   @r‘   r    r    €   s`  ø„ Ø�z‰z€Há�Óô*ó ð*ð ð.Ø)ð.Ø7Pð.à	ô.ó ð.ð ð FJð.ð
 59ñ.àð.ð Cð.ð
 2ð.ð 
ô.ó ð.ð ð FJð.àð.ð Cð.ð
 +ð.ð 
ô.ó ð.ð ð 59ð.àð.ð 2ð.ð
 +ð.ð 
ô.ó ð.ð ò1ó ð1ð ò7ó ð7ð ÚZó ØZàðØFðà	òó ðð ð	ð:ð	ð 
ò	ó ð	ð)ð:ð)ð 
"õ)õ(ð 48ðJð #ñ	Jà0ðJð ð	Jð
 
õJð Ø47ÔWó ØWØÚPó ØPØà#'ñ<Ø ð<à	6ò<ó ð<ð $(ñ4Ø ð4à	6õ4õ3õ/÷-r“   r    c                  ó¾   ‡ — e Zd Zej                  Z ee«      dˆ fd„«       Ze	dd„«       Z
dd„Z	 d	 	 	 	 	 dˆ fd„Zdd„Zddˆ fd„Zddd„Z	 ddd	œ	 	 	 	 	 dd
„Zˆ xZS )r!   c               ód   •— |j                   t        j                  u sJ ‚t        ‰| �  ||¬«       y r†   rˆ   r�   s      €r‘   rŒ   zLazyFrame.__init__  r’   r“   c                ó   — t         S r°   ©r    rª   s    r‘   Ú
_dataframezLazyFrame._dataframe  ó   € äÐr“   c                 ó   — y r°   r±   )rŽ   Úmetadatas     r‘   Ú_validate_metadatazLazyFrame._validate_metadata  s   € àr“   Nc                ó8   •— t        t        ‰| �  dd|i|¤Ž«      S )Nr—   r±   )r¾   r‹   Úcollect)rŽ   r—   Úkwargsr�   s      €r‘   ró   zLazyFrame.collect  s!   ø€ ô œ%™'™/ÑD°'ÐD¸VÑDÓEÐEr“   c                óP   — | j                  t        «       j                  «       «      S r°   rÎ   rª   s    r‘   rÑ   zLazyFrame._l1_norm  rÒ   r“   c                ó"   •— t         ‰| �  |«      S )úGet the last `n` rows.)r‹   Útail)rŽ   Únr�   s     €r‘   rø   zLazyFrame.tail  s   ø€ ä‰w‰|˜A‹Ðr“   c                óZ   — | j                  | j                  j                  ||¬«      «      S )z«Take every nth row in the DataFrame and return as a new DataFrame.

        Arguments:
            n: Gather every *n*-th row.
            offset: Starting index.
        ©rù   Úoffset)Ú_with_compliantÚ_compliant_frameÚgather_every©rŽ   rù   rü   s      r‘   rÿ   zLazyFrame.gather_every!  s0   € ð ×#Ñ#Ø×!Ñ!×.Ñ.°¸6Ð.ÓBó
ð 	
r“   )Úorder_byc               ó„   — t        |t        «      r|gn|}| j                  | j                  j	                  ||¬«      «      S )N)r»   r  )Ú
isinstancerÝ   rý   rþ   Úwith_row_index)rŽ   r»   r  Ú	order_by_s       r‘   r  zLazyFrame.with_row_index,  sH   € ô #-¨X´sÔ";�X‘JÀˆ	Ø×#Ñ#Ø×!Ñ!×0Ñ0ØØ"ð 1ó ó
ð 	
r“   rÓ   ©rÕ   ztype[DataFrame[Any]])rð   r]   rÕ   rÖ   r°   )r—   z+IntoBackend[Polars | Pandas | Arrow] | Nonerô   r   rÕ   r˜   rà   )é   ©rù   ÚintrÕ   r[   ©r   ©rù   r	  rü   r	  rÕ   r[   )Úindex)r»   rÝ   r  zstr | Sequence[str] | NonerÕ   r[   )rá   râ   rã   r   rŠ   r‰   r   ÚNwLazyFramerŒ   ræ   rí   rñ   ró   rÑ   rø   rÿ   r  rç   rè   s   @r‘   r!   r!     s�   ø„ Ø�z‰z€Há�Óô*ó ð*ð òó ðóð
 FJðFØBðFØUXðFà	õFó
-öô	
ð "ð	
ØMQñ	
Øð	
Ø0Jð	
à	÷	
r“   r!   c                  ó2  ‡ — e Zd Zej                  Z ee«      	 	 	 	 	 	 dˆ fd„«       Ze		 d	 	 	 	 	 	 	 	 	 dˆ fd„«       Z
e		 d	 	 	 	 	 	 	 	 	 dˆ fd„«       Zedd„«       Zdˆ fd„Zdddddœ	 	 	 	 	 	 	 	 	 dˆ fd	„Z	 ddd
dœ	 	 	 	 	 	 	 dˆ fd„Zddœdˆ fd„Zˆ xZS )r)   c               ód   •— |j                   t        j                  u sJ ‚t        ‰| �  ||¬«       y r†   rˆ   )rŽ   Úseriesr‡   r�   s      €r‘   rŒ   zSeries.__init__;  s-   ø€ ð �‰¤'§*¡*Ñ,Ð,Ð,Ü‰Ñ˜ uÐÕ-r“   Nc               óB   •— t         ‰| �  ||||¬«      }t        d|«      S ©Nr–   rÜ   r¦   ©rš   r»   ÚvaluesÚdtyper—   rœ   r�   s         €r‘   r§   zSeries.from_numpyE  s*   ø€ ô ‘Ñ# D¨&°%ÀÐ#ÓIˆÜ�M 6Ó*Ð*r“   c               óB   •— t         ‰| �  ||||¬«      }t        d|«      S r  )r‹   Úfrom_iterabler
   r  s         €r‘   r  zSeries.from_iterableQ  s*   ø€ ô ‘Ñ& t¨V°UÀGÐ&ÓLˆÜ�M 6Ó*Ð*r“   c                ó   — t         S r°   rì   rª   s    r‘   rí   zSeries._dataframe]  rî   r“   c                ó2   •— t        t        ‰| �	  «       «      S r°   )r¾   r‹   Úto_framerÊ   s    €r‘   r  zSeries.to_framea  s   ø€ Üœ%™'Ñ*Ó,Ó-Ð-r“   F©ÚsortÚparallelr»   Ú	normalizec               ó<   •— t        t        ‰| �	  ||||¬«      «      S )Nr  )r¾   r‹   Úvalue_counts)rŽ   r  r  r»   r  r�   s        €r‘   r   zSeries.value_countsd  s-   ø€ ô Ü‰GÑ Ø H°4À9ð !ó ó
ð 	
r“   T)Ú	bin_countÚinclude_breakpointc               ó^   •— d}t        |t        «       t        t        ‰| �  |||¬«      «      S )NzZ`Series.hist` is being called from the stable API although considered an unstable feature.)Úbinsr!  r"  )r   r#   r¾   r‹   Úhist)rŽ   r$  r!  r"  Úmsgr�   s        €r‘   r%  zSeries.histr  s@   ø€ ð#ð 	ô 	�cÔ2Ô3ÜÜ‰G‰LØ YÐCUð ó ó
ð 	
r“   ©Úignore_nullsc               óH   •— d}t        |t        «       t        ‰| �  |¬«      S )Nz_`Series.any_value` is being called from the stable API although considered an unstable feature.r'  )r   r#   r‹   Ú	any_value)rŽ   r(  r&  r�   s      €r‘   r*  zSeries.any_value„  s-   ø€ ð#ð 	ô 	�cÔ2Ô3Ü‰wÑ ¨lÐ Ó;Ð;r“   )r  r   r‡   rÔ   rÕ   rÖ   r°   )
r»   rÝ   r  r~   r  úIntoDType | Noner—   r×   rÕ   rÜ   )
r»   rÝ   r  zIterable[Any]r  r+  r—   r×   rÕ   rÜ   r  )rÕ   r˜   )
r  rß   r  rß   r»   z
str | Noner  rß   rÕ   r˜   )r$  zlist[float] | Noner!  ú
int | Noner"  rß   rÕ   r˜   )r(  rß   rÕ   r{   )rá   râ   rã   r   rŠ   r‰   r   ÚNwSeriesrŒ   rå   r§   r  ræ   rí   r  r   r%  r*  rç   rè   s   @r‘   r)   r)   8  sw  ø„ Ø�z‰z€Há�Óð.Øð.Ø%Kð.à	ô.ó ð.ð ð
 #'ð		+àð	+ð ð	+ð  ð		+ð +ð	+ð 
ô	+ó ð	+ð ð
 #'ð		+àð	+ð ð	+ð  ð		+ð +ð	+ð 
ô	+ó ð	+ð òó ðõ.ð ØØØñ
ð ð
ð ð	
ð
 ð
ð ð
ð 
õ
ð  $(ð
ð !%Ø#'ñ
à ð
ð ð	
ð
 !ð
ð 
õ
ð$ 16÷ <ó <r“   r)   c                  óº   ‡ — e Zd Zdˆ fd„Zddd„Zddd„Zddd„Zddœdd„Zddd	œdd
„Zdd„Z	dd„Z
dd„Zdd„Zdd„Z	 dddddœ	 	 	 	 	 	 	 	 	 dd„Zddœdd„Zˆ xZS )r$   c                ó    •— t         ‰| �  «       S r°   )r‹   Ú_taxicab_normrÊ   s    €r‘   rÑ   zExpr._l1_normŽ  s   ø€ Ü‰wÑ$Ó&Ð&r“   c                óX   — | j                  t        t        j                  d|¬«      «      S )zGet the first `n` rows.Úhead©rù   ©Ú_append_noder   r   ÚORDERABLE_FILTRATION©rŽ   rù   s     r‘   r2  z	Expr.head‘  ó#   € à× Ñ ¤¬(×*GÑ*GÈÐSTÔ!UÓVÐVr“   c                óX   — | j                  t        t        j                  d|¬«      «      S )r÷   rø   r3  r4  r7  s     r‘   rø   z	Expr.tail•  r8  r“   c                óZ   — | j                  t        t        j                  d||¬«      «      S )z¥Take every nth value in the Series and return as new Series.

        Arguments:
            n: Gather every *n*-th row.
            offset: Starting index.
        rÿ   rû   r4  r   s      r‘   rÿ   zExpr.gather_every™  s,   € ð × Ñ Ü”X×2Ñ2°NÀaÐPVÔWó
ð 	
r“   N)Úmaintain_orderc               ó|   — |�d}t        |t        «       | j                  t        t        j
                  d«      «      S )z(Return unique values of this expression.zx`maintain_order` has no effect and is only kept around for backwards-compatibility. You can safely remove this argument.Úunique)r   ÚUserWarningr5  r   r   Ú
FILTRATION)rŽ   r;  r&  s      r‘   r=  zExpr.unique¤  s<   € àÐ%ð7ð ô ˜#œ{Ô+Ø× Ñ ¤¬(×*=Ñ*=¸xÓ!HÓIÐIr“   F©Ú
descendingÚ
nulls_lastc               óZ   — | j                  t        t        j                  d||¬«      «      S )z*Sort this column. Place null values first.r  r@  )r5  r   r   ÚWINDOW)rŽ   rA  rB  s      r‘   r  z	Expr.sort®  s*   € à× Ñ ÜÜ—‘ °JÈ:ôó
ð 	
r“   c                óT   — | j                  t        t        j                  d«      «      S )z'Returns the index of the maximum value.Úarg_max©r5  r   r   ÚORDERABLE_AGGREGATIONrª   s    r‘   rF  zExpr.arg_max¶  ó    € à× Ñ ¤¬(×*HÑ*HÈ)Ó!TÓUÐUr“   c                óT   — | j                  t        t        j                  d«      «      S )z'Returns the index of the minimum value.Úarg_minrG  rª   s    r‘   rK  zExpr.arg_minº  rI  r“   c                óT   — | j                  t        t        j                  d«      «      S )z/Find elements where boolean expression is True.Úarg_truer4  rª   s    r‘   rM  zExpr.arg_true¾  s    € à× Ñ ¤¬(×*GÑ*GÈÓ!TÓUÐUr“   c                óT   — | j                  t        t        j                  d«      «      S )zGet the first value.ÚfirstrG  rª   s    r‘   rO  z
Expr.firstÂ  s    € à× Ñ ¤¬(×*HÑ*HÈ'Ó!RÓSÐSr“   c                óT   — | j                  t        t        j                  d«      «      S )zGet the last value.ÚlastrG  rª   s    r‘   rQ  z	Expr.lastÆ  s    € à× Ñ ¤¬(×*HÑ*HÈ&Ó!QÓRÐRr“   )ÚfractionÚwith_replacementÚseedc          
     ó^   — | j                  t        t        j                  d||||¬«      «      S )aµ  Sample randomly from this expression.

        Arguments:
            n: Number of items to return. Cannot be used with fraction.
            fraction: Fraction of items to return. Cannot be used with n.
            with_replacement: Allow values to be sampled more than once.
            seed: Seed for the random number generator. If set to None (default), a random
                seed is generated for each sample operation.
        Úsample)rù   rR  rS  rT  )r5  r   r   r?  )rŽ   rù   rR  rS  rT  s        r‘   rV  zExpr.sampleÊ  s7   € ð" × Ñ ÜÜ×#Ñ#ØØØ!Ø!1Øôó	
ð 		
r“   r'  c               ó|   — d}t        |t        «       | j                  t        t        j
                  d|¬«      «      S )Nz]`Expr.any_value` is being called from the stable API although considered an unstable feature.r*  r'  )r   r#   r5  r   r   ÚAGGREGATION)rŽ   r(  r&  s      r‘   r*  zExpr.any_valueæ  s>   € ð#ð 	ô 	�cÔ2Ô3Ø× Ñ Ü”X×)Ñ)¨;À\ÔRó
ð 	
r“   rà   )é
   r  r
  r  )r;  úbool | NonerÕ   r[   )rA  rß   rB  rß   rÕ   r[   r°   )
rù   r,  rR  zfloat | NonerS  rß   rT  r,  rÕ   r[   )r(  rß   rÕ   r[   )rá   râ   rã   rÑ   r2  rø   rÿ   r=  r  rF  rK  rM  rO  rQ  rV  r*  rç   rè   s   @r‘   r$   r$   �  s§   ø„ õ'ôWôWô	
ð 7;õ Jð */À5õ 
óVóVóVóTóSð ð
ð "&Ø!&Øñ
àð
ð ð	
ð
 ð
ð ð
ð 
ó
ð8 16÷ 
ñ 
r“   r$   c                  ó$   — e Zd Zej                  Zy)r(   N)rá   râ   rã   r   rŠ   r‰   r±   r“   r‘   r(   r(   ñ  s   „ Ø�z‰z�Hr“   r(   c                 ó   — y r°   r±   ©Úobjs    r‘   r¾   r¾   õ  ó   € ØORr“   c                 ó   — y r°   r±   r]  s    r‘   r¾   r¾   ÷  r_  r“   c                 ó   — y r°   r±   r]  s    r‘   r¾   r¾   ù  ó   € ØCFr“   c                 ó   — y r°   r±   r]  s    r‘   r¾   r¾   û  s   € Ø%(r“   c                ó2  — t        | t        «      r>t        | j                  j	                  t
        j                  «      | j                  ¬«      S t        | t        «      r>t        | j                  j	                  t
        j                  «      | j                  ¬«      S t        | t        «      r>t        | j                  j	                  t
        j                  «      | j                  ¬«      S t        | t        «      rt        | j                  Ž S t!        | «       y r†   )r  rä   r    rþ   Ú_with_versionr   rŠ   Ú_levelr  r!   r-  r)   Ú_compliant_seriesÚNwExprr$   Ú_nodesr   r]  s    r‘   r¾   r¾   ÿ  sµ   € ô �#”{Ô#Ü˜×-Ñ-×;Ñ;¼G¿J¹JÓGÈsÏzÉzÔZÐZÜ�#”{Ô#Ü˜×-Ñ-×;Ñ;¼G¿J¹JÓGÈsÏzÉzÔZÐZÜ�#”xÔ Ü�c×+Ñ+×9Ñ9¼'¿*¹*ÓEÈSÏZÉZÔXÐXÜ�#”vÔÜ�S—Z‘ZÐ Ð Ü�Õr“   c                 ó   — y r°   r±   ©Únative_objectÚkwdss     r‘   Úfrom_nativern    s   € ØPSr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn    s   € ØVYr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn    s   € ØQTr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn    rµ   r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn    ó   € ð r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn    rs  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn     s   € ØUXr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  "  rs  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  &  ó   € ð !$r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  *  rx  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  .  rx  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  2  rx  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  6  ó   € ð r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  :  r}  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  >  ó   € ð 7:r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  B  r€  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  F  rx  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  J  rx  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  N  s	   € ð SVr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  R  s	   € ð SVr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  W  s   € ØLOr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  Y  s   € ØGJr“   F)Úeager_or_interchange_onlyc                ó   — y r°   r±   )rl  Úpass_throughÚ
eager_onlyrˆ  Úseries_onlyÚallow_seriess         r‘   rn  rn  ^  s   € ð r“   )ÚstrictrŠ  r‹  rˆ  rŒ  r�  c          	     ó  — t        | t        t        f«      r|s| S t        | t        «      r|s|r| S t	        ||d¬«      }|r"dt        t        |«      «      ›�}t        |«      ‚t        | |||||t        j                  ¬«      S )aC  Convert `native_object` to Narwhals Dataframe, Lazyframe, or Series.

    See `narwhals.from_native` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    F©Úpass_through_defaultz1from_native() got an unexpected keyword argument )rŠ  r‹  rˆ  rŒ  r�  Úversion)r  r    r!   r)   r   ÚnextÚiterÚ	TypeErrorrR   r   rŠ   )	rl  rŽ  rŠ  r‹  rˆ  rŒ  r�  rm  r&  s	            r‘   rn  rn  j  s‹   € ô. �-¤)¬YÐ!7Ô8ÁØÐÜ�-¤Ô(©k¹\ØÐä2Ø�°5ô€Lñ ØAÄ$ÄtÈDÃzÓBRÐAUÐVˆÜ˜‹nÐäØØ!ØØ";ØØ!Ü—
‘
ôð r“   .)rŽ  c                ó   — y r°   r±   ©Únarwhals_objectrŽ  s     r‘   Ú	to_nativer™  ˜  ó   € ð r“   c                ó   — y r°   r±   r—  s     r‘   r™  r™  œ  rš  r“   c                ó   — y r°   r±   r—  s     r‘   r™  r™     ó   € ð r“   c                ó   — y r°   r±   r—  s     r‘   r™  r™  ¤  s   € Ø=@r“   ©rŠ  c                ó   — y r°   r±   ©r˜  rŠ  s     r‘   r™  r™  ¦  ó   € ð
 r“   c                ó   — y r°   r±   r¡  s     r‘   r™  r™  ¬  r¢  r“   c                ó   — y r°   r±   r¡  s     r‘   r™  r™  ²  r�  r“   c                ó   — y r°   r±   r¡  s     r‘   r™  r™  ¶  rb  r“   )rŽ  rŠ  c               óR   — ddl m}  |||d¬«      }t        j                  | |¬«      S )a#  Convert Narwhals object to native one.

    See `narwhals.to_native` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    r   ©r   Fr�  rŸ  )Únarwhals._utilsr   Únwr™  )r˜  rŽ  rŠ  r   s       r‘   r™  r™  º  s,   € õ @á2Ø�°5ô€Lô �<‰<˜°lÔCÐCr“   Tc               óT   ‡‡‡‡‡— t        |‰d¬«      Šdˆˆˆˆˆfd„}| €|S  || «      S )a1  Decorate function so it becomes dataframe-agnostic.

    See `narwhals.narwhalify` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    Tr�  c                ó<   •‡ — t        ‰ «      dˆˆˆˆ ˆˆfd„«       }|S )Nc                 óš  •— | D �cg c]  }t        |‰‰‰‰‰¬«      ‘Œ }}|j                  «       D ��ci c]  \  }}|t        |‰‰‰‰‰¬«      “Œ }}}g |¢|j                  «       ¢­D �ch c]  }t        |dd «      x}r |«       ’Œ }	}|	j	                  «       dkD  rd}
t        |
«      ‚ ‰|i |¤Ž}t        |‰¬«      S c c}w c c}}w c c}w )N)rŠ  r‹  rˆ  rŒ  r�  Ú__native_namespace__é   z_Found multiple backends. Make sure that all dataframe/series inputs come from the same backend.rŸ  )rn  Úitemsr  ÚgetattrÚ__len__Ú
ValueErrorr™  )Úargsrô   ÚargÚargs_nwr»   ÚvalueÚ	kwargs_nwÚvÚbÚbackendsr&  rœ   r�  r‹  rˆ  ÚfuncrŠ  rŒ  s               €€€€€€r‘   Úwrapperz.narwhalify.<locals>.decorator.<locals>.wrapperå  s  ø€ ð  ö
ð ô ØØ!-Ø)Ø.GØ +Ø!-öð
ˆGð 
ð* $*§<¡<£>÷
ñ  �D˜%ð ”kØØ!-Ø)Ø.GØ +Ø!-ôñ ð
ˆIñ 
ð 9˜7Ð8 Y×%5Ñ%5Ó%7Ñ8öàÜ  Ð$:¸DÓAÐA�AÐAñ •ðˆHð ð ×ÑÓ! AÒ%Øw�Ü  “oÐ%á˜7Ð0 iÑ0ˆFä˜V°,Ô?Ð?ùòI
ùó
ùòs   †B=³CÁ)C)r³  r   rô   r   rÕ   r   r   )r»  r¼  r�  r‹  rˆ  rŠ  rŒ  s   ` €€€€€r‘   Ú	decoratorznarwhalify.<locals>.decoratorä  s)   ù€ Ü	ˆt‹÷%	@ñ %	@ó 
ð%	@ðN ˆr“   )r»  úCallable[..., Any]rÕ   r¾  r§  )r»  rŽ  rŠ  r‹  rˆ  rŒ  r�  r½  s     ````` r‘   Ú
narwhalifyr¿  Ð  s8   ü€ ô  3Ø�°4ô€L÷)ñ )ðV €|ØÐá�T‹?Ðr“   c                 ó<   — t        t        j                  «       «      S r°   )r¾   r©  rÐ   r±   r“   r‘   rÐ   rÐ     ó   € Ü”b—f‘f“hÓÐr“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  Úcol©Únamess    r‘   rÃ  rÃ    s   € Ü”b—f‘f˜e�nÓ%Ð%r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  ÚexcluderÄ  s    r‘   rÇ  rÇ    s   € Ü”b—j‘j %Ð(Ó)Ð)r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  Únth)Úindicess    r‘   rÉ  rÉ  !  ó   € Ü”b—f‘f˜gÐ&Ó'Ð'r“   c                 ó<   — t        t        j                  «       «      S r°   )r¾   r©  Úlenr±   r“   r‘   rÍ  rÍ  %  rÁ  r“   c                ó@   — t        t        j                  | |«      «      S r°   )r¾   r©  Úlit)r¶  r  s     r‘   rÏ  rÏ  )  s   € Ü”b—f‘f˜U EÓ*Ó+Ð+r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  Úmin©Úcolumnss    r‘   rÑ  rÑ  -  rË  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  ÚmaxrÒ  s    r‘   rÕ  rÕ  1  rË  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  ÚmeanrÒ  s    r‘   r×  r×  5  s   € Ü”b—g‘g˜wÐ'Ó(Ð(r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  ÚmedianrÒ  s    r‘   rÙ  rÙ  9  s   € Ü”b—i‘i Ð)Ó*Ð*r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  ÚsumrÒ  s    r‘   rÛ  rÛ  =  rË  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  Úsum_horizontal©Úexprss    r‘   rÝ  rÝ  A  ó   € Ü”b×'Ñ'¨Ð/Ó0Ð0r“   r'  c                ó>   — t        t        j                  |d| iŽ«      S ©Nr(  )r¾   r©  Úall_horizontal©r(  rß  s     r‘   rã  rã  E  ó   € ô ”b×'Ñ'¨ÐJ¸\ÑJÓKÐKr“   c                ó>   — t        t        j                  |d| iŽ«      S râ  )r¾   r©  Úany_horizontalrä  s     r‘   rç  rç  K  rå  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  Úmean_horizontalrÞ  s    r‘   ré  ré  Q  s   € Ü”b×(Ñ(¨%Ð0Ó1Ð1r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  Úmin_horizontalrÞ  s    r‘   rë  rë  U  rà  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r©  Úmax_horizontalrÞ  s    r‘   rí  rí  Y  rà  r“   c                óD   — t        t        j                  | ||¬«      «      S )zãCompute the Pearson's or Spearman rank correlation between two columns.

    Arguments:
        a: Column name or Expression
        b: Column name or Expression
        method: Correlation method ('pearson' or 'spearman')
    )Úmethod)r¾   r©  Úcorr)Úar¹  rï  s      r‘   rð  rð  ]  s   € ô ”b—g‘g˜a ¨6Ô2Ó3Ð3r“   r®  ©Úddofc               óD   — t        t        j                  | ||¬«      «      S )a2  Compute the covariance between two columns.

    Arguments:
        a: Column name or Expression
        b: Column name or Expression
        ddof: "Delta Degrees of Freedom": the divisor used in the calculation is N - ddof,
            where N represents the number of elements. By default ddof is 1.
    rò  )r¾   r©  Úcov)rñ  r¹  ró  s      r‘   rõ  rõ  j  s   € ô ”b—f‘f˜Q ¨Ô-Ó.Ð.r“   Ú ©Ú	separatorr(  c               óH   — t        t        j                  | g|¢­||dœŽ«      S )Nr÷  )r¾   r©  Ú
concat_str)rß  rø  r(  Ú
more_exprss       r‘   rú  rú  v  s)   € ô Ü
�‰�eÐY˜jÑY°IÈLÒYóð r“   c                ó@   — t        t        j                  | g|¢­Ž «      S )zFormat expressions as a string.)r¾   r©  Úformat)Úf_stringr³  s     r‘   rý  rý  �  s   € ä”b—i‘i Ð0¨4Ò0Ó1Ð1r“   c                ó@   — t        t        j                  | g|¢­Ž «      S r°   )r¾   r©  Úcoalesce)rß  rû  s     r‘   r   r   †  s   € Ü”b—k‘k %Ð5¨*Ò5Ó6Ð6r“   c                ó   — | j                   S )a¡  Level of support Narwhals has for current object.

    Arguments:
        obj: Dataframe or Series.

    Returns:
        This can be one of

            - 'full': full Narwhals API support
            - 'lazy': only lazy operations are supported. This excludes anything
              which involves iterating over rows in Python.
            - 'interchange': only metadata operations are supported (`df.schema`)
    )rf  r]  s    r‘   Ú	get_levelr  Š  s   € ð  �:‰:Ðr“   c                  ó&   — e Zd Zedd„«       Zdd„Zy)ÚWhenc                ó*   —  | |j                   d¬«      S )Nr±   )Úchain)Ú
_predicate)rš   Úwhens     r‘   Ú	from_whenzWhen.from_whenž  s   € á�4—?‘?¨"Ô-Ð-r“   c                óf   — g | j                   ¢| j                  |f‘­}t        j                  |«      S r°   )Ú_chainr  ÚThenÚ_from_chain)rŽ   r¶  Ú	new_chains      r‘   Úthenz	When.then¢  s/   € Ø<�d—k‘kÐ< D§O¡O°UÐ#;Ñ<ˆ	Ü×Ñ 	Ó*Ð*r“   N)r  z	nw_f.WhenrÕ   r  )r¶  z&IntoExpr | NonNestedLiteral | _1DArrayrÕ   r  )rá   râ   rã   rå   r	  r  r±   r“   r‘   r  r  �  s   „ Øò.ó ð.ô+r“   r  c                  ó(   ‡ — e Zd Zdd„Zdˆ fd„Zˆ xZS )r  c                ó,   — t        |d| j                  iŽS )Nr  )r  r  )rŽ   Ú
predicatess     r‘   r  z	Then.when¨  s   € Ü�ZÐ3 t§{¡{Ñ3Ð3r“   c                ó4   •— t        t        ‰| �	  |«      «      S r°   )r¾   r‹   Ú	otherwise)rŽ   Úotherwise_valuer�   s     €r‘   r  zThen.otherwise«  s   ø€ Üœ%™'Ñ+¨OÓ<Ó=Ð=r“   ©r  úIntoExpr | Iterable[IntoExpr]rÕ   r  )r  zIntoExpr | NonNestedLiteralrÕ   r$   )rá   râ   rã   r  r  rç   rè   s   @r‘   r  r  §  s   ø„ ó4÷>ñ >r“   r  c                 óL   — t         j                  t        j                  | Ž «      S r°   )r  r	  Únw_fr  )r  s    r‘   r  r  ¯  s   € Ü�>‰>œ$Ÿ)™) ZÐ0Ó1Ð1r“   )Úrequired)r—   Únative_namespacec               óJ   — t        d|«      }t        t        | |||¬«      «      S )a=  Instantiate Narwhals Series from iterable (e.g. list or array).

    See `narwhals.new_series` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    r×   r–   )r
   r¾   r%   )r»   r  r  r—   r  s        r‘   Ú
new_seriesr  ³  s(   € ô Ð.°Ó8€GÜÔ& t¨V°UÀGÔLÓMÐMr“   c               óZ   — t        d|«      }t        t        j                  | |¬«      «      S )aJ  Construct a DataFrame from an object which supports the PyCapsule Interface.

    See `narwhals.from_arrow` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    r×   r–   )r
   r¾   r  r™   )r›   r—   r  s      r‘   r™   r™   Æ  s'   € ô Ð.°Ó8€GÜ”d—o‘o l¸GÔDÓEÐEr“   c               óD   — t        t        j                  | ||¬«      «      S )a#  Instantiate DataFrame from dictionary.

    See `narwhals.from_dict` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    r–   )r¾   r  rž   ©r    r¡   r—   r  s       r‘   rž   rž   ×  s   € ô ”d—n‘n T¨6¸7ÔCÓDÐDr“   r   r£   c               ó\   — t        d|«      }t        t        j                  | ||¬«      «      S )a)  Construct a DataFrame from a NumPy ndarray.

    See `narwhals.from_numpy` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    r×   r–   )r
   r¾   r  r§   r   s       r‘   r§   r§   ë  s)   € ô Ð.°Ó8€GÜ”d—o‘o d¨F¸GÔDÓEÐEr“   c               ó\   — t        d|«      }t        t        j                  | fd|i|¤Ž«      S )a  Read a CSV file into a DataFrame.

    See `narwhals.read_csv` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    r×   r—   )r
   r¾   r  Úread_csv©Úsourcer—   r  rô   s       r‘   r#  r#  ý  s/   € ô Ð.°Ó8€GÜ”d—m‘m FÑF°GÐF¸vÑFÓGÐGr“   c               ó\   — t        d|«      }t        t        j                  | fd|i|¤Ž«      S )a  Lazily read from a CSV file.

    See `narwhals.scan_csv` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    úIntoBackend[Backend]r—   )r
   r¾   r  Úscan_csvr$  s       r‘   r(  r(    s/   € ô Ð)¨7Ó3€GÜ”d—m‘m FÑF°GÐF¸vÑFÓGÐGr“   c               ó\   — t        d|«      }t        t        j                  | fd|i|¤Ž«      S )a*  Read into a DataFrame from a parquet file.

    See `narwhals.read_parquet` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    r×   r—   )r
   r¾   r  Úread_parquetr$  s       r‘   r*  r*  !  s1   € ô Ð.°Ó8€GÜ”d×'Ñ'¨ÑJ¸ÐJÀ6ÑJÓKÐKr“   c               ó\   — t        d|«      }t        t        j                  | fd|i|¤Ž«      S )a   Lazily read from a parquet file.

    See `narwhals.scan_parquet` for full docstring. Note that `native_namespace` is
    an is the same as `backend` but only accepts module types - for new code, we
    recommend using `backend`, as that's available beyond just `narwhals.stable.v1`.
    r'  r—   )r
   r¾   r  Úscan_parquetr$  s       r‘   r,  r,  3  s1   € ô Ð)¨7Ó3€GÜ”d×'Ñ'¨ÑJ¸ÐJÀ6ÑJÓKÐKr“   c                 ó>   — t        t        j                  | i |¤Ž«      S )aÖ  Collect columns into a struct column.

    Arguments:
        *exprs: Column(s) to collect into a struct column, specified as
            positional arguments. Accepts only expression input. Strings are parsed
            as column names, other non-expression inputs are not allowed.
        **named_exprs: Additional columns to collect into the struct column,
            specified as keyword arguments. The columns will be renamed to the
            keyword used.
    )r¾   r  Ústruct)rß  Únamed_exprss     r‘   r.  r.  E  s   € ô ”d—k‘k 5Ð8¨KÑ8Ó9Ð9r“   )Yr-   r.   r/   r0   r    r1   r2   r3   r4   r5   r$   r6   r7   r8   r9   r   r:   r;   r<   r=   r>   r"   r!   r?   r@   r(   r)   rA   rB   rC   rD   rE   rF   rG   rH   rI   rÐ   rã  rç  r   rÃ  r&   rú  rð  rõ  r*   r+   r   rÇ  rý  r™   rž   r£   rn  r§   r   r  rS   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™  rT   r  )r^  zNwDataFrame[IntoDataFrameT]rÕ   úDataFrame[IntoDataFrameT])r^  zNwLazyFrame[IntoLazyFrameT]rÕ   úLazyFrame[IntoLazyFrameT])r^  zNwSeries[IntoSeriesT]rÕ   úSeries[IntoSeriesT])r^  rh  rÕ   r$   )r^  zZNwDataFrame[IntoDataFrameT] | NwLazyFrame[IntoLazyFrameT] | NwSeries[IntoSeriesT] | NwExprrÕ   zRDataFrame[IntoDataFrameT] | LazyFrame[IntoLazyFrameT] | Series[IntoSeriesT] | Expr)rl  rQ   rm  úUnpack[OnlySeries]rÕ   rQ   )rl  rQ   rm  úUnpack[OnlySeriesStrict]rÕ   rQ   )rl  rQ   rm  úUnpack[AllowSeries]rÕ   rQ   )rl  rQ   rm  úUnpack[AllowSeriesStrict]rÕ   rQ   )rl  rJ   rm  úUnpack[ExcludeSeries]rÕ   rJ   )rl  rJ   rm  úUnpack[ExcludeSeriesStrict]rÕ   rJ   )rl  rP   rm  úUnpack[AllowLazy]rÕ   rP   )rl  rP   rm  úUnpack[AllowLazyStrict]rÕ   rP   )rl  rK   rm  zUnpack[OnlyEagerOrInterchange]rÕ   r0  )rl  rK   rm  z$Unpack[OnlyEagerOrInterchangeStrict]rÕ   r0  )rl  rK   rm  r7  rÕ   r0  )rl  rK   rm  r8  rÕ   r0  )rl  rO   rm  r3  rÕ   r2  )rl  rO   rm  r4  rÕ   r2  )rl  úIntoDataFrameT | IntoSeriesTrm  r5  rÕ   ú/DataFrame[IntoDataFrameT] | Series[IntoSeriesT])rl  r;  rm  r6  rÕ   r<  )rl  rM   rm  r9  rÕ   r1  )rl  rM   rm  r:  rÕ   r1  )rl  ú-IntoDataFrameT | IntoLazyFrameT | IntoSeriesTrm  zUnpack[AllowAny]rÕ   úKDataFrame[IntoDataFrameT] | LazyFrame[IntoLazyFrameT] | Series[IntoSeriesT])rl  r=  rm  zUnpack[AllowAnyStrict]rÕ   r>  )rl  r€   rm  zUnpack[PassThroughUnknown]rÕ   r€   )rl  r€   rm  zUnpack[StrictUnknown]rÕ   r€   )rl  r   rŠ  rß   r‹  rß   rˆ  rß   rŒ  rß   r�  rZ  rÕ   r   )rl  zJIntoDataFrameT | IntoLazyFrameT | IntoFrame | IntoSeriesT | IntoSeries | TrŽ  rZ  rŠ  rZ  r‹  rß   rˆ  rß   rŒ  rß   r�  rZ  rm  r   rÕ   zOLazyFrame[IntoLazyFrameT] | DataFrame[IntoDataFrameT] | Series[IntoSeriesT] | T)r˜  r0  rŽ  úLiteral[True] | NonerÕ   rK   )r˜  r1  rŽ  r?  rÕ   rM   )r˜  r2  rŽ  r?  rÕ   rO   )r˜  r   rŽ  rß   rÕ   r   )r˜  r0  rŠ  úLiteral[False] | NonerÕ   rK   )r˜  r1  rŠ  r@  rÕ   rM   )r˜  r2  rŠ  r@  rÕ   rO   )r˜  r   rŠ  rß   rÕ   r   )r˜  r>  rŽ  rZ  rŠ  rZ  rÕ   z3IntoLazyFrameT | IntoDataFrameT | IntoSeriesT | Anyr°   )r»  zCallable[..., Any] | NonerŽ  rZ  rŠ  rZ  r‹  rß   rˆ  rß   rŒ  rß   r�  rZ  rÕ   r¾  )rÕ   r$   )rÅ  zstr | Iterable[str]rÕ   r$   )rÊ  zint | Sequence[int]rÕ   r$   )r¶  rz   r  r+  rÕ   r$   )rÓ  rÝ   rÕ   r$   )rß  r  rÕ   r$   )rß  r  r(  rß   rÕ   r$   )Úpearson)rñ  rx   r¹  rx   rï  zLiteral['pearson', 'spearman']rÕ   r$   )rñ  rx   r¹  rx   ró  r	  rÕ   r$   )
rß  r  rû  rx   rø  rÝ   r(  rß   rÕ   r$   )rþ  rÝ   r³  rx   rÕ   r$   )rß  r  rû  rx   rÕ   r$   )r^  z5DataFrame[Any] | LazyFrame[Any] | Series[IntoSeriesT]rÕ   rÔ   r  )r»   rÝ   r  r   r  r+  r—   rÚ   r  úModuleType | NonerÕ   rÜ   )r›   rf   r—   rÚ   r  rB  rÕ   r˜   )
r    rØ   r¡   rÙ   r—   rÚ   r  rB  rÕ   r˜   )
r    r   r¡   rÛ   r—   rÚ   r  rB  rÕ   r˜   )
r%  rv   r—   rÚ   r  rB  rô   r   rÕ   r˜   )
r%  rv   r—   zIntoBackend[Backend] | Noner  rB  rô   r   rÕ   rÞ   )rß  zIntoExpr | Sequence[IntoExpr]r/  rx   rÕ   r$   )ÔÚ
__future__r   Ú	functoolsr   Útypingr   r   r   r	   r
   r   Únarwhalsr©  r   r   r  Únarwhals._exceptionsr   Únarwhals._expression_parsingr   r   r   Únarwhals._typing_compatr   r   r¨  r   r   r   r   r   r   r   r   r   r   r   r   Únarwhals.dataframer    rä   r!   r  Únarwhals.exceptionsr"   r#   Únarwhals.exprr$   rh  Únarwhals.functionsr%   r&   r'   Únarwhals.schemar(   ÚNwSchemaÚnarwhals.seriesr)   r-  Únarwhals.stable.v1r*   r+   r,   Únarwhals.stable.v1.dtypesr-   r.   r/   r0   r1   r2   r3   r4   r5   r6   r7   r8   r9   r:   r;   r<   r=   r>   r?   r@   rA   rB   rC   rD   rE   rF   rG   rH   rI   Únarwhals.stable.v1.typingrJ   rK   rL   rM   rN   rO   rP   rQ   Únarwhals.translaterR   rS   rT   Úcollections.abcrU   rV   rW   rX   ÚtypesrY   Útyping_extensionsrZ   r[   r\   r]   Únarwhals._translater^   ÚAllowAnyStrictr_   ÚAllowAnyr`   ÚAllowLazyStrictra   Ú	AllowLazyrb   ÚAllowSeriesStrictrc   ÚAllowSeriesrd   ÚExcludeSeriesStrictre   ÚExcludeSeriesrf   rg   rh   ri   ÚOnlySeriesStrictrj   Ú
OnlySeriesrk   ÚPassThroughUnknownrl   ÚStrictUnknownÚnarwhals._typingrm   rn   ro   rp   rq   rr   rs   rt   ru   Únarwhals.typingrv   rw   rx   ry   rz   r{   r|   r}   r~   r   r€   r‚   rƒ   r¾   rn  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£   Ú__annotations__r§   r#  r(  r*  r,  r.  Ú__all__r±   r“   r‘   ú<module>ri     sÍ  ðÞ "å ß E× Eã ß 2Ý .ß DÑ Dß 9÷÷ ÷ ó ÷ Rß MÝ (ß FÑ FÝ .Ý .ß >Ñ >÷÷ ÷ ÷ ÷ ÷ ÷ õ ÷>	÷ 	ó 	÷ UÑ TáßEÓEÝ ç9Ñ9å9÷÷ ÷ ÷ ñ ÷"÷ ñ ÷ H÷÷ ÷ ñ 	�˜SÔ!€AÙ�#‹€AÙ�‹€AôA-�˜NÑ+ô A-ôH1
�˜NÑ+ô 1
ôhR<ˆX�kÑ"ô R<ôja
ˆ6ô a
ôHˆXô ð 
Ú Ró 
Ø RØ	Ú Ró 
Ø RØ	Ú Fó 
Ø FØ	Ú (ó 
Ø (ðð
ðð
 Xóð" 
Ú Só 
Ø SØ	Ú Yó 
Ø YØ	Ú Tó 
Ø TØ	Ú Zó 
Ø ZØ	ðØðØ'<ðàòó 
ðð 
ðØðØ'Bðàòó 
ðð 
Ú Xó 
Ø XØ	ðØðØ'>ðàòó 
ðð 
ð$Ø!ð$Ø+Ið$àò$ó 
ð$ð 
ð$Ø!ð$Ø+Oð$àò$ó 
ð$ð 
ð$Ø!ð$Ø+@ð$àò$ó 
ð$ð 
ð$Ø!ð$Ø+Fð$àò$ó 
ð$ð 
ðØðØ(:ðàòó 
ðð 
ðØðØ(@ðàòó 
ðð 
ð:Ø/ð:Ø9Lð:à4ò:ó 
ð:ð 
ð:Ø/ð:Ø9Rð:à4ò:ó 
ð:ð 
ð$Ø!ð$Ø+<ð$àò$ó 
ð$ð 
ð$Ø!ð$Ø+Bð$àò$ó 
ð$ð 
ðVØ@ðVØJZðVàPòVó 
ðVð 
ðVØ@ðVà"ðVð QòVó 
ðVð 
Ú Oó 
Ø OØ	Ú Jó 
Ø Jð 
ð ',ñØðð ðð ð	ð
  $ðð ðð ðð 	òó 
ðð& Ø $ØØ&+ØØ $ñ+ðð+ð ð+ð ð+ð ð+ð  $ð+ð ð+ð ð+ð ð+ð Uó+ð\ 
àRUñØ.ðØ;Oðàòó 
ðð 
àRUñØ.ðØ;Oðàòó 
ðð 
àLOñØ(ðØ5Iðàòó 
ðð 
Ú @ó 
Ø @Ø	ð +.ñØ.ðð (ðð ò	ó 
ðð
 
ð +.ñØ.ðð (ðð ò	ó 
ðð
 
àSVñØ(ðØ;Pðàòó 
ðð 
Ú Fó 
Ø Fð Ø $ñDððDð
 ðDð ðDð 9óDð. '+ðBð Ø $ØØ&+ØØ $ñBØ
#ðBð ðBð ð	Bð
 ðBð  $ðBð ðBð ðBð óBóJ ó&ó*ó(ó ô,ó(ó(ó)ó+ó(ó1ð
 AFñLØ)ðLØ9=ðLà	óLð AFñLØ)ðLØ9=ðLà	óLó2ó1ó1ð
 HQð
4Øð
4Øð
4Ø&Dð
4à	ó
4ð 23õ 	/ð Øñ	Ø(ðàðð ðð ð	ð
 
óó2ó
7ðØ	>ðà+óô&+ˆ4�9Š9ô +ô>ˆ4�9Š9�dô >ó2ñ  TÔ*ð #ðNð
 15Ø*.ñNØ
ðNàðNð ðNð
 .ðNð (ðNð òNó +ðNñ$  TÔ*ð 15Ø*.ñ	FØ ðFð .ðFð (ð	Fð
 òFó +ðFñ  Óð BFðEð 15Ø*.ñEØ
ðEà>ðEð .ð	Eð
 (ðEð òEó ðEð  ×(Ò(€
ˆEÓ (ñ  TÔ*ð 15ðFð 15Ø*.ñFØ
ðFà-ðFð .ð	Fð
 (ðFð òFó +ðFñ"  TÔ*ð 15Ø*.ñ	HØðHð .ðHð (ð	Hð
 ðHð òHó +ðHñ"  TÔ*ð ,0Ø*.ñ	HØðHð )ðHð (ð	Hð
 ðHð òHó +ðHñ"  TÔ*ð 15Ø*.ñ	LØðLð .ðLð (ð	Lð
 ðLð òLó +ðLñ"  TÔ*ð ,0Ø*.ñ	LØðLð )ðLð (ð	Lð
 ðLð òLó +ðLó":òZ�r“   