Programme Leçon 68 sur 148 · Des API que personne ne peut mal utiliser
Des API que personne ne peut mal utiliser

Rendre les états explicites

Pourquoi c'est important Les objets qui ont un cycle de vie (connexions, fichiers, transactions, paiements) sont là où vit le « ça marchait sur ma machine ». Un appel dans le mauvais ordre doit échouer sur place, pas corrompre quelque chose plus tard.

Tu enveloppes un transport réseau pour le reste de l'équipe. Le transport lui-même est de bas niveau : connect(), write(data), disconnect(), et il fait tout ce qu'on lui dit. Une analyse d'incident du trimestre dernier a trouvé une tâche qui envoyait des données après avoir fermé et se reconnectait en silence au mauvais serveur. Ton enveloppe doit rendre ça impossible.

Machine à états : un petit ensemble d'états (nouveau, ouvert, fermé) et les appels autorisés dans chacun. Tout le reste est refusé.

c = Connection(transport)
c.open()
c.send(b"hello")
c.close()

with Connection(transport) as c:   # opens, and always closes
    c.send(b"hello")
À ton tour

Écris class Connection avec __init__(self, transport), open(), send(data), close(), et la prise en charge de with (ouvrir à l'entrée, fermer à la sortie même si le bloc lève une erreur). Elles appellent les méthodes connect(), write(data) et disconnect() du transport.

Des scripts de mauvaise utilisation cachés essaieront chacun de ces cas. Chacun doit lever une erreur au mauvais appel, avant que quoi que ce soit n'atteigne le transport :

  • RuntimeError (ou une sous-classe) : send ou close avant open ; open deux fois ; send, close ou open à nouveau après close (une connexion fermée est terminée ; crée-en une nouvelle) ; send après un bloc with ;
  • TypeError : envoyer tout ce qui n'est pas de type octets (bytes ou bytearray). N'encode pas les chaînes pour l'appelant.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.