hSSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSKJ r SSKJ r SS KJ r SS KJ r SS KJr SS KJr SS KJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSKJ!r! SSKJ"r" SSKJ#r# SSKJ$r$ SS KJ%r% SS!KJ&r& SS"KJ'r' SS#KJ(r( SS$KJ)r) SS%KJ*r* SS&K+J,r, SS'K+J-r- \ (aHSS(K.J/r/ SS)K.J0r0 SS*K1J2r2 SS+K3J4r4 SS,K3J5r5 SS-K3J6r6 SS.K3J7r7 SS/K3J8r8 SS0K3J9r9 SS1K3J:r: SS2K3J;r; SS3K3J\?\@\A\B\C\4rD\S5S6.SbS7jj5rE\S5S6.ScS8jj5rE\S5S6.SdS9jj5rE\SeS:j5rES;S;S<.SfS=jjrE\SgS>j5rF\ShS?j5rF\SiS@j5rF\S5SA.SjSBjj5rF\S5S5S5SC.SkSDjj5rF\S5S5S5SC.SlSEjj5rF\S5S5SF.SmSGjj5rF\S5S5SF.SnSHjj5rF\S5S5SI.SoSJjj5rF\S5S5SK.SpSLjj5rF\S5S5S5S5SM.SqSNjj5rF\S5S5S5S5SM.SrSOjj5rF\S5S5S5SP.SsSQjj5rF\S5S5S5SR.StSSjj5rF\S5S5S5ST.SuSUjj5rF\SvSVj5rFS;S;SWSWS;SX.SwSYjjrFSWSWSWSWS;SZ.SxS[jjrGSyS\jrHSyS]jrISzS;S;SWSWS^SX.S{S_jjjrJS|S`jrK/SaQrLg;)}) annotations)datetime) timedelta)Decimalwraps) TYPE_CHECKING)Any)Callable)Literal)TypeVar)overload)is_native_arrow)is_native_polars)is_native_spark_like)get_cudf)get_cupy)get_dask) get_dask_expr) get_modin) get_numpy) get_pandas) get_polars) get_pyarrow)is_cudf_dataframe)is_cudf_series)is_dask_dataframe)is_duckdb_relation) is_ibis_table)is_modin_dataframe)is_modin_series)is_pandas_dataframe)is_pandas_series)is_polars_dataframe)is_polars_lazyframe)is_polars_series)is_pyarrow_chunked_array)is_pyarrow_table)Version)import_namespace DataFrame LazyFrameSeries) DataFrameT)IntoDataFrameT) IntoFrame) IntoFrameT)IntoLazyFrameT) IntoSeries) IntoSeriesT) LazyFrameT)SeriesTT. pass_throughcgNnarwhals_objectr<s D/var/www/html/env/lib/python3.13/site-packages/narwhals/translate.py to_nativerCFscgr>r?r@s rBrCrCJsrDcgr>r?r@s rBrCrCNsrDcgr>r?r@s rBrCrCRsCFrDN)strictr<cSSKJn SSKJn SSKJn U"XSSS9n[ X5(aURR$[ X5(aURR$U(dS[U5S 3n[U5eU$) aConvert Narwhals object to native one. Arguments: narwhals_object: Narwhals object. strict: Determine what happens if `narwhals_object` isn't a Narwhals class: - `True` (default): raise an error - `False`: pass object through as-is **Deprecated** (v1.13.0): Please use `pass_through` instead. Note that `strict` is still available (and won't emit a deprecation warning) if you use `narwhals.stable.v1`, see [perfect backwards compatibility policy](../backcompat.md/). pass_through: Determine what happens if `narwhals_object` isn't a Narwhals class: - `False` (default): raise an error - `True`: pass object through as-is Returns: Object of class that user started with. r) BaseFramer/validate_strict_and_pass_thoughFTpass_through_defaultemit_deprecation_warningzExpected Narwhals object, got .) narwhals.dataframerJnarwhals.seriesr0narwhals.utilsrL isinstance_compliant_frame _native_frame_compliant_seriesnativetype TypeError)rArHr<rJr0rLmsgs rBrCrCVs:-&>25SWL/--//===/**00777 .tO/D.EQGn rDc gr>r? native_objectkwdss rB from_nativer`sADrDc gr>r?r]s rBr`r`GJrDc gr>r?r]s rBr`r`rbrD) series_onlycgr>r?r^r< eager_onlyrd allow_seriess rBr`r`s7:rD)rgrdrhcgr>r?rfs rBr`r`!$rDcgr>r?rfs rBr`r` rD)rdrhcgr>r?rfs rBr`r`rjrDcgr>r?rfs rBr`r`rlrD)rgrdcgr>r?rfs rBr`r`s ORrD)rgrhcgr>r?rfs rBr`r`rDr<rgrdrhcgr>r?rfs rBr`r`rjrDcgr>r?rfs rBr`r`rjrD)r<rdrhcgr>r?rfs rBr`r`rjrD)r<rgrdcgr>r?rfs rBr`r`s58rD)r<rgrhcgr>r?rfs rBr`r`rqrDcgr>r?rfs rBr`r`s rDF)rHr<rgrdrhc SSKJn U"XSSS9nU(a#S[[U55<3n[ U5e[ UUUSUU[ RS9$)aConvert `native_object` to Narwhals Dataframe, Lazyframe, or Series. Arguments: native_object: Raw object from user. Depending on the other arguments, input object can be: - a Dataframe / Lazyframe / Series supported by Narwhals (pandas, Polars, PyArrow, ...) - an object which implements `__narwhals_dataframe__`, `__narwhals_lazyframe__`, or `__narwhals_series__` strict: Determine what happens if the object can't be converted to Narwhals: - `True` or `None` (default): raise an error - `False`: pass object through as-is **Deprecated** (v1.13.0): Please use `pass_through` instead. Note that `strict` is still available (and won't emit a deprecation warning) if you use `narwhals.stable.v1`, see [perfect backwards compatibility policy](../backcompat.md/). pass_through: Determine what happens if the object can't be converted to Narwhals: - `False` or `None` (default): raise an error - `True`: pass object through as-is eager_only: Whether to only allow eager objects: - `False` (default): don't require `native_object` to be eager - `True`: only convert to Narwhals if `native_object` is eager series_only: Whether to only allow Series: - `False` (default): don't require `native_object` to be a Series - `True`: only convert to Narwhals if `native_object` is a Series allow_series: Whether to allow Series (default is only Dataframe / Lazyframe): - `False` or `None` (default): don't convert to Narwhals if `native_object` is a Series - `True`: allow `native_object` to be a Series Returns: DataFrame, LazyFrame, Series, or original object, depending on which combination of parameters was passed. rrKFTrMz1from_native() got an unexpected keyword argument )r<rgeager_or_interchange_onlyrdrhversion)rSrLnextiterrZ_from_native_implr)MAIN) r^rHr<rgrdrhr_rLr[s rBr`r`%seb?25SWL A$tDzBRAUVn !"'!  rD)r<rgrzrdrhc pSSKJn SSKJn SSKJn SSKJn SSKJn SSKJn SSKJ n SS KJ n SS KJ n [XU45(a U(dU$[X 5(aU(dU(aU$U(aUS La S n[U5eS nU(aU(a Sn[U5eU "U5(a2U(aU(d Sn[U5eU$U"UR5SS9$U "U5(aVU(aU(d Sn[U5eU$U(dU(aU(d Sn[U5eU$U"UR!5SS9$U"U5(a2U(dU(d Sn[U5eU$U "UR#5SS9$[%U5(GaSSKJn U(a<[+U5(d,U(d#S[-U5R.3n[U5eU$U(dU(a&[1U5(aU(d Sn[U5eU$U(d&[+U5(aU(d Sn[U5eU$U"[355nU"UUS9nUR5U5nU "U5(aU"USS9$U "U5(aU"USS9$U "USS9$[7U5(aLSSKJn U(aU(d Sn[U5eU$[=5nU"U"UU"U5U R>US S9SS9$[AU5(aKSSK!J"n U(dU(d Sn[U5eU$[=5nU "U"UU R>U"U5US9SS9$[GU5(aLSSKJn [I5nU(aU(d Sn[U5eU$U"U"UU RJU"U5US S9SS9$[MU5(aKSSK!J"n [I5nU(dU(d Sn[U5eU$U "U"UU RJU"U5US9SS9$[OU5(aLSSKJn [Q5nU(aU(d S n[U5eU$U"U"UU RRU"U5US S9SS9$[UU5(aKSSK!J"n [Q5nU(dU(d Sn[U5eU$U "U"UU RRU"U5US9SS9$[WU5(aU(a<[YU5(a,U(d#S[-U5R.3n[U5eU$U(d&[YU5(dU(d Sn[U5eU$[[U5R]U5R^R5U5nU "U5(aU"USS9$U "USS9$[aU5(aSS!K1J2n U(aU(d S"n[U5eU$U(dU(aU(d S#n[U5eU$U"[g55nUS$::a[i5c S%n[kU5eU"UUS9nU"UR5U5SS9$[mU5(axU(dU(aU(d S&n[U5eU$[[U5R]U5R^R5U5nU[nRpLaU"US'S9$U"USS9$[sU5(acSS(K:J;n U(dU(aU(d S)n[U5eU$SSK552,-Y!788-((k\ 5 ^CS/ ! /eom,, Dn$   0 0 2   . . Dn$ 2bn$   0 0 2   ] + +Ln$   - - /  - ( (> / >>;D>> import polars as pl >>> import pandas as pd >>> import narwhals as nw >>> df = nw.from_native(pd.DataFrame({"a": [1, 2, 3]})) >>> nw.get_native_namespace(df) >>> df = nw.from_native(pl.DataFrame({"a": [1, 2, 3]})) >>> nw.get_native_namespace(df) z=At least one object must be passed to `get_native_namespace`.rz0Found objects with different native namespaces: rP)r _get_native_namespace_single_objlenpop)objr[xresults rBget_native_namespacersf0 Mo;> ?3a.q13F ? 6{a@Jo ::< @sA crSSKJn U"U5(aUR5$[U5(d[ U5(a [ 5$[ U5(d[U5(a [5$[U5(d[U5(a [5$[U5(d[U5(a [5$[U5(a [!5$[#U5(d [%U5(d['U5(a [)5$S[+U53n[-U5e)Nr)has_native_namespacez4Could not get native namespace from object of type: )rSr__native_namespace__r"r#rr r!rr(r'rrrrrrr$r%r&rrYrZ)rrr[s rBrrs4C  ''))3#3C#8#8|#/#"6"6{ 8 = =}!4!4zz3#6s#;#;?OPS?T?T| @c LC C.rDTcX^^^^SSKJn U"UTSSS9mSUUUU4SjjnUcU$U"U5$)aDecorate function so it becomes dataframe-agnostic. This will try to convert any dataframe/series-like object into the Narwhals respective DataFrame/Series, while leaving the other parameters as they are. Similarly, if the output of the function is a Narwhals DataFrame or Series, it will be converted back to the original dataframe/series type, while if the output is another type it will be left as is. By setting `pass_through=False`, then every input and every output will be required to be a dataframe/series-like object. Arguments: func: Function to wrap in a `from_native`-`to_native` block. strict: **Deprecated** (v1.13.0): Please use `pass_through` instead. Note that `strict` is still available (and won't emit a deprecation warning) if you use `narwhals.stable.v1`, see [perfect backwards compatibility policy](../backcompat.md/). Determine what happens if the object can't be converted to Narwhals: - `True` or `None` (default): raise an error - `False`: pass object through as-is pass_through: Determine what happens if the object can't be converted to Narwhals: - `False` or `None` (default): raise an error - `True`: pass object through as-is eager_only: Whether to only allow eager objects: - `False` (default): don't require `native_object` to be eager - `True`: only convert to Narwhals if `native_object` is eager series_only: Whether to only allow Series: - `False` (default): don't require `native_object` to be a Series - `True`: only convert to Narwhals if `native_object` is a Series allow_series: Whether to allow Series (default is only Dataframe / Lazyframe): - `False` or `None`: don't convert to Narwhals if `native_object` is a Series - `True` (default): allow `native_object` to be a Series Returns: Decorated function. Examples: Instead of writing >>> import narwhals as nw >>> def agnostic_group_by_sum(df): ... df = nw.from_native(df, pass_through=True) ... df = df.group_by("a").agg(nw.col("b").sum()) ... return nw.to_native(df) you can just write >>> @nw.narwhalify ... def agnostic_group_by_sum(df): ... return df.group_by("a").agg(nw.col("b").sum()) rrKTrMc>>^[T5SUUUUU4Sjj5nU$)Nc >UVs/sHn[UT T TT S9PM nnUR5VVs0sHup4U[UT T TT S9_M nnn/UQUR5Q7Vs1sH n[USS5=n(dMU"5iM" nn[ U5S:a Sn[ U5eT "U0UD6n [ U T S9$s snfs snnfs snf)Nrrrrz_Found multiple backends. Make sure that all dataframe/series inputs come from the same backend.r;)r`itemsvaluesgetattrrrrC)argskwargsargnamevaluevbbackendsr[rrhrgfuncr<rds rBwrapper.narwhalify..decorator..wrapper@s   C!-) +!-    &$*<<> $2KDk!-) +!- $2  342&--/22A $:DAAAA2  8}q w o%4*6*FV,? ?E  sB=C&C C)rr rr returnr r)rrrhrgr<rds` rB decoratornarwhalify..decorator?s) t# @# @ # @JrD)rCallable[..., Any]rr)rSrL)rrHr<rgrdrhrLrs ```` rB narwhalifyrsAB?2 4RVL''R |rDcUcg[U[5(aU$[5nU(aR[XR5(a8URS:Xa([ SSS5[ UR5S-S9-$U(a7URU5(a![US5(aUR5$[5nU(a*[XR5(aUR5$U(a*[XR5(aUR5$U(aEURR R#U5(aUR%U5nU(ag[U[ [ 45(aU$[)5nU(a*[XR*5(aUR-5$[/5nU(a:[XR05(a UR2S:XaUR5$S[5U5S 3n[7U5e![&a Nf=f) a)If a scalar is not Python native, converts it to Python native. Arguments: scalar_like: Scalar-like value. Returns: Python scalar. Raises: ValueError: If the object is not convertible to a scalar. Examples: >>> import narwhals as nw >>> import pandas as pd >>> df = nw.from_native(pd.DataFrame({"a": [1, 2, 3]})) >>> nw.to_py_scalar(df["a"].item(0)) 1 >>> import pyarrow as pa >>> df = nw.from_native(pa.table({"a": [1, 2, 3]})) >>> nw.to_py_scalar(df["a"].item(0)) 1 >>> nw.to_py_scalar(1) 1 Nzdatetime64[ns]iri) microsecondsitemz/Expected object convertible to a scalar, found zH. Please report a bug to https://github.com/narwhals-dev/narwhals/issues)rTNON_TEMPORAL_SCALAR_TYPESr datetime64dtyperrrisscalarhasattrr Timestamp to_pydatetime Timedeltato_pytimedeltaapitypes is_scalarisna ExceptionrScalaras_pyrndarraysizerYr) scalar_likenpris_napacupyr[s rB to_py_scalarros2+899 B {MM 2 2   !1 1a#i[=M=M=OSW=W&XXX bkk+&&7;+G+G!! B jll33((** jll33))++ bffll$$[11 GGK(E +)455 B jii00  "" :D K66;;K;Kq;P!! :${:K9LMQ Q S/3   sH22 H?>H?)rrrCr)rADataFrame[IntoDataFrameT]r<Literal[False]rr2)rAzLazyFrame[IntoFrameT]r<rrr4)rASeries[IntoSeriesT]r<rrr7)rAr r<boolrr )rAzGDataFrame[IntoDataFrameT] | LazyFrame[IntoFrameT] | Series[IntoSeriesT]rH bool | Noner<rrz/IntoDataFrameT | IntoFrameT | IntoSeriesT | Any)r^r9r_r rr9)r^r1r_r rr1)r^r8r_r rr8) r^zIntoDataFrameT | IntoSeriesTr< Literal[True]rgrrdrrhrrz/DataFrame[IntoDataFrameT] | Series[IntoSeriesT]) r^r2r<rrgrrdrrhNonerr) r^r:r<rrgrrdrrhrrr:) r^r2r<rrgrrdrrhrrr) r^r:r<rrgrrdrrhrrr:) r^z)IntoFrameT | IntoLazyFrameT | IntoSeriesTr<rrgrrdrrhrrzGDataFrame[IntoFrameT] | LazyFrame[IntoLazyFrameT] | Series[IntoSeriesT]) r^r7r<rrgrrdrrhrrr) r^r5r<rrgrrdrrhrrzLazyFrame[IntoLazyFrameT]) r^r2r<rrgrrdrrhrrr) r^r2r<rrgrrdrrhrrr) r^zIntoFrame | IntoSeriesr<rrgrrdrrhrrz-DataFrame[Any] | LazyFrame[Any] | Series[Any]) r^r7r<rrgrrdrrhrrr) r^r r<rrgrrdrrhrrr )r^zFIntoLazyFrameT | IntoFrameT | IntoSeriesT | IntoFrame | IntoSeries | TrHrr<rrgrrdrrhrr_r rzKLazyFrame[IntoLazyFrameT] | DataFrame[IntoFrameT] | Series[IntoSeriesT] | T)r^r r<rrgrrzrrdrrhrr{r)rr )rzFDataFrame[Any] | LazyFrame[Any] | Series[Any] | IntoFrame | IntoSeriesrr r>)rzCallable[..., Any] | NonerHrr<rrgrrdrrhrrr)rr rr )M __future__rrrdecimalr functoolsrtypingr r r r r rnarwhals._namespacerrrnarwhals.dependenciesrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(rSr)r*rQr,r.rRr0narwhals.typingr1r2r3r4r5r6r7r8r9r:rbytesstrintfloatcomplexrrCr`r~rrrr__all__r?rDrBrs" /04***/++,,-3034/4152552:2"+,,&*.)*.*+*' CL      RU.AO  NQ*=K  LO(;I  F F $ --  -  -5-` D D J J J J #& :/: : :  :  :5: : "%"% $!$ $ $  $  $$ $ "%"%               #& $!$ $ $  $  $$ $ #&               "%"% R<R R R  R  RMR R "%         $'!$"% $!$!$ $  $  $$ $ $'!$"% $!$!$ $  $  $$ $ $'"% $!$!$ $  $  $$ $ $'!$"% 8)8!8 8  8  838 8 $'!$ !               $ $BYB B B  B  BB BQBP&+ $RRR R $ RRRR Rj  PD O0'+t $ $t #t t t  t  tttnJZ rD