telegrinder 0.1.dev165__py3-none-any.whl → 0.1.dev167__py3-none-any.whl

telegrinder/tools/formatting/html.py

@@ -78,11 +78,15 @@ class StringFormatter(string.Formatter):
         with suppress(ValueError):
             return HTMLFormatter(
                 format(
-                    value.formatting()
-                    if isinstance(value, TagFormat)
-                    else self.get_spec_formatter(value)(**value.__dict__).formatting()
-                    if is_spec_format(value)
-                    else value,
+                    (
+                        value.formatting()
+                        if isinstance(value, TagFormat)
+                        else (
+                            self.get_spec_formatter(value)(**value.__dict__).formatting()
+                            if is_spec_format(value)
+                            else value
+                        )
+                    ),
                     fmt,
                 )
             )

telegrinder/tools/formatting/links.py

@@ -29,9 +29,7 @@ def get_invite_chat_link(invite_link: str) -> str:
 
 
 def user_open_message_link(user_id: int, message: str | None = None) -> str:
-    return f"tg://openmessage?user_id={user_id}" + (
-        "" if not message else f"&msg?text={message}"
-    )
+    return f"tg://openmessage?user_id={user_id}" + ("" if not message else f"&msg?text={message}")
 
 
 __all__ = (

telegrinder/tools/formatting/spec_html_formats.py

@@ -76,7 +76,7 @@ class PreCode(BaseSpecFormat):
 @dataclasses.dataclass(repr=False)
 class TgEmoji(BaseSpecFormat):
     __formatter_name__ = "tg_emoji"
-    
+
     string: str
     emoji_id: int
 

telegrinder/tools/global_context/abc.py

@@ -35,7 +35,9 @@ class GlobalCtxVar(typing.Generic[T]):
 
     @classmethod
     def collect(cls, name: str, ctx_value: T | CtxVariable[T]) -> typing.Self:
-        ctx_value = CtxVar(ctx_value) if not isinstance(ctx_value, CtxVar | GlobalCtxVar) else ctx_value
+        ctx_value = (
+            CtxVar(ctx_value) if not isinstance(ctx_value, CtxVar | GlobalCtxVar) else ctx_value
+        )
         params = ctx_value.__dict__
         params["name"] = name
         return cls(**params)

telegrinder/tools/global_context/global_context.py

@@ -15,10 +15,8 @@ F = typing.TypeVar("F", bound=typing.Callable)
 CtxValueT = typing.TypeVar("CtxValueT", default=typing.Any)
 
 if typing.TYPE_CHECKING:
-
     _: typing.TypeAlias = None
 else:
-
     _ = lambda: None
 
 
@@ -51,14 +49,10 @@ def root_protection(func: F) -> F:
 
     @wraps(func)
     def wrapper(self: "GlobalContext", name: str, /, *args) -> typing.Any:
-        if self.is_root_attribute(name) and name in (
-            self.__dict__ | self.__class__.__dict__
-        ):
+        if self.is_root_attribute(name) and name in (self.__dict__ | self.__class__.__dict__):
             root_attr = self.get_root_attribute(name).unwrap()
             if all((not root_attr.can_be_rewritten, not root_attr.can_be_read)):
-                raise AttributeError(
-                    f"Unable to set, get, delete root attribute {name!r}."
-                )
+                raise AttributeError(f"Unable to set, get, delete root attribute {name!r}.")
             if func.__name__ == "__setattr__" and not root_attr.can_be_rewritten:
                 raise AttributeError(f"Unable to set root attribute {name!r}.")
             if func.__name__ == "__getattr__" and not root_attr.can_be_read:
@@ -106,9 +100,7 @@ class Storage:
     )
 
     def __repr__(self) -> str:
-        return "<ContextStorage: %s>" % ", ".join(
-            "ctx @" + repr(x) for x in self._storage
-        )
+        return "<ContextStorage: %s>" % ", ".join("ctx @" + repr(x) for x in self._storage)
 
     @property
     def storage(self) -> dict[str, "GlobalContext"]:
@@ -132,7 +124,9 @@ class Storage:
     order_default=True,
     field_specifiers=(ctx_var,),
 )
