QUAL011warningPro

code-complexity

Code is too complex - consider refactoring.

Applies to: C, C#, CPP, Go, H, HPP, JAVA, JavaScript, KT, Python, Ruby, Rust, SCALA, SWIFT, TypeScript

Why this matters

Complex code is hard to understand, test, and maintain. Deep nesting makes control flow hard to follow. Long functions do too many things. High branch counts make testing all paths difficult. Simpler code has fewer bugs and is easier to modify.

Catch it before it ships

pip install stablestack # or: npx stablestackstablestack # scans your project, QUAL011 includedstablestack explain QUAL011

QUAL011 is part of the Pro rule set. See pricing — the free tier ships 24 checks with no signup.

False positive in your codebase? Suppress a single line with # noqa: QUAL011

More Code Quality checks

QUAL001

exception-swallowing

Silently swallowed exceptions hide bugs and make debugging hard

QUAL002

unnamed-thread

Threads without names are hard to identify in debugging tools

QUAL003

complex-tuple

Tuples with 3+ elements are hard to understand - use a dataclass instead

QUAL004

mutable-default-argument

Mutable default arguments are shared between calls and cause bugs

QUAL005

print-statement

Print statements are typically debugging code that shouldn't be committed

QUAL006

todo-comment

TODO/FIXME comments indicate incomplete or problematic code

QUAL007

broad-exception

Catching all exceptions hides bugs and makes debugging hard

QUAL008

magic-number

Magic numbers make code hard to understand and maintain