libretro.drivers.message.logger

A message driver that stores core messages and optionally logs them.

See also

libretro.api.message

Defines the message types this driver records.

Classes

LoggerMessageDriver

A MessageDriver that stores all messages in memory and optionally forwards them to a standard Python Logger.

class LoggerMessageDriver[source]

Bases: MessageDriver

A MessageDriver that stores all messages in memory and optionally forwards them to a standard Python Logger.

__init__(version=1, logger=None)[source]
Parameters:
  • version (int) – The message interface version to advertise (0 or 1).

  • logger (Logger | None) – An optional Logger to write messages to.

property version

The message-interface version supported by this driver.

0 supports only retro_message. 1 additionally supports retro_message_ext.

property messages

All basic messages received from the core, in order.

property message_exts

All extended messages received from the core, in order.

set_message(message)[source]

Delivers a message from the core.

Corresponds to the RETRO_ENVIRONMENT_SET_MESSAGE and RETRO_ENVIRONMENT_SET_MESSAGE_EXT environment calls.

Parameters:

message (retro_message | retro_message_ext | None) – The message to display or log, or None.

Return type:

bool

Returns:

True if the message was accepted.

See also

retro_message

The legacy message struct delivered via RETRO_ENVIRONMENT_SET_MESSAGE.

retro_message_ext

The extended message struct delivered via RETRO_ENVIRONMENT_SET_MESSAGE_EXT.

classmethod __new__(*args, **kwargs)