python: series.to_pandas (#2835)

pola-rs · Mar 6, 2022 · 5d342a6 · 5d342a6
1 parent cdcc9a4
commit 5d342a6
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 1 deletion.
diff --git a/py-polars/docs/source/reference/series.rst b/py-polars/docs/source/reference/series.rst
@@ -35,7 +35,7 @@ Conversion
    Series.to_list
    Series.to_numpy
    Series.to_arrow
-   Series.to_numpy
+   Series.to_pandas
 
 
 Aggregation

diff --git a/py-polars/polars/internals/series.py b/py-polars/polars/internals/series.py
@@ -2102,6 +2102,16 @@ def to_arrow(self) -> "pa.Array":
         """
         return self._s.to_arrow()
 
+    def to_pandas(self) -> "pd.Series":
+        """
+        Convert this Series to a pandas Series
+        """
+        if not _PYARROW_AVAILABLE:
+            raise ImportError(  # pragma: no cover
+                "'pyarrow' is required for converting a 'polars' Series to a 'pandas' Series."
+            )
+        return self.to_arrow().to_pandas()
+
     def set(self, filter: "Series", value: Union[int, float]) -> "Series":
         """
         Set masked values.

diff --git a/py-polars/tests/test_interop.py b/py-polars/tests/test_interop.py
@@ -258,3 +258,7 @@ def test_from_empty_arrow() -> None:
 
 def test_from_null_column() -> None:
     assert pl.from_pandas(pd.DataFrame(data=[pd.NA, pd.NA])).shape == (2, 1)
+
+
+def test_to_pandas_series() -> None:
+    assert (pl.Series("a", [1, 2, 3]).to_pandas() == pd.Series([1, 2, 3])).all()