Ë
    ðmxio�  ã                  ó,  — 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
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/m0Z1 d dl2m3Z3m4Z4m5Z5 d dl6m7Z8 d dl9m:Z; d dl<m=Z=m>Z>m?Z? d dl@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\ d dl]m^Z^m_Z_m`Z`maZambZbmcZcmdZdmeZe d dlfmgZgmhZhmiZi er”d dljmkZkmlZlmmZm d dlnmoZo d dlpmqZqmrZrmsZs d dlmtZt d dlumvZwmxZymzZ{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œ 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¨ eqd«      Z© ed «      Zª G d!„ d"e)e_   «      Z( G d#„ d$e+ea   «      Z* G d%„ d&e;ec   «      Z: G d'„ d(e1«      Z0 G d)„ d*e8«      Z7ed„d+„«       Z«ed…d,„«       Z«ed†d-„«       Z«ed‡d.„«       Z«	 	 	 	 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dždE„«       Z¬edFdGœ	 	 	 	 	 	 	 	 	 	 	 	 	 dŸdH„«       Z¬dddFdFdFddIœ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d dJ„Z¬edKdLœ	 	 	 	 	 d¡dM„«       Z­edKdLœ	 	 	 	 	 d¢dN„«       Z­edKdLœ	 	 	 	 	 d£dO„«       Z­ed¤dP„«       Z­edKdQœ	 	 	 	 	 d¥dR„«       Z­edKdQœ	 	 	 	 	 d¦dS„«       Z­edKdQœ	 	 	 	 	 d§dT„«       Z­ed¨dU„«       Z­dddVœ	 	 	 	 	 	 	 d©dW„Z­	 dªdddFdFdFdXdIœ	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 d«dY„Z®d¬dZ„Z¯d­d[„Z°d­d\„Z±d®d]„Z²d¬d^„Z³dªd¯d_„Z´d°d`„Zµd°da„Z¶d°db„Z·d°dc„Z¸d°dd„Z¹d±de„ZºdFdfœ	 	 	 	 	 d²dg„Z»dFdfœ	 	 	 	 	 d²dh„Z¼d±di„Z½d±dj„Z¾d±dk„Z¿dldFdmœ	 	 	 	 	 	 	 	 	 d³dn„ZÀd´do„ZÁdµdp„ZÂ	 	 	 	 d¶dq„ZÃ G dr„ dse�jˆ                  «      ZÄ G dt„ due�jŠ                  e0«      ZÅd·dv„ZÆ edX¬w«      	 dªdddxœ	 	 	 	 	 	 	 	 	 	 	 d¸dy„«       ZÇ edX¬w«      dddxœ	 	 	 	 	 	 	 d¹dz„«       ZÈ e«       	 dªdddxœ	 	 	 	 	 	 	 	 	 dºd{„«       ZÉe(�j”                  ZÊd|eËd}<    edX¬w«      	 dªdddxœ	 	 	 	 	 	 	 	 	 d»d~„«       ZÌ edX¬w«      dddxœ	 	 	 	 	 	 	 	 	 d¼d„«       ZÍ edX¬w«      dddxœ	 	 	 	 	 	 	 	 	 d½d€„«       ZÎ edX¬w«      dddxœ	 	 	 	 	 	 	 	 	 d¼d�„«       ZÏ edX¬w«      dddxœ	 	 	 	 	 	 	 	 	 d½d‚„«       ZÐg dƒ¢ZÑy)¾é    )Úannotations©Úwraps)ÚTYPE_CHECKINGÚAnyÚCallableÚ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Ú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)Ú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)ÚDType)
Ú
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      €úR/home/htdocs/ttos/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›   re   r—   úIntoBackend[EagerAllowed]rÕ   r˜   r°   )r    úMapping[str, Any]r¡   ú.IntoSchema | Mapping[str, DType | None] | Noner—   ú IntoBackend[EagerAllowed] | NonerÕ   r˜   )r    zSequence[Any]r¡   rÙ   r—   r×   rÕ   r˜   )r    r   r¡   ú3Mapping[str, DType] | Schema | 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Õ   rZ   )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Á   úLiteral[True]rÕ   zdict[str, Series[Any]])rÁ   úLiteral[False]rÕ   zdict[str, list[Any]])rÁ   ÚboolrÕ   z-dict[str, Series[Any]] | dict[str, list[Any]])rÕ   rÜ   ©rÕ   rZ   )Ú__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!   €   sa  ø„ Ø�z‰z€Há�Óô*ó ð*ð ð.Ø)ð.Ø7Pð.à	ô.ó ð.ð ð BFð.ð
 59ñ.àð.ð ?ð.ð
 2ð.ð 
