"""
    Description du programme : que fait-il et comment le fait-il
"""

# ===================================================================
# IMPORTS
# ===================================================================

import sys 

# ===================================================================
# VARIABLES GLOBALES
# ===================================================================

# Exemple :
# nombre de tests effectués
nbr_tests = 0
# nombre de tests validés
nbr_tests_valides = 0

# ===================================================================
# SOUS-PROGRAMMES
# ===================================================================

# Exemple
def diviser(a, b) -> int:
    """
        Que fait le sous-programme, comment le fait-il, quels
        sont les particularités des paramètres. Par exemple :

        Calcul de la division entière de deux entiers
        - a, b : entiers à diviser, b peut être nul

        Retourne a/b sauf si b==0 auquel cas on affiche on lève une
        exception
        
        !!! Attention !!!
        Les commentaires de sous-programmes en Python doivent être à 
        l'intérieur du sous-programme
    """
    
    if b == 0:
        raise Exception("division par zéro")
        

    # utilisation de la division entière '//'
    return a // b



# ===================================================================
# PROGRAMME PRINCIPAL
# ===================================================================

def main():
    """
    Fonction princiale
    """

    # on indique que ces variables sont globales au programme
    global nbr_tests, nbr_tests_valides

    try:
        print("==== PREMIER TRAITEMENT ====")
        nbr_tests += 1
        a = 14
        b = 2
        c = diviser(a, b)
        print(f"{a} / {b} = {c}")
        nbr_tests_valides += 1

        print("==== SECOND TRAITEMENT ====")
        nbr_tests += 1
        a = 14
        b = 0
        c = diviser(a, b)
        print(f"{a} / {b} = {c}")
        nbr_tests_valides += 1
    except Exception as e:
         print(e)

    print(f"nombre de tests effectués={nbr_tests}") 
    print(f"nombre de tests validés  ={nbr_tests_valides}") 


# ===================================================================
# APPEL DE main()
# ===================================================================

if __name__ == '__main__':
	main()