telegrinder 0.4.2__py3-none-any.whl → 0.5.1__py3-none-any.whl

telegrinder/client/sonic.py

@@ -1,212 +0,0 @@
-from __future__ import annotations
-
-import io
-import ssl
-import typing
-
-import certifi
-
-import telegrinder.msgspec_json as json
-from telegrinder.client.abc import ABCClient
-
-if typing.TYPE_CHECKING:
-    from aiosonic import Connection, HTTPClient, HttpResponse, MultipartForm, Proxy, TCPConnector, Timeouts
-
-type Data = dict[str, typing.Any] | MultipartForm
-type Response = HttpResponse
-
-AIOSONIC_OBJECTS = (
-    "Connection",
-    "HTTPClient",
-    "HttpResponse",
-    "Proxy",
-    "TCPConnector",
-    "Timeouts",
-)
-
-
-def init_aiosonic_module(client_class: type[ABCClient[typing.Any]], /) -> None:
-    try:
-        import aiosonic
-        import aiosonic.exceptions
-    except ImportError:
-        raise ImportError(
-            "Module 'aiosonic' is not installed. You can install as follows: pip install aiosonic"
-        ) from None
-
-    globalns = globals()
-    for name in AIOSONIC_OBJECTS:
-        globalns.setdefault(name, getattr(aiosonic, name))
-
-    if "MultipartForm" not in globalns:
-        globalns["MultipartForm"] = type("MultiPartForm", (_MultipartForm, aiosonic.MultipartForm), {})
-
-    if not client_class.CONNECTION_TIMEOUT_ERRORS:
-        client_class.CONNECTION_TIMEOUT_ERRORS = (
-            aiosonic.exceptions.ConnectTimeout,
-            aiosonic.exceptions.RequestTimeout,
-            TimeoutError,
-        )
-
-    if not client_class.CLIENT_CONNECTION_ERRORS:
-        client_class.CLIENT_CONNECTION_ERRORS = (
-            aiosonic.exceptions.ConnectionDisconnected,
-            aiosonic.exceptions.ConnectionPoolAcquireTimeout,
-        )
-
-
-class _MultipartForm(MultipartForm if typing.TYPE_CHECKING else object):
-    async def _generate_chunks(self) -> typing.AsyncGenerator[bytes, None]:
-        for field in self.fields:
-            yield (f"--{self.boundary}\r\n").encode()
-
-            if isinstance(field[1], io.IOBase):
-                yield (
-                    "Content-Type: application/octet-stream\r\n"
-                    "Content-Disposition: form-data; " + f'name="{field[0]}"; filename="{field[2]}"\r\n\r\n'
-                ).encode()
-
-                async for data in self._read_file(field[1]):
-                    yield data + b"\r\n"
-
-                field[1].close()
-            else:
-                yield (
-                    "Content-Type: text/plain; charset=utf-8\r\n"
-                    f'Content-Disposition: form-data; name="{field[0]}"\r\n\r\n'
-                ).encode()
-                yield field[1].encode() + b"\r\n"
-
-        yield (f"--{self.boundary}--").encode()
-
-    async def get_body_size(self) -> tuple[bytes, int]:
-        if not self.fields:
-            return b"", 0
-        return await super().get_body_size()
-
-    def get_headers(self, size: int | None = None) -> dict[str, str]:
-        if not self.fields:
-            return {"Content-Type": "application/x-www-form-urlencoded"}
-        return super().get_headers(size)
-
-
-class AiosonicClient(ABCClient["MultipartForm"]):
-    """HTTP client based on `aiosonic` module."""
-
-    def __init_subclass__(cls, *args: typing.Any, **kwargs: typing.Any) -> None:
-        init_aiosonic_module(cls)
-        return super().__init_subclass__(*args, **kwargs)
-
-    def __init__(
-        self,
-        *,
-        verify_ssl: bool = True,
-        tpc_pool_size: int = 25,
-        tpc_timeouts: Timeouts | None = None,
-        proxy: Proxy | None = None,
-        conn_max_requests: int = 100,
-        use_dns_cache: bool = True,
-        handle_cookies: bool = False,
-        ttl_dns_cache: int = 10000,
-        **kwargs: typing.Any,
-    ) -> None:
-        init_aiosonic_module(self.__class__)
-        self.ssl = ssl.create_default_context(cafile=certifi.where())
-        self.proxy = proxy
-        self.verify_ssl = verify_ssl
-        self.handle_cookies = handle_cookies
-        self.tpc_timeouts = tpc_timeouts or Timeouts()
-        self.tcp_connector = TCPConnector(
-            pool_size=tpc_pool_size,
-            timeouts=self.tpc_timeouts,
-            connection_cls=Connection,
-            conn_max_requests=conn_max_requests,
-            use_dns_cache=use_dns_cache,
-            ttl_dns_cache=ttl_dns_cache,
-            **kwargs,
-        )
-        self.client: HTTPClient | None = None
-
-    def __repr__(self) -> str:
-        return "<{}: proxy={!r}, tpc_timeouts={!r}, tcp_connector={!r}, client={!r}>".format(
-            self.__class__.__name__,
-            self.proxy,
-            self.tpc_timeouts,
-            self.tcp_connector,
-            self.client,
-        )
-
-    @classmethod
-    def multipart_form_factory(cls) -> MultipartForm:
-        return MultipartForm()
-
-    async def request_raw(
-        self,
-        url: str,
-        method: str = "GET",
-        data: Data | None = None,
-        **kwargs: typing.Any,
-    ) -> Response:
-        if self.client is None:
-            self.client = HTTPClient(
-                connector=self.tcp_connector,
-                handle_cookies=self.handle_cookies,
-                verify_ssl=self.verify_ssl,
-                proxy=self.proxy,
-            )
-
-        return await self.client.request(
-            url=url,
-            method=method,
-            data=data,
-            json_serializer=json.dumps,
-            ssl=self.ssl,
-            **kwargs,
-        )
-
-    async def request_text(
-        self,
-        url: str,
-        method: str = "GET",
-        data: Data | None = None,
-        **kwargs: typing.Any,
-    ) -> str:
-        response = await self.request_raw(url, method, data, **kwargs)
-        return await response.text()
-
-    async def request_json(
-        self,
-        url: str,
-        method: str = "GET",
-        data: Data | None = None,
-        **kwargs: typing.Any,
-    ) -> dict[str, typing.Any]:
-        return json.loads(await self.request_content(url, method, data, **kwargs))
-
-    async def request_bytes(
-        self,
-        url: str,
-        method: str = "GET",
-        data: Data | None = None,
-        **kwargs: typing.Any,
-    ) -> bytes:
-        response = await self.request_raw(url, method, data, **kwargs)
-        return response.body
-
-    async def request_content(
-        self,
-        url: str,
-        method: str = "GET",
-        data: Data | None = None,
-        **kwargs: typing.Any,
-    ) -> bytes:
-        response = await self.request_raw(url, method, data, **kwargs)
-        return await response.content()
-
-    async def close(self) -> None:
-        if self.client is not None:
-            await self.client.connector.cleanup()
-            self.client = None
-
-
-__all__ = ("AiosonicClient",)

