Les indications de type (*type hints*) précisent, à titre indicatif, le type attendu d'un paramètre ou d'une valeur de retour — Python ne les vérifie pas à l'exécution, mais elles documentent le code et aident un éditeur à détecter des erreurs avant même de lancer le programme.

class Produit:
    def __init__(self, nom: str, prix: float, stock: int = 0):
        self.nom = nom
        self.prix = prix
        self.stock = stock

    def valeur_stock(self) -> float:
        return self.prix * self.stock

nom: str indique que nom est attendu comme chaîne de caractères ; -> float après les parenthèses indique que valeur_stock renvoie un nombre à virgule. Ces annotations ne changent rien au comportement du programme : appeler Produit(123, "cher") (types inversés) fonctionnerait toujours sans erreur immédiate, Python restant dynamiquement typé.

Les type hints servent surtout à la lecture et à la relecture d'un code, en particulier dans un projet plus grand où plusieurs personnes travaillent sur le même code : elles rendent explicite ce que chaque fonction attend et renvoie, sans avoir à lire tout le corps de la fonction pour le deviner.

À vous de jouer : ajoutez des type hints aux paramètres et à la valeur de retour d'une méthode de votre choix, sans changer son comportement.