Proofread 7

fragments/assert.md

@@ -0,0 +1,35 @@
+\center \huge Un nouveau mot-clé
+
+# Les mots-clés
+
+Des mots qui ne peut être utilisé pour des noms de variales.
+
+On a déjà vu: `def`, `class`, `import`, etc ...
+
+Aujourd'hui on va parler de `assert`
+
+# Assertions
+
+* Arrêter immédiatement le programme avec un message
+* Ressemble à `sys.exit()`
+* Mais usage un peu différent
+
+# Les assertions sont là pour les dévelopeurs
+
+* Le message n'aura en général *aucun* sens si c'est un simple utilisateur
+  qui le lit.
+* Il indique en général un problème *interne*, dans le code lui-même,
+  par opposition aux erreurs *externes*
+  
+ 
+Mais on en reparlera :)
+
+# Example
+
+```python
+
+def move_space_ship()
+    assert speed < light_speed, "the laws of the universe are broken"
+
+```
+

sessions/python-07.md

@@ -1,81 +1,77 @@
 % Programmation avec Python (chapitre 7)
 % Dimitri Merejkowsky
 
-#
+\center \huge Rappels sur les classes
 
-\center \huge Un nouveau mot-clé
+# Définition d'une classe
 
-# Les mots-clés
+Construire une classe`Counter` vide:
 
-Des mots qui ne peut être utilisé pour des noms de variales.
+```python
+class MyClass:
+   ...
+```
 
-On a déjà vu: `def`, `class`, `import`, etc ...
 
-# Assertions
+# Instantiation
 
-* Arrêter immédiatement le programme avec un message
-* Ressemble à `sys.exit()`
-* Mais usage un peu différent
+Construire une nouvelle *instance* de `Counter`
 
-# Les assertions sont là pour les dévelopeurs
+```python
+>>> my_instance = MyClass()
+```
 
-* Le message n'aura en général *aucun* sens si c'est un simple utilisateur
-  qui le lit.
-* Il indique en général un problème *interne*, dans le code lui-même,
-  par opposition aux erreurs *externes*
-Mais on en reparlera :)
+# Méthodes
 
-#
-
-\center \huge Rappels sur les classes
+Ajouter une méthode:
 
+```python
+class MyClass:
+    def my_method(self):
+        ...
+```
 
-# Définition d'une classe
+`self` représente l'objet courant.
 
-Construire la classe`Counter` avec un attribut `count`:
+# Méthodes
+     
+Appeler une méthode:
 
 ```python
-class Counter:
-    def __init__(self):
-        self.count = 0
+>>> my_instance = MyClass()
+>>> my_instance.my_method()
 ```
 
+# Ajouter un attribut
 
-# Instantiation
+```python
+>>> my_instance = MyClass()
+>>> my_instance.my_attribute = 0
+```
 
-Construire une nouvelle *instance* de `Counter`
+# Accéder à un attribut dans la classe
 
 ```python
->>> counter = Counter()
->>> counter.count
-0
+class MyClass():
+    def my_method(self):
+    	print(self.my_attribute)
 ```
 
-# Méthode
+# Méthode spéciale: __init__
 
-Ajouter une méthode pour incrémenter le compteur:
+Initialiser les attributs:
 
 ```python
-class Counter:
+class MyClass:
     def __init__(self):
-        self.count = 0
-
-    def increment(self):
-    	self.count += 1
-
-```
+        self.my_attribute = 0
 
-# Apeller une méthode
-
-```python
->>> counter = Counter()
->>> counter.count
+>>> my_instance = MyClass()
+>>> my_instance.my_attribute
 0
->>> counter.increment()
->>> counter.count
-1
 ```
 
+
 #
 
 \center \huge Compléments sur les classes
@@ -132,17 +128,12 @@ Avec un joli `@classmethod` au-dessus
 class Car:
     total_number_of_cars = 0
 
-
     @classmethod
     def print_number_of_cars(cls):
     	print(cls.total_number_of_cars, "have been made")
-
-
-   def print_color(self):
-       print("This car is", self.color)
 ```
 
-Notez le `cls`
+Notez le `cls`.
 
 # Méthodes de classes
 
@@ -155,6 +146,13 @@ Pour appeler:
 2 cars have been made
 ```
 