ô.ó ð.ð ð BFð.àð.ð ?ð.ð
 +ð.ð 
ô.ó ð.ð ð GKð.àð.ð Dð.ð
 +ð.ð 
ô.ó ð.ð ò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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Õ   rZ   ©r   ©rû   r  rþ   r  rÕ   rZ   )Úindex)r»   rÝ   r  zstr | Sequence[str] | NonerÕ   rZ   )rã   rä   rå   r   ÚNwLazyFramerŒ   rè   rï   ró   rõ   rÑ   rú   r  r  ré   rê   s   @r‘   r"   r"     s”   ø„ Ù�Óô*ó ð*ð òó ðóð
 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__9  s-   ø€ ð �‰¤'§*¡*Ñ,Ð,Ð,Ü‰Ñ˜ uÐÕ-r“   Nc               óB   •— t         ‰| �  ||||¬«      }t        d|«      S ©Nr–   rÜ   r¦   ©rš   r»   ÚvaluesÚdtyper—   rœ   r�   s         €r‘   r§   zSeries.from_numpyC  s*   ø€ ô ‘Ñ# D¨&°%ÀÐ#ÓIˆÜ�M 6Ó*Ð*r“   c               óB   •— t         ‰| �  ||||¬«      }t        d|«      S r  )r‹   Úfrom_iterabler   r  s         €r‘   r  zSeries.from_iterableO  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_frame_  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_countsb  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.histp  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*   6  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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‘   r4  z	Expr.head�  ó#   € à× Ñ ¤¬(×*GÑ*GÈÐSTÔ!UÓVÐVr“   c                óX   — | j                  t        t        j                  d|¬«      «      S )rù   rú   r5  r6  r9  s     r‘   rú   z	Expr.tail“  r:  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ý   r6  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   ÚUserWarningr7  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  rB  )r7  r   r   ÚWINDOW)rŽ   rC  rD  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©r7  r   r   ÚORDERABLE_AGGREGATIONrª   s    r‘   rH  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_minrI  rª   s    r‘   rM  zExpr.arg_min¸  rK  r“   c                óT   — | j                  t        t        j                  d«      «      S )z/Find elements where boolean expression is True.Úarg_truer6  rª   s    r‘   rO  zExpr.arg_true¼  s    € à× Ñ ¤¬(×*GÑ*GÈÓ!TÓUÐUr“   )Ú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û   rP  rQ  rR  )r7  r   r   rA  )rŽ   rû   rP  rQ  rR  s        r‘   rT  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$   r7  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Õ   rZ   )rC  rá   rD  rá   rÕ   rZ   r°   )
rû   r.  rP  zfloat | NonerQ  rá   rR  r.  rÕ   rZ   )r*  rá   rÕ   rZ   )rã   rä   rå   rÑ   r4  rú   r  r?  r  rH  rM  rO  rT  r,  ré   rê   s   @r‘   r%   r%   ‹  s›   ø„ õ'ôWôWô	
ð 7;õ Jð */À5õ 
óVóVóVð ð
ð "&Ø!&Øñ
àð
ð ð	
ð
 ð
