
    Lpj6                       S SK Jr  S SKJrJrJrJrJr  S SKJ	r	J
r
JrJrJr  S SKJr  S SKJrJrJrJrJrJr  S SKJrJrJrJr  S SKJrJr  S SKJ r J!r!J"r"J#r#J$r$  \(       am  S S	K%J&r&J'r'J(r(  S S
K)J*r*  S SK+r,S SK-r.S SK/r0S SK1J2r2J3r3J4r4  S SK5J6r6  S SK7J8r8  S SKJ9r9J:r:J;r;  S SK<J=r=  S SK>J?r?  S SK@JArAJBrBJCrCJDrDJErEJFrFJGrGJHrH   " S S\4\\S4   5      rI\" SSSS9rJ/ SQrK " S S\S   \\\   \S   \\\   5      rL " S S\L\   \\   5      rM " S  S!\ \   \!\   \\\4   5      rN " S" S#\N\\4   \\\4   5      rO " S$ S%\N\\4   \	\   \\\4   5      rP " S& S'\N\\4   \
\   \\\4   5      rQ " S( S)\N\\4   \\   \\\4   5      rR " S* S+\N\\4   \\   \\\4   5      rS " S, S-\N\\4   \\   \\\4   5      rT " S. S/\\\J4   5      rUg)0    )annotations)TYPE_CHECKINGAnyGenericLiteralProtocol)CatNamespaceDateTimeNamespaceListNamespaceStringNamespaceStructNamespace)CompliantColumn)CompliantSeriesT_coEagerDataFrameAnyEagerSeriesTEagerSeriesT_coNativeSeriesTNativeSeriesT_co)FromIterable
FromNativeNumpyConvertible
ToNarwhals)TypeVarassert_never)_StoresCompliant_StoresNativeis_compliant_seriesis_sized_multi_index_selectorunstable)IterableIteratorSequence)
ModuleTypeN)NotRequiredSelf	TypedDict)CompliantDataFrame)EagerNamespace)ImplementationVersion_LimitedContext)DType)Series)Into1DArray	IntoDTypeMultiIndexSelectorPythonLiteralRollingInterpolationMethodSizedMultiIndexSelector_1DArray_SliceIndexc                  *    \ rS rSr% S\S'   S\S'   Srg)HistData8   z/NotRequired[list[float] | _1DArray | list[Any]]
breakpointz2NativeSeriesT | _1DArray | _CountsT_co | list[Any]count N)__name__
__module____qualname____firstlineno____annotations____static_attributes__r;       V/var/www/html/pdf-tiff/venv/lib/python3.13/site-packages/narwhals/_compliant/series.pyr7   r7   8   s    CCAArB   r7   _CountsT_coIterable[Any]T)bound	covariant)	CompliantSeriesEagerSeriesEagerSeriesCatNamespaceEagerSeriesDateTimeNamespaceEagerSeriesHistEagerSeriesListNamespaceEagerSeriesNamespaceEagerSeriesStringNamespaceEagerSeriesStructNamespacec                  X   \ rS rSr% S\S'   \SJS j5       rSKS jrSLS jr\	SMS j5       r
SNS jrSOS	 jrSPS
 jr\SQS j5       r\SRS j5       rSSS jrSTS jrSUS jrSVS jrSWS jr\	SXS j5       r\	SSS.         SYS jj5       rSZS jrSZS jrSZS jrSZS jrS[S jrS[S jrS\S jrSWS jrSWS jrSKS  jr SWS! jr!S]S" jr"S^S# jr#S^S$ jr$S_S% jr%S`S& jr&S[S' jr'SaS( jr(SbS) jr)ScS* jr*SWS+ jr+SdS, jr,SeS- jr-SeS. jr.SdS/ jr/SWS0 jr0SWS1 jr1      SfS2 jr2SgS3 jr3ShS4 jr4S`S5 jr5ScS6 jr6SiS7 jr7SjS8 jr8SeS9 jr9S`S: jr:SkS; jr;      SlS< jr<SmS= jr=SnS> jr>SoS? jr?SpS@ jr@SASB.SqSC jjrA          SrSD jrBSjSE jrCSsSF jrD\E      StSG j5       rF\E      SuSH j5       rGSIrHg)vrH   L   r)   _implementationc                    g Nr;   selfs    rC   nativeCompliantSeries.nativeW   s    '*rB   c                    U $ rU   r;   rV   s    rC   __narwhals_series__#CompliantSeries.__narwhals_series__Y   s    rB   c                    g rU   r;   rV   s    rC   __native_namespace__$CompliantSeries.__native_namespace__\   s    #rB   c                  g rU   r;   clsdatacontexts      rC   from_nativeCompliantSeries.from_native]   s    WZrB   c                6    U R                   R                  U SS9$ )Nfull)level)_versionseriesrV   s    rC   to_narwhalsCompliantSeries.to_narwhals_   s    }}##D#77rB   c                    g rU   r;   rW   rk   s     rC   _with_nativeCompliantSeries._with_nativeb   s    rB   c                    g rU   r;   )rW   versions     rC   _with_versionCompliantSeries._with_versionc       srB   c                    g rU   r;   rV   s    rC   dtypeCompliantSeries.dtypef   s    !rB   c                    g rU   r;   rV   s    rC   nameCompliantSeries.nameh   s    rB   c                   g rU   r;   )rW   rx   copys      rC   	__array__CompliantSeries.__array__j   s    srB   c                    g rU   r;   rW   others     rC   __contains__CompliantSeries.__contains__k   s    rB   c                    g rU   r;   rW   items     rC   __getitem__CompliantSeries.__getitem__l   s    #rB   c                    g rU   r;   rV   s    rC   __iter__CompliantSeries.__iter__m       rB   c                ,    [        U R                  5      $ rU   )lenrX   rV   s    rC   __len__CompliantSeries.__len__n   s    4;;rB   c                  g rU   r;   ra   s      rC   
from_numpyCompliantSeries.from_numpyq   s    TWrB    N)r{   rx   c                  g rU   r;   )rb   rc   rd   r{   rx   s        rC   from_iterableCompliantSeries.from_iterables   s     rB   c                    g rU   r;   r   s     rC   __radd__CompliantSeries.__radd__}       CrB   c                    g rU   r;   r   s     rC   __rand__CompliantSeries.__rand__~   r   rB   c                    g rU   r;   r   s     rC   __rmul__CompliantSeries.__rmul__   r   rB   c                    g rU   r;   r   s     rC   __ror__CompliantSeries.__ror__       3rB   c                    g rU   r;   rV   s    rC   allCompliantSeries.all       3rB   c                    g rU   r;   rV   s    rC   anyCompliantSeries.any   r   rB   c                   g rU   r;   )rW   ignore_nullss     rC   	any_valueCompliantSeries.any_value   s    rB   c                    g rU   r;   rV   s    rC   arg_maxCompliantSeries.arg_max       crB   c                    g rU   r;   rV   s    rC   arg_minCompliantSeries.arg_min   r   rB   c                    g rU   r;   rV   s    rC   arg_trueCompliantSeries.arg_true   s    rB   c                    g rU   r;   rV   s    rC   r:   CompliantSeries.count       CrB   c                    g rU   r;   )rW   	predicates     rC   filterCompliantSeries.filter       crB   c                    g rU   r;   rV   s    rC   firstCompliantSeries.first       crB   c                    g rU   r;   rV   s    rC   lastCompliantSeries.last       SrB   c                    g rU   r;   )rW   noffsets      rC   gather_everyCompliantSeries.gather_every   s    rB   c                    g rU   r;   rW   r   s     rC   headCompliantSeries.head       CrB   c                (    U R                  5       S:H  $ Nr   )r   rV   s    rC   is_emptyCompliantSeries.is_empty   s    xxzQrB   c                   g rU   r;   )rW   
descendings     rC   	is_sortedCompliantSeries.is_sorted   s    crB   c                    g rU   r;   )rW   indexs     rC   r   CompliantSeries.item   r   rB   c                    g rU   r;   rV   s    rC   kurtosisCompliantSeries.kurtosis   s    rB   c                    g rU   r;   rV   s    rC   r   CompliantSeries.len       #rB   c                    g rU   r;   rV   s    rC   maxCompliantSeries.max   r   rB   c                    g rU   r;   rV   s    rC   meanCompliantSeries.mean   s    SrB   c                    g rU   r;   rV   s    rC   medianCompliantSeries.median       srB   c                    g rU   r;   rV   s    rC   minCompliantSeries.min   r   rB   c                    g rU   r;   rV   s    rC   n_uniqueCompliantSeries.n_unique   r   rB   c                    g rU   r;   rV   s    rC   
null_countCompliantSeries.null_count   s    rB   c                    g rU   r;   )rW   quantileinterpolations      rC   r   CompliantSeries.quantile   s    rB   c                   g rU   r;   )rW   r   with_replacementseeds       rC   sampleCompliantSeries.sample   s    SVrB   c                    g rU   r;   )rW   indicesvaluess      rC   scatterCompliantSeries.scatter   s    CrB   c                    g rU   r;   r   s     rC   shiftCompliantSeries.shift   r   rB   c                    g rU   r;   rV   s    rC   skewCompliantSeries.skew   r   rB   c                   g rU   r;   )rW   r   
nulls_lasts      rC   sortCompliantSeries.sort       3rB   c                   g rU   r;   rW   ddofs     rC   stdCompliantSeries.std       #rB   c                    g rU   r;   rV   s    rC   sumCompliantSeries.sum   r   rB   c                    g rU   r;   r   s     rC   tailCompliantSeries.tail   r   rB   c                    g rU   r;   rV   s    rC   to_arrowCompliantSeries.to_arrow   r   rB   c                   g rU   r;   )rW   	separator
drop_firsts      rC   
to_dummiesCompliantSeries.to_dummies       25rB   c                    g rU   r;   rV   s    rC   to_frameCompliantSeries.to_frame   r  rB   c                    g rU   r;   rV   s    rC   to_listCompliantSeries.to_list   r   rB   c                    g rU   r;   rV   s    rC   	to_pandasCompliantSeries.to_pandas   r   rB   c                    g rU   r;   rV   s    rC   	to_polarsCompliantSeries.to_polars   r   rB   F)maintain_orderc                   g rU   r;   )rW   r5  s     rC   uniqueCompliantSeries.unique   s    srB   c                   g rU   r;   )rW   r  parallelr{   	normalizes        rC   value_countsCompliantSeries.value_counts   r(  rB   c                   g rU   r;   r  s     rC   varCompliantSeries.var   r  rB   c                    g rU   r;   )rW   maskr   s      rC   zip_withCompliantSeries.zip_with   rv   rB   c                   g)z(`Series.hist(bins=..., bin_count=None)`.Nr;   )rW   binsinclude_breakpoints      rC   hist_from_binsCompliantSeries.hist_from_bins       
 	rB   c                   g)z(`Series.hist(bins=None, bin_count=...)`.Nr;   )rW   	bin_countrG  s      rC   hist_from_bin_count#CompliantSeries.hist_from_bin_count   rJ  rB   r;   returnr   )rP  r%   )rP  r#   )rc   r   rd   r+   rP  r%   )rP  Series[NativeSeriesT])rk   r   rP  r%   )rs   r*   rP  r%   )rP  r,   )rP  str)rx   r   r~   zbool | NonerP  r4   )r   r   rP  bool)r   MultiIndexSelector[Self]rP  r   )rP  zIterator[Any])rP  int)rc   r.   rd   r+   rP  r%   )
