code-organization

What problem does it solve?

Standardize Python project structure to reduce maintenance overhead.

Core Features & Use Cases

• Module structure guidance: Public interfaces at the top, private helpers below, and clear separation of concerns.
• Import organization and naming: Standard library, third-party, then local imports; absolute imports; no wildcard imports.
• Design principles: High cohesion, low coupling, single responsibility, and avoidance of circular dependencies.
• Use Case: A team onboarding a new Python project uses these rules to structure packages, modules, and tests with minimal friction.

Quick Start

1. Audit an existing package and outline the top-level modules and public interfaces.
2. Reorganize the module layout to match the recommended structure: public interfaces first, then internal helpers; group imports accordingly.
3. Update references, tests, and documentation to reflect the new layout.