Merge remote-tracking branch 'upstream/main' into column-getitem-and-len

Author: MarcoGorelli

.github/workflows/preview.yml

@@ -11,6 +11,7 @@ jobs:
         uses: larsoner/circleci-artifacts-redirector-action@master
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
+          api-token: ${{ secrets.CIRCLE_TOKEN }}
           artifact-path: 0/build/draft/index.html
           circleci-jobs: build_page
           job-title: Check the rendered docs here!

spec/API_specification/dataframe_api/dataframe_object.py

@@ -19,6 +19,11 @@ def dataframe(self) -> object:
         If a library only implements the Standard, then this can return `self`.
         """
         ...
+    
+    def shape(self) -> tuple[int, int]:
+        """
+        Return number of rows and number of columns.
+        """
 
     def groupby(self, keys: Sequence[str], /) -> GroupBy:
         """
@@ -174,21 +179,6 @@ def drop_column(self, label: str) -> DataFrame:
         """
         ...
 
-    def set_column(self, label: str, value: Column) -> DataFrame:
-        """
-        Add or replace a column.
-
-        Parameters
-        ----------
-        label : str
-        value : Column
-
-        Returns
-        -------
-        DataFrame
-        """
-        ...
-
     def rename_columns(self, mapping: Mapping[str, str]) -> DataFrame:
         """
         Rename columns.
@@ -452,6 +442,17 @@ def __divmod__(self, other: DataFrame | Scalar) -> tuple[DataFrame, DataFrame]:
         """
         ...
 
+    def __invert__(self) -> DataFrame:
+        """
+        Invert truthiness of (boolean) elements.
+
+        Raises
+        ------
+        ValueError
+            If any of the DataFrame's columns is not boolean.
+        """
+        ...
+
     def __iter__(self) -> NoReturn:
         """
         Iterate over elements.
@@ -467,12 +468,50 @@ def __iter__(self) -> NoReturn:
     def any(self, skipna: bool = True) -> DataFrame:
         """
         Reduction returns a 1-row DataFrame.
+
+        Raises
+        ------
+        ValueError
+            If any of the DataFrame's columns is not boolean.
         """
         ...
 
     def all(self, skipna: bool = True) -> DataFrame:
         """
         Reduction returns a 1-row DataFrame.
+
+        Raises
+        ------
+        ValueError
+            If any of the DataFrame's columns is not boolean.
+        """
+        ...
+    
+    def any_rowwise(self, skipna: bool = True) -> Column:
+        """
+        Reduction returns a Column.
+
+        Differs from ``DataFrame.any`` and that the reduction happens
+        for each row, rather than for each column.
+
+        Raises
+        ------
+        ValueError
+            If any of the DataFrame's columns is not boolean.
+        """
+        ...
+
+    def all_rowwise(self, skipna: bool = True) -> Column:
+        """
+        Reduction returns a Column.
+
+        Differs from ``DataFrame.all`` and that the reduction happens
+        for each row, rather than for each column.
+
+        Raises
+        ------
+        ValueError
+            If any of the DataFrame's columns is not boolean.
         """
         ...
 

spec/API_specification/dataframe_api/groupby_object.py

@@ -34,3 +34,6 @@ def std(self, skipna: bool = True) -> "DataFrame":
 
     def var(self, skipna: bool = True) -> "DataFrame":
         ...
+
+    def size(self) -> "DataFrame":
+        ...