[i5 ddlmZddlmZmZmZmZmZddlm Z m Z m Z m Z m Z ddlmZddlmZmZmZmZmZmZddlmZmZmZmZddlmZmZddlm Z m!Z!m"Z"m#Z#m$Z$ermdd l%m&Z&m'Z'm(Z(dd l)m*Z*dd l+Z,dd l-Z.dd l/Z0dd l1m2Z2m3Z3m4Z4dd l5m6Z6ddl7m8Z8ddlm9Z9m:Z:m;Z;ddlm?Z?ddl@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHGdde4eedfZIedddZJgdZKGddedeeeedeeeZLGddeLeeeZMGd d!e ee!eeeefZNGd"d#eNeefeeefZOGd$d%eNeefe eeeefZPGd&d'eNeefe eeeefZQGd(d)eNeefe eeeefZRGd*d+eNeefe eeeefZSGd,d-eNeefe eeeefZTGd.d/eeeJfZUy )0) annotations) TYPE_CHECKINGAnyGenericLiteralProtocol) CatNamespaceDateTimeNamespace ListNamespaceStringNamespaceStructNamespace)CompliantColumn)CompliantSeriesT_coEagerDataFrameAny EagerSeriesTEagerSeriesT_co NativeSeriesTNativeSeriesT_co) FromIterable FromNativeNumpyConvertible ToNarwhals)TypeVar assert_never)_StoresCompliant _StoresNativeis_compliant_seriesis_sized_multi_index_selectorunstable)IterableIteratorSequence) ModuleTypeN) NotRequiredSelf TypedDict)CompliantDataFrame)EagerNamespace)ImplementationVersion_LimitedContext)DType)Series) Into1DArray IntoDTypeMultiIndexSelector PythonLiteralRollingInterpolationMethodSizedMultiIndexSelector_1DArray _SliceIndexc"eZdZUded<ded<y)HistDataz/NotRequired[list[float] | _1DArray | list[Any]] breakpointz2NativeSeriesT | _1DArray | _CountsT_co | list[Any]countN)__name__ __module__ __qualname____annotations__k/var/www/html/userprofiledev.eatanceapp.com/venv/lib/python3.12/site-packages/narwhals/_compliant/series.pyr7r78sCCAAr?r7 _CountsT_co Iterable[Any]T)bound covariant) CompliantSeries EagerSeriesEagerSeriesCatNamespaceEagerSeriesDateTimeNamespaceEagerSeriesHistEagerSeriesListNamespaceEagerSeriesNamespaceEagerSeriesStringNamespaceEagerSeriesStructNamespaceceZdZUded<edHdZdIdZdJdZedKdZ dLdZ dMdZ dNd Z edOd Z edPd ZdQd ZdRd ZdSdZdTdZdUdZedVdZeddd dWdZdXdZdXdZdXdZdXdZdYdZdYdZdZdZdUdZdUdZdIdZdUd Z d[d!Z!d\d"Z"d\d#Z#d]d$Z$d^d%Z%dYd&Z&d_d'Z'd`d(Z(dad)Z)dUd*Z*dbd+Z+dcd,Z,dcd-Z-dbd.Z.dUd/Z/dUd0Z0 ddd1Z1 ded2Z2dfd3Z3d^d4Z4dad5Z5dgd6Z6dhd7Z7dcd8Z8d^d9Z9did:Z: djd;Z;dkd<ZZ>dnd?Z?d@dAdodBZ@ dpdCZAdhdDZBdqdEZCeD drdFZEeD dsdGZFy)trEr)_implementationcyNr>selfs r@nativezCompliantSeries.nativeWs'*r?c|SrQr>rRs r@__narwhals_series__z#CompliantSeries.__narwhals_series__Ys r?cyrQr>rRs r@__native_namespace__z$CompliantSeries.__native_namespace__\s#r?cyrQr>clsdatacontexts r@ from_nativezCompliantSeries.from_native]sWZr?c<|jj|dS)Nfull)level)_versionseriesrRs r@ to_narwhalszCompliantSeries.to_narwhals_s}}##D#77r?cyrQr>rSrcs r@ _with_nativezCompliantSeries._with_nativebsr?cyrQr>)rSversions r@ _with_versionzCompliantSeries._with_versioncsr?cyrQr>rRs r@dtypezCompliantSeries.dtypefs!r?cyrQr>rRs r@namezCompliantSeries.namehsr?cyrQr>)rSrmcopys r@ __array__zCompliantSeries.__array__jssr?cyrQr>rSothers r@ __contains__zCompliantSeries.__contains__ksr?cyrQr>rSitems r@ __getitem__zCompliantSeries.__getitem__ls#r?cyrQr>rRs r@__iter__zCompliantSeries.__iter__mr?c,t|jSrQ)lenrTrRs r@__len__zCompliantSeries.__len__ns4;;r?cyrQr>rZs r@ from_numpyzCompliantSeries.from_numpyqsTWr?N)rormcyrQr>)r[r\r]rorms r@ from_iterablezCompliantSeries.from_iterablessr?cyrQr>rts r@__radd__zCompliantSeries.__radd__}Cr?cyrQr>rts r@__rand__zCompliantSeries.__rand__~rr?cyrQr>rts r@__rmul__zCompliantSeries.__rmul__rr?cyrQr>rts r@__ror__zCompliantSeries.__ror__3r?cyrQr>rRs r@allzCompliantSeries.all3r?cyrQr>rRs r@anyzCompliantSeries.anyrr?cyrQr>)rS ignore_nullss r@ any_valuezCompliantSeries.any_valuesr?cyrQr>rRs r@arg_maxzCompliantSeries.arg_maxcr?cyrQr>rRs r@arg_minzCompliantSeries.arg_minrr?cyrQr>rRs r@arg_truezCompliantSeries.arg_truesr?cyrQr>rRs r@r9zCompliantSeries.countCr?cyrQr>)rS predicates r@filterzCompliantSeries.filtercr?cyrQr>rRs r@firstzCompliantSeries.firstcr?cyrQr>rRs r@lastzCompliantSeries.lastSr?cyrQr>)rSnoffsets r@ gather_everyzCompliantSeries.gather_everysr?cyrQr>rSrs r@headzCompliantSeries.headCr?c(|jdk(SNr)rrRs r@is_emptyzCompliantSeries.is_emptysxxzQr?cyrQr>)rS descendings r@ is_sortedzCompliantSeries.is_sortedscr?cyrQr>)rSindexs r@ryzCompliantSeries.itemrr?cyrQr>rRs r@kurtosiszCompliantSeries.kurtosissr?cyrQr>rRs r@rzCompliantSeries.len#r?cyrQr>rRs r@maxzCompliantSeries.maxrr?cyrQr>rRs r@meanzCompliantSeries.meansSr?cyrQr>rRs r@medianzCompliantSeries.mediansr?cyrQr>rRs r@minzCompliantSeries.minrr?cyrQr>rRs r@n_uniquezCompliantSeries.n_uniquerr?cyrQr>rRs r@ null_countzCompliantSeries.null_countsr?cyrQr>)rSquantile interpolations r@rzCompliantSeries.quantilesr?cyrQr>)rSrfractionwith_replacementseeds r@samplezCompliantSeries.samplesr?cyrQr>)rSindicesvaluess r@scatterzCompliantSeries.scatters#r?cyrQr>rs r@shiftzCompliantSeries.shiftrr?cyrQr>rRs r@skewzCompliantSeries.skewrr?cyrQr>)rSr nulls_lasts r@sortzCompliantSeries.sort3r?cyrQr>rSddofs r@stdzCompliantSeries.std#r?cyrQr>rRs r@sumzCompliantSeries.sumrr?cyrQr>rs r@tailzCompliantSeries.tailrr?cyrQr>rRs r@to_arrowzCompliantSeries.to_arrowr}r?cyrQr>)rS separator drop_firsts r@ to_dummieszCompliantSeries.to_dummies25r?cyrQr>rRs r@to_framezCompliantSeries.to_framerr?cyrQr>rRs r@to_listzCompliantSeries.to_listrr?cyrQr>rRs r@ to_pandaszCompliantSeries.to_pandasrr?cyrQr>rRs r@ to_polarszCompliantSeries.to_polarsrr?F)maintain_ordercyrQr>)rSrs r@uniquezCompliantSeries.uniquessr?cyrQr>)rSrparallelro normalizes r@ value_countszCompliantSeries.value_countsrr?cyrQr>rs r@varzCompliantSeries.varrr?cyrQr>)rSmaskrus r@zip_withzCompliantSeries.zip_withrkr?cy)z(`Series.hist(bins=..., bin_count=None)`.Nr>)rSbinsinclude_breakpoints r@hist_from_binszCompliantSeries.hist_from_bins r?cy)z(`Series.hist(bins=None, bin_count=...)`.Nr>)rS bin_countrs r@hist_from_bin_countz#CompliantSeries.hist_from_bin_countrr?returnr)r r%)r r#)r\rr]r+r r%)r Series[NativeSeriesT])rcrr r%)rir*r r%)r r,)r str)rmrrqz bool | Noner r4)rurr bool)ryMultiIndexSelector[Self]r r)r z Iterator[Any])r int)r\r.r]r+r r%) r\rBr]r+rorrmzIntoDType | Noner r%)rurr r%r r)rrr r1)rrr r%)r r1)rrrrr r%)rrr r%)rrr r)r int | Noner r)r  float | None)r r)r float)rrrr2r r) rrrrrrrrr r%)rzint | Sequence[int]rrr r%)rrrrr r%)rrr r)r z pa.Array[Any])rrrrr 'CompliantDataFrame[Self, Any, Any, Any])r r)r z list[Any])r zpd.Series[Any])r z pl.Series)rrr r%) rrrrroz str | Nonerrr r)rrrurr r%)r list[float]rrr r)r rrrr r)Gr:r;r<r=propertyrTrVrX classmethodr^rdrgrjrmrorrrvrzr|rrrrrrrrrrrrrr9rrrrrrrryrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr r>r?r@rErELsI$# **6ZZ85:!! J3E, WW"& !     0//.D!!#1)(<':1+ ""$.H        N('F-',66-16 06G'.)/4B66'+63=6JN6 06.:  8< 0    59 0  r?rE)r4r.rceZdZUded<ded<ded<ded<edd Zedd Zdd Zd d  ddZ ddZ ddZ ddZ d dZ ed!dZed"dZed#dZed$dZed%dZy)&rFr_native_seriesr)rOr*rbr _broadcastc6|jjSrQ)rO_backend_versionrRs r@rzEagerSeries._backend_versions##4466r?cy)aEnsure 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>)r[rcs r@_align_full_broadcastz!EagerSeries._align_full_broadcasts r?c@|j|g|j|S)N)ror])rro)rSvalues r@ _from_scalarzEagerSeries._from_scalars !!5' 4!HHr?F)preserve_broadcastcy)aReturn 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>)rSrcr%s r@rgzEagerSeries._with_natives r?cyrQr>rRs r@__narwhals_namespace__z"EagerSeries.__narwhals_namespace__s=@r?cyrQr>rSrowss r@_gatherzEagerSeries._gathersSr?cyrQr>r*s r@ _gather_slicezEagerSeries._gather_slicesr?ct|ttfr|j|St |r|j |j St|r|j |St|yrQ) isinstancesliceranger.rr,rTrrrxs r@rzzEagerSeries.__getitem__s[ dUEN +%%d+ + t $<< , , *4 0<<% %Tr?cyrQr>rRs r@rzEagerSeries.strsFIr?cyrQr>rRs r@dtzEagerSeries.dtsGJr?cyrQr>rRs r@catzEagerSeries.cat sCFr?cyrQr>rRs r@listzEagerSeries.list sEHr?cyrQr>rRs r@structzEagerSeries.structsILr?Nr ztuple[int, ...])rcr%r zSequence[Self])r#rr r%)rcrr%rr r%)r z2EagerNamespace[Any, Self, Any, Any, NativeSeriesT])r+z&SizedMultiIndexSelector[NativeSeriesT]r r%)r+z_SliceIndex | ranger r%)ryrr r%)r z/EagerSeriesStringNamespace[Self, NativeSeriesT])r z1EagerSeriesDateTimeNamespace[Self, NativeSeriesT])r z,EagerSeriesCatNamespace[Self, NativeSeriesT])r z-EagerSeriesListNamespace[Self, NativeSeriesT])r z/EagerSeriesStructNamespace[Self, NativeSeriesT])r:r;r<r=rrrr!r$rgr(r,r.rzrr5r7r9r;r>r?r@rFrFs## 77  "IDI  #  <@    A ;AQCII JJ FF HH LLr?rFczeZdZUded<ed dZed dZed dZed dZeddZ ddZ y )_SeriesNamespacer_compliant_seriesc|jSrQr?rRs r@ compliantz_SeriesNamespace.compliants%%%r?c.|jjSrQ)rBrOrRs r@implementationz_SeriesNamespace.implementations~~---r?c6|jjSrQ)rDrrRs r@backend_versionz _SeriesNamespace.backend_version!s""3355r?c.|jjSrQ)rBrbrRs r@riz_SeriesNamespace.version%s~~&&&r?c.|jjSrQ)r?rTrRs r@rTz_SeriesNamespace.native)s%%,,,r?c8|jj|SrQ)rBrgrfs r@ with_nativez_SeriesNamespace.with_native-s~~**622r?N)r r)r r)r<)r r*)r r)rcrr r) r:r;r<r=rrBrDrFrirTrJr>r?r@r>r>sq +* &&..66''--3r?r>c eZdZUded<ddZy)rKrr?c||_yrQrArfs r@__init__zEagerSeriesNamespace.__init__7s !'r?N)rcrr None)r:r;r<r=rMr>r?r@rKrK1s'&(r?rKc eZdZy)rGNr:r;r<r>r?r@rGrG;r?rGc eZdZy)rHNrPr>r?r@rHrHBrQr?rHc eZdZy)rJNrPr>r?r@rJrJIrQr?rJc eZdZy)rLNrPr>r?r@rLrLPrQr?rLc eZdZy)rMNrPr>r?r@rMrMWrQr?rMceZdZUded<ded<ded<eddZe ddZdd Zd d  dd Z dd Z ddZ ddZ ddZ ddZddZd dZ d!dZy)"rIEagerSeries[NativeSeriesT]_seriesr _breakpoint$HistData[NativeSeriesT, _CountsT_co]_datac.|jjSrQ)rXrTrRs r@rTzEagerSeriesHist.nativecs||"""r?cD|j|}||_||_|SrQ)__new__rXrY)r[rcrobjs r@ from_serieszEagerSeriesHist.from_seriesgs%kk# , r?cyrQr>rRs r@rzEagerSeriesHist.to_framepsSr?both)closedcyrQr>)rSstartend num_samplesrcs r@ _linear_spacezEagerSeriesHist._linear_spaceqsr?cyrQr>rRs r@is_empty_serieszEagerSeriesHist.is_empty_series{ssr?c,|jrggdSdgiS)N)r8r9r9)rYrRs r@ data_emptyzEagerSeriesHist.data_empty~s262B2Bb2.URT Ur?cyrQr>)rSargs r@ series_emptyzEagerSeriesHist.series_empty/2r?ct|dkr|j|_|S|jr|j ||_|S|j ||_|S)N)rrlr[rjro_calculate_histrSrs r@ with_binszEagerSeriesHist.with_binssb t9>*DJ   ! ! #**40DJ --d3DJ r?c|dk(r|j|_|S|jr|j||_|S|j |j ||_|Sr)rlr[rjrors_calculate_binsrSr s r@with_bin_countzEagerSeriesHist.with_bin_countsi >*DJ   ! ! #**95DJ --d.B.B9.MNDJ r?c\t|tr|jdd|dzn|}|ddS)Nrrr)r0rrh)rSrnrs r@_calculate_breakpointz%EagerSeriesHist._calculate_breakpoints04>sC4Ht!!!Qa0cABxr?cyrQr>rxs r@rwzEagerSeriesHist._calculate_binss3r?cyrQr>rts r@rszEagerSeriesHist._calculate_histrpr?Nr )rcrWrrr r%)r r) rerrfrrgrrczLiteral['both', 'none']r r4r)r rZ)rnint | list[float]r rZ)rrr r%)r rr r%)rnr~r list[float] | _1DArray)r rr r4)rrr rZ)r:r;r<r=rrTrr`rrhrjrlroruryr{rwrsr>r?r@rIrI^s '' // ##/HL 1+1   (  +V 3$3 -3?3*3 -3r?rI)V __future__rtypingrrrrr!narwhals._compliant.any_namespacer r r r r narwhals._compliant.columnrnarwhals._compliant.typingrrrrrrnarwhals._translaterrrrnarwhals._typing_compatrrnarwhals._utilsrrrrrcollections.abcr r!r"typesr#pandaspdpolarsplpyarrowpatyping_extensionsr$r%r&narwhals._compliant.dataframer'narwhals._compliant.namespacer(r)r*r+narwhals.dtypesr,narwhals.seriesr-narwhals.typingr.r/r0r1r2r3r4r5r7rA__all__rErFr>rKrGrHrJrLrMrIr>r?r@rsM"AA7WV9<< >>@<HH%&   B9gm]&BCB m?dK  | ./}&' ] | ~DM/-0(=2IDMN3()"# "2 233>(_&667 O- -.(_&667! _. ./_&667o& _. ./\#334, \+ +,\#334L! \+ +,_&667O$ _. ./B3h}k9:B3r?