Line data    Source code

       1              : # SPDX-FileCopyrightText: 2025 PairInteraction Developers
       2              : # SPDX-License-Identifier: LGPL-3.0-or-later
       3            1 : from __future__ import annotations
       4              : 
       5            1 : from functools import partial
       6            1 : from typing import TYPE_CHECKING
       7              : 
       8            1 : from PySide6.QtCore import QTimer
       9            1 : from PySide6.QtGui import QStatusTipEvent
      10            1 : from PySide6.QtWidgets import QApplication
      11              : 
      12              : if TYPE_CHECKING:
      13              :     import logging
      14              : 
      15              :     from PySide6.QtCore import QObject
      16              : 
      17              : 
      18            1 : def show_status_tip(parent: QObject, message: str, timeout: int = 0, logger: logging.Logger | None = None) -> None:
      19              :     """Show a status tip message using QStatusTipEvent."""
      20            1 :     QApplication.sendEvent(parent, QStatusTipEvent(message))
      21            1 :     if logger:
      22            1 :         logger.info(message)
      23            1 :     if timeout > 0:
      24            1 :         QTimer.singleShot(timeout, partial(reset_status_tip, parent))
      25              : 
      26              : 
      27            1 : def reset_status_tip(parent: QObject) -> None:
      28              :     """Hide the status tip by sending an empty message."""
      29            1 :     QApplication.sendEvent(parent, QStatusTipEvent("Ready"))