Wrong behavior description in polars.dataframe.group_by.GroupBy.__iter__

[liufeimath]

Description

In this doc:
https://docs.pola.rs/api/python/stable/reference/dataframe/api/polars.dataframe.group_by.GroupBy.__iter__.html

It says

If a single string was passed to by, the keys are a single value instead of a tuple.

This is not true for 1.0.0, e.g.

df = pl.DataFrame({"foo": ["a", "a", "b"], "bar": [1, 2, 3]})
for name, data in df.group_by("foo"):  
    print(name)
    print(data)

prints

('a',)
shape: (2, 2)
┌─────┬─────┐
│ foo ┆ bar │
│ --- ┆ --- │
│ str ┆ i64 │
╞═════╪═════╡
│ a   ┆ 1   │
│ a   ┆ 2   │
└─────┴─────┘
('b',)
shape: (1, 2)
┌─────┬─────┐
│ foo ┆ bar │
│ --- ┆ --- │
│ str ┆ i64 │
╞═════╪═════╡
│ b   ┆ 3   │
└─────┴─────┘

Keys are still a tuple, not a single value.

Link

https://docs.pola.rs/api/python/stable/reference/dataframe/api/polars.dataframe.group_by.GroupBy.__iter__.html

[henryharbeck]

This was fixed in #17383, so will be resolved on the next release.

[cmdlineluser]

You can see the updated docs in the /dev/ section:

• https://docs.pola.rs/api/python/dev/reference/dataframe/api/polars.dataframe.group_by.GroupBy.__iter__.html

[liufeimath]

Thanks for the info! All good now.

[nameexhaustion]

Fixed by #17383