KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen