100 lines
2.4 KiB
Python
100 lines
2.4 KiB
Python
# SPDX-License-Identifier: LGPL-3.0-or-later
|
|
|
|
from dataclasses import dataclass, field
|
|
from typing import TYPE_CHECKING, Any, Dict, Optional
|
|
|
|
import pyotherside
|
|
|
|
from .utils import serialize_value_for_qml
|
|
|
|
if TYPE_CHECKING:
|
|
from .models import SyncId
|
|
|
|
|
|
@dataclass
|
|
class PyOtherSideEvent:
|
|
"""Event that will be sent on instanciation to QML by PyOtherSide."""
|
|
|
|
def __post_init__(self) -> None:
|
|
# XXX: CPython 3.6 or any Python implemention >= 3.7 is required for
|
|
# correct __dataclass_fields__ dict order.
|
|
args = [
|
|
serialize_value_for_qml(getattr(self, field))
|
|
for field in self.__dataclass_fields__ # type: ignore
|
|
if field != "callbacks"
|
|
]
|
|
pyotherside.send(type(self).__name__, *args)
|
|
|
|
|
|
@dataclass
|
|
class ExitRequested(PyOtherSideEvent):
|
|
"""Request for the application to exit."""
|
|
|
|
exit_code: int = 0
|
|
|
|
|
|
@dataclass
|
|
class AlertRequested(PyOtherSideEvent):
|
|
"""Request a window manager alert to be shown.
|
|
|
|
Sets the urgency hint for compliant X11/Wayland window managers;
|
|
flashes the taskbar icon on Windows.
|
|
"""
|
|
|
|
high_importance: bool = False
|
|
|
|
|
|
@dataclass
|
|
class CoroutineDone(PyOtherSideEvent):
|
|
"""Indicate that an asyncio coroutine finished."""
|
|
|
|
uuid: str = field()
|
|
result: Any = None
|
|
exception: Optional[Exception] = None
|
|
traceback: Optional[str] = None
|
|
|
|
|
|
@dataclass
|
|
class LoopException(PyOtherSideEvent):
|
|
"""Indicate an uncaught exception occurance in the asyncio loop."""
|
|
|
|
message: str = field()
|
|
exception: Optional[Exception] = field()
|
|
traceback: Optional[str] = None
|
|
|
|
|
|
@dataclass
|
|
class ModelEvent(PyOtherSideEvent):
|
|
"""Base class for model change events."""
|
|
|
|
sync_id: "SyncId" = field()
|
|
|
|
|
|
@dataclass
|
|
class ModelItemSet(ModelEvent):
|
|
"""Indicate `ModelItem` insert or field changes in a `Backend` `Model`."""
|
|
|
|
index_then: Optional[int] = field()
|
|
index_now: int = field()
|
|
fields: Dict[str, Any] = field()
|
|
|
|
|
|
@dataclass
|
|
class ModelItemDeleted(ModelEvent):
|
|
"""Indicate the removal of a `ModelItem` from a `Backend` `Model`."""
|
|
|
|
index: int = field()
|
|
count: int = 1
|
|
|
|
|
|
@dataclass
|
|
class ModelCleared(ModelEvent):
|
|
"""Indicate that a `Backend` `Model` was cleared."""
|
|
|
|
|
|
@dataclass
|
|
class DevicesUpdated(PyOtherSideEvent):
|
|
"""Indicate changes in devices for us or users we share a room with."""
|
|
|
|
our_user_id: str = field()
|