python:bases:exceptions [WEBGE Wikis]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
[[:python:accueilpython|{{ :iconemaison.jpg?nolink&30|Sommaire Python et microPython}}]]

===== Python - Test, exceptions, assertions et module doctest =====
[Mise à jour le : 16/12/2022]

  * **Sources** 
    *  **Documentation** sur Python.org : <html><html><a href="https://docs.python.org/fr/3.6/reference/index.html" target="_blank">référence du langage</a>, <a href="https://docs.python.org/fr/3/tutorial/errors.html?highlight=exceptions" target="_blank">erreurs et exceptions</a></html>, <html><a href="https://docs.python.org/fr/3.5/library/functions.html" target="_blank">fonctions natives</a></html> (built-in)
    * Framework sur Github - <html><a href="https://github.com/nteract/testbook" target="_blank">testbook</a></html>

  * **Mots-clés** : exceptions, assertions

<callout type="warning" icon="true">Les mots ci-dessous sont dits "réservés". Ils ne peuvent pas être utilisés comme nom de variable. Les mots __soulignés__ sont une nouveauté de Python 3. Les mots en **gras** sont utilisés dans cette page.</callout>

|  and         |  continue    |  **finally**  |  is            |  **raise**  |
|  as          |  def         |  for          |  lambda        |  return     |
|  **assert**  |  del         |  from         |  __None__      |  __True__   |
|  __async__   |  elif        |  global       |  __nonlocal__  |  **try**    |
|  __await__   |  **else**    |  if           |  not           |  while      |
|  break       |  **except**  |  import       |  or            |  with       |
|  class       |  __False__   |  in           |  **pass**      |  yield      |

  * <html><a href="https://docs.python.org/fr/3.5/library/functions.html" target="_blank">Fonctions natives</a></html>** (built-in)**((Fonctions toujours disponibles.)) utilisées dans les exemples : **enumerate**(), **flush**(), **open**(), **print**(), **ranges**(), **repr**().

----

==== Introduction ====
Quand Python rencontre une erreur dans le code, il **lève une exception**. Le traitement de ces exceptions permettra notamment de donner une réponse à une erreur produite par l'action de l'utilisateur (entrée de valeurs, etc.).

==== 1. Exceptions ====

=== 1.1 Forme minimale try ... except ===

<code python *.py>
try:
    # Bloc de code à essayer
    pass
except:
    # Bloc qui sera exécuté en cas d'erreur
    pass
</code>

//Exemple//

<code python *.py>
age = input("Quel est votre âge ? ")
try:
    age = int(age)
    print("Vous avez", age,"ans")
except:
    print("Erreur lors de la conversion de votre âge !")
</code>

//Résultat attendu//

Quel est votre âge ? 35 \\
Vous avez 35 ans \\
\\
Quel est votre âge ? ldkfjg \\
Erreur lors de la conversion de votre âge ! \\

<callout type="primary" icon="true">On intercepte toutes les erreurs sans les distinguer.</callout>

=== 1.2 Forme complète try ... except ... finally===

<code python *.py>
try:
    # Bloc de code à essayer
    pass
except <error_1>:
    # Ce bloc sera exécuté si l'erreur = <error_1>
    pass
except <error_2>:
    # Ce bloc sera exécuté si  l'erreur = <error_2>
    pass
except <error_n>:
    # Ce bloc sera exécuté si  l'erreur = <error_n>
    pass
else:
    # Ce bloc sera exécuté si le code du bloc try s'est exécuté sans erreur
    # else souvent omis et bloc placé dans try
    pass
finally:
    # Bloc exécuté qu'il y ait eu des erreurs ou non
</code>

//Exemple//

<code python *.py>
num = input("Entrée le numérateur  ")
denom = input("Entrée le dénominateur ")
resultat = 0
try:
    numerateur = int(num)
    denominateur = int(denom)
    resultat = numerateur / denominateur
except NameError:
    print("Le numérateur ou le dénominateur n'ont pas été définis")
except ValueError:
    print("Le numérateur ou le dénominateur possède un type incompatible avec la division.")
except ZeroDivisionError:
    print("Le dénominateur est égal à 0.")
else:
    print("Le résultat de la division est", resultat)
finally:
    print("On poursuit l'exécution du programme")
</code>

//Résultat attendu//

Entrer le numérateur  12 \\
Entrer le dénominateur 2 \\
Le résultat de la division est 6.0 \\
On poursuit l'exécution du programme \\
\\
Entrer le numérateur  12 \\
Entrer le dénominateur klkl \\
Le numérateur ou le dénominateur possède un type incompatible avec la division. \\
On poursuit l'exécution du programme  \\
\\
Entrer le numérateur  12 \\
Entrer le dénominateur 0 \\
Le dénominateur est égal à 0. \\
On poursuit l'exécution du programme \\

=== 1.3 Lever une exception ===
<callout type="primary" icon="true">Pour lever une exception on utilise le mot-clé **raise**.</callout>

<code python *.py>
raise TypeException("Message à afficher")
</code>

==== 2. Les assertions ====
<callout type="primary" icon="true">Les assertions sont un moyen de s'assurer, avant de continuer , qu'une condition est respectée.</callout>

// Syntaxe //
<code python *.py>
assert test
</code>

//Exemple//

<code python *.py>
val = input("Saisissez une valeur supérieure à 0 : ")
try:
    val=int(val)
    assert val>0
except ValueError:
    print("Ce n'est pas un nombre")
except AssertionError:
    print("La valeur n'est pas supérieure à 0 !")
</code>

// Résultat attendu //
Saisissez une valeur supérieure à 0 : 6 \\
\\
Saisissez une valeur supérieure à 0 : 0 \\
La valeur n'est pas supérieure à 0 !


==== 2. Le module doctest ====

  * **Source** : <html><a href="https://docs.python.org/fr/3/library/doctest.html#module-doctest" target="_blank">Test interactive Python examples</a></html> sur python.org

<callout type="primary" icon="true">Le module doctest recherche des zones de texte ressemblant à des sessions Python interactives et les exécute pour en vérifier le bon fonctionnement. Principe et exemples <html><a href="https://franckchambon.github.io/ClasseVirtuelle/Term_NSI/doctest.html" target="_blank"><strong>ici</strong></a></html></callout>

----

==== Résumé ====
  * On peut intercepter les erreurs (ou exceptions) levées par le code avec **try... except... finally...**
  * La syntaxe d'une assertion est **assert test**.
  * Les assertions lèvent une exception **AssertionError** si le test échoue.
  * On peut lever une exception grâce au mot-clé **raise** suivi du type de l'exception et d'un message.

----

{{  :python:bases:realpython.png?nolin|}}
==== Pour aller plus loin ... ====
    * <html><a href="https://testdriven.io/blog/pytest-for-beginners/" target="_blank">Pytest for Beginners</a></html>
    * <html><a href="https://realpython.com/python-assert-statement/" target="_blank">Python's assert: Debug and Test Your Code Like a Pro</a></html>
    * <html><a href="https://realpython.com/python-testing/" target="_blank">Getting Started With Testing in Python</a></html>
    * <html><a href="https://realpython.com/learning-paths/test-your-python-apps/" target="_blank">Test Your Python Apps</a></html>
    * <html><a href="https://ward.readthedocs.io/en/latest/" target="_blank">ward : un framework de test pour Python</a></html>
    * <html><a href="https://snyk.io/blog/the-dangers-of-assert-in-python/?utm_campaign=AOM-2022&utm_medium=Paid-Email&utm_source=PyCoders&utm_content=the-dangers-of-assert-in-python" target="_blank">The dangers of assert in Python</a></html>