Running code: python file.py vs python -m ...

This project uses python -m src.scout because it keeps imports and folders sane as your code grows.

What -m expects

When you run python -m src.scout, Python looks for a folder named src, then a folder named scout inside it, then runs __main__.py.

src/
  scout/
    __main__.py

The most common “beginner trap”

You run the command from the wrong folder and Python can’t find src.

ModuleNotFoundError: No module named 'src'

Fix: cd into the project root (the folder that contains src/).

Optional: __init__.py

If you still get import weirdness, adding empty __init__.py files makes your folders explicit Python packages.

src/__init__.py
src/scout/__init__.py