-jdSSKJr SSKrSSKJrJr SSKJr \(ahSSKJr SSK r SSK J r SSK r SSKrSSKJr SSKrSSKrSSKrSSKJr SSKJr SSKJr SSKJ r SS K!JrJ"r" SS K#J$r$ SS K%J&r&J'r'J(r(J)r)J*r*J+r+J,r,J-r-J.r.J/r/ \0"S /5r1ScS jr2ScSjr3ScSjr4ScSjr5ScSjr6ScSjr7ScSjr8ScSjr9ScSjr:ScSjr;ScSjrScSjr?ScSjr@ScSjrASdSjrBSeSjrCSfSjrDSfS jrESgS!jrFSgS"jrGShS#jrHSiS$jrISiS%jrJSjS&jrKSjS'jrLSkS(jrMSlS)jrNSlS*jrOSmS+jrPSmS,jrQSnS-jrRSoS.jrSSpS/jrTSpS0jrUSqS1jrVSqS2jrWSrS3jrXSrS4jrYSsS5jrZSsS6jr[StS7jr\StS8jr]SuS9jr^SuS:jr_SvS;jr`SwS<jraSxS=jrbSxS>jrcSyS?jrdSyS@jreSzSAjrfS{SBjrgS|SCjrhS}SDjriS}SEjrjS~SFjrkS~SGjrlSSHjrmSSIjrnSSJjroSSKjrpSSLjrqSSMjrrSSNjrsSSOjrtSSPjruSSQjrvSSRjrwSSSjrxSSTjrySSUjrzSSVjr{SSWjr|SSXjr}SSYjr~SSZjrSS[jrSS\jrSS]jrSS^jrSS_jrSS`jrSSajr/SbQrg)) annotationsN) TYPE_CHECKINGAny) issue_warning) TypeGuard DataFrame)TypeIs)SQLFrameDataFrame)r LazyFrameSeries) IntoDataFrameTIntoLazyFrameT IntoSeriesTPandasLikeDType_1DArray _1DArrayInt_2DArray_NDArray _NumpyScalar_ShapeT fireduckscB[RRSS5$)z;Get Polars module (if already imported - else return None).polarsNsysmodulesgetڣC:\Users\johnn\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.13_qbz5n2kfra8p0\LocalCache\local-packages\Python313\site-packages\narwhals/dependencies.py get_polarsr#1 ;;??8T **r!cB[RRSS5$)z;Get pandas module (if already imported - else return None).pandasNrr r!r" get_pandasr'6r$r!cB[RRSS5$)zAGet modin.pandas module (if already imported - else return None).z modin.pandasNrr r!r" get_modinr);s ;;??>4 00r!cB[RRSS5$)z9Get cudf module (if already imported - else return None).cudfNrr r!r"get_cudfr,@ ;;??64 ((r!cB[RRSS5$)z9Get cupy module (if already imported - else return None).cupyNrr r!r"get_cupyr0Er-r!cB[RRSS5$)zGet dask_expr module (if already imported - else return None).N dask_expr)r<hasattrrDrrr)dds r" get_dask_exprrGhs; ""/GB 4L4L|| ;;??; --r!cB[RRSS5$)z# UHPn[RRUS5=mSL=(a [TTRR 5v MR g7fN)rrr isinstancer&r ).0 module_namedfmods r" '_is_pandas_dataframe..sRV(K  T2 24? 1 r3::// 0 1'AA)r'rkr any IMPORT_HOOKS)rnpdros` @r"_is_pandas_dataframervsF< R , MB 1M RUV(VSr!c.[U5 [U5$)zCheck whether `df` is a pandas DataFrame without importing pandas. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrvrns r"is_pandas_dataframery r"  ##r!c^^[5=nSL=(a [TUR5=(d [UU4Sj[55$)z@Check whether `ser` is a pandas Series without importing pandas.Nc3># UHPn[RRUS5=mSL=(a [TTRR 5v MR g7frj)rrrrkr&r)rlrmrorfs r"rp$_is_pandas_series..sRT(K  T2 24? / sCJJ-- . /'rr)r'rkrrsrt)rfruros` @r"_is_pandas_seriesr~sF< R , KC1K PST(TQr!c.[U5 [U5$)zCheck whether `ser` is a pandas Series without importing pandas. Warning: This method cannot be called on Narwhals Series. )rgr~rfs r"is_pandas_seriesr S! S !!r!c^^[5=nSL=(a [TUR5=(d [UU4Sj[55$)zACheck whether `index` is a pandas Index without importing pandas.Nc3># UHPn[RRUS5=mSL=(a [TTRR 5v MR g7frj)rrrrkr&Index)rlrmindexros r"rp"is_pandas_index..sRU(K  T2 24? 0 ucjj.. / 0'rr)r'rkrrsrt)rruros` @r"is_pandas_indexrsF< R , LE2881L QTU(URr!cV[5=nSL=(a [XR5$)z@Check whether `df` is a modin DataFrame without importing modin.N)r)rkr )rnmpds r"_is_modin_dataframers"; Ct + M 2}}0MMr!c.[U5 [U5$)zCheck whether `df` is a modin DataFrame without importing modin. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrrxs r"is_modin_dataframer r" r ""r!cV[5=nSL=(a [XR5$)z>Check whether `ser` is a modin Series without importing modin.N)r)rkr)rfrs r"_is_modin_seriesrs"; Ct + K 3 0KKr!c.[U5 [U5$)z~Check whether `ser` is a modin Series without importing modin. Warning: This method cannot be called on Narwhals Series. )rgrrs r"is_modin_seriesrs S! C  r!cV[5=nSL=(a [XR5$)z?Check whether `index` is a modin Index without importing modin.N)r)rkr)rrs r"is_modin_indexrs"; Ct + L 5))0LLr!cV[5=nSL=(a [XR5$)z>Check whether `df` is a cudf DataFrame without importing cudf.N)r,rkr )rnr+s r"_is_cudf_dataframers"J Dt + N 2~~0NNr!c.[U5 [U5$)zCheck whether `df` is a cudf DataFrame without importing cudf. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrrxs r"is_cudf_dataframer r" b !!r!cV[5=nSL=(a [XR5$)zCheck whether `df` is a Dask DataFrame without importing Dask.N)r<rkr )rnrFs r"_is_dask_dataframers#$& &Bt 3 T 2||8TTr!c.[U5 [U5$)zCheck whether `df` is a Dask DataFrame without importing Dask. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrrxs r"is_dask_dataframer!rr!cV[5=nSL=(a [XR5$)zACheck whether `df` is a DuckDB Relation without importing DuckDB.N)r?rkDuckDBPyRelation)rnr>s r"_is_duckdb_relationr+s+ l "F4 / J # #5r!c.[U5 [U5$)zCheck whether `df` is a DuckDB Relation without importing DuckDB. Warning: This method cannot be called on Narwhals DataFrame/LazyFrame. )rcrrxs r"is_duckdb_relationr2rr!c~[5=nSL=(a) [XRRR5$)z:Check whether `df` is a Ibis Table without importing Ibis.N)rBrkexprtypesTable)rnrAs r"_is_ibis_tabler<s,J Dt + U 2yy?T?T0UUr!c.[U5 [U5$)zCheck whether `df` is a Ibis Table without importing Ibis. Warning: This method cannot be called on Narwhals DataFrame/LazyFrame. )rcrrxs r" is_ibis_tablerAs r" " r!cV[5=nSL=(a [XR5$)zBCheck whether `df` is a Polars DataFrame without importing Polars.N)r#rkr rnpls r"_is_polars_dataframerK", Bt + L 2||0LLr!c.[U5 [U5$)zCheck whether `df` is a Polars DataFrame without importing Polars. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrrxs r"is_polars_dataframerPrzr!cV[5=nSL=(a [XR5$)zBCheck whether `df` is a Polars LazyFrame without importing Polars.N)r#rkr rs r"_is_polars_lazyframerZrr!c.[U5 [U5$)zCheck whether `df` is a Polars LazyFrame without importing Polars. Warning: This method cannot be called on Narwhals DataFrame/LazyFrame. )rcrrxs r"is_polars_lazyframer_rzr!cV[5=nSL=(a [XR5$)z@Check whether `ser` is a Polars Series without importing Polars.N)r#rkr)rfrs r"_is_polars_seriesris", Bt + J 3 0JJr!c.[U5 [U5$)zCheck whether `ser` is a Polars Series without importing Polars. Warning: This method cannot be called on Narwhals Series. )rgrrs r"is_polars_seriesrnrr!c[[5=n5=(a( [US5=(a [XR5$)NSchema)boolr#rErkrrrs r"is_polars_schemarxs0 :< R YWR%:Yz#yy?Yr!cd[[5=n5=(a [XR5$rj)rr#rkDataTypers r"is_polars_data_typers" jl" # D 3 (DDr!cV[5=nSL=(a [XR5$)zHCheck whether `ser` is a PyArrow ChunkedArray without importing PyArrow.N)r3rk ChunkedArray)rfpas r"_is_pyarrow_chunked_arrayrs"- B , QC1QQr!c.[U5 [U5$)zCheck whether `ser` is a PyArrow ChunkedArray without importing PyArrow. Warning: This method cannot be called on Narwhals Series. )rgrrs r"is_pyarrow_chunked_arrayrs S! $S ))r!cV[5=nSL=(a [XR5$)z@Check whether `df` is a PyArrow Table without importing PyArrow.N)r3rkr)rnrs r"_is_pyarrow_tablers"- B , IB1IIr!c.[U5 [U5$)zCheck whether `df` is a PyArrow Table without importing PyArrow. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrrxs r"is_pyarrow_tablers r" R  r!cV[5=nSL=(a [XR5$rj)r3rkScalarrrs r"is_pyarrow_scalarrs"- B , KC1KKr!cd[[5=n5=(a [XR5$rj)rr3rkrrs r"is_pyarrow_schemars" km# $ CC)CCr!cd[[5=n5=(a [XR5$rj)rr3rkrrs r"is_pyarrow_data_typers" km# $ EC)EEr!ch[[5=nSL=(a [XR55$)zDCheck whether `df` is a PySpark DataFrame without importing PySpark.N)rrLrkr )rn pyspark_sqls r"_is_pyspark_dataframers2 ') )$6 2 r00 1 r!c.[U5 [U5$)zCheck whether `df` is a PySpark DataFrame without importing PySpark. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrrxs r"is_pyspark_dataframers r"  $$r!c^[5bSSKJn [ X5$g![a gf=f)zLCheck whether `df` is a PySpark Connect DataFrame without importing PySpark.rrF)rNpyspark.sql.connect.dataframer ImportErrorrkrnr s r"_is_pyspark_connect_dataframers7(  ?"((   s  ,,c.[U5 [U5$)zCheck whether `df` is a PySpark Connect DataFrame without importing PySpark. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrrxs r"is_pyspark_connect_dataframers r" ( ,,r!c<[5bSSKJn [X5$g)zFCheck whether `df` is a SQLFrame DataFrame without importing SQLFrame.r) BaseDataFrameF)rQsqlframe.base.dataframerrk)rnrs r"_is_sqlframe_dataframers~!9",, r!c.[U5 [U5$)zCheck whether `df` is a SQLFrame DataFrame without importing SQLFrame. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcrrxs r"is_sqlframe_dataframers r" !" %%r!cV[5=nSL=(a [XR5$)z=Check whether `arr` is a NumPy Array without importing NumPy.N)r7rkrarrnps r"is_numpy_arrayrs"+ Bd * Jz#zz/JJr!cD[U5=(a URS:H$)z@Check whether `arr` is a 1D NumPy Array without importing NumPy.rUrndimrs r"is_numpy_array_1dr #  0388q=0r!c[5=n=(a8 [U5=(a& URURUR5$rj)r7r issubdtypedtypeintegerrs r"is_numpy_array_1d_intrs9{  1 c " 1 MM#))RZZ 0r!c[5=n=(a8 [U5=(a& URURUR5$rj)r7rrrbool_rs r"is_numpy_array_1d_boolrs9{  / c " / MM#))RXX .r!cD[U5=(a URS:H$)z@Check whether `arr` is a 2D NumPy Array without importing NumPy.rrs r"is_numpy_array_2drrr!cV[5=nSL=(a [XR5$)zACheck whether `scalar` is a NumPy Scalar without importing NumPy.N)r7rkgeneric)scalarrs r"is_numpy_scalarr s$ + Bd * Mz&**/MMr!c`[U5=(d [U5=(d [U5$)zzCheck whether `df` is a pandas-like DataFrame without doing any imports. By "pandas-like", we mean: pandas, Modin, cuDF. )rvrrrxs r"_is_pandas_like_dataframer s&  # X':2'> XBTUWBXXr!c.[U5 [U5$)zCheck whether `df` is a pandas-like DataFrame without doing any imports. By "pandas-like", we mean: pandas, Modin, cuDF. Warning: This method cannot be called on a Narwhals DataFrame/LazyFrame. )rcr rxs r"is_pandas_like_dataframer sr" $R ((r!c`[U5=(d [U5=(d [U5$)zxCheck whether `ser` is a pandas-like Series without doing any imports. By "pandas-like", we mean: pandas, Modin, cuDF. )r~rrrs r"_is_pandas_like_seriesr"s$ S ! R%5c%: Roc>RRr!c.[U5 [U5$)zCheck whether `ser` is a pandas-like Series without doing any imports. By "pandas-like", we mean: pandas, Modin, cuDF. Warning: This method cannot be called on Narwhals Series. )rgrrs r"is_pandas_like_seriesr*sS! !# &&r!c`[U5=(d [U5=(d [U5$)zyCheck whether `index` is a pandas-like Index without doing any imports. By "pandas-like", we mean: pandas, Modin, cuDF. )rrr)rs r"is_pandas_like_indexr6s% O."7O=;Or!c[[5=n5=(a= [XRRR [ 5R45$rj)rr'rkapi extensionsExtensionDtyper7rrrus r"is_pandas_like_dtyper@sB jl" #   ff.. 0A0A B)r!c[[5=n5=(a< [XRRR 5=(a [ US5$)Nto_arrow)rr'rkrrrrErs r" is_cudf_dtyperFsD :< R  % sVV..== ? % C $r!cSSKJn SSKJn U"US5=(dG [ U5=(d5 [ U5=(d# [ U5=(d URU5$)Nrplugins_hasattr_static__narwhals_series__)narwhalsrr[r!rrris_native_seriesrrr!s r"_is_native_seriesr&PsX / 23 ) S ! ) $S ) ) "# & )  # #C ( r!cSSKJn SSKJn U"US5=(dG [ U5=(d5 [ U5=(d# [ U5=(d URU5$)Nrrr __narwhals_dataframe__)r#rr[r!rrr is_native_dataframer%s r"_is_native_dataframer*]sX / 56 ,  $ , S ! , %S ) ,  & &s + r!cXSSKJn SSKJn U"US5=(d [ U5=(d} [ U5=(dk [ U5=(dY [U5=(dG [U5=(d5 [U5=(d# [U5=(d URU5$)Nrrr __narwhals_lazyframe__) r#rr[r!rrrrrrris_native_lazyframer%s r"_is_native_lazyframer.js / 56 ,  $ , c " , s # , #   , ! %  , ) -  , "# & ,  & &s + r!cHSSKJn [X5=(d [U5$)a Check whether `native_series` can be converted to a Narwhals Series. Arguments: native_series: The object to check. Examples: >>> import pandas as pd >>> import polars as pl >>> import numpy as np >>> import narwhals as nw >>> s_pd = pd.Series([1, 2, 3]) >>> s_pl = pl.Series([1, 2, 3]) >>> np_arr = np.array([1, 2, 3]) >>> nw.dependencies.is_into_series(s_pd) True >>> nw.dependencies.is_into_series(s_pl) True >>> nw.dependencies.is_into_series(np_arr) False rr )narwhals.seriesrrkr&) native_seriesrs r"is_into_seriesr2{s.' m , P0A-0PPr!cHSSKJn [X5=(d [U5$)aPCheck whether `native_dataframe` can be converted to a Narwhals DataFrame. Arguments: native_dataframe: The object to check. Examples: >>> import pandas as pd >>> import polars as pl >>> import numpy as np >>> from narwhals.dependencies import is_into_dataframe >>> df_pd = pd.DataFrame({"a": [1, 2, 3], "b": [4, 5, 6]}) >>> df_pl = pl.DataFrame({"a": [1, 2, 3], "b": [4, 5, 6]}) >>> np_arr = np.array([[1, 4], [2, 5], [3, 6]]) >>> is_into_dataframe(df_pd) True >>> is_into_dataframe(df_pl) True >>> is_into_dataframe(np_arr) False rr)narwhals.dataframer rkr*)native_dataframer s r"is_into_dataframer6%.- & 2 6J7r!cHSSKJn [X5=(d [U5$)aQCheck whether `native_lazyframe` can be converted to a Narwhals LazyFrame. Arguments: native_lazyframe: The object to check. Examples: >>> import pandas as pd >>> import polars as pl >>> import numpy as np >>> from narwhals.dependencies import is_into_lazyframe >>> df_pd = pd.DataFrame({"a": [1, 2, 3], "b": [4, 5, 6]}) >>> lf_pl = pl.LazyFrame({"a": [1, 2, 3], "b": [4, 5, 6]}) >>> np_arr = np.array([[1, 4], [2, 5], [3, 6]]) >>> is_into_lazyframe(df_pd) False >>> is_into_lazyframe(lf_pl) True >>> is_into_lazyframe(np_arr) False rr )r4r rkr.)native_lazyframer s r"is_into_lazyframer;r7r!c$SSKJn [X5$)zCheck whether `df` is a Narwhals DataFrame. This is useful if you expect a user to pass in a Narwhals DataFrame directly, and you want to catch both `narwhals.DataFrame` and `narwhals.stable.v1.DataFrame`. rr)r4r rkrs r"rYrY- b $$r!c$SSKJn [X5$)zCheck whether `lf` is a Narwhals LazyFrame. This is useful if you expect a user to pass in a Narwhals LazyFrame directly, and you want to catch both `narwhals.LazyFrame` and `narwhals.stable.v1.LazyFrame`. rr9)r4r rk)lfr s r"rZrZr=r!c$SSKJn [X5$)zCheck whether `ser` is a Narwhals Series. This is useful if you expect a user to pass in a Narwhals Series directly, and you want to catch both `narwhals.Series` and `narwhals.stable.v1.Series`. rr )r0rrk)rfrs r"reres' c ""r!cZ[U5=(a URR5$rj)rer is_integerrs r"is_narwhals_series_intrCs c " =syy';';'==r!cZ[U5=(a URR5$rj)rer is_booleanrs r"is_narwhals_series_boolrFs! c " =syy';';'==r!),r,r:r<r?rBr)r7r'r#r3rJrNrLrQrrrrrrr6r;r2rrrrYrZrerryrr rrrrrrrrrrr)returnr)r`rrGNone)rfrrGrH)rnrrGzTypeIs[pd.DataFrame])rfrrGzTypeIs[pd.Series[Any]])rrrGzTypeIs[pd.Index[Any]])rnrrGzTypeIs[mpd.DataFrame])rfrrGzTypeIs[mpd.Series])rrrGzTypeIs[mpd.Index[Any]])rnrrGzTypeIs[cudf.DataFrame])rfrrGzTypeIs[cudf.Series[Any]])rrrGzTypeIs[cudf.Index])rrrGr)rnrrGzTypeIs[dd.DataFrame])rnrrGzTypeIs[duckdb.DuckDBPyRelation])rnrrGzTypeIs[ibis.Table])rnrrGzTypeIs[pl.DataFrame])rnrrGzTypeIs[pl.LazyFrame])rfrrGzTypeIs[pl.Series])rrrGzTypeIs[pl.Schema])rrrGzTypeIs[pl.DataType])rfrrGzTypeIs[pa.ChunkedArray[Any]])rnrrGzTypeIs[pa.Table])rrrGzTypeIs[pa.Scalar[Any]])rrrGzTypeIs[pa.Schema])rrrGzTypeIs[pa.DataType])rnrrGzTypeIs[pyspark_sql.DataFrame])rnrrGzTypeIs[PySparkConnectDataFrame])rnrrGzTypeIs[SQLFrameDataFrame])rzAny | _NDArray[_ShapeT]rGzTypeIs[_NDArray[_ShapeT]])rrrGzTypeIs[_1DArray])rrrGzTypeIs[_1DArrayInt])rrrGzTypeIs[_2DArray])rrrGzTypeGuard[_NumpyScalar])rnrrGr)rfrrGr)rrrGr)rrrGzTypeIs[PandasLikeDType])rrrGz(TypeIs[pd.api.extensions.ExtensionDtype])rAny | IntoSeriesTrGTypeIs[IntoSeriesT])rAny | IntoDataFrameTrGTypeIs[IntoDataFrameT])rAny | IntoLazyFrameTrGTypeIs[IntoLazyFrameT])r1rIrGrJ)r5rKrGrL)r:rMrGrN)rnzDataFrame[IntoDataFrameT] | AnyrGz!TypeIs[DataFrame[IntoDataFrameT]])r?zAny | LazyFrame[IntoLazyFrameT]rGz!TypeIs[LazyFrame[IntoLazyFrameT]])rfzAny | Series[IntoSeriesT]rGzTypeIs[Series[IntoSeriesT]]) __future__rrtypingrrnarwhals._exceptionsrrr+dask.dataframe dataframerFr>rA modin.pandasr&rrurrr2r pyspark.sqlsqlrrr PySparkConnectDataFrametyping_extensionsr narwhals._spark_like.dataframer r4r r0rnarwhals.typingrrrrrrrrrr frozensetrtr#r'r)r,r0r3r7r:r<r?rBrGrJrLrNrQrcrgrvryr~rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr r r rrrrrr&r*r.r2r6r;rYrZrerCrF__all__r r!r"r]se# %. %R(@7&   "+' + + 1 ) ) , * ) 3 + ) ., 0 8 - ( ($"N #L !M O "M  U "#V M $M $K "ER *J !LDF%-&K 1 1 NY )S '  -  "Q8<< %' %& % %' %& % #>> "> > - r!