CKTIS / Python
logging.basicConfig
basicConfig stelt met level de drempel van de rootlogger in en configureert de uitvoerstream en opmaak.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
logging.basicConfig(**kwargs)basicConfig stelt met level de drempel van de rootlogger in en configureert de uitvoerstream en opmaak.
Configureer de uitvoer vóór de eerste logging.warning, die bij een lege rootlogger zelf een handler toevoegt. Bij een bestand regelen encoding en errors de codering en afhandeling van niet-representeerbare tekens. Bij bestaande roothandlers verandert de standaardaanroep niets. force=True verwijdert en sluit de eerdere handlers. Bij daadwerkelijke configuratie filename en stream tegelijk opgeven veroorzaakt ValueError.
In het voorbeeld laat INFO ready door en filtert het DEBUG-bericht.
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'
Voorbeelden
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())
Resultaat
ready
In het voorbeeld laat INFO ready door en filtert het DEBUG-bericht.