-class GlobalContext(ABCGlobalContext, typing.Generic[CtxValueT], dict[str, GlobalCtxVar[CtxValueT]]):
+class GlobalContext(
+    ABCGlobalContext, typing.Generic[CtxValueT], dict[str, GlobalCtxVar[CtxValueT]]
+):
     """GlobalContext.
 
     ```
@@ -208,19 +202,14 @@ class GlobalContext(ABCGlobalContext, typing.Generic[CtxValueT], dict[str, Globa
         """Returns True if the names of context stores
         that use self and __value instances are equivalent."""
 
-        return (
-            isinstance(__value, GlobalContext)
-            and self.__ctx_name__ == __value.__ctx_name__
-        )
+        return isinstance(__value, GlobalContext) and self.__ctx_name__ == __value.__ctx_name__
 
     def __setitem__(self, __name: str, __value: CtxValueT | CtxVariable[CtxValueT]):
         if is_dunder(__name):
             raise NameError("Cannot set a context variable with dunder name.")
         var = self.get(__name)
         if var and var.unwrap().const:
-            raise TypeError(
-                f"Unable to set variable {__name!r}, because it's a constant."
-            )
+            raise TypeError(f"Unable to set variable {__name!r}, because it's a constant.")
         dict.__setitem__(self, __name, GlobalCtxVar.collect(__name, __value))
 
     def __getitem__(self, __name: str) -> CtxValueT:
@@ -229,9 +218,7 @@ class GlobalContext(ABCGlobalContext, typing.Generic[CtxValueT], dict[str, Globa
     def __delitem__(self, __name: str):
         var = self.get(__name).unwrap()
         if var.const:
-            raise TypeError(
-                f"Unable to delete variable {__name!r}, because it's a constant."
-            )
+            raise TypeError(f"Unable to delete variable {__name!r}, because it's a constant.")
         dict.__delitem__(self, __name)
 
     @root_protection
@@ -328,9 +315,7 @@ class GlobalContext(ABCGlobalContext, typing.Generic[CtxValueT], dict[str, Globa
         var_value_type: type[T],
     ) -> Option[GlobalCtxVar[T]]: ...
 
-    def pop(
-        self, var_name: str, var_value_type: type[T] = object
-    ) -> Option[GlobalCtxVar[T]]:
+    def pop(self, var_name: str, var_value_type: type[T] = object) -> Option[GlobalCtxVar[T]]:
         """Pop context variable by name."""
 
         val = self.get(var_name, var_value_type)
@@ -398,9 +383,7 @@ class GlobalContext(ABCGlobalContext, typing.Generic[CtxValueT], dict[str, Globa
 
         var = self.get(old_var_name).unwrap()
         if var.const:
-            return Error(
-                f"Unable to rename variable {old_var_name!r}, " "because it's a constant."
-            )
+            return Error(f"Unable to rename variable {old_var_name!r}, " "because it's a constant.")
         del self[old_var_name]
         self[new_var_name] = var.value
         return Ok(_())
@@ -419,9 +402,8 @@ class GlobalContext(ABCGlobalContext, typing.Generic[CtxValueT], dict[str, Globa
             return dict.clear(self)
 
         for name, var in self.dict().items():
-            if var.const:
-                continue
-            del self[name]
+            if not var.const:
+                del self[name]
 
     def delete_ctx(self) -> Result[_, str]:
         """Delete context by `ctx_name`."""

telegrinder/tools/global_context/telegrinder_ctx.py

@@ -7,7 +7,7 @@ from telegrinder.tools.global_context import GlobalContext, ctx_var
 
 class TelegrinderCtx(GlobalContext):
     """Basic type-hinted telegrinder context with context name `"telegrinder"`.
