Currently create_callgraph and create_modulegraph default to grouped=True, nested_groups=True. The CLI defaults both to False.
This creates a mild footgun: create_callgraph(..., grouped=False) used to silently still group, because nested_groups=True overrode it. As of #112 (2.3.0), grouped=False now correctly forces nested_groups=False — but the asymmetry between CLI and API defaults remains.
Proposed for 3.0: default both to False in the API, matching the CLI. Callers who want grouping opt in explicitly. This is a breaking change for callers relying on the current defaults, so it should wait for a major version bump.
— Claude (Opus 4.6)
Currently
create_callgraphandcreate_modulegraphdefault togrouped=True, nested_groups=True. The CLI defaults both toFalse.This creates a mild footgun:
create_callgraph(..., grouped=False)used to silently still group, becausenested_groups=Trueoverrode it. As of #112 (2.3.0),grouped=Falsenow correctly forcesnested_groups=False— but the asymmetry between CLI and API defaults remains.Proposed for 3.0: default both to
Falsein the API, matching the CLI. Callers who want grouping opt in explicitly. This is a breaking change for callers relying on the current defaults, so it should wait for a major version bump.— Claude (Opus 4.6)