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

CKTIS / Python

logging.basicConfig

basicConfig règle avec level le seuil du journal racine, ainsi que le flux et le format de sortie.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

logging.basicConfig(**kwargs)

basicConfig règle avec level le seuil du journal racine, ainsi que le flux et le format de sortie.

Configurer la sortie avant le premier logging.warning évite son installation implicite d’un gestionnaire sur la racine vide. Pour un fichier, encoding et errors déterminent l’encodage et le traitement des caractères non représentables. Si des gestionnaires racine existent, l’appel par défaut ne change rien. force=True retire et ferme les anciens gestionnaires. Lors d’une configuration effective, fournir filename et stream ensemble lève ValueError.

Dans l’exemple INFO laisse passer ready et filtre le message DEBUG.

import io,logging
a,b=io.StringIO(),io.StringIO()
logging.basicConfig(level=logging.INFO,stream=a,format='%(message)s',force=True)
logging.basicConfig(stream=b,level=logging.ERROR)
logging.info('one')
assert a.getvalue()=='one\n' and not b.getvalue()
logging.basicConfig(stream=b,format='%(message)s',level=logging.ERROR,force=True)
logging.info('hidden')
logging.error('two')
assert b.getvalue()=='two\n'
try: logging.basicConfig(stream=b,filename='unused',force=True)
except ValueError: pass
else: raise AssertionError
import tempfile,pathlib
logging.basicConfig(stream=b,force=True)
logging.basicConfig(filename='ignored',stream=b)
with tempfile.TemporaryDirectory() as d:
    path=pathlib.Path(d)/'ref.log'
    logging.basicConfig(filename=path,encoding='ascii',errors='replace',format='%(message)s',level=logging.INFO,force=True)
    logging.info('café')
    logging.basicConfig(stream=b,force=True)
    assert path.read_text(encoding='ascii')=='caf?\n'

Exemples

import logging
from io import StringIO

out = StringIO()
logging.basicConfig(stream=out, level=logging.INFO, format="%(message)s", force=True)
logging.debug("hidden")
logging.info("ready")
print(out.getvalue().strip())

Résultat

ready

Dans l’exemple INFO laisse passer ready et filtre le message DEBUG.

Sources