Comment fonctionnent les modules, les imports et les packages ?

Question

Accepted Answer

Un **module** est un fichier `.py` unique ; un **package** est un répertoire de modules. Les **imports** vous permettent d'utiliser du code d'autres modules, organisant un programme en pièces réutilisables.

## Modules et importation

```python
# math_utils.py — a module
def add(a, b): return a + b
PI = 3.14159
```

```python
# main.py — different ways to import
import math_utils                  # import the whole module
math_utils.add(2, 3)               # access via the module name

from math_utils import add, PI     # import specific names
add(2, 3)                          # use directly

from math_utils import add as plus # import with an alias
import numpy as np                 # common aliasing convention
```

## Packages — répertoires de modules

```text
mypackage/
  __init__.py        ← marks it as a package (can be empty)
  module_a.py
  subpackage/
    __init__.py
    module_b.py
```

```python
from mypackage.module_a import something
from mypackage.subpackage.module_b import other
```

Le fichier `__init__.py` marque un répertoire comme un package (et peut exécuter du code d'initialisation du package ou définir ce que `from package import *` expose).

## L'idiome `if __name__ == "__main__"`

```python
def main():
    print("running as a script")

if __name__ == "__main__":   # True only when run directly, not when imported
    main()
```

Ceci permet à un fichier d'agir à la fois comme un module importable *et* un script exécutable — le code sous cette condition s'exécute uniquement quand le fichier est exécuté directement (`python file.py`), pas quand il est importé. Un idiome Python quasi universel.

## Où Python cherche les modules

```python
import sys
sys.path   # the list of directories Python searches for imports
# includes: the current directory, installed packages (site-packages), stdlib
```

## Bibliothèque standard et tiers

```python
import os, json, datetime    # standard library — "batteries included"
import requests              # third-party — installed via pip from PyPI
```

## Pourquoi c'est important

Les modules et les packages sont la façon dont vous organisez le code Python en unités réutilisables et maintenables plutôt qu'en un seul fichier géant — fondamental pour tout projet non trivial.

Comprendre les styles d'import, la structure des packages (`__init__.py`), l'idiome `if __name__ == "__main__"` (comportement dual script/module), et la façon dont Python trouve les modules (`sys.path`) est essentiel pour structurer les projets, réutiliser le code, et utiliser la vaste bibliothèque standard et l'écosystème PyPI.

Les erreurs d'import et la confusion de structure sont des obstacles courants au début que cette connaissance résout.

Modules et importation

Packages — répertoires de modules

L'idiome if __name__ == "__main__"

Où Python cherche les modules

Bibliothèque standard et tiers

Pourquoi c'est important

L'idiome `if name == "main"`