Extrait le tuto VSCode dans un fichier à part

src/cours/CIEL1/01-bases-python/annexes/anglais.md

@@ -0,0 +1,26 @@
+# Anglais - Vocabulaire de la programmation
+
+|Français|Anglais|
+|--------|-------|
+|Interpréteur|Interpreter|
+|Invite de commande|Command prompt|
+|Opérateur|Operator|
+|Fonction|Function|
+|Racine carrée|Square root|
+|Affecter une variable|Assign a variable|
+|Sensible à la casse|Case sensitive|
+|Majuscules|Uppercase|
+|Minuscules|Lowercase|
+|Mot-clé|Keyword|
+|Mot-clé réservé|Reserved keyword|
+|Typage dynamique|Dynamic typing|
+|Chaîne de caractères|String|
+|Chaîne de caractères formatée|Formatted string|
+|Boucle|Loop|
+|Appeler une fonction|Call a function|
+|Virgule|Comma|
+|Deux points `:`|Colon|
+|Point virgule `;`|Semi-colon|
+|Parenthèses `()`|Brackets|
+|Crochets `[]`|Square brackets|
+|Accolades `{}`|Curly brackets|

src/cours/CIEL1/01-bases-python/annexes/vscode.md

@@ -0,0 +1,89 @@
+# Utilisation de Visual Studio Code
+
+Visual studio code est un éditeur de texte. Il en existe de nombreux, mais celui-ci est devenu courant dans l'industrie et s'adapte à de nombreux cas d'usage.
+
+Ce document regroupe des informations pour vous aider à prendre en main VSCode.
+
+## Mise en route
+
+Lancez Visual Studio Code depuis le menu démarrer de votre machine. Vous verrez une interface comme ci-dessous. Sur la capture d'écran, les sections dont vous aurez besoin en TP sont indiquées par des flèches.
+
+![alt text](./images/image-3.png)
+
+![alt text](./images/image-8.png)
+
+
+### Ouvrir un répertoire
+
+Créez un sous-répertoire dans votre espace personnel, sous `projets/python/nom_du_tp/` et selectionnez-le. Cochez la case et cliquez sur `Yes, I trust the authors` si la fenêtre ci-dessous s'ouvre.
+    ![alt text](./images/image-4.png)
+
+```admonish tip title="Astuce"
+L'explorateur de VSCode montre le contenu de votre répertoire de travail. Mais vous l'avez toujours sous les yeux, ce qui est bien plus pratique pour jongler entre de nombreux fichiers.
+```
+
+### Extension Python
+
+Vérifiez dans le menu extensions que l'extension Python proposée par Microsoft soit bien installée. Sinon, recherchez-la dans la barre de recherche du menu des extensions et installez-la.
+
+![alt text](./images/image-6.png)
+
+Cette extension vous permettra d'avoir une coloration syntaxique ainsi que des suggestions pour écrire le code qui vous seront très utiles. Elle vous permettra aussi de détecter des erreurs de syntaxe, ce qui pourra vous permettre de progresser plus vite.
+
+### Terminal 
+
+Ouvrez le menu `Terminal`, et cliquez sur `Nouveau terminal`. Vous verrez apparaître un volet en bas avec un terminal prêt à l'emploi. 
+
+![alt text](./images/image-7.png)
+
+Ce terminal vous permettra de saisir des commandes systèmes.
+
+### Python en mode interactif
+Dans le terminal, tapez la commande `python`. Vous verrez apparaître l'invite de commande de l'interpréteur python. Vous pourrez l'utiliser pour essayer des commandes python au cours du TP. 
+
+En attendant, essayez de taper `print("Hello, World!")` dans l'interpréteur pour vérifier que tout fonctionne.
+
+![alt text](./images/image-9.png)
+
+```admonish warning title="Attention"
+Il faut bien distinguer le terminal système de la console Python.
+
+- Le terminal système a une invite qui commence par PS (pour PowerShell, sous windows) ou qui contient votre nom (sous linux)
+- La console Python permet de taper du code Python directement. Son invite commence par `>>>`
+
+Visual studio code va parfois essayer de lancer des commandes dans le premier terminal à sa disposition, sans faire attention s'il s'agit d'une console Python. Vous verrez alors des erreurs. 
+
+**Vérifiez toujours d'être dans le bon type de terminal**. Dans le doute, fermez-les et laissez VSCode ouvrir ce dont il a besoin.
+```
+
+### Exécuter un script Python
+
+Dans l'explorateur, faites un clic droit et créez un nouveau fichier que vous appellerez `main.py` (ou tout autre nom plus adapté, en évitant les espaces et les majuscules). Dans ce fichier, ajoutez la ligne `print("Hello, World!")`.
+
+![alt text](./images/image-5.png)
+
+#### 1e méthode : ligne de commande
+Dans un nouveau terminal (vous pouvez cliquer sur le petit + en haut à droite du volet terminal actuel) tapez `python main.py`. Vous devriez voir s'afficher `Hello, World!` dans le terminal.
+    ![alt text](./images/image-10.png)
+
+#### 2e méthode : via l'interface VSCode
+Cliquez maintenant sur le triangle en haut à droite de votre fichier. Vous devriez voir un nouveau terminal s'ouvrir et votre script sera exécuté.
+
+![alt text](./images/image-11.png)
+
+Remarquez que dans ce second cas, VSCode utilise des chemins absolus (depuis `C:/`).
+
+
+### Sauvegarder un fichier
+
+Pour sauvegarder un fichier n'oubliez pas d'appuyer sur <kbd>Ctrl</kbd>+<kbd>S</kbd> régulièrement.
+
+Vous pouvez aussi faire `Fichier > Sauvegarder` (ou `File > Save` si l'interface est en anglais) dans le menu.
+
+Pour savoir si un fichier a des modifications en cours, regardez son onglet : 
+
+Modifications en attente (on a un rond plein à droite):
+![alt text](images/image.png)
+
+Tout est correctement sauvegardé (on a une croix à droite):
+![alt text](images/image-saved.png)

src/cours/CIEL1/01-bases-python/cours/python-bases-3-fonctions.md

@@ -180,25 +180,4 @@ def add(a, b):
         """
         # Bloc d'instructions
         return True
-    ```
-
-
-# Annexes
-
-## Un petit peu d'anglais
-
-|Français|Anglais|
-|--------|-------|
-|Interpréteur|Interpreter|
-|Invite de commande|Command prompt|
-|Opérateur|Operator|
-|Fonction|Function|
-|Racine carrée|Square root|
-|Affecter une variable|Assign a variable|
-|Sensible à la casse|Case sensitive|
-|Mot-clé|Keyword|
-|Mot clé réservé|Reserved keyword|
-|Typage dynamique|Dynamic typing|
-|Chaîne de caractères|String|
-|Chaîne de caractères formatée|Formatted string|
-|Boucle|Loop|
+    ```

src/cours/CIEL1/01-bases-python/tp/01_decouverte.md

@@ -1 +0,0 @@
-# TP1 - Découverte de Python

src/cours/CIEL1/01-bases-python/tp/02_fonctions.md

@@ -8,7 +8,7 @@ Dans ce TP, nous allons commencer à utiliser Visual Studio Code, qui nous servi
 
 ### 1.1 - Mise en route
 
-Pour ce TP nous n'allons plus utiliser Thonny mais Visual Studio Code. Thonny est un excellent logiciel pour débuter en python, et il sera facile à utiliser pour vous entraîner à la maison, mais il n'est pas beaucoup utilisé par les professionnels car il manque de nombreuses fonctionnalités indispensables. Visual Studio Code est un éditeur de texte libre édité par Microsoft, compatible avec toutes les plateformes. Il permet de faire ce que fait Thonny, mais également plein d'autres choses. C'est un logiciel très utilisé en entreprise et pourra vous servir pour de nombreux langages de programmation. C'est pour cela que nous allons commencer à l'utiliser, et vous vous habituerez à son fonctionnement au fil du temps.
+Pour ce TP nous n'allons plus utiliser Thonny mais Visual Studio Code. Thonny est un excellent logiciel pour débuter en python, et il sera facile à utiliser pour vous entraîner à la maison, mais il n'est pas beaucoup utilisé par les professionnels car il manque de fonctionnalités indispensables. Visual Studio Code est un éditeur de texte libre édité par Microsoft, compatible avec toutes les plateformes. Il permet de faire ce que fait Thonny, mais également plein d'autres choses. C'est un logiciel très utilisé en entreprise et pourra vous servir pour de nombreux langages de programmation. C'est pour cela que nous allons commencer à l'utiliser, et vous vous habituerez à son fonctionnement au fil du temps.
 
 Lancez Visual Studio Code depuis le menu démarrer de votre machine. Vous verrez une interface comme ci-dessous. Sur la capture d'écran, les sections dont vous aurez besoin lors de ce TP sont indiquées par des flèches.
 

src/cours/CIEL1/01-bases-python/tp/TP_MDP02_fonctions.md

@@ -0,0 +1,178 @@
+# Itération 2 - Fonctions et modules
+
+## Objectifs du TP
+
+### Apprendre
+
+- **Fonctions** : Création de fonctions
+- **Refactorisation** : réorganiser le code existant
+- **Modules** : Répartir le code dans différents fichiers
+
+### Objectif technique
+
+Créer un menu interactif pour que l'utilisateurice puisse choisir son option
+
+```
+================================================
+CIEL - Générateur de mots de passe
+================================================
+Quel type de mot de passe souhaitez-vous créer ?
+1 - Mot de passe avec configuration par défaut
+2 - Mot de passe avec configuration personnalisée
+3 - Phrase de passe avec configuration par défaut
+4 - Phrase de passe avec configuration personnalisée
+0 - Quitter
+Saisissez votre choix : 1
+Mot de passe par défaut
+```
+
+## Étapes
+
+### 1 - Préparation
+
+**Objectif :** Préparer votre fichier de script et commencer à travailler avec Thonny
+
+```admonish travail
+- Créer un fichier `main.py` dans votre répertoire de travail
+```
+
+### 2 - Affichage du titre et du menu
+
+**Objectif :** Afficher le titre et toutes les options du menu
+
+```admonish tip title="A utiliser"
+- La fonction `print`
+```
+
+**Résultat attendu :**
+```
+================================================
+CIEL - Générateur de mots de passe
+================================================
+Quel type de mot de passe souhaitez-vous créer ?
+1 - Mot de passe avec configuration par défaut
+2 - Mot de passe avec configuration personnalisée
+3 - Phrase de passe avec configuration par défaut
+4 - Phrase de passe avec configuration personnalisée
+0 - Quitter
+```
+
+```admonish travail
+- Utilisez du code pour afficher exactement le texte ci-dessus
+```
+
+### 3 - Demander le choix à l'utilisateur
+
+**Objectif :** Afficher "Saisissez votre choix : " et récupérer la réponse de l'utilisateur 
+
+```admonish tip title="A utiliser"
+- La fonction `input`
+```
+
+```admonish question
+1. Quel est le type de la donnée récupérée via `input`
+2. Comment allez-vous stocker cette donnée ? Quel type aura la variable ?
+```
+
+
+### 4 - Gérer les choix valides
+
+**Objectif :** Utiliser des conditions pour gérer les choix de l'utilisateur (1, 2, 3, 4 et 0)
+
+```admonish tip title="A utiliser"
+- `if` 
+- `elif`
+- Opérateurs de comparaison
+```
+
+**Résultat attendu :** Afficher le texte pour chacun des cas
+
+|Choix|Texte à afficher|
+|-|-|
+|1|Mot de passe par défaut|
+|2|Mot de passe personnalisé|
+|3|Phrase de passe par défaut|
+|4|Phrase de passe personnalisée|
+|0|Vous quittez le programme|
+
+### 5 - Gérer les choix invalides
+
+**Objectif :** Traiter le cas où l'utilisateur saisit un choix non valide
+
+```admonish tip title="A utiliser"
+- Ajouter un `else` pour capturer les autres cas
+- Utiliser une chaîne formatée
+```
+
+**Résultat attendu :** Afficher le texte `Erreur : l'option 6 n'existe pas` (si le choix de l'utilisateur est 6 par exemple)
+
+```admonish question
+1. Que se passe-t-il lorsque l'utilisateurice saisit une lettre au lieu d'un chiffre lors du choix de l'option ? Pourquoi à votre avis ? Nous ignorerons cette possibilité pour le moment, et verrons plus tard dans l'année comment le gérer.
+```
+
+### 6 - Ajouter une boucle
+
+**Objectif :** Le programme doit pouvoir être répété autant que l'utilisateur le veut.
+
+```admonish tip title="Quelle boucle utiliser ?"
+- La boucle `for` s'utilise pour un nombre connu d'itérations
+- La boucle `while` s'utilise pour un nombre non défini à l'avance d'itérations
+```
+
+```admonish warning title="Gestion de la pause"
+Si le choix de l'utilisateurice est différent de zéro (pour quitter), il faut avoir le temps de lire avant de réafficher le menu. 
+
+Pour cela on peut demander une entrée (avec `input`) à l'utilisateurice, mais ignorer sa saisie. On peut alors simplement lui proposer d'appuyer sur Entrée. Une fois la saisie effectuée, on pourra alors reboucler.
+```
+
+```admonish question
+1. Quelle boucle sera la plus adaptée ? Pourquoi ?
+2. Comment éviter de déclencher la pause lorsque l'utilisateurice souhaite quitter le programme ?
+```
+
+## Validation
+
+### Checklist
+
+- [ ] Le programme se lance sans erreur
+- [ ] Le titre s'affiche correctement
+- [ ] Toutes les options s'affichent
+- [ ] La saisie utilisateur fonctionne
+- [ ] Chaque option affcihe le bon message
+- [ ] Un choix (nombre entier) invalide affiche une erreur claire
+- [ ] Le code est propre, les variables sont correctement nommées et avec des noms compréhensibles
+
+### Critères d'évaluation
+
+- Le programme fonctionne correctement
+- Le code est propre : nommage des variables, lisibilité
+- Documentation : commentaires pertinents
+- Réponse aux questions dans le compte-rendu
+
+## Pour aller plus loin
+### Bonus - Améliorations
+- Personnaliser le titre avec votre nom
+- Améliorer le texte des options et les messages
+- Amélioration de la présentation du menu
+
+### Bonus difficile - Utiliser l'instruction `match`
+
+```admonish warning title='Attention'
+Cette question n'est à faire **que si le reste du TP est terminé**. Elle demande plus d'autonomie et est beaucoup moins guidée.
+Si vous n'êtes pas très à l'aise avec Python ou la programmation il vaut mieux se concentrer sur le reste et bien comprendre.
+
+Cette section n'est pas nécessaire à la bonne exécution du TP ni des séances suivantes. On peut terminer sans la faire. 
+
+**Faites une copie de votre code dans un nouveau fichier avant toute modification afin de pouvoir revenir en arrière au prochain TP si vous ne terminez pas cette question.**
+```
+
+**Objectif :** Utiliser la documentation Python pour remplacer les conditions du menu par la structure `match`.
+
+```admonish tip title="A utiliser"
+- Utiliser la documentation officielle de Python pour comprendre la structure `match` : [Documentation](https://docs.python.org/3/tutorial/controlflow.html#match-statements)
+- Utiliser la structure match pour remplacer la suite de conditions
+```
+
+```admonish question
+- Comment gérer les cas non prévus dans le menu (ce que faisait le `else`) avec `match` ?
+```

src/cours/SUMMARY.md

@@ -12,6 +12,8 @@
         - [TP2 - Fonctions](./CIEL1/01-bases-python/tp/02_fonctions.md)
         - [TD1 - Bases](./CIEL1/01-bases-python/td/td01-python.md)
         - [TD2 - Fonctions ](./CIEL1/01-bases-python/td/td02-fonctions.md)
+        - [Annexe - Visual Studio Code](./CIEL1/01-bases-python/annexes/vscode.md)
+        - [Annexe - Un peu d'anglais](./CIEL1/01-bases-python/annexes/anglais.md)
     - [L'adressage IP](./CIEL1/02-reseau/cours/adressage-ip.md)
     - [L'environnement de développement](./CIEL1/03-dev-env/dev-env.md)
         - [Les conteneurs](./CIEL1/03-dev-env/conteneurs.md)