complex-tuple
Tuples with 3+ elements are hard to understand - use a dataclass instead
Applies to: Python
Why this matters
When you use Tuple[str, int, float, bool], code like `data[2]` is confusing - what is element 2? A dataclass with named fields like `data.price` is much clearer and helps prevent bugs from accessing the wrong index.
Catch it before it ships
pip install stablestack # or: npx stablestackstablestack # scans your project, QUAL003 includedstablestack explain QUAL003QUAL003 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: QUAL003
More Code Quality checks
exception-swallowing
Silently swallowed exceptions hide bugs and make debugging hard
QUAL002unnamed-thread
Threads without names are hard to identify in debugging tools
QUAL004mutable-default-argument
Mutable default arguments are shared between calls and cause bugs
QUAL005print-statement
Print statements are typically debugging code that shouldn't be committed
QUAL006todo-comment
TODO/FIXME comments indicate incomplete or problematic code
QUAL007broad-exception
Catching all exceptions hides bugs and makes debugging hard
QUAL008magic-number
Magic numbers make code hard to understand and maintain
QUAL009file-too-long
File exceeds recommended maximum length.