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

Pas de pièges booléens

Pourquoi c'est important copy(src, dst, True, False) ne peut pas se lire sans ouvrir la fonction. Échange les deux options et une simulation devient un vrai écrasement. Les options nommées font dire à chaque appel ce qu'il fait.

Une équipe data a une fonction utilitaire qui copie des enregistrements entre deux stockages : copy_records(src, dst, overwrite, dry_run). Le mois dernier, quelqu'un l'a appelée comme copy_records(a, b, False, True) en voulant dire « simulation, ne pas écraser », s'est trompé d'ordre, et a écrasé une table de production. Tu la remplaces.

Piège booléen : un argument qui vaut seulement True ou False, donc l'endroit de l'appel ne dit pas ce qu'il signifie et il est facile à échanger.

copy_records(src, dst, on_conflict="keep", mode="dry_run")
À ton tour

Écris copy_records(src, dst, *, on_conflict, mode). src et dst sont des dicts. Pour chaque clé de src : si elle n'est pas dans dst, copie-la ; si elle y est, on_conflict décide : "keep" (laisser la valeur de dst), "overwrite" (utiliser celle de src), ou "fail" (lever ValueError et ne rien changer du tout). mode vaut "apply" (modifier dst) ou "dry_run" (ne rien modifier). Renvoie la liste triée des clés écrites (ou qui le seraient).

Des scripts de mauvaise utilisation cachés essaieront chacun de ces cas ; chacun doit lever TypeError ou ValueError et laisser dst inchangé : passer les options par position, omettre l'une des options (pas de valeurs par défaut : l'appelant doit choisir), toute valeur qui n'est pas exactement une des chaînes nommées (fautes de frappe, autres majuscules, True, False, None), et l'ancien mot-clé overwrite=.

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.