WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

logging.basicConfig

basicConfig setzt mit level die Schwelle des Root-Loggers sowie Stream und Format der Ausgabe.

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

Syntax

logging.basicConfig(**kwargs)

basicConfig setzt mit level die Schwelle des Root-Loggers sowie Stream und Format der Ausgabe.

Konfiguriere die Ausgabe vor dem ersten logging.warning, das bei leerem Root-Logger selbst einen Handler anlegt. Bei Dateiausgabe bestimmen encoding und errors die Kodierung und die Behandlung nicht darstellbarer Zeichen. Bei vorhandenen Root-Handlern bleibt der Standardaufruf wirkungslos. force=True entfernt und schließt die bisherigen Handler. Bei aktiver Konfiguration löst filename zusammen mit stream ValueError aus.

Im Beispiel lässt INFO nur ready durch und filtert die DEBUG-Meldung.

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'

Beispiele

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())

Ergebnis

ready

Im Beispiel lässt INFO nur ready durch und filtert die DEBUG-Meldung.

Quellen