+# Note
+
+Au lieu de dire "de classe" on utilise parfois "statique". 
+
+Mais "statique" veut dire plein d'autres chose...
+
+
 # On retrouve le même mécanisme
 
 * ce qu'on écrit
@@ -199,13 +197,11 @@ def print_number_of_cars(cls):
 \center \huge Les API Web
 
 
-# Concepts
-
 # HTTP
 
-Une façon pour des machines différentes de parler entre elles.
+Un *protocole*: une façon pour des machines différentes d'échanger des informations.
 
-On fait toujours un aller-retour du *client* vers le *serveur*.
+On fait souvent un aller-retour du *client* vers le *serveur*.
 
 ![](img/client-serveur.png)
 
@@ -215,7 +211,7 @@ Une requête part du client vers le serveur et consite en:
 
 * Une URL
 * Un verbe (souvent GET)
-* Des paramètres
+* Des paramètres (sous la forme: `?a=42&b=true`)
 * Et d'autres trucs
 
 # Réponses
@@ -238,11 +234,50 @@ Vous voyez parfois le code de retour (le plus connu étant 404)
 
 *C'est très simplifié*
 
+#  Le format HTML
+
+Des règles pour interpréter du texte:
+
+```html
+<body>
+<h1>Ceci est un titre</h1>
+<p>
+Ceci est un paragraphe
+</p>
+</body>
+```
+
+# Faire des requêtes en Python
+
+Avec `requests`, *la* librarie pour faire des requêtes HTTP en Python.
+
+Malheureusement pas dans la librarie standard.
+
+```python
+import requests
+
+>>> response = request.get(url)
+>>> response.status_code
+200 # si tout va bien
+>>> response.text
+"<!DOCTYPE html ..."> # le texte de la réponse
+```
+
+
+
+# Une API Web
+
+Faire tourner de code sur le client, en utilisant du code sur un
+serveur *via* le protocole HTTP.
+
+![](img/client-serveur.png)
+
+
 # Utiliser une API Web
 
 * Lire les conditions d'utilisation (important!)
 * Regarder les URLs possibles et les paramètres attendus
-* Faire quelque chose avec la réponse
+* Ensuite seulement, écrire du code.
 
 Notez qu'on a *absolument* aucune connaissance du code qui tourne sur le serveur!
 
@@ -270,9 +305,12 @@ Examples:
 {
    "color": "blue",
    "size": 3
+   "pretty": bool,
 }
 ```
 
+**Attention**: les clés json sont *toujours* des strings.
+
 # JSON
 
 On peut imbriquer les objets les uns dans les autres:
@@ -285,8 +323,6 @@ On peut imbriquer les objets les uns dans les autres:
 }
 ```
 
-On dit que JSON est un format *texte* par ce qu'on peut le mettre dans une string.
-
 
 # JSON / Python
 
@@ -334,22 +370,6 @@ None        | null
 * Le rendre plus flexible
 * Etc ...
 
-# Requests
-
-*La* librarie pour faire des requêtes HTTP en Python.
-
-Malheureusement pas dans la librarie standard.
-
-```python
-import requests
-
->>> response = request.get(url)
->>> response.status_code
-200 # si tout va bien
->>> response.text
-"<!DOCTYPE html ..."> # le texte de la réponse
-```
-
 # Requests + JSON
 
 ```python

sources/marvel/get-character-description.py

@@ -13,7 +13,10 @@ def main():
     # Read api keys from the text file
     with open("api-keys.txt", "r") as file:
         lines = file.readlines()
-    assert len(lines) == 2, "Incorrect api-keys file"
+
+    if len(lines) != 2:
+        sys.exit("Incorrect api-keys file")
+
     public_key = lines[0].strip()
     private_key = lines[1].strip()
 
@@ -40,7 +43,8 @@ def main():
     url = base_url + "/characters"
     response = requests.get(url, params=params)
     status_code = response.status_code
-    assert status_code == 200, "got status: " + str(status_code)
+    if status_code != 200:
+        sys.exit("got status: " + str(status_code))
     body = response.json()
 
     description = body["data"]["results"][0]["description"]