Logging Module#

SPDX-FileCopyrightText: 2025 DESY and the Constellation authors SPDX-License-Identifier: EUPL-1.2

This module provides a base class for Constellation Satellite modules.

class core.logging.ConstellationLogger(*args: Any, **kwargs: Any)#

Bases: Logger

Custom Logger class for Constellation.

error(msg: str, *args: Any, **kwargs: Any) None#

Map error level to CRITICAL.

status(msg: str, *args: Any, **kwargs: Any) None#

Define level for important information about the host program to the end user with low frequency.

trace(msg: str, *args: Any, **kwargs: Any) None#

Define level for verbose information which allows to follow the call stack of the host program.

class core.logging.ZeroMQSocketLogHandler(transmitter: CMDPTransmitter)#

Bases: Handler

This handler sends records to a ZMQ socket.

close() None#

Tidy up any resources used by the handler.

This version removes the handler from an internal map of handlers, _handlers, which is used for handler lookup by name. Subclasses should ensure that this gets called from overridden close() methods.

emit(record: LogRecord) None#

Do whatever it takes to actually log the specified logging record.

This version is intended to be implemented by subclasses and so raises a NotImplementedError.

core.logging.setup_cli_logging(level: str) None#

Sets up the CLI logging configuration.

Defines the following log levels:

  • logging.NOTSET : 0

  • logging.TRACE : 5

  • logging.DEBUG : 10

  • logging.INFO : 20

  • logging.WARNING : 30

  • logging.STATUS : 35

  • logging.ERROR : mapped to CRITICAL

  • logging.CRITICAL : 50