Numérique et Sciences Informatiques • 1ère

Structuration de projets simples

Arborescence de fichiers
Projet → Dossiers → Fichiers
Organisation hiérarchique du code
Structure de base :
projet/
├── main.py
├── modules/
│ ├── fonctions.py
│ └── outils.py
└── README.md
Types de fichiers
🐍
.py : fichiers sources Python
📋
README.md : documentation du projet
⚙️
requirements.txt : dépendances
Exemple de projet
# main.py
from modules.calculs import addition, multiplication
from modules.utilitaires import afficher_resultat

def main():
    a = 10
    b = 5
    resultat_add = addition(a, b)
    resultat_mult = multiplication(a, b)
    afficher_resultat(resultat_add, resultat_mult)

if __name__ == "__main__":
    main()

# modules/calculs.py
def addition(x, y):
    return x + y

def multiplication(x, y):
    return x * y

# modules/utilitaires.py
def afficher_resultat(add, mult):
    print(f"Addition: {add}")
    print(f"Multiplication: {mult}")
📁
Dossiers : regroupement logique
🔄
Importation : modules réutilisables
🎯
Séparation : logique métier distincte
🔧
Maintenabilité : modifications ciblées
Bonnes pratiques
📏
Noms descriptifs pour dossiers/fichiers
🧩
Modules spécialisés par fonctionnalité
🔄
Importation explicite des dépendances
Avantages de la structuration
🔍
Lisibilité : code facilement navigable
🔄
Réutilisabilité : modules interchangeables
👥
Collaboration : travail en équipe facilité
🛠️
Maintenance : corrections ciblées
📈
Évolutivité : ajout de fonctionnalités
Erreurs Fréquentes
Erreur 1 :
Tout mettre dans un seul fichier
Erreur 2 :
Noms de fichiers peu descriptifs
Erreur 3 :
Dépendances circulaires entre modules
Erreur 4 :
Structure trop complexe pour un petit projet
Étapes de structuration
Analyse :
Identifier les fonctionnalités principales
Regrouper les tâches similaires
Déterminer les dépendances
Organisation :
Créer les dossiers nécessaires
Répartir le code dans les modules
Établir les relations entre composants
Structure du code Génie logiciel