more cleanups

narwhals/pandas_like/dataframe.py

@@ -88,7 +88,7 @@ def schema(self) -> dict[str, DType]:
     def shape(self) -> tuple[int, int]:
         return self._dataframe.shape  # type: ignore[no-any-return]
 
-    # --- reshaping ---
+    # --- reshape ---
     def with_columns(
         self,
         *exprs: IntoExpr | Iterable[IntoExpr],
@@ -112,7 +112,7 @@ def filter(
     def rename(self, mapping: dict[str, str]) -> Self:
         return self._dispatch_to_lazy("rename", mapping)
 
-    # --- transforms ---
+    # --- transform ---
     def sort(
         self,
         by: str | Iterable[str],
@@ -165,7 +165,7 @@ def join(
             "join", other.lazy(), how=how, left_on=left_on, right_on=right_on
         )
 
-    # --- partial reductions ---
+    # --- partial reduction ---
     def head(self, n: int) -> Self:
         return self._dispatch_to_lazy("head", n)
 
@@ -237,7 +237,7 @@ def schema(self) -> dict[str, DType]:
             col: translate_dtype(dtype) for col, dtype in self._dataframe.dtypes.items()
         }
 
-    # --- reshaping ---
+    # --- reshape ---
     def select(
         self,
         *exprs: IntoExpr | Iterable[IntoExpr],
@@ -275,7 +275,7 @@ def with_columns(
     def rename(self, mapping: dict[str, str]) -> Self:
         return self._from_dataframe(self._dataframe.rename(columns=mapping))
 
-    # --- transforms ---
+    # --- transform ---
     def sort(
         self,
         by: str | Iterable[str],
@@ -340,7 +340,7 @@ def join(
             ),
         )
 
-    # --- partial reductions ---
+    # --- partial reduction ---
 
     def head(self, n: int) -> Self:
         return self._from_dataframe(self._dataframe.head(n))

narwhals/pandas_like/namespace.py

@@ -106,7 +106,7 @@ def all(self) -> Expr:
             implementation=self._implementation,
         )
 
-    # --- reductions ---
+    # --- reduction ---
     def sum(self, *column_names: str) -> Expr:
         return Expr.from_column_names(
             *column_names, implementation=self._implementation

narwhals/spec/__init__.py

@@ -75,7 +75,7 @@ def max(self) -> Expr:
     def n_unique(self) -> Expr:
         ...
 
-    # --- transforms ---
+    # --- transform ---
     def is_between(
         self, lower_bound: Any, upper_bound: Any, closed: str = "both"
     ) -> Expr:
@@ -87,7 +87,7 @@ def is_in(self, other: Any) -> Expr:
     def is_null(self) -> Expr:
         ...
 
-    # --- partial reductions ---
+    # --- partial reduction ---
     def drop_nulls(self) -> Expr:
         ...
 
@@ -132,7 +132,7 @@ def col(self, *names: str | Iterable[str]) -> Expr:
     def all(self) -> Expr:
         ...
 
-    # --- reductions ---
+    # --- reduction ---
     def sum(self, *columns: str) -> Expr:
         ...
 
@@ -220,7 +220,7 @@ def schema(self) -> dict[str, DType]:
     def shape(self) -> tuple[int, int]:
         ...
 
-    # --- reshaping ---
+    # --- reshape ---
     def with_columns(
         self, *exprs: IntoExpr | Iterable[IntoExpr], **named_exprs: IntoExpr
     ) -> Self:
@@ -237,7 +237,7 @@ def select(
     def rename(self, mapping: dict[str, str]) -> Self:
         ...
 
-    # --- transforms ---
+    # --- transform ---
     def sort(
         self,
         by: str | Iterable[str],
@@ -273,7 +273,7 @@ def join(
     def group_by(self, *keys: str | Iterable[str]) -> GroupBy:
         ...
 
-    # --- partial reductions ---
+    # --- partial reduction ---
     def head(self, n: int) -> Self:
         ...
 
@@ -291,7 +291,7 @@ def columns(self) -> list[str]:
     def schema(self) -> dict[str, DType]:
         ...
 
-    # --- reshaping ---
+    # --- reshape ---
     def with_columns(
         self, *exprs: IntoExpr | Iterable[IntoExpr], **named_exprs: IntoExpr
     ) -> Self:
@@ -305,7 +305,7 @@ def select(
     ) -> Self:
         ...
 
-    # --- transforms ---
+    # --- transform ---
     def sort(
         self,
         by: str | Iterable[str],
@@ -332,7 +332,7 @@ def join(
     ) -> Self:
         ...
 
-    # --- partial reductions ---
+    # --- partial reduction ---
     def head(self, n: int) -> Self:
         ...