rc   rE   rd   r+   r{   rR  rx   zIntoDType | NonerP  r%   )r   r   rP  r%   rP  rS  )r   rS  rP  r1   )r   r   rP  r%   )rP  r1   )r   rU  r   rU  rP  r%   )r   rU  rP  r%   )r   rS  rP  rS  )r   
int | NonerP  r   )rP  zfloat | None)rP  r   )rP  float)r   rX  r   r2   rP  rX  )r   rU  r   rS  r  rW  rP  r%   )r  r%   r  r%   rP  r%   )r   rS  r  rS  rP  r%   )r  rU  rP  rX  )rP  zpa.Array[Any])r$  rR  r%  rS  rP  'CompliantDataFrame[Self, Any, Any, Any])rP  rY  )rP  z	list[Any])rP  zpd.Series[Any])rP  z	pl.Series)r5  rS  rP  r%   )
r  rS  r:  rS  r{   z
str | Noner;  rS  rP  rY  )rB  r   r   r   rP  r%   )rF  list[float]rG  rS  rP  rY  )rL  rU  rG  rS  rP  rY  )Ir<   r=   r>   r?   r@   propertyrX   r[   r^   classmethodre   rl   rp   rt   rx   r{   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r:   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r  r  r
  r  r  r  r  r  r!  r&  r*  r-  r0  r3  r7  r<  r?  rC  r   rH  rM  rA   r;   rB   rC   rH   rH   L   s    $#* * 6Z Z8 5: ! ! J3E,  W W "&
 !    
  0//.D!!#1)(<' :1+ ""$.H	 W?('F-',66-16	06 G'.)/4B66'+63=6JN6	06 .: 8<	0  59	0 rB   rH   )r4   r.   rQ  c                     \ rS rSr% S\S'   S\S'   S\S'   S\S	'   \SS
 j5       r\SS j5       rSS jr	SS.     SS jjr
  SS jrS S jrS!S jrS"S jr\S#S j5       r\S$S j5       r\S%S j5       r\S&S j5       r\S'S j5       rSrg)(rI      r   _native_seriesr)   rS   r*   rj   rS  
_broadcastc                6    U R                   R                  5       $ rU   )rS   _backend_versionrV   s    rC   rb  EagerSeries._backend_version   s    ##4466rB   c                    g)a  Ensure all of `series` have the same length (and index if `pandas`).

Scalars get broadcasted to the full length of the longest Series.

This is useful when you need to construct a full Series anyway, such as:

    DataFrame.select(...)

It should not be used in binary operations, such as:

    nw.col("a") - nw.col("a").mean()

because then it's more efficient to extract the right-hand-side's single element as a scalar.
Nr;   )rb   rk   s     rC   _align_full_broadcast!EagerSeries._align_full_broadcast   s      	rB   c                :    U R                  U/U R                  U S9$ )N)r{   rd   )r   r{   )rW   values     rC   _from_scalarEagerSeries._from_scalar   s     !!5'		4!HHrB   F)preserve_broadcastc                   g)a{  Return a new `CompliantSeries`, wrapping the native `series`.

