rename get_rows to take (#339)

* rename get_rows to gather

* rename to take instead

Author: MarcoGorelli

spec/API_specification/dataframe_api/__init__.py

@@ -413,6 +413,6 @@ def unique_indices(*columns: Column, skip_nulls: bool = True) -> Column:
     If the original column(s) contain multiple `'NaN'` values, then
     only a single index corresponding to those values will be returned.
     Likewise for null values (if ``skip_nulls=False``).
-    To get the unique values, you can do ``df.get_rows(df.unique_indices(keys))``.
+    To get the unique values, you can do ``df.take(df.unique_indices(keys))``.
     """
     ...

spec/API_specification/dataframe_api/column_object.py

@@ -106,7 +106,7 @@ def dtype(self) -> DType:
         """Return data type of column."""
         ...
 
-    def get_rows(self, indices: Self) -> Self:
+    def take(self, indices: Self) -> Self:
         """Select a subset of rows, similar to `ndarray.take`.
 
         Parameters
@@ -867,7 +867,7 @@ def unique_indices(self, *, skip_nulls: bool | Scalar = True) -> Self:
         If the original Column contains multiple `'NaN'` values, then
         only a single index corresponding to those values will be returned.
         Likewise for null values (if ``skip_nulls=False``).
-        To get the unique values, you can do ``col.get_rows(col.unique_indices())``.
+        To get the unique values, you can do ``col.take(col.unique_indices())``.
         """
         ...
 

spec/API_specification/dataframe_api/dataframe_object.py

@@ -132,7 +132,7 @@ def select(self, *names: str) -> Self:
         """
         ...
 
-    def get_rows(self, indices: Column) -> Self:
+    def take(self, indices: Column) -> Self:
         """Select a subset of rows, similar to `ndarray.take`.
 
         Parameters