add drop_nulls (#318)

Author: MarcoGorelli

spec/API_specification/dataframe_api/dataframe_object.py

@@ -854,6 +854,28 @@ def fill_null(
         """
         ...
 
+    def drop_nulls(
+        self,
+        *,
+        column_names: list[str] | None = None,
+    ) -> Self:
+        """Drop rows containing null values.
+
+        Parameters
+        ----------
+        column_names : list[str] | None
+            A list of column names to consider when dropping nulls.
+            If ``None``, all columns will be considered.
+
+        Raises
+        ------
+        KeyError
+            If ``column_names`` contains a column name that is not present in
+            the dataframe.
+
+        """
+        ...
+
     def to_array(self, dtype: DType) -> Any:
         """Convert to array-API-compliant object.