瀏覽代碼

Proofread 7

master
Dimitri Merejkowsky 5 年之前
父節點
當前提交
cdeb8dcd00
共有 3 個文件被更改,包括 136 次插入77 次删除
  1. +35
    -0
      fragments/assert.md
  2. +95
    -75
      sessions/python-07.md
  3. +6
    -2
      sources/marvel/get-character-description.py

+ 35
- 0
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"

```


+ 95
- 75
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


+ 6
- 2
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"]