telegrinder 0.1.dev169__py3-none-any.whl → 0.1.dev171__py3-none-any.whl

telegrinder/msgspec_utils.py

@@ -1,6 +1,8 @@
+import dataclasses
 import typing
 
 import fntypes.option
+import fntypes.result
 import msgspec
 from fntypes.co import Error, Ok, Result, Variative
 
@@ -8,10 +10,12 @@ if typing.TYPE_CHECKING:
     from datetime import datetime
 
     from fntypes.option import Option
+    from fntypes.result import Result
 else:
     from datetime import datetime as dt
 
     Value = typing.TypeVar("Value")
+    Err = typing.TypeVar("Err")
 
     datetime = type("datetime", (dt,), {})
 
@@ -19,13 +23,18 @@ else:
         def __instancecheck__(cls, __instance: typing.Any) -> bool:
             return isinstance(__instance, fntypes.option.Some | fntypes.option.Nothing)
 
+    class ResultMeta(type):
+        def __instancecheck__(cls, __instance: typing.Any) -> bool:
+            return isinstance(__instance, fntypes.result.Ok | fntypes.result.Error)
+
     class Option(typing.Generic[Value], metaclass=OptionMeta):
         pass
 
+    class Result(typing.Generic[Value, Err], metaclass=ResultMeta):
+        pass
+
 
 T = typing.TypeVar("T")
-Type = typing.TypeVar("Type", bound=type | typing.Any)
-Ts = typing.TypeVarTuple("Ts")
 
 DecHook: typing.TypeAlias = typing.Callable[[type[T], typing.Any], typing.Any]
 EncHook: typing.TypeAlias = typing.Callable[[T], typing.Any]
@@ -41,18 +50,62 @@ def repr_type(t: type) -> str:
     return getattr(t, "__name__", repr(get_origin(t)))
 
 
-def msgspec_convert(obj: typing.Any, t: type[T]) -> Result[T, msgspec.ValidationError]:
+def msgspec_convert(obj: typing.Any, t: type[T]) -> Result[T, str]:
     try:
         return Ok(decoder.convert(obj, type=t, strict=True))
-    except msgspec.ValidationError as exc:
-        return Error(exc)
+    except msgspec.ValidationError:
+        return Error(
+            "Expected object of type `{}`, got `{}`.".format(
+                repr_type(t),
+                repr_type(type(obj)),
+            )
+        )
+
+
+def msgspec_to_builtins(
+    obj: typing.Any,
+    *,
+    str_keys: bool = False,
+    builtin_types: typing.Iterable[type[typing.Any]] | None = None,
+    order: typing.Literal["deterministic", "sorted"] | None = None,
+) -> typing.Any:
+    return encoder.to_builtins(**locals())
 
 
 def option_dec_hook(tp: type[Option[typing.Any]], obj: typing.Any) -> Option[typing.Any]:
-    if obj is None:
-        return Nothing
+    orig_type = get_origin(tp)
     (value_type,) = typing.get_args(tp) or (typing.Any,)
-    return msgspec_convert({"value": obj}, fntypes.option.Some[value_type]).unwrap()
+
+    if obj is None and orig_type in (fntypes.option.Nothing, Option):
+        return fntypes.option.Nothing()
+    return fntypes.option.Some(msgspec_convert(obj, value_type).unwrap())
+
+
+def result_dec_hook(
+    tp: type[Result[typing.Any, typing.Any]], obj: typing.Any
+) -> Result[typing.Any, typing.Any]:
+    if not isinstance(obj, dict):
+        raise TypeError(f"Cannot parse to Result object of type `{repr_type(type(obj))}`.")
+
+    orig_type = get_origin(tp)
+    (first_type, second_type) = (
+        typing.get_args(tp) + (typing.Any,) if len(typing.get_args(tp)) == 1 else typing.get_args(tp)
+    ) or (typing.Any, typing.Any)
+
+    if orig_type is Ok and "ok" in obj:
+        return Ok(msgspec_convert(obj["ok"], first_type).unwrap())
+
+    if orig_type is Error and "error" in obj:
+        return Error(msgspec_convert(obj["error"], first_type).unwrap())
+
+    if orig_type is Result:
+        match obj:
+            case {"ok": ok}:
+                return Ok(msgspec_convert(ok, first_type).unwrap())
+            case {"error": error}:
+                return Error(msgspec_convert(error, second_type).unwrap())
+
+    raise msgspec.ValidationError(f"Cannot parse object `{obj!r}` to Result.")
 
 
 def variative_dec_hook(tp: type[Variative], obj: typing.Any) -> Variative:
@@ -93,6 +146,11 @@ def variative_dec_hook(tp: type[Variative], obj: typing.Any) -> Variative:
     )
 
 
+@typing.runtime_checkable
+class DataclassInstance(typing.Protocol):
+    __dataclass_fields__: typing.ClassVar[dict[str, dataclasses.Field[typing.Any]]]
+
+
 class Decoder:
     """Class `Decoder` for `msgspec` module with decode hook
     for objects with the specified type.
@@ -111,7 +169,6 @@ class Decoder:
     decoder.dec_hooks[dt] = lambda t, timestamp: t.fromtimestamp(timestamp)
 
     decoder.dec_hook(dt, 1713354732)  #> datetime.datetime(2024, 4, 17, 14, 52, 12)
-    decoder.dec_hook(int, "123")  #> TypeError: Unknown type `int`. You can implement decode hook for this type.
 
     decoder.convert("123", type=int, strict=False)  #> 123
     decoder.convert(1, type=Digit)  #> <Digit.ONE: 1>
@@ -122,9 +179,14 @@ class Decoder:
 
     def __init__(self) -> None:
         self.dec_hooks: dict[typing.Any, DecHook[typing.Any]] = {
+            Result: result_dec_hook,
             Option: option_dec_hook,
             Variative: variative_dec_hook,
             datetime: lambda t, obj: t.fromtimestamp(obj),
+            fntypes.result.Error: result_dec_hook,
+            fntypes.result.Ok: result_dec_hook,
+            fntypes.option.Some: option_dec_hook,
+            fntypes.option.Nothing: option_dec_hook,
         }
 
     def __repr__(self) -> str:
@@ -143,7 +205,7 @@ class Decoder:
         origin_type = t if isinstance((t := get_origin(tp)), type) else type(t)
         if origin_type not in self.dec_hooks:
             raise TypeError(
-                f"Unknown type `{repr_type(origin_type)}`. " "You can implement decode hook for this type."
+                f"Unknown type `{repr_type(origin_type)}`. You can implement decode hook for this type."
             )
         return self.dec_hooks[origin_type](tp, obj)
 
@@ -201,8 +263,6 @@ class Encoder:
     encoder.enc_hooks[dt] = lambda d: int(d.timestamp())
 
     encoder.enc_hook(dt.now())  #> 1713354732
-    encoder.enc_hook(123)  #> NotImplementedError: Not implemented encode hook for object of type `int`.
-
     encoder.encode({'digit': Digit.ONE})  #> '{"digit":1}'
     ```
     """
@@ -211,6 +271,10 @@ class Encoder:
         self.enc_hooks: dict[typing.Any, EncHook[typing.Any]] = {
             fntypes.option.Some: lambda opt: opt.value,
             fntypes.option.Nothing: lambda _: None,
+            fntypes.result.Ok: lambda ok: {"ok": ok.value},
+            fntypes.result.Error: lambda err: {
+                "error": (str(err.error) if isinstance(err.error, BaseException) else err.error)
+            },
             Variative: lambda variative: variative.v,
             datetime: lambda date: int(date.timestamp()),
         }
@@ -232,7 +296,7 @@ class Encoder:
         origin_type = get_origin(obj.__class__)
         if origin_type not in self.enc_hooks:
             raise NotImplementedError(
-                "Not implemented encode hook for " f"object of type `{repr_type(origin_type)}`."
+                f"Not implemented encode hook for object of type `{repr_type(origin_type)}`."
             )
         return self.enc_hooks[origin_type](obj)
 
