python-project-structure

The best way to structure a Python project involves using standard directory layouts like `src/` and `tests/`, ensuring module cohesion, and defining explicit public APIs with `__all__` for clear code organization and maintainability.

Organize Python modules by emphasizing module cohesion and using `__all__` to define explicit public interfaces, which enhances code discoverability and establishes a clear module architecture for consumers.

You need a `src` directory when setting up a new Python project to establish a robust, standard directory structure that separates the importable package from project root files, improving module architecture.

Refactor an existing Python codebase by applying principles of module cohesion, flattening hierarchies, enforcing naming conventions like `snake_case`, and using `__all__` to define clear, explicit interfaces.

Defining `__all__` in Python modules improves API design by explicitly declaring the public interface, which enforces module cohesion, prevents unintended imports, and enhances overall code organization.

For Python project structure, you should use `snake_case` and clear, descriptive names for modules and files, adhering to consistent conventions that support flat hierarchies and module discoverability.