Annotations de type

Programmation orientée objet intermédiaire en Python

Jake Roach

Data Engineer

Code sans annotations de type

class Student:
    def __init__(self, name, student_id, tuition_balance):
        self.name = name
        self.student_id = student_id
        self.tuition_balance = tuition_balance

# Créer une classe peut être piégeux
walker = Student("Sarah Walker", 319921, 15000)

student_id doit-il être un entier ?
tuition_balance doit-il être un float ou un entier ? Peut-être une chaîne ?
Après la création de walker, comment se souvenir de son type plus loin dans le code ?

Annotations de type

Outil optionnel pour ajouter des infos de type dans le code

Lecture et débogage facilités
L'un des meilleurs moyens de montrer des compétences Python de niveau entreprise
Non imposé par l'interpréteur
Mots-clés intégrés, bibliothèque typing, classes personnalisées

# Ajouter une annotation lors de la création 
# d'une variable
gpa: float = 3.92

# Ajouter des annotations à une définition 
# de fonction/méthode
def check_grades(year: str) -> List[int]:
    ...

# Utiliser aussi des classes personnalisées
students: Dict[str, Student] = {...}

Annotations avec mots-clés de type intégrés

# Annotation pour une logique déclarative
name: str = "Frost"  # Avant : name = "Frost"
student_id: int = 91031367
tuition_balance: float = 17452.78

# Annotation pour les définitions de fonctions/méthodes
def get_schedule(semester: str) -> dict:
    ...

Utilisez la syntaxe variable: type
Déclaratif, signature de fonction/méthode
def .... () -> type: pour indiquer le type de retour

Bibliothèque typing

typing est une bibliothèque qui offre plus d'outils pour annoter les types

List, Dict, Tuple
Annotez les objets de haut niveau et leurs éléments

from typing import List, Dict

student_names: List[str] = ["Morgan", "Chuck", "Anna"]
student_gpas: Dict[str, float] = {
    "Casey": 3.71,
    "Sarah": 4.0
}

Any, Set, Iterator, Callable

Annotations avec des classes personnalisées

class Student:
    def __init__(self, name: str, student_id: int, tuition_balance: float) -> None:
        self.name: str = name
        self.student_id: int = student_id
        self.tuition_balance: float = tuition_balance

    def get_course(self, course_id: str) -> Course:
        ...
        return course

# Utiliser Student et Course pour annoter les types
walker: Student = Student("Sarah Walker", 319921, 15000)
data_science: Course = walker.get_course("TDM-20100")

Vérifier les types d'objets

# walker: Student = Student("Sarah Walker", 319921, 15000)
print(type(walker))

<class '__main__.Student'>

# data_science: Course = walker.get_course("TDM-20100")
print(type(data_science))

<class '__main__.Course'>

Passons à la pratique !

Programmation orientée objet intermédiaire en Python