assert

Vérifie une hypothèse dans le code et lève AssertionError lorsqu’elle n’est pas vraie.

Sur cette page

Exemple

#
Python
def average(values):
    assert len(values) > 0, "La liste ne peut pas être vide"
    return sum(values) / len(values)

print(average([80, 90]))

try:
    average([])
except AssertionError as error:
    print("AssertionError :", error)
Résultatrésultat enregistré, vous pouvez le vérifier
85.0
AssertionError : La liste ne peut pas être vide

Définition et utilisation

#

L’instruction assert condition, message vérifie si la condition est vraie. Sinon, elle lève une AssertionError avec le message donné. C’est un moyen de consigner, directement dans le code, des hypothèses qui devraient toujours être vraies.

Les assertions sont le fondement des tests de la bibliothèque pytest : chaque test est une fonction qui vérifie des résultats avec assert.

N’utilisez pas assert pour valider des données venant d’un utilisateur. Python lancé avec le drapeau d’optimisation (-O) ignore toutes les assertions, une telle validation pourrait donc tout simplement disparaître. Les conditions ordinaires et raise sont l’outil adapté.

Syntaxe

#
Syntaxe
assert condition, "message"

Bonnes pratiques

#
  • Utilisez assert dans les tests et pour vérifier les hypothèses du programmeur, pas pour valider des données d’entrée.
  • Le message d’une assertion doit dire quelle hypothèse a été violée.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.