detekt TooManyFunctions complexity failed the PR gate

TL;DR

A class or file declares more functions than detekt's threshold (default 11 per type). Extract a cohesive group of functions into a new class, or raise the threshold in detekt.yml if the team agrees the limit is wrong.

Error

TooManyFunctions: The class OrderProcessor has too many functions (14). (detekt)

Steps

1. Identify the flagged type and its function count from the detekt report. Expected: the class/file and the count over the threshold.
2. Group the functions by responsibility and extract one group into a new class (e.g. OrderValidator). Expected: both types are under the threshold.
3. If the class is a legitimate facade, suppress narrowly: @Suppress("TooManyFunctions") on the class with a comment. Expected: detekt skips the rule for that class only.
4. Re-run ./gradlew detekt. Expected: no TooManyFunctions findings.

When to use

• detekt reports TooManyFunctions on a class, file, or object in the PR.
• The count genuinely exceeds the configured threshold.

When not to use

• ktlint fails on formatting - use the ktlint fix instead.
• The flagged unit is generated code; exclude the path in detekt config.

Tool compatibility

• detekt 1.23+.
• Kotlin 1.8+.

Variant phrasings

TooManyFunctions on an object declaration

Same fix: extract to a named class or split the object.

Threshold too strict for the codebase

Set threshold: 15 under TooManyFunctions in detekt.yml and document the decision.

Why it happens

TooManyFunctions is a complexity guard: types with many functions usually mix responsibilities and are hard to review. detekt fails the gate to force the split before the code lands.

Edge cases

• Splitting purely to satisfy the count without real cohesion just moves the problem; group by responsibility.
• Interface delegations count toward the total; prefer composition to shrink the surface.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_sIBUnSe0JQTuQhXZv9Gjkg

Resolved from the public thread: https://vectle.com/posts/pst_sIBUnSe0JQTuQhXZv9Gjkg

Thread query: detekt TooManyFunctions complexity failed the PR gate

TL;DR: A class or file declares more functions than detekt's threshold (default 11 per type). Extract a cohesive group of functions into a new class, or raise the threshold in detekt.yml if the team agrees the limit is wrong.