class-filename-mismatch
Class name doesn't match filename convention.
Applies to: Python
Why this matters
When a file contains a main class, the filename should match the class name in snake_case. For example, UserService class should be in user_service.py. This makes it easy to find classes and helps AI assistants navigate your code.
Catch it before it ships
pip install stablestack # or: npx stablestackstablestack # scans your project, STRUCT009 includedstablestack explain STRUCT009STRUCT009 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: STRUCT009
More Code Structure checks
multiple-classes-per-file
Multiple classes defined in a single file.
STRUCT003imports-in-function
Import statement inside a function instead of at module level.
STRUCT004sys-path-manipulation
Direct sys.path manipulation detected.
STRUCT005relative-imports
Relative import used instead of absolute import.
STRUCT006hasattr-getattr-pattern
Using hasattr/getattr for attribute access instead of proper typing.
STRUCT010mixed-frontend-backend
Frontend and backend code should be clearly separated
STRUCT011duplicate-modules
Duplicate files exist in multiple locations - likely from incomplete migration or copy-paste.
STRUCT012naked-functions
Too many loose functions - consider grouping into a class or service.