ð ð
ð 
ó
ð8 16÷ 
ñ 
r“   r%   c                  óX   ‡ — e Zd Zej                  Z ee«      	 d	 	 	 dˆ fd„«       Zˆ xZ	S )r)   c                ó$   •— t         ‰| �  |«       y r°   )r‹   rŒ   )rŽ   r¡   r�   s     €r‘   rŒ   zSchema.__init__ê  s   ø€ ô 	‰Ñ˜Õ r“   r°   )r¡   z8Mapping[str, DType] | Iterable[tuple[str, DType]] | NonerÕ   rÖ   )
rã   rä   rå   r   rŠ   r‰   r   ÚNwSchemarŒ   ré   rê   s   @r‘   r)   r)   ç  s6   ø„ Ø�z‰z€Há�ÓàQUð!ØNð!à	ô!ó ô!r“   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  .  rx  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  2  ó   € ð r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  6  r}  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  :  ó   € ð 7:r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  >  r€  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  B  rx  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  F  rx  r“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  J  s	   € ð SVr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  N  s	   € ð SVr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  S  s   € ØLOr“   c                 ó   — y r°   r±   rk  s     r‘   rn  rn  U  s   € ØGJr“   F)Úeager_or_interchange_onlyc                ó   — y r°   r±   )rl  Úpass_throughÚ
eager_onlyrˆ  Úseries_onlyÚallow_seriess         r‘   rn  rn  Z  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  f  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š  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ö   Úargr»   ÚvalueÚvÚbÚbackendsr(  rœ   r�  r‹  rˆ  ÚfuncrŠ  rŒ  s             €€€€€€r‘   Úwrapperz.narwhalify.<locals>.decorator.<locals>.wrapperÝ  s  ø€ ð  ö
ð ô ØØ!-Ø)Ø.GØ +Ø!-öð
ˆDð 
ð* $*§<¡<£>÷
ñ  �D˜%ð ”kØØ!-Ø)Ø.GØ +Ø!-ôñ ð
ˆFñ 
ð 3˜4Ð2 &§-¡-£/Ñ2öàÜ  Ð$:¸DÓAÐA�AÐAñ •ðˆHð ð ×ÑÓ! AÒ%Øw�Ü  “oÐ%á˜4Ð* 6Ñ*ˆ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Ò  )  rÈ  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r¨  ÚmeanrÏ  s    r‘   rÔ  rÔ  -  s   € Ü”b—g‘g˜wÐ'Ó(Ð(r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r¨  ÚmedianrÏ  s    r‘   rÖ  rÖ  1  s   € Ü”b—i‘i Ð)Ó*Ð*r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r¨  ÚsumrÏ  s    r‘   rØ  rØ  5  rÈ  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r¨  Úsum_horizontal©Úexprss    r‘   rÚ  rÚ  9  ó   € Ü”b×'Ñ'¨Ð/Ó0Ð0r“   r)  c                ó>   — t        t        j                  |d| iŽ«      S ©Nr*  )r¾   r¨  Úall_horizontal©r*  rÜ  s     r‘   rà  rà  =  ó   € ô ”b×'Ñ'¨ÐJ¸\ÑJÓKÐKr“   c                ó>   — t        t        j                  |d| iŽ«      S rß  )r¾   r¨  Úany_horizontalrá  s     r‘   rä  rä  C  râ  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r¨  Úmean_horizontalrÛ  s    r‘   ræ  ræ  I  s   € Ü”b×(Ñ(¨%Ð0Ó1Ð1r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r¨  Úmin_horizontalrÛ  s    r‘   rè  rè  M  rÝ  r“   c                 ó8   — t        t        j                  | Ž «      S r°   )r¾   r¨  Úmax_horizontalrÛ  s    r‘   rê  rê  Q  rÝ  r“   Ú ©Ú	separatorr*  c               óH   — t        t        j                  | g|¢­||dœŽ«      S )Nrì  )r¾   r¨  Ú
concat_str)rÜ  rí  r*  Ú
more_exprss       r‘   rï  rï  U  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õ  e  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÷  i  s   € ð  �:‰:Ðr“   c                  ó2   ‡ — e Zd Zedd„«       Zdˆ fd„Zˆ xZS )ÚWhenc                ó&   —  | |j                   «      S r°   )Ú
_predicate)rš   Úwhens     r‘   Ú	from_whenzWhen.from_when}  s   € á�4—?‘?Ó#Ð#r“   c                óH   •— t         j                  t        ‰| �  |«      «      S r°   )ÚThenÚ	from_thenr‹   Úthen©rŽ   r´  r�   s     €r‘   r  z	When.then�  s   ø€ Ü�~‰~œe™g™l¨5Ó1Ó2Ð2r“   )rü  z	nw_f.WhenrÕ   rù  )r´  ú&IntoExpr | NonNestedLiteral | _1DArrayrÕ   rÿ  )rã   rä   rå   rç   rý  r  ré   rê   s   @r‘   rù  rù  |  s   ø„ Øò$ó ð$÷3ñ 3r“   rù  c                  ó2   ‡ — e Zd Zedd„«       Zdˆ fd„Zˆ xZS )rÿ  c                ó    —  | |j                   Ž S r°   )ri  )rš   r  s     r‘   r   zThen.from_then†  s   € á�D—K‘KÐ Ð r“   c                ó4   •— t        t        ‰| �	  |«      «      S r°   )r¾   r‹   Ú	otherwiser  s     €r‘   r  zThen.otherwiseŠ  s   ø€ Üœ%™'Ñ+¨EÓ2Ó3Ð3r“   )r  z	nw_f.ThenrÕ   rÿ  )r´  r  rÕ   r%   )rã   rä   rå   rç   r   r  ré   rê   s   @r‘   rÿ  rÿ  …  s   ø„ Øò!ó ð!÷4ñ 4r“   rÿ  c                 óL   — t         j                  t        j                  | Ž «      S r°   )rù  rý  Únw_frü  )Ú
predicatess    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    s1   € ô Ð)¨7Ó3€GÜ”d×'Ñ'¨ÑJ¸ÐJÀ6ÑJÓKÐKr“   )Ur.   r/   r0   r1   r!   r2   r3   r4   r5   r6   r%   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£   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™  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Õ   r  )rl  rK   rm  z$Unpack[OnlyEagerOrInterchangeStrict]rÕ   r  )rl  rK   rm  r%  rÕ   r  )rl  rK   rm  r&  rÕ   r  )rl  rO   rm  r!  rÕ   r   )rl  rO   rm  r"  rÕ   r   )rl  úIntoDataFrameT | IntoSeriesTrm  r#  rÕ   ú/DataFrame[IntoDataFrameT] | Series[IntoSeriesT])rl  r)  rm  r$  rÕ   r*  )rl  rM   rm  r'  rÕ   r  )rl  rM   rm  r(  rÕ   r  )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�  rX  rÕ   r   )rl  zJIntoDataFrameT | IntoLazyFrameT | IntoFrame | IntoSeriesT | IntoSeries | TrŽ  rX  rŠ  rX  r‹  rá   rˆ  rá   rŒ  rá   r�  rX  rm  r   rÕ   zOLazyFrame[IntoLazyFrameT] | DataFrame[IntoDataFrameT] | Series[IntoSeriesT] | T)r˜  r  rŽ  rß   rÕ   rK   )r˜  r  rŽ  rß   rÕ   rM   )r˜  r   rŽ  rß   rÕ   rO   )r˜  r   rŽ  rá   rÕ   r   )r˜  r  rŠ  rà   rÕ   rK   )r˜  r  rŠ  rà   rÕ   rM   )r˜  r   rŠ  rà   rÕ   rO   )r˜  r   rŠ  rá   rÕ   r   )r˜  r,  rŽ  rX  rŠ  rX  rÕ   z3IntoLazyFrameT | IntoDataFrameT | IntoSeriesT | Anyr°   )r¸  zCallable[..., Any] | NonerŽ  rX  rŠ  rX  r‹  rá   rˆ  rá   rŒ  rá   r�  rX  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Ü  úIntoExpr | Iterable[IntoExpr]rÕ   r%   )rÜ  r-  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-  r—   rÚ   r  úModuleType | NonerÕ   rÜ   )r›   re   r—   rÚ   r  r.  rÕ   r˜   )
r    rØ   r¡   z#Mapping[str, DType] | Schema | Noner—   rÚ   r  r.  rÕ   r˜   )
r    r   r¡   rÛ   r—   rÚ   r  r.  rÕ   r˜   )
r  rv   r—   rÚ   r  r.  rö   r   rÕ   r˜   )
r  rv   r—   zIntoBackend[Backend] | Noner  r.  rö   r   rÕ   rÞ   )ÒÚ
__future__r   Ú	functoolsr   Útypingr   r   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)   r[  Únarwhals.seriesr*   r/  Únarwhals.stable.v1r+   r,   r-   Únarwhals.stable.v1.dtypesr.   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   ÚtypesrX   Útyping_extensionsrY   rZ   r[   r\   Únarwhals._translater]   ÚAllowAnyStrictr^   ÚAllowAnyr_   ÚAllowLazyStrictr`   Ú	AllowLazyra   ÚAllowSeriesStrictrb   ÚAllowSeriesrc   ÚExcludeSeriesStrictrd   ÚExcludeSeriesre   rf   rg   rh   ÚOnlySeriesStrictri   Ú
OnlySeriesrj   ÚPassThroughUnknownrk   ÚStrictUnknownÚnarwhals._typingrl   rm   rn   ro   rp   rq   rr   rs   rt   Únarwhals.dtypesru   Ú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£   Ú__annotations__r§   r  r  r  r  Ú__all__r±   r“   r‘   ú<module>rU     sŒ  ðÞ "å ß O× OÑ Oã ß 2Ý .ß DÑ Dß 9÷÷ ÷ ó ÷ Rß MÝ (ß FÑ FÝ .Ý .ß >Ñ >÷÷ ÷ ÷ ÷ ÷ ÷ ó ÷<	÷ 	ó 	÷ UÑ Táß;Ñ;Ý ç9Ñ9å9÷÷ ÷ ÷ ñ ÷"÷ ñ ÷ HÝ%÷÷ ÷ ñ 	�˜SÔ!€AÙ�#‹€AÙ�‹€AôA-�˜NÑ+ô A-ôH/
�˜NÑ+ô /
ôdR<ˆX�kÑ"ô R<ôjY
ˆ6ô Y
ôx!ˆ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ó+ð\ 
àKNñØ.ðØ;Hðàòó 
ðð 
àKNñØ.ðØ;Hðàòó 
ðð 
àEHñØ(ðØ5Bðàòó 
ðð 
Ú @ó 
Ø @Ø	àRUñØ.ðØAOðàòó 
ðð 
àRUñØ.ðØAOðàòó 
ðð 
àLOñØ(ðØ;Iðàòó 
ðð 
Ú 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ð Øñ	Ø(ðàðð ðð ð	ð
 
óó2ó
7ðØ	>ðà+óô&3ˆ4�9Š9ô 3ô4ˆ4�9Š9�dô 4ó2ñ  TÔ*ð #ðNð
 15Ø*.ñNØ
ðNàðNð ðNð
 .ðNð (ðNð òNó +ðNñ$  TÔ*ð 15Ø*.ñ	FØ ðFð .ðFð (ð	Fð
 òFó +ðFñ  Óð 37ðEð 15Ø*.ñEØ
ðEà/ðEð .ð	Eð
 (ðEð òEó ðEð  ×(Ò(€
ˆEÓ (ñ  TÔ*ð CGð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ò"V�r“   