docs: replace remaining native_namespace refs (#2221)

#2218 (comment)

Author: dangotbanned

docs/basics/dataframe_conversion.md

@@ -52,7 +52,7 @@ which implements `__arrow_c_stream__`:
 ```python exec="1" source="above" session="conversion" result="python"
 def df_to_polars(df_native: Any) -> pl.DataFrame:
     if hasattr(df_native, "__arrow_c_stream__"):
-        return nw.from_arrow(df_native, native_namespace=pl).to_native()
+        return nw.from_arrow(df_native, backend=pl).to_native()
     msg = (
         f"Expected object which implements '__arrow_c_stream__' got: {type(df_native)}"
     )
@@ -62,7 +62,7 @@ def df_to_polars(df_native: Any) -> pl.DataFrame:
 print(df_to_polars(df_duckdb))  # You can only execute this line of code once.
 ```
 
-It works to pass Polars to `native_namespace` here because Polars supports the [PyCapsule Interface](https://arrow.apache.org/docs/format/CDataInterface/PyCapsuleInterface.html) for import.
+It works to pass Polars to `backend` here because Polars supports the [PyCapsule Interface](https://arrow.apache.org/docs/format/CDataInterface/PyCapsuleInterface.html) for import.
 
 Note that the PyCapsule Interface makes no guarantee that you can call it repeatedly, so the approach above only works if you
 only expect to perform the conversion a single time on each input object.

narwhals/dataframe.py

@@ -414,7 +414,7 @@ class DataFrame(BaseFrame[DataFrameT]):
             ```py
             narwhals.from_dict(
                 data={"a": [1, 2, 3]},
-                native_namespace=narwhals.get_native_namespace(another_object),
+                backend=narwhals.get_native_namespace(another_object),
             )
             ```
     """

narwhals/functions.py

@@ -977,7 +977,7 @@ def read_parquet(
                 see [perfect backwards compatibility policy](../backcompat.md/).
         kwargs: Extra keyword arguments which are passed to the native parquet reader.
             For example, you could use
-            `nw.read_parquet('file.parquet', native_namespace=pd, engine='pyarrow')`.
+            `nw.read_parquet('file.parquet', backend=pd, engine='pyarrow')`.
 
     Returns:
         DataFrame.
@@ -1061,7 +1061,7 @@ def scan_parquet(
                 see [perfect backwards compatibility policy](../backcompat.md/).
         kwargs: Extra keyword arguments which are passed to the native parquet reader.
             For example, you could use
-            `nw.scan_parquet('file.parquet', native_namespace=pd, engine='pyarrow')`.
+            `nw.scan_parquet('file.parquet', backend=pd, engine='pyarrow')`.
 
     Returns:
         LazyFrame.

narwhals/series.py

@@ -58,7 +58,7 @@ class Series(Generic[IntoSeriesT]):
             narwhals.new_series(
                 name=name,
                 values=values,
-                native_namespace=narwhals.get_native_namespace(another_object),
+                backend=narwhals.get_native_namespace(another_object),
             )
             ```
     """

narwhals/stable/v1/__init__.py

@@ -126,7 +126,7 @@ class DataFrame(NwDataFrame[IntoDataFrameT]):
             ```py
             narwhals.from_dict(
                 data={"a": [1, 2, 3]},
-                native_namespace=narwhals.get_native_namespace(another_object),
+                backend=narwhals.get_native_namespace(another_object),
             )
             ```
     """
@@ -385,7 +385,7 @@ class Series(NwSeries[IntoSeriesT]):
             narwhals.new_series(
                 name=name,
                 values=values,
-                native_namespace=narwhals.get_native_namespace(another_object),
+                backend=narwhals.get_native_namespace(another_object),
             )
             ```
     """
@@ -2445,7 +2445,7 @@ def read_parquet(
                 see [perfect backwards compatibility policy](../backcompat.md/).
         kwargs: Extra keyword arguments which are passed to the native parquet reader.
             For example, you could use
-            `nw.read_parquet('file.parquet', native_namespace=pd, engine='pyarrow')`.
+            `nw.read_parquet('file.parquet', backend=pd, engine='pyarrow')`.
 
     Returns:
         DataFrame.
@@ -2486,7 +2486,7 @@ def scan_parquet(
                 see [perfect backwards compatibility policy](../backcompat.md/).
         kwargs: Extra keyword arguments which are passed to the native parquet reader.
             For example, you could use
-            `nw.scan_parquet('file.parquet', native_namespace=pd, engine='pyarrow')`.
+            `nw.scan_parquet('file.parquet', backend=pd, engine='pyarrow')`.
 
     Returns:
         LazyFrame.

tests/new_series_test.py

@@ -26,17 +26,15 @@ def test_new_series(constructor_eager: ConstructorEager) -> None:
 
 def test_new_series_v1(constructor_eager: ConstructorEager) -> None:
     s = nw_v1.from_native(constructor_eager({"a": [1, 2, 3]}), eager_only=True)["a"]
-    result = nw_v1.new_series(
-        "b", [4, 1, 2], native_namespace=nw_v1.get_native_namespace(s)
-    )
+    result = nw_v1.new_series("b", [4, 1, 2], backend=nw_v1.get_native_namespace(s))
     expected = {"b": [4, 1, 2]}
     # all supported libraries auto-infer this to be int64, we can always special-case
     # something different if necessary
     assert result.dtype == nw_v1.Int64
     assert_equal_data(result.to_frame(), expected)
 
     result = nw_v1.new_series(
-        "b", [4, 1, 2], nw_v1.Int32, native_namespace=nw_v1.get_native_namespace(s)
+        "b", [4, 1, 2], nw_v1.Int32, backend=nw_v1.get_native_namespace(s)
     )
     expected = {"b": [4, 1, 2]}
     assert result.dtype == nw_v1.Int32

tpch/execute.py

@@ -100,9 +100,7 @@ def execute_query(query_id: str) -> None:
         result: pl.DataFrame = (
             query_module.query(
                 *(
-                    nw.scan_parquet(
-                        str(path), native_namespace=native_namespace, **kwargs
-                    )
+                    nw.scan_parquet(str(path), backend=native_namespace, **kwargs)
                     for path in data_paths
                 )
             )