structure a medium-sized Python project

[sudoUgando]

What’s the recommended way to structure a medium-sized Python project (modules/packages)?

[EimanTahir027]

What’s the recommended way to structure a medium-sized Python project (modules/packages)?

A medium-sized Python project should be organized so it’s easy to navigate, test, extend, and package. The common, proven approach today is the “src layout + clear separation of concerns.”

project-name/
│
├── src/
│ └── project_name/
│ ├── init.py
│ ├── main.py # Entry point
│ │
│ ├── config/ # Settings, env handling
│ │ └── settings.py
│ │
│ ├── models/ # Data models / schemas
│ │ └── user.py
│ │
│ ├── services/ # Core business logic
│ │ └── chatbot.py
│ │
│ ├── routes/ # API routes (Flask/FastAPI)
│ │ └── chat_routes.py
│ │
│ ├── utils/ # Helper functions
│ │ └── helpers.py
│ │
│ └── core/ # Shared logic (optional)
│ └── constants.py
│
├── tests/ # Unit & integration tests
│ └── test_chatbot.py
│
├── requirements.txt
├── .env
├── .gitignore
├── README.md
└── run.py # Optional app runner