matrix-python 0.1.2a0__py3-none-any.whl → 1.0.0__py3-none-any.whl

matrix/__init__.py

@@ -1,19 +1,35 @@
 """A simple, developer-friendly library to create powerful Matrix bots."""
 
-__version__ = "0.1.2-alpha"
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("matrix-python")
+except PackageNotFoundError:
+    from matrix._version import version as __version__
 
 from .bot import Bot
+from .group import Group, group
 from .config import Config
 from .context import Context
 from .command import Command
 from .help import HelpCommand
 from .checks import cooldown
+from .room import Room
+from .space import Space
+from .message import Message
+from .extension import Extension
 
 __all__ = [
     "Bot",
+    "Group",
+    "group",
     "Config",
     "Command",
     "Context",
     "HelpCommand",
     "cooldown",
+    "Room",
+    "Space",
+    "Message",
+    "Extension",
 ]

matrix/_error_handler.py

@@ -0,0 +1,14 @@
+import inspect
+from typing import Callable, Dict, Optional, TypeVar
+
+F = TypeVar("F", bound=Callable[..., object])
+
+
+def resolve_error_handler(
+    handlers: Dict[type[Exception], F], error: Exception
+) -> Optional[F]:
+    """Look up the handler registered for the error's type or nearest base class."""
+    for cls in inspect.getmro(type(error)):
+        if cls in handlers:
+            return handlers[cls]
+    return None

matrix/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '1.0.0'
+__version_tuple__ = version_tuple = (1, 0, 0)
+
+__commit_id__ = commit_id = 'g058abf630'

matrix/api.py

@@ -0,0 +1,35 @@
+from typing import Awaitable, TypeVar
+
+from nio import ErrorResponse, Response
+
+from matrix.errors import MatrixError
+
+T = TypeVar("T", bound=Response)
+
+
+async def matrix_call(coro: Awaitable[T], /, *, error_message: str) -> T:
+    """Await `coro`, translating any failure into a `MatrixError`.
+
+    matrix-nio's `AsyncClient` methods don't raise on API-level errors; they
+    return an `ErrorResponse` instead of raising. This wraps a single call so
+    both transport-level exceptions and nio `ErrorResponse` results become a
+    `MatrixError` carrying `error_message`.
+
+    ## Example
+
+    ```python
+    response = await matrix_call(
+        self.client.room_kick(room_id=self.room_id, user_id=user_id),
+        error_message="Failed to kick user",
+    )
+    ```
+    """
+    try:
+        response = await coro
+    except Exception as e:
+        raise MatrixError(f"{error_message}: {e}") from e
+
+    if isinstance(response, ErrorResponse):
+        raise MatrixError(f"{error_message}: {response}")
+
+    return response