telegrinder/msgspec_utils.py

@@ -1,478 +0,0 @@
-import typing
-from contextlib import contextmanager
-
-import fntypes.option
-import fntypes.result
-import msgspec
-from fntypes.co import Error, Ok, Variative
-
-if typing.TYPE_CHECKING:
-    from datetime import datetime
-
-    from fntypes.option import Option
-
-    def get_class_annotations(obj: typing.Any, /) -> dict[str, typing.Any]: ...
-
-    def get_type_hints(obj: typing.Any, /) -> dict[str, typing.Any]: ...
-
-else:
-    from datetime import datetime as dt
-
-    from msgspec._utils import get_class_annotations, get_type_hints
-
-    datetime = type("datetime", (dt,), {})
-
-    class OptionMeta(type):
-        def __instancecheck__(cls, __instance: typing.Any) -> bool:
-            return isinstance(__instance, (fntypes.option.Some | fntypes.option.Nothing, msgspec.UnsetType))
-
-    class Option[Value](metaclass=OptionMeta):
-        pass
-
-
-type DecHook[T] = typing.Callable[typing.Concatenate[type[T], typing.Any, ...], typing.Any]
-type EncHook[T] = typing.Callable[typing.Concatenate[T, ...], typing.Any]
-
-
-def get_origin[T](t: type[T]) -> type[T]:
-    return typing.cast(T, typing.get_origin(t)) or t
-
-
-def repr_type(t: typing.Any) -> str:
-    return getattr(t, "__name__", repr(get_origin(t)))
-
-
-def is_common_type(type_: typing.Any) -> typing.TypeGuard[type[typing.Any]]:
-    if not isinstance(type_, type):
-        return False
-    return (
-        type_ in (str, int, float, bool, None, Variative)
-        or issubclass(type_, msgspec.Struct)
-        or hasattr(type_, "__dataclass_fields__")
-    )
-
-
-def struct_as_dict(struct: msgspec.Struct, /) -> dict[str, typing.Any]:
-    return {
-        k: v
-        for k, v in msgspec.structs.asdict(struct).items()
-        if not isinstance(v, msgspec.UnsetType | type(None) | fntypes.option.Nothing)
-    }
-
-
-def type_check(obj: typing.Any, t: typing.Any) -> bool:
-    return (
-        isinstance(obj, t)
-        if isinstance(t, type) and issubclass(t, msgspec.Struct)
-        else type(obj) in t
-        if isinstance(t, tuple)
-        else type(obj) is t
-    )
-
-
-def msgspec_convert[T](obj: typing.Any, t: type[T]) -> fntypes.result.Result[T, str]:
-    try:
-        return Ok(decoder.convert(obj, type=t, strict=True))
-    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,
-) -> fntypes.result.Result[typing.Any, msgspec.ValidationError]:
-    try:
-        return Ok(encoder.to_builtins(**locals()))
-    except msgspec.ValidationError as exc:
-        return Error(exc)
-
-
-def option_dec_hook(
-    tp: type[Option[typing.Any]],
-    obj: typing.Any,
-) -> fntypes.option.Option[typing.Any] | msgspec.UnsetType:
-    if obj is msgspec.UNSET:
-        return obj
-
-    if obj is None or isinstance(obj, fntypes.option.Nothing):
-        return fntypes.option.Nothing()
-
-    (value_type,) = typing.get_args(tp) or (typing.Any,)
-    orig_value_type = typing.get_origin(value_type) or value_type
-    orig_obj = obj
-
-    if not isinstance(orig_obj, dict | list) and is_common_type(orig_value_type):
-        if orig_value_type is Variative:
-            obj = value_type(orig_obj)  # type: ignore
-            orig_value_type = typing.get_args(value_type)
-
-        if not type_check(orig_obj, orig_value_type):
-            raise TypeError(f"Expected `{repr_type(orig_value_type)}`, got `{repr_type(type(orig_obj))}`.")
-
-        return fntypes.option.Some(obj)
-
-    return fntypes.option.Some(decoder.convert(orig_obj, type=value_type))
-
-
-def variative_dec_hook(tp: type[Variative], obj: typing.Any) -> Variative:
-    union_types = typing.get_args(tp)
-
-    if isinstance(obj, dict):
-        models_struct_fields: dict[type[msgspec.Struct], int] = {
-            m: sum(1 for k in obj if k in m.__struct_fields__)
-            for m in union_types
-            if issubclass(get_origin(m), msgspec.Struct)
-        }
-        union_types = tuple(t for t in union_types if t not in models_struct_fields)
-        reverse = False
-
-        if len(set(models_struct_fields.values())) != len(models_struct_fields.values()):
-            models_struct_fields = {m: len(m.__struct_fields__) for m in models_struct_fields}
-            reverse = True
-
-        union_types = (
-            *sorted(
-                models_struct_fields,
-                key=lambda k: models_struct_fields[k],
-                reverse=reverse,
-            ),
-            *union_types,
-        )
-
-    for t in union_types:
-        if not isinstance(obj, dict | list) and is_common_type(t) and type_check(obj, t):
-            return tp(obj)
-        match msgspec_convert(obj, t):
-            case Ok(value):
-                return tp(value)
-
-    raise TypeError(
-        "Object of type `{}` does not belong to types `{}`".format(
-            repr_type(obj.__class__),
-            " | ".join(map(repr_type, union_types)),
-        )
-    )
-
-
-class Decoder:
-    """Class `Decoder` for `msgspec` module with decode hook
-    for objects with the specified type.
-
-    ```
-    import enum
-
-    from datetime import datetime as dt
-
-    class Digit(enum.IntEnum):
-        ONE = 1
-        TWO = 2
-        THREE = 3
-
-    decoder = 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.convert("123", type=int, strict=False)  #> 123
-    decoder.convert(1, type=Digit)  #> <Digit.ONE: 1>
-
-    decoder.decode(b'{"digit":3}', type=dict[str, Digit])  #> {'digit': <Digit.THREE: 3>}
-    ```
-    """
-
-    def __init__(self) -> None:
-        self.dec_hooks: dict[typing.Any, DecHook[typing.Any]] = {
-            Option: option_dec_hook,
-            Variative: variative_dec_hook,
-            datetime: lambda t, obj: t.fromtimestamp(obj),
-            fntypes.option.Some: option_dec_hook,
-            fntypes.option.Nothing: option_dec_hook,
-        }
-
-    def __repr__(self) -> str:
-        return "<{}: dec_hooks={!r}>".format(
-            self.__class__.__name__,
-            self.dec_hooks,
-        )
-
-    @typing.overload
-    def __call__[T](
-        self,
-        type: type[T],
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.ContextManager[msgspec.json.Decoder[T]]: ...
-
-    @typing.overload
-    def __call__(
-        self,
-        type: typing.Any,
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.ContextManager[msgspec.json.Decoder[typing.Any]]: ...
-
-    @typing.overload
-    def __call__[T](
-        self,
-        type: type[T],
-        *,
-        strict: bool = True,
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.ContextManager[msgspec.json.Decoder[T]]: ...
-
-    @typing.overload
-    def __call__(
-        self,
-        type: typing.Any,
-        *,
-        strict: bool = True,
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.ContextManager[msgspec.json.Decoder[typing.Any]]: ...
-
-    @contextmanager
-    def __call__(self, type=object, *, strict=True, context=None):
-        """Context manager returns an `msgspec.json.Decoder` object with the `dec_hook`."""
-        dec_obj = msgspec.json.Decoder(
-            type=typing.Any if type is object else type,
-            strict=strict,
-            dec_hook=self.dec_hook(context),
-        )
-        yield dec_obj
-
-    def add_dec_hook[T](self, t: type[T], /):
-        def decorator(func: DecHook[T]) -> DecHook[T]:
-            return self.dec_hooks.setdefault(get_origin(t), func)
-
-        return decorator
-
-    def dec_hook(self, context: dict[str, typing.Any] | None = None):
-        from telegrinder.tools.magic import magic_bundle
-
-        def inner(tp: type[typing.Any], obj: object) -> typing.Any:
-            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."
-                )
-            dec_hook_func = self.dec_hooks[origin_type]
-            kwargs = magic_bundle(dec_hook_func, context or {}, start_idx=2)
-            return dec_hook_func(tp, obj, **kwargs)
-
-        return inner
-
-    def convert[T](
-        self,
-        obj: object,
-        *,
-        type: type[T] = dict,
-        strict: bool = True,
-        from_attributes: bool = False,
-        builtin_types: typing.Iterable[type[typing.Any]] | None = None,
-        str_keys: bool = False,
-        context: dict[str, typing.Any] | None = None,
-    ) -> T:
-        return msgspec.convert(
-            obj,
-            type,
-            strict=strict,
-            from_attributes=from_attributes,
-            dec_hook=self.dec_hook(context),
-            builtin_types=builtin_types,
-            str_keys=str_keys,
-        )
-
-    @typing.overload
-    def decode(
-        self,
-        buf: str | bytes,
-        *,
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.Any: ...
-
-    @typing.overload
-    def decode[T](
-        self,
-        buf: str | bytes,
-        *,
-        type: type[T],
-        context: dict[str, typing.Any] | None = None,
-    ) -> T: ...
-
-    @typing.overload
-    def decode(
-        self,
-        buf: str | bytes,
-        *,
-        type: typing.Any,
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.Any: ...
-
-    @typing.overload
-    def decode[T](
-        self,
-        buf: str | bytes,
-        *,
-        type: type[T],
-        strict: bool = True,
-        context: dict[str, typing.Any] | None = None,
-    ) -> T: ...
-
-    @typing.overload
-    def decode(
-        self,
-        buf: str | bytes,
-        *,
-        type: typing.Any,
-        strict: bool = True,
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.Any: ...
-
-    def decode(self, buf, *, type=object, strict=True, context=None):
-        return msgspec.json.decode(
-            buf,
-            type=typing.Any if type is object else type,
-            strict=strict,
-            dec_hook=self.dec_hook(context),
-        )
-
-
-class Encoder:
-    """Class `Encoder` for `msgspec` module with encode hooks for objects.
-
-    ```
-    from datetime import datetime as dt
-
-    encoder = Encoder()
-    encoder.enc_hooks[dt] = lambda d: int(d.timestamp())
-
-    encoder.enc_hook(dt.now())  #> 1713354732
-    encoder.encode({'digit': Digit.ONE})  #> '{"digit":1}'
-    ```
-    """
-
-    def __init__(self) -> None:
-        self.enc_hooks: dict[typing.Any, EncHook[typing.Any]] = {
-            fntypes.option.Some: lambda opt: opt.value,
-            fntypes.option.Nothing: lambda _: None,
-            Variative: lambda variative: variative.v,
-            datetime: lambda date: int(date.timestamp()),
-        }
-
-    def __repr__(self) -> str:
-        return "<{}: enc_hooks={!r}>".format(
-            self.__class__.__name__,
-            self.enc_hooks,
-        )
-
-    @contextmanager
-    def __call__(
-        self,
-        *,
-        decimal_format: typing.Literal["string", "number"] = "string",
-        uuid_format: typing.Literal["canonical", "hex"] = "canonical",
-        order: typing.Literal[None, "deterministic", "sorted"] = None,
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.Generator[msgspec.json.Encoder, typing.Any, None]:
-        """Context manager returns an `msgspec.json.Encoder` object with the `enc_hook`."""
-        enc_obj = msgspec.json.Encoder(enc_hook=self.enc_hook(context))
-        yield enc_obj
-
-    def add_enc_hook[T](self, t: type[T], /):
-        def decorator(func: EncHook[T]) -> EncHook[T]:
-            encode_hook = self.enc_hooks.setdefault(get_origin(t), func)
-            return func if encode_hook is not func else encode_hook
-
-        return decorator
-
-    def enc_hook(self, context: dict[str, typing.Any] | None = None):
-        from telegrinder.tools.magic import magic_bundle
-
-        def inner(obj: typing.Any) -> typing.Any:
-            origin_type = get_origin(obj.__class__)
-            if origin_type not in self.enc_hooks:
-                raise NotImplementedError(
-                    f"Not implemented encode hook for object of type `{repr_type(origin_type)}`.",
-                )
-            enc_hook_func = self.enc_hooks[origin_type]
-            kwargs = magic_bundle(enc_hook_func, context or {}, start_idx=1)
-            return enc_hook_func(obj, **kwargs)
-
-        return inner
-
-    @typing.overload
-    def encode(
-        self,
-        obj: typing.Any,
-        *,
-        context: dict[str, typing.Any] | None = None,
-    ) -> str: ...
-
-    @typing.overload
-    def encode(
-        self,
-        obj: typing.Any,
-        *,
-        as_str: typing.Literal[True],
-        context: dict[str, typing.Any] | None = None,
-    ) -> str: ...
-
-    @typing.overload
-    def encode(
-        self,
-        obj: typing.Any,
-        *,
-        as_str: typing.Literal[False],
-        context: dict[str, typing.Any] | None = None,
-    ) -> bytes: ...
-
-    def encode(
-        self,
-        obj: typing.Any,
-        *,
-        as_str: bool = True,
-        context: dict[str, typing.Any] | None = None,
-    ) -> str | bytes:
-        buf = msgspec.json.encode(obj, enc_hook=self.enc_hook(context))
-        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,
-        context: dict[str, typing.Any] | None = None,
-    ) -> typing.Any:
-        return msgspec.to_builtins(
-            obj,
-            str_keys=str_keys,
-            builtin_types=builtin_types,
-            enc_hook=self.enc_hook(context),
-            order=order,
-        )
-
-
-decoder: typing.Final[Decoder] = Decoder()
-encoder: typing.Final[Encoder] = Encoder()
-
-
-__all__ = (
-    "Decoder",
-    "Encoder",
-    "Option",
-    "datetime",
-    "decoder",
-    "encoder",
-    "get_class_annotations",
-    "get_type_hints",
-    "msgspec_convert",
-    "msgspec_to_builtins",
-    "struct_as_dict",
-)

telegrinder/tools/adapter/__init__.py

@@ -1,19 +0,0 @@
-from telegrinder.tools.adapter.abc import ABCAdapter, AdaptResult, Event
-from telegrinder.tools.adapter.dataclass import DataclassAdapter
-from telegrinder.tools.adapter.errors import AdapterError
-from telegrinder.tools.adapter.event import EventAdapter
-from telegrinder.tools.adapter.node import NodeAdapter
-from telegrinder.tools.adapter.raw_event import RawEventAdapter
-from telegrinder.tools.adapter.raw_update import RawUpdateAdapter
-
-__all__ = (
-    "ABCAdapter",
-    "AdaptResult",
-    "AdapterError",
-    "DataclassAdapter",
-    "Event",
-    "EventAdapter",
-    "NodeAdapter",
-    "RawEventAdapter",
-    "RawUpdateAdapter",
-)