Ice.Logger

class Ice.Logger

Bases: ABC

Represents Ice’s abstraction for logging and tracing.

Applications can provide their own logger by implementing this abstraction and setting a logger on the communicator.

The Ice runtime calls print(), trace(), warning() and error() from contexts where exceptions cannot be handled. Implementations of these methods must not raise exceptions: a raised exception can terminate the process.

abstractmethod print(message: str)

Prints a message.

The message is printed literally, without any decorations such as executable name or timestamp.

An implementation of this method must not raise exceptions.

Parameters:

message (str) – The message to log.

abstractmethod trace(category: str, message: str)

Logs a trace message.

An implementation of this method must not raise exceptions.

Parameters:

• category (str) – The trace category.

• message (str) – The trace message to log.

abstractmethod warning(message: str)

Logs a warning message.

An implementation of this method must not raise exceptions.

Parameters:

message (str) – The warning message to log.

abstractmethod error(message: str)

Logs an error message.

An implementation of this method must not raise exceptions.

Parameters:

message (str) – The error message to log.

abstractmethod getPrefix() → str

Returns this logger’s prefix.

Returns:

The prefix.

Return type:

str

abstractmethod cloneWithPrefix(prefix: str) → Logger

Returns a clone of the logger with a new prefix.

Parameters:

prefix (str) – The new prefix for the logger.

Returns:

A new logger instance with the specified prefix.

Return type:

Ice.Logger