Structuration des programmes

🧩 1. Modularité

🔍 Définition

La modularité, c’est l’idée de découper un programme en morceaux indépendants (des modules ou fonctions) qui ont chacun un rôle précis.

Un module bien conçu = une brique qu’on peut tester, réutiliser ou modifier sans toucher au reste du programme.

✅ Avantages de la modularité

🛠️ Exemple simple

def ajouter(a, b):
    return a + b

def demander_nombres():
    a = int(input("Entrez un nombre : "))
    b = int(input("Entrez un autre : "))
    return a, b

def main():
    x, y = demander_nombres()
    print("Résultat :", ajouter(x, y))

main()

On voit ici :

• Une fonction pour additionner

• Une autre pour demander à l’utilisateur

• Et une fonction main() comme point d’entrée

📁 2. Découpage en fichiers / modules

🧱 Pourquoi découper un programme en fichiers ?

Quand un projet devient long (plus de 100-200 lignes), il devient essentiel de séparer le code dans plusieurs fichiers :

• 💼 utilitaires.py : fonctions génériques

• 🎮 jeu.py : logique du jeu

• 🧠 ia.py : intelligence artificielle

• 🚪 main.py : point d’entrée du programme

🔌 Comment importer un fichier Python ?

Si on a un fichier maths_utiles.py :

# maths_utiles.py
def carre(x):
    return x * x

On peut l’utiliser dans un autre fichier :

# programme.py
import maths_utiles

print(maths_utiles.carre(5))  # Affiche 25

🧠 Import avancé

from maths_utiles import carre

print(carre(5))

📂 Organisation typique d’un projet

mon_projet/
│
├── main.py             # Point d’entrée
├── utils.py            # Fonctions générales
├── data/
│   └── base.json       # Données
├── modules/
│   ├── analyse.py
│   └── affichage.py
└── README.md           # Explication du projet

Un bon projet est bien organisé, commenté et découpé.

🎯 3. Mini-projets / Cas pratiques

🕹️ Exemple 1 : Calculatrice en modules

• main.py : gère le menu

• operations.py : contient les fonctions add, sub, mul, div

• utils.py : vérifie les entrées de l'utilisateur

🎮 Exemple 2 : Jeu "Devine le nombre"

• main.py : lance le jeu

• logique.py : compare les propositions

• affichage.py : affiche les messages

📁 Exemple 3 : Analyse de texte

• analyse.py : fonctions pour compter mots, lettres, etc.

• io.py : fonctions pour lire/écrire dans les fichiers

• main.py : gère l'exécution

🧹 4. Bonnes pratiques de structuration

📘 1. Nommer clairement les fonctions

def charger_donnees():  # clair
def f1():               # obscur

🧼 2. Ne jamais tout faire dans main()

Séparer les responsabilités !

📦 3. Un fichier = un rôle

Exemple :

• affichage.py → interface console

• logique.py → règles métier

• main.py → coordination

🧪 4. Ajouter des tests unitaires

def somme(a, b):
    return a + b

def test_somme():
    assert somme(2, 3) == 5
    assert somme(-1, 1) == 0

test_somme()

🧠 À retenir