Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

Obtenir un journaliseur enfant avec Logger.getChild

Retrouvez un journaliseur à partir du nom de son parent et transmettez ses enregistrements au gestionnaire du parent sans le copier sur l’enfant.

Version : Python 3.12

Syntaxe

parent_logger.getChild(suffix)

logging.Logger.getChild(suffix) est une méthode d’instance disponible depuis Python 3.2. Pour un journaliseur autre que la racine, elle ajoute au nom un point et le suffixe fourni sous forme de chaîne, puis recherche le journaliseur correspondant. Pour le journaliseur racine, elle utilise directement le suffixe, sans le préfixe root.. Si app désigne le journaliseur nommé app, app.getChild("validation") renvoie le même objet que logging.getLogger("app.validation"). Le suffixe peut contenir des points : validation.rules désigne un descendant plus profond.

La méthode ne copie aucun gestionnaire. Lorsque app.validation accepte un enregistrement et que propagate=True (par défaut), l’enregistrement atteint aussi les gestionnaires de app. Avec app.propagate = False, ces gestionnaires restent actifs, mais l’enregistrement ne remonte pas jusqu’au journaliseur racine.

Les seuils du journaliseur et du gestionnaire interviennent à des étapes différentes. Avec son niveau à NOTSET, app.validation utilise le niveau INFO de app comme niveau effectif dans l’exemple. Après acceptation de l’enregistrement, la propagation n’applique pas de nouveau les niveaux ni les filtres des journaliseurs ancêtres, mais chaque gestionnaire applique toujours son propre seuil et ses filtres. Si le même gestionnaire est rattaché à l’enfant et au parent, il peut afficher l’enregistrement deux fois.

Exemples

import logging
import sys

app = logging.getLogger("app")
app.setLevel(logging.INFO)
app.propagate = False

handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(name)s | %(levelname)s | %(message)s"))
app.addHandler(handler)

validation = app.getChild("validation")
assert validation is logging.getLogger("app.validation")
validation.info("Input accepted")

Résultat

app.validation | INFO | Input accepted

Exécutez le script dans un nouveau processus Python 3.12. L’assertion utilise `is` pour vérifier l’identité de l’objet. Le seul gestionnaire est rattaché à `app`, mais la sortie affiche `app.validation`, car c’est ce journaliseur qui a créé l’enregistrement.

Leçons associées

  • Python · Leçon 24 · Intermédiaire · Version : 3

Sources