In cases when operations are known to not affect whether a result should
be broadcast, we can pass `preserve_broadcast=True`.
Set this with care - it should only be set for unary expressions which don't
change length or order, such as `.alias` or `.fill_null`. If in doubt, don't
set it, you probably don't need it.
Nr;   )rW   rk   rk  s      rC   rp   EagerSeries._with_native   s     	rB   c                    g rU   r;   rV   s    rC   __narwhals_namespace__"EagerSeries.__narwhals_namespace__   s    =@rB   c                    g rU   r;   rW   rowss     rC   _gatherEagerSeries._gather   s    SrB   c                    g rU   r;   rr  s     rC   _gather_sliceEagerSeries._gather_slice   s    rB   c                
   [        U[        [        45      (       a  U R                  U5      $ [	        U5      (       a  U R                  UR                  5      $ [        U5      (       a  U R                  U5      $ [        U5        g rU   )	
isinstanceslicerangerw  r   rt  rX   r   r   r   s     rC   r   EagerSeries.__getitem__   sd    dUEN++%%d++t$$<<,,*400<<%%TrB   c                    g rU   r;   rV   s    rC   rR  EagerSeries.str   s    FIrB   c                    g rU   r;   rV   s    rC   dtEagerSeries.dt  s    GJrB   c                    g rU   r;   rV   s    rC   catEagerSeries.cat  s    CFrB   c                    g rU   r;   rV   s    rC   listEagerSeries.list  s    EHrB   c                    g rU   r;   rV   s    rC   structEagerSeries.struct  s    ILrB   r;   NrP  ztuple[int, ...])rk   r%   rP  zSequence[Self])rh  r   rP  r%   )rk   r   rk  rS  rP  r%   )rP  z2EagerNamespace[Any, Self, Any, Any, NativeSeriesT])rs  z&SizedMultiIndexSelector[NativeSeriesT]rP  r%   )rs  z_SliceIndex | rangerP  r%   )r   rT  rP  r%   )rP  z/EagerSeriesStringNamespace[Self, NativeSeriesT])rP  z1EagerSeriesDateTimeNamespace[Self, NativeSeriesT])rP  z,EagerSeriesCatNamespace[Self, NativeSeriesT])rP  z-EagerSeriesListNamespace[Self, NativeSeriesT])rP  z/EagerSeriesStructNamespace[Self, NativeSeriesT])r<   r=   r>   r?   r@   r[  rb  r\  re  ri  rp   ro  rt  rw  r   rR  r  r  r  r  rA   r;   rB   rC   rI   rI      s    ##7 7  "I DI#<@	A	;A QC I IJ JF FH HL LrB   rI   c                      \ rS rSr% S\S'   \SS j5       r\SS j5       r\SS j5       r\SS j5       r	\SS j5       r
SS	 jrS
rg)_SeriesNamespacei  r   _compliant_seriesc                    U R                   $ rU   r  rV   s    rC   	compliant_SeriesNamespace.compliant  s    %%%rB   c                .    U R                   R                  $ rU   )r  rS   rV   s    rC   implementation_SeriesNamespace.implementation  s    ~~---rB   c                6    U R                   R                  5       $ rU   )r  rb  rV   s    rC   backend_version _SeriesNamespace.backend_version  s    ""3355rB   c                .    U R                   R                  $ rU   )r  rj   rV   s    rC   rs   _SeriesNamespace.version  s    ~~&&&rB   c                .    U R                   R                  $ rU   )r  rX   rV   s    rC   rX   _SeriesNamespace.native"  s    %%,,,rB   c               8    U R                   R                  U5      $ rU   )r  rp   ro   s     rC   with_native_SeriesNamespace.with_native&  s    ~~**622rB   r;   N)rP  r   )rP  r)   r  )rP  r*   )rP  r   )rk   r   rP  r   )r<   r=   r>   r?   r@   r[  r  r  r  rs   rX   r  rA   r;   rB   rC   r  r    sq    
 +*& & . . 6 6 ' ' - -3rB   r  c                  *    \ rS rSr% S\S'   SS jrSrg)rN   i*  r   r  c                   Xl         g rU   r  ro   s     rC   __init__EagerSeriesNamespace.__init__0  s    !'rB   r  N)rk   r   rP  None)r<   r=   r>   r?   r@   r  rA   r;   rB   rC   rN   rN   *  s     '&(rB   rN   c                      \ rS rSrSrg)rJ   i4  r;   Nr<   r=   r>   r?   rA   r;   rB   rC   rJ   rJ   4       rB   rJ   c                      \ rS rSrSrg)rK   i;  r;   Nr  r;   rB   rC   rK   rK   ;  r  rB   rK   c                      \ rS rSrSrg)rM   iB  r;   Nr  r;   rB   rC   rM   rM   B  r  rB   rM   c                      \ rS rSrSrg)rO   iI  r;   Nr  r;   rB   rC   rO   rO   I  r  rB   rO   c                      \ rS rSrSrg)rP   iP  r;   Nr  r;   rB   rC   rP   rP   P  r  rB   rP   c                      \ rS rSr% S\S'   S\S'   S\S'   \SS j5       r\      SS	 j5       rSS
 jr	SS.         SS jjr