@@ -249,6 +313,22 @@ class Encoder:
         buf = msgspec.json.encode(obj, enc_hook=self.enc_hook)
         return buf.decode() if as_str else buf
 
+    def to_builtins(
+        self,
+        obj: typing.Any,
+        *,
+        str_keys: bool = False,
+        builtin_types: typing.Iterable[type[typing.Any]] | None = None,
+        order: typing.Literal["deterministic", "sorted"] | None = None,
+    ) -> typing.Any:
+        return msgspec.to_builtins(
+            obj,
+            str_keys=str_keys,
+            builtin_types=builtin_types,
+            enc_hook=self.enc_hook,
+            order=order,
+        )
+
 
 decoder: typing.Final[Decoder] = Decoder()
 encoder: typing.Final[Encoder] = Encoder()
@@ -264,6 +344,7 @@ __all__ = (
     "encoder",
     "get_origin",
     "msgspec_convert",
+    "msgspec_to_builtins",
     "option_dec_hook",
     "repr_type",
     "variative_dec_hook",

telegrinder/node/__init__.py

@@ -1,10 +1,13 @@
 from .attachment import Attachment, Audio, Photo, Video
-from .base import ComposeError, DataNode, Node, ScalarNode, is_node
+from .base import BaseNode, ComposeError, DataNode, Node, ScalarNode, is_node, node_impl
+from .callback_query import CallbackQueryNode
 from .command import CommandInfo
 from .composer import Composition, NodeCollection, NodeSession, compose_node, compose_nodes
 from .container import ContainerNode
+from .event import EventNode
 from .me import Me
 from .message import MessageNode
+from .polymorphic import Polymorphic, impl
 from .rule import RuleChain
 from .scope import GLOBAL, PER_CALL, PER_EVENT, NodeScope, global_node, per_call, per_event
 from .source import ChatSource, Source, UserSource
@@ -15,35 +18,41 @@ from .update import UpdateNode
 __all__ = (
     "Attachment",
     "Audio",
+    "BaseNode",
+    "CallbackQueryNode",
     "ChatSource",
+    "CommandInfo",
     "ComposeError",
+    "Composition",
     "ContainerNode",
     "DataNode",
+    "EventNode",
+    "GLOBAL",
+    "Me",
     "MessageNode",
     "Node",
     "NodeCollection",
+    "NodeScope",
     "NodeSession",
+    "PER_CALL",
+    "PER_EVENT",
     "Photo",
+    "Polymorphic",
     "RuleChain",
     "ScalarNode",
     "Source",
     "Text",
     "TextInteger",
-    "UserSource",
     "UpdateNode",
+    "UserSource",
     "Video",
     "compose_node",
+    "compose_nodes",
     "generate_node",
-    "Composition",
+    "global_node",
+    "impl",
     "is_node",
-    "compose_nodes",
-    "NodeScope",
-    "PER_CALL",
-    "PER_EVENT",
+    "node_impl",
     "per_call",
     "per_event",
-    "CommandInfo",
-    "GLOBAL",
-    "global_node",
-    "Me",
 )

telegrinder/node/attachment.py

@@ -1,30 +1,33 @@
 import dataclasses
 import typing
 
-from fntypes import Option, Some
+from fntypes.co import Option, Some
 from fntypes.option import Nothing
 
 import telegrinder.types
+from telegrinder.node.base import ComposeError, DataNode, ScalarNode
+from telegrinder.node.message import MessageNode
 
-from .base import ComposeError, DataNode, ScalarNode
-from .message import MessageNode
 
-
-@dataclasses.dataclass
+@dataclasses.dataclass(slots=True)
 class Attachment(DataNode):
     attachment_type: typing.Literal["audio", "document", "photo", "poll", "video"]
     audio: Option[telegrinder.types.Audio] = dataclasses.field(
-        default_factory=lambda: Nothing(), kw_only=True
+        default_factory=lambda: Nothing(),
+        kw_only=True,
     )
     document: Option[telegrinder.types.Document] = dataclasses.field(
-        default_factory=lambda: Nothing(), kw_only=True
+        default_factory=lambda: Nothing(),
+        kw_only=True,
     )
     photo: Option[list[telegrinder.types.PhotoSize]] = dataclasses.field(
-        default_factory=lambda: Nothing(), kw_only=True
+        default_factory=lambda: Nothing(),
+        kw_only=True,
     )
     poll: Option[telegrinder.types.Poll] = dataclasses.field(default_factory=lambda: Nothing(), kw_only=True)
     video: Option[telegrinder.types.Video] = dataclasses.field(
-        default_factory=lambda: Nothing(), kw_only=True
+        default_factory=lambda: Nothing(),
+        kw_only=True,
     )
 
     @classmethod
@@ -33,17 +36,17 @@ class Attachment(DataNode):
             match getattr(message, attachment_type, Nothing()):
                 case Some(attachment):
                     return cls(attachment_type, **{attachment_type: Some(attachment)})
-        return cls.compose_error("No attachment found in message")
+        return cls.compose_error("No attachment found in message.")
 
 
-@dataclasses.dataclass
+@dataclasses.dataclass(slots=True)
 class Photo(DataNode):
     sizes: list[telegrinder.types.PhotoSize]
 
     @classmethod
     async def compose(cls, attachment: Attachment) -> typing.Self:
         if not attachment.photo:
-            raise ComposeError("Attachment is not an photo")
+            raise ComposeError("Attachment is not a photo.")
         return cls(attachment.photo.unwrap())
 
 
@@ -51,7 +54,7 @@ class Video(ScalarNode, telegrinder.types.Video):
     @classmethod
     async def compose(cls, attachment: Attachment) -> telegrinder.types.Video:
         if not attachment.video:
-            raise ComposeError("Attachment is not an video")
+            raise ComposeError("Attachment is not a video.")
         return attachment.video.unwrap()
 
 
@@ -59,7 +62,7 @@ class Audio(ScalarNode, telegrinder.types.Audio):
     @classmethod
     async def compose(cls, attachment: Attachment) -> telegrinder.types.Audio:
         if not attachment.audio:
-            raise ComposeError("Attachment is not an audio")
+            raise ComposeError("Attachment is not an audio.")
         return attachment.audio.unwrap()
 
 
@@ -67,7 +70,7 @@ class Document(ScalarNode, telegrinder.types.Document):
     @classmethod
     async def compose(cls, attachment: Attachment) -> telegrinder.types.Document:
         if not attachment.document:
-            raise ComposeError("Attachment is not an document")
+            raise ComposeError("Attachment is not a document.")
         return attachment.document.unwrap()
 
 
@@ -75,7 +78,7 @@ class Poll(ScalarNode, telegrinder.types.Poll):
     @classmethod
     async def compose(cls, attachment: Attachment) -> telegrinder.types.Poll:
         if not attachment.poll:
-            raise ComposeError("Attachment is not an poll")
+            raise ComposeError("Attachment is not a poll.")
         return attachment.poll.unwrap()
 
 

telegrinder/node/base.py

@@ -1,19 +1,70 @@
 import abc
 import inspect
 import typing
+from types import AsyncGeneratorType
+
+from telegrinder.api.api import API
+from telegrinder.bot.cute_types.update import UpdateCute
+from telegrinder.bot.dispatch.context import Context
+from telegrinder.node.scope import NodeScope
+from telegrinder.tools.magic import (
+    NODE_IMPL_MARK,
+    cache_magic_value,
+    get_annotations,
+    get_impls_by_key,
+    magic_bundle,
+    node_impl,
+)
 
-from telegrinder.tools.magic import get_annotations
+ComposeResult: typing.TypeAlias = typing.Awaitable[typing.Any] | typing.AsyncGenerator[typing.Any, None]
 
-from .scope import NodeScope
 
-ComposeResult: typing.TypeAlias = (
-    typing.Coroutine[typing.Any, typing.Any, typing.Any]
-    | typing.AsyncGenerator[typing.Any, None]
-    | typing.Any
-)
+def is_node(maybe_node: type[typing.Any]) -> typing.TypeGuard[type["Node"]]:
+    maybe_node = typing.get_origin(maybe_node) or maybe_node
+    return (
+        isinstance(maybe_node, type)
+        and issubclass(maybe_node, Node)
+        or isinstance(maybe_node, Node)
+        or hasattr(maybe_node, "as_node")
+    )
+
+
+@cache_magic_value("__compose_annotations__")
+def get_compose_annotations(function: typing.Callable[..., typing.Any]) -> dict[str, typing.Any]:
+    return {k: v for k, v in get_annotations(function).items() if not is_node(v)}
+
 
+@cache_magic_value("__nodes__")
+def get_nodes(function: typing.Callable[..., typing.Any]) -> dict[str, type["Node"]]:
+    return {k: v for k, v in get_annotations(function).items() if is_node(v)}
 
-class ComposeError(BaseException): ...
+
+@cache_magic_value("__is_generator__")
+def is_generator(function: typing.Callable[..., typing.Any]) -> typing.TypeGuard[AsyncGeneratorType[typing.Any, None]]:
+    return inspect.isasyncgenfunction(function)
+
+
+def get_node_impls(node_cls: type["Node"]) -> dict[str, typing.Any]:
+    if not hasattr(node_cls, "__node_impls__"):
+        impls = get_impls_by_key(node_cls, NODE_IMPL_MARK)
+        if issubclass(node_cls, BaseNode):
+            impls |= get_impls_by_key(BaseNode, NODE_IMPL_MARK)
+        setattr(node_cls, "__node_impls__", impls)
+    return getattr(node_cls, "__node_impls__")
+
+
+def get_node_impl(
+    node: type[typing.Any],
+    node_impls: dict[str, typing.Callable[..., typing.Any]],
+) -> typing.Callable[..., typing.Any] | None:
+    for n_impl in node_impls.values():
+        if "return" in n_impl.__annotations__ and node is n_impl.__annotations__["return"]:
+            return n_impl
+    return None
+
+
+class ComposeError(BaseException):
+    pass
 
 
 class Node(abc.ABC):
@@ -25,13 +76,46 @@ class Node(abc.ABC):
     def compose(cls, *args, **kwargs) -> ComposeResult:
         pass
 
+    @classmethod
+    async def compose_annotation(
+        cls,
+        annotation: typing.Any,
+        update: UpdateCute,
+        ctx: Context,
+    ) -> typing.Any:
+        orig_annotation: type[typing.Any] = typing.get_origin(annotation) or annotation
+        n_impl = get_node_impl(orig_annotation, cls.get_node_impls())
+        if n_impl is None:
+            raise ComposeError(f"Node implementation for {orig_annotation!r} not found.")
+
+        result = n_impl(
+            cls,
+            **magic_bundle(
+                n_impl,
+                {"update": update, "context": ctx},
+                start_idx=0,
+                bundle_ctx=False,
+            ),
+        )
+        if inspect.isawaitable(result):
+            return await result
+        return result
+
     @classmethod
     def compose_error(cls, error: str | None = None) -> typing.NoReturn:
         raise ComposeError(error)
 
     @classmethod
-    def get_sub_nodes(cls) -> dict[str, type[typing.Self]]:
-        return get_annotations(cls.compose)
+    def get_sub_nodes(cls) -> dict[str, type["Node"]]:
+        return get_nodes(cls.compose)
+
+    @classmethod
+    def get_compose_annotations(cls) -> dict[str, typing.Any]:
+        return get_compose_annotations(cls.compose)
+
+    @classmethod
+    def get_node_impls(cls) -> dict[str, typing.Callable[..., typing.Any]]:
+        return get_node_impls(cls)
 
     @classmethod
     def as_node(cls) -> type[typing.Self]:
@@ -39,10 +123,29 @@ class Node(abc.ABC):
 
     @classmethod
     def is_generator(cls) -> bool:
-        return inspect.isasyncgenfunction(cls.compose)
+        return is_generator(cls.compose)
+
+
+class BaseNode(Node, abc.ABC):
+    @classmethod
+    @abc.abstractmethod
+    def compose(cls, *args, **kwargs) -> ComposeResult:
+        pass
+
+    @node_impl
+    def compose_api(cls, update: UpdateCute) -> API:
+        return update.ctx_api
+
+    @node_impl
+    def compose_context(cls, context: Context) -> Context:
+        return context
 
+    @node_impl
+    def compose_update(cls, update: UpdateCute) -> UpdateCute:
+        return update
 
-class DataNode(Node, abc.ABC):
+
+class DataNode(BaseNode, abc.ABC):
     node = "data"
 
     @typing.dataclass_transform()
@@ -52,7 +155,7 @@ class DataNode(Node, abc.ABC):
         pass
 
 
-class ScalarNodeProto(Node, abc.ABC):
+class ScalarNodeProto(BaseNode, abc.ABC):
     @classmethod
     @abc.abstractmethod
     async def compose(cls, *args, **kwargs) -> ComposeResult:
@@ -68,7 +171,6 @@ if typing.TYPE_CHECKING:
         pass
 
 else:
-
     def create_node(cls, bases, dct):
         dct.update(cls.__dict__)
         return type(cls.__name__, bases, dct)
@@ -87,21 +189,15 @@ else:
         pass
 
 
-def is_node(maybe_node: type[typing.Any]) -> typing.TypeGuard[type[Node]]:
-    maybe_node = typing.get_origin(maybe_node) or maybe_node
-    return (
-        isinstance(maybe_node, type)
-        and issubclass(maybe_node, Node)
-        or isinstance(maybe_node, Node)
-        or hasattr(maybe_node, "as_node")
-    )
-
-
 __all__ = (
+    "BaseNode",
     "ComposeError",
     "DataNode",
     "Node",
     "SCALAR_NODE",
     "ScalarNode",
+    "ScalarNodeProto",
+    "get_compose_annotations",
+    "get_nodes",
     "is_node",
 )

telegrinder/node/callback_query.py

@@ -1,18 +1,14 @@
-from telegrinder.bot.cute_types import CallbackQueryCute
-
-from .base import ComposeError, ScalarNode
-from .update import UpdateNode
+from telegrinder.bot.cute_types.callback_query import CallbackQueryCute
+from telegrinder.node.base import ComposeError, ScalarNode
+from telegrinder.node.update import UpdateNode
 
 
 class CallbackQueryNode(ScalarNode, CallbackQueryCute):
     @classmethod
     async def compose(cls, update: UpdateNode) -> CallbackQueryCute:
         if not update.callback_query:
-            raise ComposeError
-        return CallbackQueryCute(
-            **update.callback_query.unwrap().to_dict(),
-            api=update.api,
-        )
+            raise ComposeError("Update is not a callback_query.")
+        return update.callback_query.unwrap()
 
 
 __all__ = ("CallbackQueryNode",)

telegrinder/node/command.py

@@ -1,3 +1,4 @@
+import typing
 from dataclasses import dataclass, field
 
 from fntypes import Nothing, Option, Some
@@ -16,14 +17,17 @@ def cut_mention(text: str) -> tuple[str, Option[str]]:
     return left, Some(right) if right else Nothing()
 
 
-@dataclass
+@dataclass(slots=True)
 class CommandInfo(DataNode):
     name: str
     arguments: str
     mention: Option[str] = field(default_factory=Nothing)
 
     @classmethod
-    async def compose(cls, text: Text):
+    async def compose(cls, text: Text) -> typing.Self:
         name, arguments = single_split(text, separator=" ")
         name, mention = cut_mention(name)
         return cls(name, arguments, mention)
+
+
+__all__ = ("CommandInfo", "cut_mention", "single_split")