python Series alias method

pola-rs · Oct 22, 2021 · 3e0e79e · 3e0e79e
1 parent b56c930
commit 3e0e79e
Show file tree

Hide file tree

Showing 2 changed files with 19 additions and 3 deletions.
diff --git a/py-polars/docs/source/reference/series.rst b/py-polars/docs/source/reference/series.rst
@@ -119,6 +119,7 @@ Manipulation/ selection
 .. autosummary::
    :toctree: api/
 
+    Series.alias
     Series.rename
     Series.limit
     Series.slice

diff --git a/py-polars/polars/eager/series.py b/py-polars/polars/eager/series.py
@@ -902,6 +902,23 @@ def name(self) -> str:
         """
         return self._s.name()
 
+    def alias(self, name: str) -> "Series":
+        """
+        Rename the Series
+
+        Parameters
+        ----------
+        name
+            New name
+
+        Returns
+        -------
+
+        """
+        s = self.clone()
+        s._s.rename(name)
+        return s
+
     def rename(self, name: str, in_place: bool = False) -> Optional["Series"]:
         """
         Rename this Series.
@@ -930,9 +947,7 @@ def rename(self, name: str, in_place: bool = False) -> Optional["Series"]:
             self._s.rename(name)
             return None
         else:
-            s = self.clone()
-            s._s.rename(name)
-            return s
+            return self.alias(name)
 
     def chunk_lengths(self) -> tp.List[int]:
         """