with

Un gestionnaire de contexte : préparation et nettoyage automatiques des ressources.

Sur cette page

Exemple

#
Python
from contextlib import contextmanager

@contextmanager
def lesson(title):
    print(f"Début : {title}")
    try:
        yield title.upper()
    finally:
        print(f"Fin : {title}")

with lesson("boucles") as name:
    print(f"Apprentissage : {name}")
Résultatrésultat enregistré, vous pouvez le vérifier
Début : boucles
Apprentissage : BOUCLES
Fin : boucles

Définition et utilisation

#

L’instruction with utilise un gestionnaire de contexte, qui prépare une ressource avant le bloc et la nettoie ensuite, même si une erreur survient à l’intérieur du bloc. L’exemple le plus connu est l’ouverture d’un fichier : à la sortie du bloc, le fichier est fermé automatiquement.

Les verrous de threads, les connexions à une base de données et les changements temporaires de réglages sont aussi des gestionnaires de contexte, par exemple. Vous pouvez en utiliser plusieurs à la fois, séparés par des virgules.

Vous pouvez écrire votre propre gestionnaire de contexte sous forme de classe avec les méthodes __enter__ et __exit__, ou, plus simplement, sous forme de fonction décorée avec @contextmanager du module contextlib.

Syntaxe

#
Syntaxe
with expression as name:
    ...

Plus d’exemples

#
Ouverture d’un fichier
Python
with open("notes.txt", "w", encoding="utf-8") as file:
    file.write("Une boucle for parcourt les éléments\n")

with open("notes.txt", encoding="utf-8") as file:
    print(file.read().strip())
Résultatrésultat enregistré, vous pouvez le vérifier
Une boucle for parcourt les éléments

Le fichier sera fermé après chaque bloc with, même si l’écriture a levé une erreur.

Bonnes pratiques

#
  • Ouvrez toujours les fichiers avec with. Vous n’avez pas à penser à close(), et le fichier est fermé même après une erreur.
  • Pour les fichiers texte, indiquez encoding="utf-8" afin que les caractères accentués se comportent de la même façon sur tous les systèmes.

Entrées associées

#

Pratiquer dans les leçons

#

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