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

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/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/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
@@ -56,22 +59,26 @@ class DelayedTask(typing.Generic[CoroFunc]):
 
 @dataclasses.dataclass(kw_only=True)
 class Lifespan:
-    startup_tasks: list[CoroutineTask[typing.Any]] = dataclasses.field(default_factory=lambda: [])
-    shutdown_tasks: list[CoroutineTask[typing.Any]] = dataclasses.field(default_factory=lambda: [])
+    startup_tasks: list[CoroutineTask[typing.Any]] = dataclasses.field(
+        default_factory=lambda: []
+    )
+    shutdown_tasks: list[CoroutineTask[typing.Any]] = dataclasses.field(
+        default_factory=lambda: []
+    )
 
     def on_startup(self, task_or_func: Task) -> Task:
         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 +93,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 +101,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 +130,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 +138,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,208 @@
 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",
+    "BotDescription",
+    "BotName",
+    "BotShortDescription",
+    "BusinessConnection",
+    "BusinessIntro",
+    "BusinessLocation",
+    "BusinessMessagesDeleted",
+    "BusinessOpeningHours",
+    "BusinessOpeningHoursInterval",
+    "CallbackGame",
+    "CallbackQuery",
+    "Chat",
+    "ChatAdministratorRights",
+    "ChatBackground",
+    "ChatBoost",
+    "ChatBoostAdded",
+    "ChatBoostRemoved",
+    "ChatBoostSource",
+    "ChatBoostSourceGiftCode",
+    "ChatBoostSourceGiveaway",
+    "ChatBoostSourcePremium",
+    "ChatBoostUpdated",
+    "ChatFullInfo",
+    "ChatInviteLink",
+    "ChatJoinRequest",
+    "ChatLocation",
+    "ChatMember",
+    "ChatMemberAdministrator",
+    "ChatMemberBanned",
+    "ChatMemberLeft",
+    "ChatMemberMember",
+    "ChatMemberOwner",
+    "ChatMemberRestricted",
+    "ChatMemberUpdated",
+    "ChatPermissions",
+    "ChatPhoto",
+    "ChatShared",
+    "ChosenInlineResult",
+    "Contact",
+    "Dice",
+    "Document",
+    "EncryptedCredentials",
+    "EncryptedPassportElement",
+    "ExternalReplyInfo",
+    "File",
+    "ForceReply",
+    "ForumTopic",
+    "ForumTopicClosed",
+    "ForumTopicCreated",
+    "ForumTopicEdited",
+    "ForumTopicReopened",
+    "Game",
+    "GameHighScore",
+    "GeneralForumTopicHidden",
+    "GeneralForumTopicUnhidden",
+    "Giveaway",
+    "GiveawayCompleted",
+    "GiveawayCreated",
+    "GiveawayWinners",
+    "InaccessibleMessage",
+    "InlineKeyboardButton",
+    "InlineKeyboardMarkup",
+    "InlineQuery",
+    "InlineQueryResult",
+    "InlineQueryResultArticle",
+    "InlineQueryResultAudio",
+    "InlineQueryResultCachedAudio",
+    "InlineQueryResultCachedDocument",
+    "InlineQueryResultCachedGif",
+    "InlineQueryResultCachedMpeg4Gif",
+    "InlineQueryResultCachedPhoto",
+    "InlineQueryResultCachedSticker",
+    "InlineQueryResultCachedVideo",
+    "InlineQueryResultCachedVoice",
+    "InlineQueryResultContact",
+    "InlineQueryResultDocument",
+    "InlineQueryResultGame",
+    "InlineQueryResultGif",
+    "InlineQueryResultLocation",
+    "InlineQueryResultMpeg4Gif",
+    "InlineQueryResultPhoto",
+    "InlineQueryResultVenue",
+    "InlineQueryResultVideo",
+    "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",
+    "MaybeInaccessibleMessage",
+    "MenuButton",
+    "MenuButtonCommands",
+    "MenuButtonDefault",
+    "MenuButtonWebApp",
+    "Message",
+    "MessageAutoDeleteTimerChanged",
+    "MessageEntity",
+    "MessageId",
+    "MessageOrigin",
+    "MessageOriginChannel",
+    "MessageOriginChat",
+    "MessageOriginHiddenUser",
+    "MessageOriginUser",
+    "MessageReactionCountUpdated",
+    "MessageReactionUpdated",
+    "Model",
+    "OrderInfo",
+    "PassportData",
+    "PassportElementError",
+    "PassportElementErrorDataField",
+    "PassportElementErrorFile",
+    "PassportElementErrorFiles",
+    "PassportElementErrorFrontSide",
+    "PassportElementErrorReverseSide",
+    "PassportElementErrorSelfie",
+    "PassportElementErrorTranslationFile",
+    "PassportElementErrorTranslationFiles",
+    "PassportElementErrorUnspecified",
+    "PassportFile",
+    "PhotoSize",
+    "Poll",
+    "PollAnswer",
+    "PollOption",
+    "PreCheckoutQuery",
+    "ProximityAlertTriggered",
+    "ReactionCount",
+    "ReactionType",
+    "ReactionTypeCustomEmoji",
+    "ReactionTypeEmoji",
+    "ReplyKeyboardMarkup",
+    "ReplyKeyboardRemove",
+    "ReplyParameters",
+    "ResponseParameters",
+    "SentWebAppMessage",
+    "SharedUser",
+    "ShippingAddress",
+    "ShippingOption",
+    "ShippingQuery",
+    "Sticker",
+    "StickerSet",
+    "Story",
+    "SuccessfulPayment",
+    "SwitchInlineQueryChosenChat",
+    "TextQuote",
+    "Update",
+    "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",
+)