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