SS jrSS jr    SS jrSS jrS S jrS!S jrS"S jr    S#S jrSrg)$rL   iX  EagerSeries[NativeSeriesT]_seriesrS  _breakpoint$HistData[NativeSeriesT, _CountsT_co]_datac                .    U R                   R                  $ rU   )r  rX   rV   s    rC   rX   EagerSeriesHist.native]  s    ||"""rB   c               @    U R                  U 5      nXl        X#l        U$ rU   )__new__r  r  )rb   rk   rG  objs       rC   from_seriesEagerSeriesHist.from_seriesa  s!     kk#,
rB   c                    g rU   r;   rV   s    rC   r*  EagerSeriesHist.to_framej  s    SrB   both)closedc                   g rU   r;   )rW   startendnum_samplesr  s        rC   _linear_spaceEagerSeriesHist._linear_spacek  s     rB   c                    g rU   r;   rV   s    rC   is_empty_seriesEagerSeriesHist.is_empty_seriesu  s    srB   c                6    U R                   (       a  / / S.$ S/ 0$ )N)r9   r:   r:   )r  rV   s    rC   
data_emptyEagerSeriesHist.data_emptyx  s    262B2Bb2.URTUrB   c                   g rU   r;   )rW   args     rC   series_emptyEagerSeriesHist.series_empty}      /2rB   c                   [        U5      S::  a  U R                  5       U l        U $ U R                  5       (       a  U R	                  U5      U l        U $ U R                  U5      U l        U $ )N   )r   r  r  r  r  _calculate_histrW   rF  s     rC   	with_binsEagerSeriesHist.with_bins  se    t9>*DJ
 	 !!##**40DJ  --d3DJrB   c                   US:X  a  U R                  5       U l        U $ U R                  5       (       a  U R                  U5      U l        U $ U R	                  U R                  U5      5      U l        U $ r   )r  r  r  r  r  _calculate_binsrW   rL  s     rC   with_bin_countEagerSeriesHist.with_bin_count  sl    >*DJ
 	 !!##**95DJ  --d.B.B9.MNDJrB   c               f    [        U[        5      (       a  U R                  SSUS-   5      OUnUSS  $ )Nr   r  )rz  rU  r  )rW   r  rF  s      rC   _calculate_breakpoint%EagerSeriesHist._calculate_breakpoint  s3    4>sC4H4Ht!!!Qa0cABxrB   c                    g rU   r;   r  s     rC   r  EagerSeriesHist._calculate_bins  s    3rB   c                    g rU   r;   r  s     rC   r  EagerSeriesHist._calculate_hist  r  rB   )r  NrO  )rk   r  rG  rS  rP  r%   )rP  r   )
