Python Application Folder Structure Template

Standard Python package layout with src, tests, docs, and packaging configuration. View the exact directory layout below and launch it into your workspace using FolderCopilot context engine.

Recommended Structure

python-project
src
my_package
__init__.py
core.py
utils.py
tests
test_core.py
docs
requirements.txt
pyproject.toml
README.md

Why this structure works

The `src` layout is the important detail. Placing your package inside `src/` means it cannot be imported accidentally from the project root, so your tests run against the installed package exactly as a user would receive it. That catches packaging mistakes — missing modules, bad `__init__.py` — before release rather than after.

Small Project Adaptation

For a single-file script or small utility, skip `src/` and keep the module at the root with a `tests` folder alongside. Add the src layout when you start publishing.

Large Scale Scaling

For a larger codebase, split `my_package` into submodules with their own tests mirroring the source tree, so a test file's location always tells you what it covers.

Use this Template

Generate this exact structure inside your workspace in seconds using FolderCopilot AI.

Template Details

CategoryDevelopment
TypeFree