refactor-module-stutter

Module-name stutter in Python APIs occurs when public symbols redundantly repeat the module namespace, such as a module named fragment exporting a class named WriteFragment. This pattern adds noise and harms code readability, maintainability, and import ergonomics.

You detect redundant module name repetition by running a static-analysis audit against your Python package. The audit checks top-level class and function definitions, including __init__.py re-exports, to surface symbols that repeat the module namespace.

Yes, you can configure ignore lists for naming lint rules to adapt to large codebases. This allows for gradual migrations by excluding specific symbols or modules from the stutter detection audit.

You enforce Python API naming conventions in CI pipelines by using the stutter audit's gate enforcement feature. The audit produces a Markdown report with findings and recommended refactor steps, which can block pipeline progression on violations.

The best way to refactor Python __init__ exports is to follow the suggested renames and safe refactor paths generated in the Markdown report. This ensures re-exported symbols drop the redundant module namespace without breaking the public API.