CKTIS / Python
Obter um logger filho com Logger.getChild
Obtém um logger a partir do nome do logger pai e encaminha os seus registos para o handler do pai sem copiar esse handler para o filho.
Versão: Python 3.12
Sintaxe
parent_logger.getChild(suffix)logging.Logger.getChild(suffix) é um método de instância disponível desde o Python 3.2. Para um logger que não seja o logger raiz, acrescenta ao nome um ponto e o sufixo fornecido como cadeia de caracteres e procura o logger com o nome resultante. Para o logger raiz, usa diretamente o sufixo, sem o prefixo root.. Se app for o logger com o nome app, app.getChild("validation") devolve o mesmo objeto que logging.getLogger("app.validation"). O sufixo pode conter pontos: validation.rules identifica um descendente mais abaixo na hierarquia.
O método não copia handlers. Quando app.validation aceita um registo e tem propagate=True (o valor predefinido), o registo também chega aos handlers de app. A atribuição app.propagate = False mantém esses handlers ativos, mas impede que o registo siga até ao logger raiz.
O limiar do logger e o do handler aplicam-se em etapas distintas. Com o seu nível em NOTSET, app.validation usa INFO de app como nível efetivo no exemplo. Depois de o registo ser aceite, a propagação não volta a aplicar os níveis nem os filtros dos loggers antecessores, mas cada handler continua a aplicar o seu próprio limiar e os seus filtros. Associar o mesmo handler ao filho e ao pai pode fazer com que o mesmo registo seja apresentado duas vezes.
Exemplos
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")Resultado
app.validation | INFO | Input accepted
Executa o script num novo processo Python 3.12. A asserção usa `is` para verificar a identidade do objeto. O único handler está associado a `app`, mas a saída indica `app.validation` porque foi esse logger que criou o registo.
Lições relacionadas
- Python · Lição 24 · Intermédio · Versão: 3