hh UddlmZddlmZddlmZmZmZmZm Z m Z m Z ddl Z ddl mZmZddlmZddlmZmZddlmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"dd l#m$Z%m&Z'dd l(m)Z)dd l*m+Z,dd l-m.Z.m/Z/m0Z0dd l1m2Z3ddl4m5Z6ddl7m8Z8m9Z9m:Z:ddl;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWddlXmYZYmZZZddl[m\Z\m]Z]m^Z^erddl_m`Z`maZambZbddlcmdZdddlemfZfmgZgddlhmiZiddljmkZkmlZlmmZmmnZnmoZompZpmqZqddl#mrZrmsZsddltmuZuddlvmwZwmxZxmyZymzZzm{Z{m|Z|m}Z}m~Z~mZmZmZeddZeddZed d!Zed"e#Zefd$Zed%Zed&d'e(ZGd)d*e%eYZ$Gd+d,e'eZZ&Gd-d.e6eZ5Gd/d0e,Z+Gd1d2e3Z2e dd7Ze dd:Ze dd=Ze dd?ZddBZe ddFZe ddGZe ddHZe ddJZe dKdKdLd dVZe dKdKdWd dXZe dKdKdKdYd d\Ze dKdKdKdYd d]Ze dKdKdKd^d d_Ze dKdKdKd^dd`Ze dKdKdKdadddZe dKdKdKdeddfZe dKdKdKdKdgddhZe dKdKdKdKdgddjZe dKdKdKdKdgddkZe dKdKdKdKdlddnZe dKdKdKdKdKdoddpZe dKdKdKdKdqddrZe dKdKdKdKdsddvZe dKdKdKdKdwddxZe dKdKdKdKdKdoddyZe dKdKdLdd|Ze dKdKdWdd}Ze dKdKdKdYdd~Ze dKdKdKdYddZe dKdKdKd^ddZe dKdKdKd^ddZe dKdKdKdad dZe dKdKdKded!dZe dKdKdKdKdgd"dZe dKdKdKdKdgd#dZe dKdKdKdKdd$dZe dKdKdKdKdd%dZe dKdKdKdKdd&dZe dKdKdKdKdd'dZe dKdKdKdKdKdd(dZe dKdKdKdKdKdd)dZe ddd*dZdddddddd+dZe dKdd,dZe dKdd-dZe dKdd.dZe d/dZe dKdd0dZe dKdd1dZe dKdd2dZe d3dZdddd4dZ d5dddddddd6dZd7dZd8dZd8dZd9dZd7dZd5d:dZd;dZd;dZd;dZd;d„Zd;dÄZddӄZd?dքZd@dׄZdAdڄZGdۄdejZGd݄deje+ZdBdZed d5ddddCdZedddddDdZe d5ddddEdZe$jZded<ed d5ddddFdZedddddGdZedddddHdZedddddGdZedddddHdZgdZdS(I) annotationswraps) TYPE_CHECKINGAnyCallableFinalLiteralcastoverloadN) exceptions functions) issue_warning)TypeVar assert_never) ImplementationVersiondeprecate_native_namespacegenerate_temporary_column_name inherit_docis_ordered_categoricalmaybe_align_indexmaybe_convert_dtypesmaybe_get_indexmaybe_reset_indexmaybe_set_indexvalidate_strict_and_pass_though) DataFrame LazyFrame)InvalidIntoExprErrorExpr)_new_series_implconcat show_versions)SchemaSeries) dependenciesdtypes selectors)ArrayBinaryBoolean CategoricalDateDatetimeDecimalDurationEnumFieldFloat32Float64Int8Int16Int32Int64Int128ListObjectStringStructTimeUInt8UInt16UInt32UInt64UInt128Unknown)IntoDataFrameTIntoLazyFrameT)_from_native_implget_native_namespace to_py_scalar)IterableMappingSequence) ModuleType) ParamSpecSelf)IntoArrowTable)ArrowBackend EagerAllowed IntoBackend LazyAllowedPandasPolars)MultiColSelectorMultiIndexSelector)DType) FileSource IntoDTypeIntoExpr IntoFrame IntoSchema IntoSeriesNonNestedLiteralSingleColSelectorSingleIndexSelector_1DArray_2DArray DataFrameTDataFrame[Any])bound LazyFrameTLazyFrame[Any]SeriesT Series[Any]T)defaultPR IntoSeriesTrc)rkrqceZdZejZeedGfd Ze dHfd Z e dIdddJfdZ e dIdKfd Z e dIdLfd Z edMdZedNdZedOd"ZedPd%ZedQd(ZdRfd+ ZdSfd/ Z dIdd0dTfd5Zed6d7dUd;ZedVd>Zed?d7dWdBZd?d7dWfdCZdXfdD ZdXfdE ZdYdFZxZS)Zrdfrlevel&Literal['full', 'lazy', 'interchange']returnNonecx|jtjusJt||dSN)rw_versionrV1super__init__selfrvrw __class__s R/var/www/histauto/venv/lib/python3.11/site-packages/narwhals/stable/v1/__init__.pyrzDataFrame.__init__n;{gj(((( 5))))) native_framerSbackendIntoBackend[EagerAllowed]rjcjt||}td|SNrrj)r from_arrowr )clsrrresultrs rrzDataFrame.from_arrowvs2##L'#BB$f---rNrdataMapping[str, Any]schema#Mapping[str, DType] | Schema | None IntoBackend[EagerAllowed] | Noneclt|||}td|Sr)r from_dictr rrrrrrs rrzDataFrame.from_dict}s4""4"AA$f---r Sequence[Any]IntoSchema | Noneclt|||}td|Sr)r from_dictsr rs rrzDataFrame.from_dicts4##D&'#BB$f---rrh3Mapping[str, DType] | Schema | Sequence[str] | Noneclt|||}td|Srr from_numpyr rs rrzDataFrame.from_numpyrrtype[Series[Any]]c,tdtS)Nr)r r(rs r_serieszDataFrame._seriess'000rtype[LazyFrame[Any]]c,tdtS)Nr)r rrs r _lazyframezDataFrame._lazyframes*I666ritem-tuple[SingleIndexSelector, SingleColSelector]cdSNrrs r __getitem__zDataFrame.__getitem__sWZWZr2str | tuple[MultiIndexSelector, SingleColSelector]rocdSrrrs rrzDataFrame.__getitem__s crSingleIndexSelector | MultiIndexSelector | MultiColSelector | tuple[SingleIndexSelector, MultiColSelector] | tuple[MultiIndexSelector, MultiColSelector]rRcdSrrrs rrzDataFrame.__getitem__s sr SingleIndexSelector | SingleColSelector | MultiColSelector | MultiIndexSelector | tuple[SingleIndexSelector, SingleColSelector] | tuple[SingleIndexSelector, MultiColSelector] | tuple[MultiIndexSelector, SingleColSelector] | tuple[MultiIndexSelector, MultiColSelector]Series[Any] | Self | AnycFt|Sr)rr)rrrs rrzDataFrame.__getitem__sww""4(((rnamestrr(cFt|Sr)r get_column)rrrs rrzDataFrame.get_columnsww!!$'''r)sessionIntoBackend[LazyAllowed] | Noner Any | Nonermcdtt||S)N)rr) _stableifyrlazy)rrrrs rrzDataFrame.lazys' %'',,w,HHIIIr. as_seriesr Literal[True]dict[str, Series[Any]]cdSrrrrs rto_dictzDataFrame.to_dictsTWTWrLiteral[False]dict[str, list[Any]]cdSrrrs rrzDataFrame.to_dictsMPSrTbool-dict[str, Series[Any]] | dict[str, list[Any]]cdSrrrs rrzDataFrame.to_dicts 9<rcHt|S)Nr)rr)rrrs rrzDataFrame.to_dicts ww333rc^ttSr)rr is_duplicatedrrs rrzDataFrame.is_duplicateds!%''//11222rc^ttSr)rr is_uniquers rrzDataFrame.is_uniques!%''++--...rch|tSrselectall_l1_normrs rrzDataFrame._l1_norm"{{355>>++,,,rrvrrwrxryrz)rrSrrryrjr)rrrrrrryrj)rrrrrrryrj)rrhrrrrryrj)ryr)ryr)rrryr)rrryro)rrryrR)rrryr)rrryr()rrrrryrm)rrryr)rrryr)rrryr)ryroryrR)__name__ __module__ __qualname__rrr~r NwDataFramer classmethodrrrrpropertyrrr rrrrrrr __classcell__rs@rrrks!zH[******.....[. 7;. 59 .......[.%)......[.GK......[.111X1777X7ZZZXZ X   X  ) ) ) ) ) )((((((48J# JJJJJJJJ47WWWWWXW PPPXP #'<<<<<X<$(44444444333333//////--------rrceZdZeed"fd Zed#d Zd$d Z d%d&fd Z d'dZ d(d)fd Z d*d+dZ d,d dd-d!Z xZS).rrvrrwrxryrzcx|jtjusJt||dSr|r}rs rrzLazyFrame.__init__rrtype[DataFrame[Any]]ctSrrrs r _dataframezLazyFrame._dataframerargcddlm}ddlm}t ||rd}t |t ||t fr)||dStj t|)Nrr!r'z.Mixing Series with LazyFrame is not supported.F) str_as_lit) narwhals.exprr"narwhals.seriesr( isinstance TypeErrorr__narwhals_namespace__parse_into_exprr from_invalid_typetype)rrr"r(msgs r_extract_compliantzLazyFrame._extract_compliants '&&&&&****** c6 " " !BCC.. cD#; ' ' X..00@@QV@WW W"4T#YY???rNr+IntoBackend[Polars | Pandas | Arrow] | Nonekwargsrjc Tttjdd|i|S)Nrr)rrcollect)rrrrs rrzLazyFrame.collects./%''/DD'DVDDEEErrRch|tSrrrs rrzLazyFrame._l1_norm rrnintcFt|S)Get the last `n` rows.)rtail)rrrs rrzLazyFrame.tailsww||Arroffsetc`||j||S)zTake every nth row in the DataFrame and return as a new DataFrame. Arguments: n: Gather every *n*-th row. offset: Starting index. rr)_with_compliant_compliant_frame gather_everyrrrs rrzLazyFrame.gather_everys5##  ! . .6 . B B   rindex)order_byrrr str | Sequence[str] | Nonect|tr|gn|}||j||S)N)rr )rrrrwith_row_index)rrr  order_by_s rrzLazyFrame.with_row_indexsW#-Xs";";IXJJ ##  ! 0 0" 1     rrryr)rrryrr)rrrrryrjr)rrrryrRrrrrrryrR)r )rrr r ryrR)rrrr NwLazyFramerrrrrrrrrrrs@rrrs6[******X @ @ @ @FJFFFFFFF ----      "  MQ           rrceZdZejZeed)fd Ze d*d+fd Z e d*d,fd Z e d-dZ d.fd Zdddddd/fd Z d*dd!d"d0fd(ZxZS)1r(seriesrrwrxryrzcx|jtjusJt||dSr|r})rrrwrs rrzSeries.__init__-s='*,,,, u-----rNrrvaluesrgdtypeIntoDType | Nonerrrocnt||||}td|SNrrorrrrrrrrs rrzSeries.from_numpy7s5##D&%#IIM6***r Iterable[Any]cnt||||}td|Sr)r from_iterabler rs rr zSeries.from_iterableCs5&&tVUG&LLM6***rrctSrrrs rrzSeries._dataframeOrrrjc^ttSr)rrto_framers rr#zSeries.to_frameSs!%''**,,---rFsortparallelr normalizer%rr& str | Noner'chtt||||S)Nr$)rr value_counts)rr%r&rr'rs rr*zSeries.value_countsVs< GG H49 !     rT) bin_countinclude_breakpointbinslist[float] | Noner+ int | Noner,cddlm}d}t||tt |||S)Nr)NarwhalsUnstableWarningzZ`Series.hist` is being called from the stable API although considered an unstable feature.)r-r+r,)narwhals.exceptionsr1rrrhist)rr-r+r,r1rrs rr3z Series.histdsi @????? #  c2333 GGLLYCU      r)rrrwrxryrzr) rrrrgrrrrryro) rrrrrrrrryror)ryrj) r%rr&rrr(r'rryrj)r-r.r+r/r,rryrj)rrrrrr~rNwSeriesrrrr rrr#r*r3rrs@rr(r(*sozH[...... #' + + + + + +[ + #' + + + + + +[ +X......          $( !%#'             rr(ceZdZd!fd Zd"d#dZd"d#dZd$d%d Zd d d&dZdddd'dZd!dZ d!dZ d!dZ d(d dd dd)d Z xZ S)*r"ryrRcDtSr)r _taxicab_normrs rrz Expr._l1_normzsww$$&&&r rrc8fdS)zGet the first `n` rows.cT|Sr)_to_compliant_exprheadplxrrs rzExpr.head..#//4499!<<r_with_orderable_filtrationrrs``rr<z Expr.head}+.. < < < < <   rc8fdS)rcT|Sr)r;rr=s rr?zExpr.tail..r@rrArCs``rrz Expr.tailrDrrrc<fdS)zTake every nth value in the Series and return as new Series. Arguments: n: Gather every *n*-th row. offset: Starting index. cX|S)Nr)r;r)r>rrrs rr?z#Expr.gather_every..s(//44AAAfAUUrrAr s```rrzExpr.gather_everys1.. U U U U U U   rN)maintain_orderrI bool | Nonecf|d}t|tfdS)z(Return unique values of this expression.Nzx`maintain_order` has no effect and is only kept around for backwards-compatibility. You can safely remove this argument.cR|Sr)r;uniquer>rs rr?zExpr.unique..s!1H1H1M1M1T1T1V1Vr)r UserWarning_with_filtration)rrIrs` rrMz Expr.uniquesC  %7  #{ + + +$$%V%V%V%VWWWrF descending nulls_lastrRrrSc<fdS)z*Sort this column. Place null values first.cX|S)NrQ)r;r%)r>rRrSrs rr?zExpr.sort..s///4499%*:r) _with_window)rrRrSs```rr%z Expr.sorts;           rc4fdS)z'Returns the index of the maximum value.cR|Sr)r;arg_maxrNs rr?zExpr.arg_max..!//44<<>>r_with_orderable_aggregationrs`rrYz Expr.arg_max'// > > > >   rc4fdS)z'Returns the index of the minimum value.cR|Sr)r;arg_minrNs rr?zExpr.arg_min..rZrr[rs`rr`z Expr.arg_minr]rc4fdS)z/Find elements where boolean expression is True.cR|Sr)r;arg_truerNs rr?zExpr.arg_true..s!//44==??rrArs`rrcz Expr.arg_trues'.. ? ? ? ?   rfractionwith_replacementseedr/re float | NonerfrgcDfdS)aSample 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. c\|S)Nrd)r;sample)r>rerrgrrfs rr?zExpr.sample..s4//44;;H7Gd<r)rP)rrrerfrgs`````rrkz Expr.samplesI"$$           rr)r8rrr)rIrJryrR)rRrrSrryrRr) rr/rerhrfrrgr/ryrR)rrrrr<rrrMr%rYr`rcrkrrs@rr"r"ysE''''''               7;XXXXXX*/5                   "&!&           rr"cTeZdZejZee ddfd ZxZ S) r&Nr8Mapping[str, DType] | Iterable[tuple[str, DType]] | NoneryrzcJt|dSr)rr)rrrs rrzSchema.__init__s#      rr)rrmryrz) rrrrrr~rNwSchemarrrs@rr&r&sazH[QU!!!!!!!!!!!rr&objNwDataFrame[IntoDataFrameT]ryDataFrame[IntoDataFrameT]cdSrrrps rrrORsrNwLazyFrame[IntoLazyFrameT]LazyFrame[IntoLazyFrameT]cdSrrrts rrrrurNwSeries[IntoSeriesT]Series[IntoSeriesT]cdSrrrts rrrCF3rNwExprcdSrrrts rrrs%(SrZNwDataFrame[IntoDataFrameT] | NwLazyFrame[IntoLazyFrameT] | NwSeries[IntoSeriesT] | NwExprRDataFrame[IntoDataFrameT] | LazyFrame[IntoLazyFrameT] | Series[IntoSeriesT] | ExprcPt|tr8t|jt j|jSt|tr8t|jt j|jSt|tr8t|j t j|jSt|trt|j|jSt#|dSr|)rrrr _with_versionrr_levelrrr4r(_compliant_seriesr}r"r; _metadatarrts rrrs #{##[-;;GJGGszZZZZ#{##[-;;GJGGszZZZZ#x  Yc+99'*EESZXXXX#v;C*CM:::r native_objectkwdsrc dSrrrrs r from_nativersADrc dSrrrs rrrGJsrc dSrrrs rrrrrDataFrameT | LazyFrameTc dSrrrs rrrs "cr.) eager_only series_onlyIntoDataFrameT | IntoSeriesTstrictrreager_or_interchange_onlyrr allow_series/DataFrame[IntoDataFrameT] | Series[IntoSeriesT]cdSrrrrrrrrs rrr 7:cr)rrcdSrrrs rrrrr)rrrrHrzcdSrrrs rrr !$rcdSrrrs rrr+  r)rrrcdSrrrs rrr7rrcdSrrrs rrrCrr)rrr-IntoDataFrameT | IntoLazyFrameT | IntoSeriesTKDataFrame[IntoDataFrameT] | LazyFrame[IntoLazyFrameT] | Series[IntoSeriesT]cdSrrrs rrrO SVRUr)rrrcdSrrrs rrr[ #r)rrrrcdSrrrs rrrgrrrIcdSrrrs rrrsrrcdSrrrs rrrrr)rrrrLiteral[True] | NonecdSrrrs rrrrr)rrrrrcdSrrrs rrrrr)rrrrcdSrrrs rrrrr)rrrrIntoFrame | IntoSeries-DataFrame[Any] | LazyFrame[Any] | Series[Any]cdSrrrs rrr 58Cr)rrrrcdSrrrs rrrrrcdSrrrs rrrrrIntoDataFrameT | IntoSeries pass_throughcdSrrrrrrrrs rrrrrcdSrrrs rrrrrcdSrrrs rrrrrcdSrrrs rrrrrcdSrrrs rrrrrcdSrrrs rrrrrcdSrrrs rrrrrcdSrrrs rrr'rrIntoDataFrameT | IntoLazyFrameT5DataFrame[IntoDataFrameT] | LazyFrame[IntoLazyFrameT]cdSrrrs rrr3s =@CrcdSrrrs rrr?rr)rrrrcdSrrrs rrrKrr)rrrrcdSrrrs rrrWrr)rrrrcdSrrrs rrrcrr)rrrrcdSrrrs rrrorrrrrrrcdSrrrs rrr{rrcdSrrrs rrrrrF)rrrJcdSrrrs rrrs  #r)rrrrrrJIntoDataFrameT | IntoLazyFrameT | IntoFrame | IntoSeriesT | IntoSeries | TOLazyFrame[IntoLazyFrameT] | DataFrame[IntoDataFrameT] | Series[IntoSeriesT] | Tc <t|ttfr|s|St|tr|s|r|St ||d}|r.dt t |}t|t||||||tj S)aCConvert `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`. Fpass_through_defaultz1from_native() got an unexpected keyword argument )rrrrrversion) rrrr(rnextiterrrJrr) rrrrrrrrrs rrrs.-)Y!788-((k\2 5L V$tDzzBRBRVVnn !";!    r)rnarwhals_objectcdSrrrrs r to_nativer SrcdSrrrs rrrrrcdSrrrs rrr #rcdSrrrs rrrs=@SrrcdSrrrrs rrrrrcdSrrrs rrrrrcdSrrrs rrrrrcdSrrrs rrrr|r)rr3IntoLazyFrameT | IntoDataFrameT | IntoSeriesT | AnycVddlm}|||d}tj||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`. rrFrr)narwhals._utilsrnwr)rrrrs rrrsL@?????22 5L <l C C CCrTfuncCallable[..., Any] | NoneCallable[..., Any]cbt|ddfd }||S||S) a1Decorate 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`. TrrrrycJtdfd }|S)Nargsrrryc@ fd|D} fd|D}fdg||RD}|dkrd}t| |i|}t | S)Nc :g|]}t|Srr).0rrrrrrs r zBnarwhalify..decorator..wrapper..sL   !-).G +!-    rc Bi|]\}}|t|Srr)rrvaluerrrrrs r zBnarwhalify..decorator..wrapper..%sR    D%k!-).G +!-    rcJh|]}t|ddx S)__native_namespace__N)getattr)rvbs r zAnarwhalify..decorator..wrapper..1sG $:DAAAArz_Found multiple backends. Make sure that all dataframe/series inputs come from the same backend.r)itemsr__len__ ValueErrorr) rrbackendsrrrrrrrrrs @rwrapperz.narwhalify..decorator..wrappers            D        $*<<>>   F242&--//22H !!A%%w oo%T4*6**FV,??? ?r)rrrrryrr)rrrrrrrs` r decoratorznarwhalify..decorators^ t% @% @% @% @% @% @% @% @% @% @ % @NrN)rrryrr)rrrrrrrrs ````` r narwhalifyrsr 3 4L))))))))))V | 9T??rcBttjSr)rrrrrrrrG bfhh  rnamesstr | Iterable[str]c8ttj|Sr)rrcolrs rr r Ks bfen % %%rc8ttj|Sr)rrexcluder s rr r Os bj%( ) ))rindicesint | Sequence[int]c8ttj|Sr)rrnth)r s rrrS bfg& ' ''rcBttjSr)rrlenrrrrrWrrrrdrrcFttj||Sr)rrlit)rrs rrr[s bfUE** + ++rcolumnsrc8ttj|Sr)rrminrs rrr_rrc8ttj|Sr)rrmaxrs rrrcrrc8ttj|Sr)rrmeanrs rrrgs bgw' ( ((rc8ttj|Sr)rrmedianrs rrrks bi) * **rc8ttj|Sr)rrsumrs rr!r!orrexprsIntoExpr | Iterable[IntoExpr]c8ttj|Sr)rrsum_horizontalr"s rr%r%s b'/ 0 00r) ignore_nullsr(c>ttj|d|iSNr()rrall_horizontalr(r"s rr+r+w" b'J\JJ K KKrc>ttj|d|iSr*)rrany_horizontalr,s rr/r/}r-rc8ttj|Sr)rrmean_horizontalr&s rr1r1s b(%0 1 11rc8ttj|Sr)rrmin_horizontalr&s rr3r3r'rc8ttj|Sr)rrmax_horizontalr&s rr5r5r'r separatorr( more_exprsr`r8cHttj|g|R||dS)Nr7)rr concat_str)r"r8r(r9s rr;r;s5  eYjYYILYYY  rf_stringrc@ttj|g|RS)zFormat expressions as a string.)rrformat)r<rs rr>r>s" bi04000 1 11rc@ttj|g|RSr)rrcoalesce)r"r9s rr@r@s" bk%5*555 6 66r5DataFrame[Any] | LazyFrame[Any] | Series[IntoSeriesT]rxc|jS)aLevel 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`) )rrts r get_levelrCs :rc8eZdZed dZd fd ZxZS) Whenwhen nw_f.Whenryc"||jSr) _predicate)rrFs r from_whenzWhen.from_whenss4?###rr&IntoExpr | NonNestedLiteral | _1DArrayThencvtt|Sr)rL from_thenrthenrrrs rrOz When.thens%~~eggll511222r)rFrGryrE)rrKryrL)rrrrrJrOrrs@rrErEs[$$$[$3333333333rrEc8eZdZed dZd fd ZxZS) rLrO nw_f.Thenryc.||j|jSr)r;r)rrOs rrNzThen.from_thenss4*DN;;;rrrKr"c`tt|Sr)rr otherwiserPs rrUzThen.otherwises#%''++E22333r)rOrRryrL)rrKryr")rrrrrNrUrrs@rrLrLs[<<<[<4444444444rrL predicatescNttj|Sr)rErJnw_frF)rVs rrFrFs >>$)Z0 1 11r)required)rnative_namespacerrrrrZModuleType | Nonecbtd|}tt||||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`. rr)r rr#)rrrrrZs r new_seriesr]s4.88G &tVUGLLL M MMrrrSchtd|}ttj||S)aJConstruct 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`. rr)r rrXr)rrrZs rrrs1.88G dolGDDD E EErrrrrcJttj|||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)rrXrrrrrZs rrrs# dnT67CCC D DDrr rrhrcjtd|}ttj|||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`. rr)r rrXrr`s rrrs3.88G dodFGDDD E EErsourcer^rc dtd|}ttj|fd|i|S)aRead 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`. rr)r rrXread_csvrbrrZrs rrdrds9.88G dmFFFGFvFF G GGrIntoBackend[Backend] | Nonec dtd|}ttj|fd|i|S)aLazily 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 rrXscan_csvres rriri(s9)733G dmFFFGFvFF G GGrc dtd|}ttj|fd|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`. rr)r rrX read_parquetres rrkrk:s:.88G d'JJJ6JJ K KKrc dtd|}ttj|fd|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`. rhr)r rrX scan_parquetres rrmrmLs:)733G d'JJJ6JJ K KKr)Sr,r-r.r/rr0r1r2r3r4r"r5r6r7rr8r9r:r;r<rr=r>r&r(r?r@rArBrCrDrErFrGrr+r/r@r r$r;r)r*r r r>rrrrrrrCrKrrrrr5rrrrrrr1rrr3rr]rrdrkrirmr+r%r!r%rrLrF)rprqryrr)rprvryrw)rpryryrz)rpr}ryr")rprryr)rrnrrryrn)rrirrryri)rrlrrryrl)rrrrryr)rrrrrrrrrrrrryr)rrrrrrrrrrrrryr)rrHrrrrrrrrrrzryrr)rrprrrrrrrrrrzryrp)rrHrrrrrrrrrrzryrr)rrprrrrrrrrrrzryrp)rrrrrrrrrrrrryr)rrtrrrrrrrrrrzryrz)rrHrrrrrrrrrrzryrr)rrIrrrrrrrrrrzryrw)rrprrrrrrrrrrzryrp)rrHrrrrrrrrrrzryrr)rrIrrrrrrrrrrzryrw)rrHrrrrrrrrrrzryrr)rrrrrrrrrrrrryr)rrtrrrrrrrrrrzryrz)rrHrrrrrrrrrrzryrr)rrrrrrrrrrrrryrr)rrrrrrrrrrrrryr)rrHrrrrrrrrrrzryrr)rrprrrrrrrrrrzryrp)rrHrrrrrrrrrrzryrr)rrprrrrrrrrrrzryrp)rrrrrrrrrrrrryr)rrtrrrrrrrrrrzryrz)rrrrrrrrrrrrzryr)rrprrrrrrrrrrzryrp)rrHrrrrrrrrrrzryrr)rrHrrrrrrrrrrzryrr)rrrrrrrrrrrrryr)rrtrrrrrrrrrrzryrz)rrHrrrrrrrrrrzryrr)rrIrrrrrrrrrrzryrw)rrrrrrrrrrrrJryr)rrrrJrrJrrrrrrrrJrrryr)rrrrrryrH)rrwrrryrI)rrzrrryrt)rrrrryr)rrrrrryrH)rrwrrryrI)rrzrrryrt)rrrrryr)rrrrJrrJryrr)rrrrJrrJrrrrrrrrJryr)ryr")rrryr")r rryr")rrdrrryr")rrryr")r"r#ryr")r"r#r(rryr") r"r#r9r`r8rr(rryr")r<rrr`ryr")r"r#r9r`ryr")rprAryrx)rVr#ryrE) rrrrrrrrrZr[ryro)rrSrrrZr[ryrj) rrrrrrrZr[ryrj) rrhrrrrrZr[ryrj) rbr^rrrZr[rrryrj) rbr^rrfrZr[rrryrm) __future__r functoolsrtypingrrrr r r r narwhalsrr rrXnarwhals._exceptionsrnarwhals._typing_compatrrrrrrrrrrrrrrrnarwhals.dataframerrrrr2r rr"r}narwhals.functionsr#r$r%narwhals.schemar&rorr(r4narwhals.stable.v1r)r*r+narwhals.stable.v1.dtypesr,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGnarwhals.stable.v1.typingrHrInarwhals.translaterJrKrLcollections.abcrMrNrOtypesrPtyping_extensionsrQrRnarwhals._translaterSnarwhals._typingrTrUrVrWrXrYrZr[r\narwhals.dtypesr]narwhals.typingr^r_r`rarbrcrdrerfrgrhrirlrnrprrrsrtrrrrrr r rrrrrrrr!r%r+r/r1r3r5r;r>r@rCrErLrFr]rrr__annotations__rrdrirkrm__all__rrrrs"""""""OOOOOOOOOOOOOOOOOO22222222......99999999                            RQQQQQQQ444444((((((FFFFFFFFFF............>>>>>>>>>><EDDDDDDDTTTTTTTTTT%;;;;;;;;;;      11111111222222HGGGGGGG%%%%%%                          -=>>>J-=>>>Jgi}555GS!!!A #A Agm<EEE A-A-A-A-A- N+A-A-A-H8 8 8 8 8 N+8 8 8 vL L L L L Xk "L L L ^T T T T T 6T T T n!!!!!X!!! RRR R RRR R FFF F ((( (" DDD D JJJ J JJJ J """ "  "%"% ::::: : 14"% ::::: : "%"%$$$$$ $ "%"%        14"%$$$$$ $ 14"%        "%03"% VVVVV V "%03  "%03"%$$$$$ $ "%03"%$$$$$ $ "%03"%        $'!$"%$$$$$ $ $'!$03"%$$$$$ $ $'03"%$$$$$ $ $'!$03"% 88888 8 $'!$03  $'!$03"%$$$$$ $ "%"% $$$$$ $ 14"% ::::: : "%"%$$$$$ $ "%"%        14"%$$$$$ $ 14"%        "%03"% VVVVV V "%03  "%03"%@@@@@ @ "%03"%        $'!$"%$$$$$ $ $'03"%$$$$$ $ $'!$03"% 88888 8 $'!$03  $'!$03"%$$$$$ $ $'!$03"%$$$$$ $ ',  & $&+ $++++++\ KN  KN  EH  @@@ @ RU  RU  LO  FFF F $ DDDDDD.'+B $&+ $BBBBBBJ    &&&&****((((    ,,,,,(((((((())))++++((((1111 AFLLLLLLAFLLLLLL 222211111111 2222 7777&33333493334444449d4442222T***#N 15*. NNNNN+*N$T***15*. F F F F F+* F 37 E15*. E E E E E E ( ((((T***CGF15*. FFFFF+*F"T***15*. HHHHH+*H"T***,0*. HHHHH+*H"T***15*. LLLLL+*L"T***,0*. LLLLL+*L"T T T r