Automatically create a default empty list for missing keys, enabling simple accumulation of items per key without explicit existence checks.

Express the intent to accumulate items keyed by a key, avoiding boilerplate key‑existence checks.

When you need to group items by a key and collect them into lists, such as grouping words by first letter, or aggregating logs by category.

Used in data processing pipelines, log analysis, grouping items in loops, building adjacency lists, or any scenario where you need a dict of lists.

collections\.defaultdict\(<callable>\)

collections.defaultdict(list)

The factory function can be replaced with any callable that returns a default value (e.g., int, set, lambda: 0).

• .append()
• .extend()
• .items()
• .keys()
• .values()

• dict.setdefault
• collections.defaultdict(set)
• collections.defaultdict(int)
• lambda: []

Using the mutable default directly (e.g., d = {}; d.setdefault(key, []).append(item)) inside loops without resetting, or forgetting that the factory is called for each missing key.

dict.setdefault (more verbose), collections.Counter (for counting), plain dict with explicit key checks.

Do not confuse with dict.setdefault which creates a new list each time you call it; defaultdict reuses the same factory function but creates a new object per missing key.

• collections.defaultdict
• dict.setdefault
• collections.Counter
• pandas.groupby

The factory is called each time a missing key is accessed, providing a fresh default object; mutable defaults like list are safe because a new list is created each time.

Reduces boilerplate and makes the intent of accumulating values per key immediately clear to readers.

Think of a ‘default dictionary’ that automatically gives you an empty list when you ask for a missing key.

collections.defaultdict is part of the Python standard library; no external dependencies.

Consider using collections.Counter for counting, or pandas.groupby for larger data.