-    
+
     You can use this class or GlobalContext:
     ```
     from telegrinder.tools.global_context import GlobalContext, TelegrinderCtx

telegrinder/tools/i18n/base.py

@@ -1,4 +1,5 @@
 import enum
+import typing
 from abc import ABC, abstractmethod
 
 
@@ -9,14 +10,14 @@ class ABCI18n(ABC):
 
 
 class ABCTranslator(ABC):
-    def __init__(self, locale: str, **kwargs):
+    def __init__(self, locale: str, **kwargs: typing.Any) -> None:
         self.locale = locale
 
     @abstractmethod
-    def get(self, __key: str, *args, **kwargs) -> str:
+    def get(self, __key: str, *args: typing.Any, **kwargs: typing.Any) -> str:
         """This translates a key to actual human-readable string"""
 
-    def __call__(self, __key: str, *args, **kwargs):
+    def __call__(self, __key: str, *args: typing.Any, **kwargs: typing.Any) -> str:
         return self.get(__key, *args, **kwargs)
 
 

telegrinder/tools/i18n/middleware/base.py

@@ -17,9 +17,7 @@ class ABCTranslatorMiddleware(ABCMiddleware[T]):
         pass
 
     async def pre(self, event: T, ctx: dict) -> bool:
-        ctx[I18nEnum.I18N] = self.i18n.get_translator_by_locale(
-            await self.get_locale(event)
-        )
+        ctx[I18nEnum.I18N] = self.i18n.get_translator_by_locale(await self.get_locale(event))
         return True
 
 

telegrinder/tools/i18n/simple.py

@@ -20,9 +20,7 @@ class SimpleI18n(ABCI18n):
             if not os.path.isdir(os.path.join(self.folder, name)):
                 continue
 
-            mo_path = os.path.join(
-                self.folder, name, "LC_MESSAGES", f"{self.domain}.mo"
-            )
+            mo_path = os.path.join(self.folder, name, "LC_MESSAGES", f"{self.domain}.mo")
             if os.path.exists(mo_path):
                 with open(mo_path, "rb") as f:
                     result[name] = gettext.GNUTranslations(f)

telegrinder/tools/keyboard.py

@@ -46,7 +46,7 @@ class ABCMarkup(ABC, typing.Generic[ButtonT]):
     def add(self, row_or_button: RowButtons[ButtonT] | ButtonT) -> typing.Self:
         if not len(self.keyboard):
             self.row()
-        
+
         if isinstance(row_or_button, RowButtons):
             self.keyboard[-1].extend(row_or_button.get_data())
             if row_or_button.auto_row:

telegrinder/tools/limited_dict.py

@@ -0,0 +1,27 @@
+import typing
+from collections import UserDict, deque
+
+KT = typing.TypeVar("KT")
+VT = typing.TypeVar("VT")
+
+
+class LimitedDict(UserDict[KT, VT]):
+    def __init__(self, *, maxlimit: int = 1000) -> None:
+        super().__init__()
+        self.maxlimit = maxlimit
+        self.queue: deque[KT] = deque(maxlen=maxlimit)
+
+    def __setitem__(self, key: KT, value: VT, /) -> None:
+        if len(self.queue) >= self.maxlimit:
+            self.pop(self.queue.popleft(), None)
+        if key not in self.queue:
+            self.queue.append(key)
+        super().__setitem__(key, value)
+    
+    def __delitem__(self, key: KT) -> None:
+        if key in self.queue:
+            self.queue.remove(key)
+        return super().__delitem__(key)
+
+
+__all__ = ("LimitedDict",)

telegrinder/tools/loop_wrapper/loop_wrapper.py

@@ -16,17 +16,20 @@ CoroutineFunc: typing.TypeAlias = typing.Callable[P, CoroutineTask[T]]
 Task: typing.TypeAlias = typing.Union[CoroutineFunc, CoroutineTask, "DelayedTask"]
 
 
-def run_tasks(tasks: list[CoroutineTask[typing.Any]], loop: asyncio.AbstractEventLoop) -> None:
-    while len(tasks) != 0:
+def run_tasks(
+    tasks: list[CoroutineTask[typing.Any]],
+    loop: asyncio.AbstractEventLoop,
+) -> None:
+    while tasks:
         loop.run_until_complete(tasks.pop(0))
 
 
-def to_coroutine_task(task: Task) -> CoroutineTask:
+def to_coroutine_task(task: Task) -> CoroutineTask[typing.Any]:
     if asyncio.iscoroutinefunction(task) or isinstance(task, DelayedTask):
         task = task()
     elif not asyncio.iscoroutine(task):
-        raise TypeError("Task should be coroutine or coroutine function.")   
-    return task     
+        raise TypeError("Task should be coroutine or coroutine function.")
+    return task
 
 
 @dataclasses.dataclass
@@ -63,15 +66,15 @@ class Lifespan:
         task_or_func = to_coroutine_task(task_or_func)
         self.startup_tasks.append(task_or_func)
         return task_or_func
-    
+
     def on_shutdown(self, task_or_func: Task) -> Task:
         task_or_func = to_coroutine_task(task_or_func)
         self.shutdown_tasks.append(task_or_func)
         return task_or_func
-    
+
     def start(self, loop: asyncio.AbstractEventLoop) -> None:
         run_tasks(self.startup_tasks, loop)
-    
+
     def shutdown(self, loop: asyncio.AbstractEventLoop) -> None:
         run_tasks(self.shutdown_tasks, loop)
 
@@ -86,7 +89,7 @@ class LoopWrapper(ABCLoopWrapper):
         self.tasks: list[CoroutineTask[typing.Any]] = tasks or []
         self.lifespan = lifespan or Lifespan()
         self._loop = asyncio.new_event_loop()
-    
+
     def __repr__(self) -> str:
         return "<{}: loop={!r} with tasks={!r}, lifespan={!r}>".format(
             self.__class__.__name__,
@@ -94,15 +97,16 @@ class LoopWrapper(ABCLoopWrapper):
             self.tasks,
             self.lifespan,
         )
-        
+
     def run_event_loop(self) -> None:
         if not self.tasks:
             logger.warning("You run loop with 0 tasks!")
 
         self.lifespan.start(self._loop)
-        run_tasks(self.tasks, self._loop)
+        while self.tasks:
+            self._loop.create_task(self.tasks.pop(0))
         tasks = asyncio.all_tasks(self._loop)
-        
+
         try:
             while tasks:
                 tasks_results, _ = self._loop.run_until_complete(
@@ -122,7 +126,7 @@ class LoopWrapper(ABCLoopWrapper):
             self.lifespan.shutdown(self._loop)
             if self._loop.is_running():
                 self._loop.close()
-        
+
     def add_task(self, task: Task) -> None:
         task = to_coroutine_task(task)
 
@@ -130,7 +134,7 @@ class LoopWrapper(ABCLoopWrapper):
             self._loop.create_task(task)
         else:
             self.tasks.append(task)
-    
+
     def complete_tasks(self, tasks: set[asyncio.Task[typing.Any]]) -> None:
         tasks = tasks | asyncio.all_tasks(self._loop)
         task_to_cancel = asyncio.gather(*tasks, return_exceptions=True)

telegrinder/tools/magic.py

@@ -28,7 +28,7 @@ def to_str(s: str | enum.Enum) -> str:
 
 
 def magic_bundle(
-    handler: FuncType, 
+    handler: FuncType,
     kw: dict[str | enum.Enum, typing.Any],
     *,
     start_idx: int = 1,

telegrinder/types/__init__.py

@@ -1,2 +1,238 @@
 from telegrinder.types.enums import *
 from telegrinder.types.objects import *
+
+__all__ = (
+    "Animation",
+    "Audio",
+    "BackgroundFill",
+    "BackgroundFillFreeformGradient",
+    "BackgroundFillGradient",
+    "BackgroundFillSolid",
+    "BackgroundType",
+    "BackgroundTypeChatTheme",
+    "BackgroundTypeFill",
+    "BackgroundTypePattern",
+    "BackgroundTypeWallpaper",
+    "Birthdate",
+    "BotCommand",
+    "BotCommandScope",
+    "BotCommandScopeAllChatAdministrators",
+    "BotCommandScopeAllGroupChats",
+    "BotCommandScopeAllPrivateChats",
+    "BotCommandScopeChat",
+    "BotCommandScopeChatAdministrators",
+    "BotCommandScopeChatMember",
+    "BotCommandScopeDefault",
+    "BotCommandScopeType",
+    "BotDescription",
+    "BotName",
+    "BotShortDescription",
+    "BusinessConnection",
+    "BusinessIntro",
+    "BusinessLocation",
+    "BusinessMessagesDeleted",
+    "BusinessOpeningHours",
+    "BusinessOpeningHoursInterval",
+    "CallbackGame",
+    "CallbackQuery",
+    "Chat",
+    "ChatAction",
+    "ChatAdministratorRights",
+    "ChatBackground",
+    "ChatBoost",
+    "ChatBoostAdded",
+    "ChatBoostRemoved",
+    "ChatBoostSource",
+    "ChatBoostSourceGiftCode",
+    "ChatBoostSourceGiveaway",
+    "ChatBoostSourcePremium",
+    "ChatBoostSourceType",
+    "ChatBoostUpdated",
+    "ChatFullInfo",
+    "ChatInviteLink",
+    "ChatJoinRequest",
+    "ChatLocation",
+    "ChatMember",
+    "ChatMemberAdministrator",
+    "ChatMemberBanned",
+    "ChatMemberLeft",
+    "ChatMemberMember",
+    "ChatMemberOwner",
+    "ChatMemberRestricted",
+    "ChatMemberStatus",
+    "ChatMemberUpdated",
+    "ChatPermissions",
+    "ChatPhoto",
+    "ChatShared",
+    "ChatType",
+    "ChosenInlineResult",
+    "Contact",
+    "ContentType",
+    "Currency",
+    "DefaultAccentColor",
+    "Dice",
+    "DiceEmoji",
+    "Document",
+    "EncryptedCredentials",
+    "EncryptedPassportElement",
+    "EncryptedPassportElementType",
+    "ExternalReplyInfo",
+    "File",
+    "ForceReply",
+    "ForumTopic",
+    "ForumTopicClosed",
+    "ForumTopicCreated",
+    "ForumTopicEdited",
+    "ForumTopicReopened",
+    "Game",
+    "GameHighScore",
+    "GeneralForumTopicHidden",
+    "GeneralForumTopicUnhidden",
+    "Giveaway",
+    "GiveawayCompleted",
+    "GiveawayCreated",
+    "GiveawayWinners",
+    "InaccessibleMessage",
+    "InlineKeyboardButton",
+    "InlineKeyboardMarkup",
+    "InlineQuery",
+    "InlineQueryChatType",
+    "InlineQueryResult",
+    "InlineQueryResultArticle",
+    "InlineQueryResultAudio",
+    "InlineQueryResultCachedAudio",
+    "InlineQueryResultCachedDocument",
+    "InlineQueryResultCachedGif",
+    "InlineQueryResultCachedMpeg4Gif",
+    "InlineQueryResultCachedPhoto",
+    "InlineQueryResultCachedSticker",
+    "InlineQueryResultCachedVideo",
+    "InlineQueryResultCachedVoice",
+    "InlineQueryResultContact",
+    "InlineQueryResultDocument",
+    "InlineQueryResultDocumentMimeType",
+    "InlineQueryResultGame",
+    "InlineQueryResultGif",
+    "InlineQueryResultGifThumbnailMimeType",
+    "InlineQueryResultLocation",
+    "InlineQueryResultMimeType",
+    "InlineQueryResultMpeg4Gif",
+    "InlineQueryResultMpeg4GifThumbnailMimeType",
+    "InlineQueryResultPhoto",
+    "InlineQueryResultThumbnailMimeType",
+    "InlineQueryResultVenue",
+    "InlineQueryResultVideo",
+    "InlineQueryResultVideoMimeType",
+    "InlineQueryResultVoice",
+    "InlineQueryResultsButton",
+    "InputContactMessageContent",
+    "InputFile",
+    "InputInvoiceMessageContent",
+    "InputLocationMessageContent",
+    "InputMedia",
+    "InputMediaAnimation",
+    "InputMediaAudio",
+    "InputMediaDocument",
+    "InputMediaPhoto",
+    "InputMediaVideo",
+    "InputMessageContent",
+    "InputPollOption",
+    "InputSticker",
+    "InputTextMessageContent",
+    "InputVenueMessageContent",
+    "Invoice",
+    "KeyboardButton",
+    "KeyboardButtonPollType",
+    "KeyboardButtonRequestChat",
+    "KeyboardButtonRequestUsers",
+    "LabeledPrice",
+    "LinkPreviewOptions",
+    "Location",
+    "LoginUrl",
+    "MaskPosition",
+    "MaskPositionPoint",
+    "MaybeInaccessibleMessage",
+    "MenuButton",
+    "MenuButtonCommands",
+    "MenuButtonDefault",
+    "MenuButtonWebApp",
+    "Message",
+    "MessageAutoDeleteTimerChanged",
+    "MessageEntity",
+    "MessageEntityType",
+    "MessageId",
+    "MessageOrigin",
+    "MessageOriginChannel",
+    "MessageOriginChat",
+    "MessageOriginHiddenUser",
+    "MessageOriginType",
+    "MessageOriginUser",
+    "MessageReactionCountUpdated",
+    "MessageReactionUpdated",
+    "Model",
+    "OrderInfo",
+    "PassportData",
+    "PassportElementError",
+    "PassportElementErrorDataField",
+    "PassportElementErrorFile",
+    "PassportElementErrorFiles",
+    "PassportElementErrorFrontSide",
+    "PassportElementErrorReverseSide",
+    "PassportElementErrorSelfie",
+    "PassportElementErrorTranslationFile",
+    "PassportElementErrorTranslationFiles",
+    "PassportElementErrorType",
+    "PassportElementErrorUnspecified",
+    "PassportFile",
+    "PhotoSize",
+    "Poll",
+    "PollAnswer",
+    "PollOption",
+    "PollType",
+    "PreCheckoutQuery",
+    "ProgrammingLanguage",
+    "ProximityAlertTriggered",
+    "ReactionCount",
+    "ReactionEmoji",
+    "ReactionType",
+    "ReactionTypeCustomEmoji",
+    "ReactionTypeEmoji",
+    "ReactionTypeType",
+    "ReplyKeyboardMarkup",
+    "ReplyKeyboardRemove",
+    "ReplyParameters",
+    "ResponseParameters",
+    "SentWebAppMessage",
+    "SharedUser",
+    "ShippingAddress",
+    "ShippingOption",
+    "ShippingQuery",
+    "Sticker",
+    "StickerFormat",
+    "StickerSet",
+    "StickerSetStickerType",
+    "StickerType",
+    "Story",
+    "SuccessfulPayment",
+    "SwitchInlineQueryChosenChat",
+    "TextQuote",
+    "TopicIconColor",
+    "Update",
+    "UpdateType",
+    "User",
+    "UserChatBoosts",
+    "UserProfilePhotos",
+    "UsersShared",
+    "Venue",
+    "Video",
+    "VideoChatEnded",
+    "VideoChatParticipantsInvited",
+    "VideoChatScheduled",
+    "VideoChatStarted",
+    "VideoNote",
+    "Voice",
+    "WebAppData",
+    "WebAppInfo",
+    "WebhookInfo",
+    "WriteAccessAllowed",
+)

telegrinder/types/enums.py

@@ -657,3 +657,37 @@ class StickerFormat(str, enum.Enum):
     STATIC = "static"
     ANIMATED = "animated"
     VIDEO = "video"
+
+
+__all__ = (
+    "BotCommandScopeType",
+    "ChatAction",
+    "ChatBoostSourceType",
+    "ChatMemberStatus",
+    "ChatType",
+    "ContentType",
+    "Currency",
+    "DefaultAccentColor",
+    "DiceEmoji",
+    "EncryptedPassportElementType",
+    "InlineQueryChatType",
+    "InlineQueryResultDocumentMimeType",
+    "InlineQueryResultGifThumbnailMimeType",
+    "InlineQueryResultMimeType",
+    "InlineQueryResultMpeg4GifThumbnailMimeType",
+    "InlineQueryResultThumbnailMimeType",
+    "InlineQueryResultVideoMimeType",
+    "MaskPositionPoint",
+    "MessageEntityType",
+    "MessageOriginType",
+    "PassportElementErrorType",
+    "PollType",
+    "ProgrammingLanguage",
+    "ReactionEmoji",
+    "ReactionTypeType",
+    "StickerFormat",
+    "StickerSetStickerType",
+    "StickerType",
+    "TopicIconColor",
+    "UpdateType",
+)