Library Settings

Drawlib includes the dutil_settings object, which provides functions to manage library settings. Currently, these settings are focused on logging and debug modes:

  • get_logging_mode(): Retrieves the current logging mode.

  • set_logging_mode(): Sets the logging mode.

  • get_suppress_warning(): Checks if warnings are suppressed.

  • set_suppress_warning(): Enables or disables warning suppression.

  • is_debug_mode(): Checks if debug mode is enabled.

  • is_developer_debug_mode(): Checks if developer debug mode is enabled.

These functions allow users to control the behavior of logging and debug messages within the library.

Logging

Drawlib provides functionality to adjust its logging level, which is distinct from the traditional syslog levels:

  • quiet: Shows only warnings and errors, equivalent to logging.ERROR.

  • normal: Default level, provides standard information, equivalent to logging.INFO.

  • verbose: Generates more detailed logs, equivalent to logging.DEBUG.

  • debug: Same to verbose.

  • developer: Extensive logging including debug information, with error handling disabled.

You can set the logging level using set_logging_mode(mode) and retrieve the current level with get_logging_mode(). When you use drawlib command, logging level can be also configured at CLI options.

Suppressing Warnings

Drawlib and its underlying libraries may generate warnings in certain situations. For instance, attempting to render Japanese text using an alphabet-only font could trigger a warning.

To control the display of these warnings, you can utilize the following functions from dutil_settings:

  • set_suppress_warning(enable: bool): Enables or disables the suppression of warnings.

  • get_suppress_warning(): Retrieves the current suppression setting.

Adjusting these settings allows users to manage how warnings are handled within Drawlib and its associated operations.