dictutils.ops.group_by

dictutils.ops.group_by(items, key)

Group items by key function or path.

Parameters:

• items (Iterable[Any]) – Collection to group

• key (Union[str, Callable[[Any], Any]]) – Path string or function to extract grouping key

Return type:

dict[Any, list[Any]]

Returns:

Dictionary mapping keys to lists of items

Example

>>> import json
>>> users = [
...     {"role": "admin", "name": "Alice"},
...     {"role": "user", "name": "Bob"},
...     {"role": "admin", "name": "Carol"}
... ]
>>> result = group_by(users, "role")
>>> print(json.dumps(result, indent=4))
{
    "admin": [
        {
            "role": "admin",
            "name": "Alice"
        },
        {
            "role": "admin",
            "name": "Carol"
        }
    ],
    "user": [
        {
            "role": "user",
            "name": "Bob"
        }
    ]
}