L’union de types `X | None`
`X | None` décrit une valeur de type `X` ou la valeur `None`. Dans `-> str | None`, l’union décrit la valeur renvoyée par une fonction, pas une valeur par défaut.
CKTIS / Python
Syntaxe, opérateurs et concepts de programmation. Trouvez une explication, explorez un exemple et reprenez votre apprentissage.
`X | None` décrit une valeur de type `X` ou la valeur `None`. Dans `-> str | None`, l’union décrit la valeur renvoyée par une fonction, pas une valeur par défaut.
Utilisez `X | None` pour accepter une valeur de type `X` ou `None`. Si une classe est définie plus loin, mettez toute l’annotation entre guillemets ou utilisez l’import `__future__`.
Utilisez `setUp()` pour fournir des données neuves à chaque test, puis vérifiez des valeurs avec `assertEqual()` et une exception attendue avec `assertRaises()`.
Vérifiez plusieurs entrées dans une seule méthode de test, identifiez les sous-tests en échec et distinguez une assertion d’égalité d’une vérification d’exception.
Exécutez une suite de tests ou un cas de test isolé, puis utilisez le `TestResult` renvoyé pour produire un bilan personnalisé sans analyser le rapport textuel.
Dans une définition de fonction, `*args` recueille les arguments positionnels supplémentaires dans un tuple. Dans un appel, `*` dépaquette un itérable en arguments positionnels.
En Python 3.12, `*args` recueille les arguments positionnels supplémentaires dans un tuple et `**kwargs` les arguments nommés non associés dans un dictionnaire. Lors d’un appel, ces mêmes symboles déballent les arguments.
Dans une définition de fonction, `*items` regroupe les arguments positionnels restants dans un tuple. À l’appel, `*values` fait l’inverse : il transmet les éléments d’un itérable comme arguments positionnels distincts.
Enveloppez un journaliseur existant dans un `logging.LoggerAdapter` muni du champ `team` pour que `info`, `warning` et `error` partagent le même contexte d’équipe.
Utilisez `write()` pour écrire du texte en mémoire par morceaux, `read()` pour lire à partir de la position courante et `getvalue()` pour récupérer tout le tampon sans revenir au début.
AssertionError est une exception intégrée déclenchée lorsque la condition d’une instruction assert est fausse. Les assertions vérifient les hypothèses internes du programme, et non la validation obligatoire des entrées : l’optimisation peut les supprimer.
Exception est la classe de base intégrée de Python pour les exceptions ordinaires. Elle permet de définir des types d’erreur personnalisés et de les intercepter ensemble, mais ne couvre pas tous les descendants de BaseException.
IndexError est une exception intégrée déclenchée lorsqu’on tente d’accéder à un élément d’une séquence avec un indice hors limites. Découvrez les limites des indices valides, la différence entre l’indexation et le découpage, ainsi que la manière d’intercepter cette exception.
KeyError signifie qu’une clé demandée est introuvable dans un mapping, comme un dict. Découvrez la différence entre l’accès avec des crochets et get(), et gérez les clés manquantes sans masquer les erreurs sans rapport.
NameError signifie que Python n’a pas trouvé un nom utilisé dans les portées disponibles. Vérifiez l’orthographe, l’ordre des affectations et les imports. Distinguez NameError d’AttributeError. UnboundLocalError est une sous-classe de NameError.
StopIteration signale l’épuisement d’un itérateur pendant next(). Son attribut value peut contenir la valeur de retour d’un générateur. Terminer un générateur avec return n’est pas la même chose que laisser une exception StopIteration explicitement levée s’échapper de son code.
TimeoutError signale qu’une opération a dépassé son délai. Dans Python 3.14, asyncio.TimeoutError est un alias obsolète de la même classe, et non une exception distincte. Interceptez TimeoutError et distinguez un dépassement de délai d’une annulation ordinaire de tâche.
Une erreur TypeError signifie qu’une opération ou une fonction a reçu un objet d’un type inapproprié. Découvrez en quoi elle diffère de ValueError et comment la traiter sans masquer le problème sous-jacent.
UnboundLocalError se produit lorsqu’une fonction lit une variable locale à laquelle aucune valeur n’est affectée à ce moment-là. C’est une sous-classe de NameError ; une cause fréquente est une affectation qui masque une variable d’une portée extérieure.
ValueError indique qu’un argument a le type attendu, mais une valeur inacceptable. Découvrez en quoi il diffère de TypeError et comment le lever et l’intercepter.
ZeroDivisionError est une exception intégrée déclenchée lorsqu’une division ou une opération de reste utilise un diviseur nul. Gérez-la avec except ZeroDivisionError lorsque le programme peut réagir de manière pertinente à ce cas.
Renvoie la valeur absolue d’un nombre ou le module d’un complexe.
Obtient un itérateur asynchrone via `__aiter__` sans attendre une valeur.
Teste la valeur de vérité des éléments jusqu’au premier faux.