QUAL017infoPro

hardcoded-model-id

Hardcoded AI model IDs go stale when models are retired

Applies to: JavaScript, Python, TypeScript

Why this matters

AI model IDs like 'gpt-4o' or 'claude-3-opus' change frequently. When they're hardcoded across multiple files, upgrading requires a tedious find-and-replace that invariably misses call sites. Centralize model IDs in a config constant with an env var override.

Catch it before it ships

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

QUAL017 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: QUAL017

More Code Quality checks

exception-swallowing

Silently swallowed exceptions hide bugs and make debugging hard

unnamed-thread

Threads without names are hard to identify in debugging tools

complex-tuple

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

mutable-default-argument

Mutable default arguments are shared between calls and cause bugs

print-statement

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

todo-comment

TODO/FIXME comments indicate incomplete or problematic code

broad-exception

Catching all exceptions hides bugs and makes debugging hard

magic-number

Magic numbers make code hard to understand and maintain