fluxgram-plugin 2.10.0__py3-none-any.whl

fluxgram/__init__.py

@@ -0,0 +1,117 @@
+from .plugin import Plugin
+from .settings import SwitchSetting, SelectSetting, SliderSetting, TextSetting
+from .events import (
+    ApplicationBackgroundedEvent,
+    ApplicationForegroundedEvent,
+    BeforeSendEvent,
+    ChatClosedEvent,
+    ChatOpenedEvent,
+    EventChannel,
+    EventContext,
+    EventSubscription,
+    Events,
+    ExecutionContext,
+    MessageDeletedEvent,
+    MessageEditedEvent,
+    MessageReceivedEvent,
+    PluginSettingChangedEvent,
+)
+from .storage import (
+    Storage,
+    StorageAccountUnavailableError,
+    StorageError,
+    StorageInactiveError,
+    StorageLimits,
+    StorageMigration,
+    StorageMigrationError,
+    StorageOwnerChangedError,
+    StorageQueueFullError,
+    StorageQuotaExceededError,
+    StorageResult,
+    StorageFileScope,
+    StorageScope,
+    StorageStatistics,
+    StorageThreadError,
+    StorageTransaction,
+    StorageTransactionError,
+    StorageTask,
+    StorageTypeError,
+    StorageUnavailableError,
+)
+from .tasks import (
+    CancellationToken,
+    TaskCancelledError,
+    TaskError,
+    TaskHandle,
+    TaskInactiveError,
+    TaskQueueFullError,
+    TaskResult,
+    Tasks,
+    TaskUnavailableError,
+)
+from .models import (
+    ChatInfo,
+    ChatNotifications,
+    MessageInfo,
+    NotificationOverride,
+)
+
+API_VERSION = 2
+API_MINOR_VERSION = 9
+
+__all__ = [
+    "Plugin",
+    "ApplicationBackgroundedEvent",
+    "ApplicationForegroundedEvent",
+    "SwitchSetting",
+    "SelectSetting",
+    "SliderSetting",
+    "TextSetting",
+    "BeforeSendEvent",
+    "ChatClosedEvent",
+    "ChatOpenedEvent",
+    "MessageDeletedEvent",
+    "MessageEditedEvent",
+    "MessageReceivedEvent",
+    "Events",
+    "EventChannel",
+    "EventContext",
+    "EventSubscription",
+    "ExecutionContext",
+    "PluginSettingChangedEvent",
+    "Storage",
+    "StorageScope",
+    "StorageTransaction",
+    "StorageMigration",
+    "StorageLimits",
+    "StorageStatistics",
+    "StorageResult",
+    "StorageFileScope",
+    "StorageTask",
+    "StorageError",
+    "StorageUnavailableError",
+    "StorageInactiveError",
+    "StorageAccountUnavailableError",
+    "StorageOwnerChangedError",
+    "StorageQueueFullError",
+    "StorageThreadError",
+    "StorageTypeError",
+    "StorageQuotaExceededError",
+    "StorageTransactionError",
+    "StorageMigrationError",
+    "Tasks",
+    "TaskHandle",
+    "TaskResult",
+    "CancellationToken",
+    "TaskError",
+    "TaskUnavailableError",
+    "TaskInactiveError",
+    "TaskQueueFullError",
+    "TaskCancelledError",
+    "API_VERSION",
+    "API_MINOR_VERSION",
+    "ChatInfo",
+    "ChatNotifications",
+    "MessageInfo",
+    "NotificationOverride",
+]

fluxgram/_runtime.py

@@ -0,0 +1,129 @@
+from collections.abc import Callable, Iterator
+from contextlib import contextmanager
+from contextvars import ContextVar
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Any, Protocol
+
+from .events import LegacyEventsPort
+from .models import ChatInfo
+
+
+if TYPE_CHECKING:
+    from .storage import StoragePort
+    from .tasks import TasksPort
+
+
+class Chats(Protocol):
+    def get(
+        self,
+        *,
+        account: int,
+        dialog_id: int,
+        topic_id: int = 0,
+    ) -> ChatInfo:
+        ...
+
+
+class Client(Protocol):
+    chats: Chats
+
+    def _bind_runtime(self, host: Any, generation: int) -> None:
+        ...
+
+    def _close(self) -> None:
+        ...
+
+
+class UIThread(Protocol):
+    def is_ui_thread(self) -> bool:
+        ...
+
+    def post(self, callback: Callable[[], Any]) -> None:
+        ...
+
+
+class BulletinPresenter(Protocol):
+    def dismiss(self) -> None:
+        ...
+
+    def simple(
+        self,
+        title: str,
+        text: str,
+        *,
+        on_click: Callable[[], Any] | None = None,
+        duration: int = 4000,
+        top: bool = True,
+    ) -> bool:
+        ...
+
+
+class NotificationsService(Protocol):
+    def show_message(
+        self,
+        event: Any,
+        *,
+        respect_mute: bool = True,
+        show_in_current_chat: bool = False,
+        duration: int = 5000,
+    ) -> bool:
+        ...
+
+
+class UIServices(Protocol):
+    def create_bulletin_presenter(self, ui: Any) -> BulletinPresenter:
+        ...
+
+    def create_notifications(self, ui: Any) -> NotificationsService:
+        ...
+
+    def open_chat(
+        self,
+        account: int,
+        dialog_id: int,
+        topic_id: int,
+        message_id: int,
+    ) -> bool:
+        ...
+
+
+@dataclass(frozen=True)
+class RuntimeBindings:
+    events: LegacyEventsPort
+    client: Client
+    ui_thread: UIThread
+    ui_services: UIServices
+    call_ui: Callable[[Callable[[], Any]], Any]
+    log: Callable[[str, str], None]
+    storage: "StoragePort | None" = None
+    tasks: "TasksPort | None" = None
+
+
+class RuntimeFactory(Protocol):
+    def __call__(self, plugin_id: str) -> RuntimeBindings:
+        ...
+
+
+_factory: ContextVar[RuntimeFactory | None] = ContextVar(
+    "fluxgram_runtime_factory",
+    default=None,
+)
+
+
+def create_runtime(plugin_id: str) -> RuntimeBindings:
+    factory = _factory.get()
+
+    if factory is None:
+        raise RuntimeError("Plugin instances can only be created by FluxGram")
+
+    return factory(plugin_id)
+
+
+@contextmanager
+def runtime_scope(factory: RuntimeFactory) -> Iterator[None]:
+    token = _factory.set(factory)
+
+    try:
+        yield
+    finally:
+        _factory.reset(token)