devctrl.utility.messaging#

Show exceptions, warnings or messages to the user.

Use these functions in this module over plain print, log or QMessagBox calls since they automatically chose either the console printing or a GUI window depending on how the library is configured: If ENABLE_GUI is configured in devctrl, then this module imports functionality from devctrl.gui.utility.messaging and all functions show dialog windows with the respective messages (and log them). If GUI is not enabled, functionality is imported from devctrl.utility.messaging and print messages to standard output (and logs).

  • .show_exception: Show an python exception with a stacktrace and message, without raising it.

  • .show_error: Show an error message.

  • .show_warning: Show a warning message.

  • .block_until_done: Show a message while until a process is finished.

block_until_done(title, message, is_done[, ...])

Block execution until the given function returns True.

exception

Show an exception.

warning

Show an exception as warning.