fix : strict parameter is enabled by default

py-polars/polars/expr/struct.py

@@ -189,14 +189,16 @@ def unnest(self) -> Expr:
         """
         return self.field("*")
 
-    def rename_fields(self, names: Sequence[str]) -> Expr:
+    def rename_fields(self, names: Sequence[str], strict: bool = True) -> Expr:
         """
         Rename the fields of the struct.
 
         Parameters
         ----------
         names
             New names, given in the same order as the struct's fields.
+        strict
+            If True, raises an error if the length of names does not match the number of fields.
 
         Examples
         --------
@@ -214,7 +216,7 @@ def rename_fields(self, names: Sequence[str]) -> Expr:
         │ struct_col           │
         │ ---                  │
         │ struct[4]            │
-        ╞══════════════════════╡
+        ╞══════��═══════════════╡
         │ {1,"ab",true,[1, 2]} │
         │ {2,"cd",null,[3]}    │
         └──────────────────────┘
@@ -251,6 +253,8 @@ def rename_fields(self, names: Sequence[str]) -> Expr:
         >>> df.select(pl.col("struct_col").struct.field("aaa"))  # doctest: +SKIP
         StructFieldNotFoundError: aaa
         """
+        if strict and len(names) != len(self.fields):
+            raise ValueError("The length of names must match the number of fields in the struct.")
         return wrap_expr(self._pyexpr.struct_rename_fields(names))
 
     def json_encode(self) -> Expr:
@@ -332,7 +336,7 @@ def with_fields(
         │ 1.0 ┆ 4   ┆ 40    ┆ 10       │
         │ 2.0 ┆ 9   ┆ 18    ┆ 2        │
         │ 3.0 ┆ 16  ┆ 48    ┆ 3        │
-        └─────┴─────┴───────┴──────────┘
+        └─────┴─────┴──���────┴───���──────┘
 
         Parameters
         ----------

py-polars/polars/series/struct.py

@@ -73,24 +73,25 @@ def field(self, name: str) -> Series:
         ]
         """
 
-    def rename_fields(self, names: Sequence[str]) -> Series:
+    def rename_fields(self, names: Sequence[str], strict: bool = True) -> Series:
         """
         Rename the fields of the struct.
 
         Parameters
         ----------
         names
             New names in the order of the struct's fields.
+        strict
+            If True, raises an error if the length of names does not match the number of fields.
 
         Examples
         --------
         >>> s = pl.Series([{"a": 1, "b": 2}, {"a": 3, "b": 4}])
-        >>> s.struct.fields
-        ['a', 'b']
-        >>> s = s.struct.rename_fields(["c", "d"])
-        >>> s.struct.fields
-        ['c', 'd']
+        >>> s.struct.rename_fields(["c", "d"], strict=True)
         """
+        if strict and len(names) != len(self.fields):
+            raise ValueError("The length of names must match the number of fields in the struct.")
+
 
     @property
     def schema(self) -> Schema: