Logger

class rmote.tools.logger.Logger[source]

Bases: Tool

Control logging on the remote side and forward records to the local process.

Log records emitted on the remote side are forwarded over the protocol channel and appear locally under the rmote.remote.<name> logger hierarchy.

classmethod log(level, message, *args)[source]

Emit a log record on the remote side.

The record is forwarded to the local logging system via the protocol’s LOG packet and appears under the rmote.remote.<name> logger.

Parameters:
  • level (Text) – Log level name (e.g. "INFO", "DEBUG").

  • message (Text) – Log message format string (%-style).

  • *args (Any) – Arguments merged into message.

Raises:

ValueError – If level is not a recognised level name.

Return type:

None

classmethod set_log_level(level)[source]

Set the root logger level on the remote side.

Parameters:

level (Text) – One of "NOTSET", "DEBUG", "INFO", "WARNING", "ERROR", or "CRITICAL" (case-insensitive).

Raises:

ValueError – If level is not a recognised level name.

Return type:

None