magic-number
Magic numbers make code hard to understand and maintain
Applies to: Go, JAVA, JavaScript, Python, Ruby, Rust, TypeScript
Why this matters
Numbers like 86400, 3.14159, or 1024 scattered in code are confusing. What does 86400 mean? (It's seconds in a day.) Named constants like SECONDS_PER_DAY = 86400 make code self-documenting and easier to update.
Catch it before it ships
pip install stablestack # or: npx stablestackstablestack # scans your project, QUAL008 includedstablestack explain QUAL008QUAL008 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: QUAL008
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
QUAL003complex-tuple
Tuples with 3+ elements are hard to understand - use a dataclass instead
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
QUAL009file-too-long
File exceeds recommended maximum length.