code en anglais, commentaires en français

src/devine_humain.py

@@ -6,29 +6,40 @@ min=0
 max=10
 print("Je pense à un nombre entre", min, "et", max )
 
-nombre = random.randint(min,max)
-essais=4
+# Tire un entier ("integer") au hasard entre min et max compris
+number = random.randint(min,max)
 
-while essais > 0:
-    print("Devine ? ")
-    devine = input()
-    devine = int(devine)
+attempts = 4
 
-    if devine > nombre:
+while attempts > 0:
+    print("guess ? ")
+
+    # attends une saisie de l'utilisateur sous forme de chaine de caractère
+    guess = input()
+
+    # interprète la chaine de caractère comme un entier
+    guess = int(guess)
+
+    if guess > number:
         print("Trop grand")
 
-    if devine < nombre:
+    if guess < number:
         print("Trop petit")
 
-    if devine == nombre:
+    if guess == number:
+        # sort directement de la boucle "while"
         break
 
-    essais = essais - 1
-    print("Plus que", essais, "essais")
+    attempts = attempts - 1
+    print("Plus que", attempts, "essais")
 
 
-if devine != nombre:
-    print("Perdu, je pensais au nombre", nombre)
+# On arrive ici dans deux situations :
+# 1) tous les essais ont été tentés, la boucle s'arrête d'elle-même
+# 2) on a deviné le nombre secret, on est sorti par l'instruction "break"
+
+if guess != number:
+    print("Perdu, je pensais au nombre", number)
 else:
     print("Bravo !")