r  rX  r  rX  r  rU  r  zLiteral['both', 'none']rP  r4   rV  )rP  r  )r  int | list[float]rP  r  )rF  rZ  rP  r%   )rL  rU  rP  r%   )r  r  rP  list[float] | _1DArray)rL  rU  rP  r4   )rF  r  rP  r  )r<   r=   r>   r?   r@   r[  rX   r\  r  r*  r  r  r  r  r  r  r  r  r  rA   r;   rB   rC   rL   rL   X  s    ''//# # /HL	  1 +1  	 ( 
 +V
3$3	-3 ?3*3	-3rB   rL   )V
__future__r   typingr   r   r   r   r   !narwhals._compliant.any_namespacer	   r
   r   r   r   narwhals._compliant.columnr   narwhals._compliant.typingr   r   r   r   r   r   narwhals._translater   r   r   r   narwhals._typing_compatr   r   narwhals._utilsr   r   r   r   r   collections.abcr    r!   r"   typesr#   pandaspdpolarsplpyarrowpatyping_extensionsr$   r%   r&   narwhals._compliant.dataframer'   narwhals._compliant.namespacer(   r)   r*   r+   narwhals.dtypesr,   narwhals.seriesr-   narwhals.typingr.   r/   r0   r1   r2   r3   r4   r5   r7   rD   __all__rH   rI   r  rN   rJ   rK   rM   rO   rP   rL   r;   rB   rC   <module>r     sM   " A A  7  W V 9  << >>@<HH%&	 	 	B9gm]&BC B
 m?dK
u./}&']upDM/-0(=2I DMN3()"# "2233>(_&667O--.(_&667!_../_&667o&_../\#334,\++,\#334L!\++,_&667O$_../B3h}k9: B3rB   