teleflow-sdk 0.0.1__tar.gz

teleflow_sdk-0.0.1/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: teleflow-sdk
+Version: 0.0.1
+Summary: A lightweight and elegant Telegram Bot SDK in Python
+Author-email: Armen <kazaryanarmen71@gmail.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests==2.34.2

teleflow_sdk-0.0.1/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "teleflow-sdk"
+version = "0.0.1"
+description = "A lightweight and elegant Telegram Bot SDK in Python"
+readme = "README.md"
+authors = [{ name = "Armen", email = "kazaryanarmen71@gmail.com" }]
+license = { text = "MIT" }
+dependencies = [
+    "requests==2.34.2"
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.8"

teleflow_sdk-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

teleflow_sdk-0.0.1/teleflow/__init__.py

@@ -0,0 +1,12 @@
+from .bot import TelegramBot
+from .router import EventRouter
+from .exceptions import TelegramAPIError, TelegramNetworkError, TelegramBadRequestError, TelegramUnauthorizedError
+
+__all__ = [
+    "TelegramBot",
+    "EventRouter",
+    "TelegramAPIError",
+    "TelegramNetworkError",
+    "TelegramBadRequestError",
+    "TelegramUnauthorizedError",
+]

teleflow_sdk-0.0.1/teleflow/bot.py

@@ -0,0 +1,128 @@
+import requests
+import json
+import time
+import datetime
+from .exceptions import TelegramBadRequestError, TelegramUnauthorizedError, TelegramNetworkError, TelegramAPIError
+from .methods.get_updates import get_updates
+from .methods import __all__ as all_methods
+
+class MethodsProxy:
+    def __init__(self, bot: 'TelegramBot'):
+        self._bot = bot
+        from . import methods
+        for method_name in all_methods:
+            method_func = getattr(methods, method_name)
+            setattr(self, method_name, lambda *args, func=method_func, **kwargs: func(self._bot, *args, **kwargs))
+
+class TelegramBot:
+    def __init__(self, token: str):
+        self.token = token
+        self.base_url = f"https://api.telegram.org/bot{token}"
+        self.file_url = f"https://api.telegram.org/file/bot{token}"
+        self.session = requests.Session()
+        self.methods = MethodsProxy(self)
+
+    def request(self, method_name: str, params: dict | None = None, files: dict | None = None) -> dict:
+        url = f"{self.base_url}/{method_name}"
+        if params:
+            cleaned_params = {}
+            for k, v in params.items():
+                if v is not None:
+                    if hasattr(v, 'to_dict'):
+                        v = v.to_dict()
+                    elif isinstance(v, list):
+                        v = [i.to_dict() if hasattr(i, 'to_dict') else i for i in v]
+
+                    if isinstance(v, (dict, list)):
+                        v = json.dumps(v)
+
+                    original_key = k[:-1] if k.endswith('_') and k[:-1] in ['from', 'photo', 'video', 'document', 'audio', 'sticker', 'animation', 'voice'] else k
+                    cleaned_params[original_key] = v
+            params = cleaned_params
+        
+        try:
+            response = self.session.post(url, data=params, files=files, timeout=60)
+        except requests.RequestException as e:
+            raise TelegramNetworkError(f"Network error during request to {method_name}: {e}")
+
+        try:
+            data = response.json()
+        except ValueError:
+            raise TelegramAPIError("Received an invalid JSON response from the Telegram server.")
+
+        if not data.get("ok", False):
+            error_code = data.get("error_code")
+            description = data.get("description", "Unknown error")
+            
+            if error_code == 401:
+                raise TelegramUnauthorizedError(f"Authorization error: {description}", error_code)
+            elif error_code == 400:
+                raise TelegramBadRequestError(f"Bad request: {description}", error_code)
+            else:
+                raise TelegramAPIError(f"API error [{error_code}]: {description}", error_code)
+
+        return data.get("result")
+
+    def download_file(self, file_path: str, destination_path: str) -> None:
+        url = f"{self.file_url}/{file_path}"
+        try:
+            response = self.session.get(url, stream=True, timeout=60)
+            if response.status_code == 200:
+                with open(destination_path, 'wb') as f:
+                    for chunk in response.iter_content(chunk_size=8192):
+                        f.write(chunk)
+            else:
+                raise TelegramAPIError(f"Failed to download file. Status code: {response.status_code}")
+        except requests.RequestException as e:
+            raise TelegramNetworkError(f"Network error while downloading file: {e}")
+
+    def start_polling(self, router, interval: float = 1.0) -> None:
+        offset = 0
+
+        startup_time = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+        bot_name = "Bot"
+
+        try:
+            me = self.methods.get_me()
+
+            if isinstance(me, dict):
+                bot_name = f"@{me.get('username')}" if me.get('username') else me.get('first_name', 'Bot')
+            elif me:
+                username = getattr(me, "username", None)
+                first_name = getattr(me, "first_name", None)
+                bot_name = f"@{username}" if username else (first_name or "Bot")
+        except Exception:
+            pass
+
+        print(
+            f"\n"
+            f"┌────────────────────────────────────────┐\n"
+            f"│            🤖 TELEFLOW SDK             │\n"
+            f"├────────────────────────────────────────┤\n"
+            f"│  Bot:      {bot_name:<27} │\n"
+            f"│  Status:   🟢 Polling Active           │\n"
+            f"│  Started:  {startup_time}         │\n"
+            f"└────────────────────────────────────────┘\n"
+            f"  (Press Ctrl+C to stop the bot)\n"
+        )
+
+        while True:
+            try:
+                updates = self.methods.get_updates(offset=offset, timeout=30)
+                if updates:
+                    for update in updates:
+                        if isinstance(update, dict):
+                            offset = update.get("update_id", offset) + 1
+                            router.feed(update)
+                        else:
+                            offset = getattr(update, "update_id", offset) + 1
+                            if hasattr(update, 'to_dict'):
+                                router.feed(update.to_dict())
+                            else:
+                                router.feed(update)
+            except KeyboardInterrupt:
+                print("Polling stopped by user.")
+                break
+            except Exception as e:
+                print(f"Polling error: {e}")
+            time.sleep(interval)

teleflow_sdk-0.0.1/teleflow/exceptions.py

@@ -0,0 +1,17 @@
+class TelegramAPIError(Exception):
+    """Base exception for Telegram Bot API errors."""
+    def __init__(self, message: str, error_code: int | None = None):
+        super().__init__(message)
+        self.error_code = error_code
+
+class TelegramNetworkError(TelegramAPIError):
+    """Network errors or timeouts during API requests."""
+    pass
+
+class TelegramBadRequestError(TelegramAPIError):
+    """Error 400: Bad request or parameters."""
+    pass
+
+class TelegramUnauthorizedError(TelegramAPIError):
+    """Error 401: Invalid bot token."""
+    pass

teleflow_sdk-0.0.1/teleflow/methods/__init__.py

@@ -0,0 +1,373 @@
+from .get_updates import get_updates
+from .set_webhook import set_webhook
+from .delete_webhook import delete_webhook
+from .get_webhook_info import get_webhook_info
+from .get_me import get_me
+from .log_out import log_out
+from .close import close
+from .send_message import send_message
+from .forward_message import forward_message
+from .forward_messages import forward_messages
+from .copy_message import copy_message
+from .copy_messages import copy_messages
+from .send_photo import send_photo
+from .send_live_photo import send_live_photo
+from .send_audio import send_audio
+from .send_document import send_document
+from .send_video import send_video
+from .send_animation import send_animation
+from .send_voice import send_voice
+from .send_video_note import send_video_note
+from .send_paid_media import send_paid_media
+from .send_media_group import send_media_group
+from .send_location import send_location
+from .send_venue import send_venue
+from .send_contact import send_contact
+from .send_poll import send_poll
+from .send_checklist import send_checklist
+from .send_dice import send_dice
+from .send_message_draft import send_message_draft
+from .send_chat_action import send_chat_action
+from .set_message_reaction import set_message_reaction
+from .get_user_profile_photos import get_user_profile_photos
+from .get_user_profile_audios import get_user_profile_audios
+from .set_user_emoji_status import set_user_emoji_status
+from .get_file import get_file
+from .ban_chat_member import ban_chat_member
+from .unban_chat_member import unban_chat_member
+from .restrict_chat_member import restrict_chat_member
+from .promote_chat_member import promote_chat_member
+from .set_chat_administrator_custom_title import set_chat_administrator_custom_title
+from .set_chat_member_tag import set_chat_member_tag
+from .ban_chat_sender_chat import ban_chat_sender_chat
+from .unban_chat_sender_chat import unban_chat_sender_chat
+from .set_chat_permissions import set_chat_permissions
+from .export_chat_invite_link import export_chat_invite_link
+from .create_chat_invite_link import create_chat_invite_link
+from .edit_chat_invite_link import edit_chat_invite_link
+from .create_chat_subscription_invite_link import create_chat_subscription_invite_link
+from .edit_chat_subscription_invite_link import edit_chat_subscription_invite_link
+from .revoke_chat_invite_link import revoke_chat_invite_link
+from .approve_chat_join_request import approve_chat_join_request
+from .decline_chat_join_request import decline_chat_join_request
+from .answer_chat_join_request_query import answer_chat_join_request_query
+from .send_chat_join_request_web_app import send_chat_join_request_web_app
+from .set_chat_photo import set_chat_photo
+from .delete_chat_photo import delete_chat_photo
+from .set_chat_title import set_chat_title
+from .set_chat_description import set_chat_description
+from .pin_chat_message import pin_chat_message
+from .unpin_chat_message import unpin_chat_message
+from .unpin_all_chat_messages import unpin_all_chat_messages
+from .leave_chat import leave_chat
+from .get_chat import get_chat
+from .get_chat_administrators import get_chat_administrators
+from .get_chat_member_count import get_chat_member_count
+from .get_chat_member import get_chat_member
+from .get_user_personal_chat_messages import get_user_personal_chat_messages
+from .set_chat_sticker_set import set_chat_sticker_set
+from .delete_chat_sticker_set import delete_chat_sticker_set
+from .get_forum_topic_icon_stickers import get_forum_topic_icon_stickers
+from .create_forum_topic import create_forum_topic
+from .edit_forum_topic import edit_forum_topic
+from .close_forum_topic import close_forum_topic
+from .reopen_forum_topic import reopen_forum_topic
+from .delete_forum_topic import delete_forum_topic
+from .unpin_all_forum_topic_messages import unpin_all_forum_topic_messages
+from .edit_general_forum_topic import edit_general_forum_topic
+from .close_general_forum_topic import close_general_forum_topic
+from .reopen_general_forum_topic import reopen_general_forum_topic
+from .hide_general_forum_topic import hide_general_forum_topic
+from .unhide_general_forum_topic import unhide_general_forum_topic
+from .unpin_all_general_forum_topic_messages import unpin_all_general_forum_topic_messages
+from .answer_callback_query import answer_callback_query
+from .answer_guest_query import answer_guest_query
+from .get_user_chat_boosts import get_user_chat_boosts
+from .get_business_connection import get_business_connection
+from .get_managed_bot_token import get_managed_bot_token
+from .replace_managed_bot_token import replace_managed_bot_token
+from .get_managed_bot_access_settings import get_managed_bot_access_settings
+from .set_managed_bot_access_settings import set_managed_bot_access_settings
+from .set_my_commands import set_my_commands
+from .delete_my_commands import delete_my_commands
+from .get_my_commands import get_my_commands
+from .set_my_name import set_my_name
+from .get_my_name import get_my_name
+from .set_my_description import set_my_description
+from .get_my_description import get_my_description
+from .set_my_short_description import set_my_short_description
+from .get_my_short_description import get_my_short_description
+from .set_my_profile_photo import set_my_profile_photo
+from .remove_my_profile_photo import remove_my_profile_photo
+from .set_chat_menu_button import set_chat_menu_button
+from .get_chat_menu_button import get_chat_menu_button
+from .set_my_default_administrator_rights import set_my_default_administrator_rights
+from .get_my_default_administrator_rights import get_my_default_administrator_rights
+from .get_available_gifts import get_available_gifts
+from .send_gift import send_gift
+from .gift_premium_subscription import gift_premium_subscription
+from .verify_user import verify_user
+from .verify_chat import verify_chat
+from .remove_user_verification import remove_user_verification
+from .remove_chat_verification import remove_chat_verification
+from .read_business_message import read_business_message
+from .delete_business_messages import delete_business_messages
+from .set_business_account_name import set_business_account_name
+from .set_business_account_username import set_business_account_username
+from .set_business_account_bio import set_business_account_bio
+from .set_business_account_profile_photo import set_business_account_profile_photo
+from .remove_business_account_profile_photo import remove_business_account_profile_photo
+from .set_business_account_gift_settings import set_business_account_gift_settings
+from .get_business_account_star_balance import get_business_account_star_balance
+from .transfer_business_account_stars import transfer_business_account_stars
+from .get_business_account_gifts import get_business_account_gifts
+from .get_user_gifts import get_user_gifts
+from .get_chat_gifts import get_chat_gifts
+from .convert_gift_to_stars import convert_gift_to_stars
+from .upgrade_gift import upgrade_gift
+from .transfer_gift import transfer_gift
+from .post_story import post_story
+from .repost_story import repost_story
+from .edit_story import edit_story
+from .delete_story import delete_story
+from .answer_web_app_query import answer_web_app_query
+from .save_prepared_inline_message import save_prepared_inline_message
+from .save_prepared_keyboard_button import save_prepared_keyboard_button
+from .edit_message_text import edit_message_text
+from .edit_message_caption import edit_message_caption
+from .edit_message_media import edit_message_media
+from .edit_message_live_location import edit_message_live_location
+from .stop_message_live_location import stop_message_live_location
+from .edit_message_checklist import edit_message_checklist
+from .edit_message_reply_markup import edit_message_reply_markup
+from .stop_poll import stop_poll
+from .edit_ephemeral_message_text import edit_ephemeral_message_text
+from .edit_ephemeral_message_media import edit_ephemeral_message_media
+from .edit_ephemeral_message_caption import edit_ephemeral_message_caption
+from .edit_ephemeral_message_reply_markup import edit_ephemeral_message_reply_markup
+from .approve_suggested_post import approve_suggested_post
+from .decline_suggested_post import decline_suggested_post
+from .delete_message import delete_message
+from .delete_messages import delete_messages
+from .delete_ephemeral_message import delete_ephemeral_message
+from .delete_message_reaction import delete_message_reaction
+from .delete_all_message_reactions import delete_all_message_reactions
+from .send_sticker import send_sticker
+from .get_sticker_set import get_sticker_set
+from .get_custom_emoji_stickers import get_custom_emoji_stickers
+from .upload_sticker_file import upload_sticker_file
+from .create_new_sticker_set import create_new_sticker_set
+from .add_sticker_to_set import add_sticker_to_set
+from .set_sticker_position_in_set import set_sticker_position_in_set
+from .delete_sticker_from_set import delete_sticker_from_set
+from .replace_sticker_in_set import replace_sticker_in_set
+from .set_sticker_emoji_list import set_sticker_emoji_list
+from .set_sticker_keywords import set_sticker_keywords
+from .set_sticker_mask_position import set_sticker_mask_position
+from .set_sticker_set_title import set_sticker_set_title
+from .set_sticker_set_thumbnail import set_sticker_set_thumbnail
+from .set_custom_emoji_sticker_set_thumbnail import set_custom_emoji_sticker_set_thumbnail
+from .delete_sticker_set import delete_sticker_set
+from .send_rich_message import send_rich_message
+from .send_rich_message_draft import send_rich_message_draft
+from .answer_inline_query import answer_inline_query
+from .send_invoice import send_invoice
+from .create_invoice_link import create_invoice_link
+from .answer_shipping_query import answer_shipping_query
+from .answer_pre_checkout_query import answer_pre_checkout_query
+from .get_my_star_balance import get_my_star_balance
+from .get_star_transactions import get_star_transactions
+from .refund_star_payment import refund_star_payment
+from .edit_user_star_subscription import edit_user_star_subscription
+from .set_passport_data_errors import set_passport_data_errors
+from .send_game import send_game
+from .set_game_score import set_game_score
+from .get_game_high_scores import get_game_high_scores
+
+__all__ = [
+    'get_updates',
+    'set_webhook',
+    'delete_webhook',
+    'get_webhook_info',
+    'get_me',
+    'log_out',
+    'close',
+    'send_message',
+    'forward_message',
+    'forward_messages',
+    'copy_message',
+    'copy_messages',
+    'send_photo',
+    'send_live_photo',
+    'send_audio',
+    'send_document',
+    'send_video',
+    'send_animation',
+    'send_voice',
+    'send_video_note',
+    'send_paid_media',
+    'send_media_group',
+    'send_location',
+    'send_venue',
+    'send_contact',
+    'send_poll',
+    'send_checklist',
+    'send_dice',
+    'send_message_draft',
+    'send_chat_action',
+    'set_message_reaction',
+    'get_user_profile_photos',
+    'get_user_profile_audios',
+    'set_user_emoji_status',
+    'get_file',
+    'ban_chat_member',
+    'unban_chat_member',
+    'restrict_chat_member',
+    'promote_chat_member',
+    'set_chat_administrator_custom_title',
+    'set_chat_member_tag',
+    'ban_chat_sender_chat',
+    'unban_chat_sender_chat',
+    'set_chat_permissions',
+    'export_chat_invite_link',
+    'create_chat_invite_link',
+    'edit_chat_invite_link',
+    'create_chat_subscription_invite_link',
+    'edit_chat_subscription_invite_link',
+    'revoke_chat_invite_link',
+    'approve_chat_join_request',
+    'decline_chat_join_request',
+    'answer_chat_join_request_query',
+    'send_chat_join_request_web_app',
+    'set_chat_photo',
+    'delete_chat_photo',
+    'set_chat_title',
+    'set_chat_description',
+    'pin_chat_message',
+    'unpin_chat_message',
+    'unpin_all_chat_messages',
+    'leave_chat',
+    'get_chat',
+    'get_chat_administrators',
+    'get_chat_member_count',
+    'get_chat_member',
+    'get_user_personal_chat_messages',
+    'set_chat_sticker_set',
+    'delete_chat_sticker_set',
+    'get_forum_topic_icon_stickers',
+    'create_forum_topic',
+    'edit_forum_topic',
+    'close_forum_topic',
+    'reopen_forum_topic',
+    'delete_forum_topic',
+    'unpin_all_forum_topic_messages',
+    'edit_general_forum_topic',
+    'close_general_forum_topic',
+    'reopen_general_forum_topic',
+    'hide_general_forum_topic',
+    'unhide_general_forum_topic',
+    'unpin_all_general_forum_topic_messages',
+    'answer_callback_query',
+    'answer_guest_query',
+    'get_user_chat_boosts',
+    'get_business_connection',
+    'get_managed_bot_token',
+    'replace_managed_bot_token',
+    'get_managed_bot_access_settings',
+    'set_managed_bot_access_settings',
+    'set_my_commands',
+    'delete_my_commands',
+    'get_my_commands',
+    'set_my_name',
+    'get_my_name',
+    'set_my_description',
+    'get_my_description',
+    'set_my_short_description',
+    'get_my_short_description',
+    'set_my_profile_photo',
+    'remove_my_profile_photo',
+    'set_chat_menu_button',
+    'get_chat_menu_button',
+    'set_my_default_administrator_rights',
+    'get_my_default_administrator_rights',
+    'get_available_gifts',
+    'send_gift',
+    'gift_premium_subscription',
+    'verify_user',
+    'verify_chat',
+    'remove_user_verification',
+    'remove_chat_verification',
+    'read_business_message',
+    'delete_business_messages',
+    'set_business_account_name',
+    'set_business_account_username',
+    'set_business_account_bio',
+    'set_business_account_profile_photo',
+    'remove_business_account_profile_photo',
+    'set_business_account_gift_settings',
+    'get_business_account_star_balance',
+    'transfer_business_account_stars',
+    'get_business_account_gifts',
+    'get_user_gifts',
+    'get_chat_gifts',
+    'convert_gift_to_stars',
+    'upgrade_gift',
+    'transfer_gift',
+    'post_story',
+    'repost_story',
+    'edit_story',
+    'delete_story',
+    'answer_web_app_query',
+    'save_prepared_inline_message',
+    'save_prepared_keyboard_button',
+    'edit_message_text',
+    'edit_message_caption',
+    'edit_message_media',
+    'edit_message_live_location',
+    'stop_message_live_location',
+    'edit_message_checklist',
+    'edit_message_reply_markup',
+    'stop_poll',
+    'edit_ephemeral_message_text',
+    'edit_ephemeral_message_media',
+    'edit_ephemeral_message_caption',
+    'edit_ephemeral_message_reply_markup',
+    'approve_suggested_post',
+    'decline_suggested_post',
+    'delete_message',
+    'delete_messages',
+    'delete_ephemeral_message',
+    'delete_message_reaction',
+    'delete_all_message_reactions',
+    'send_sticker',
+    'get_sticker_set',
+    'get_custom_emoji_stickers',
+    'upload_sticker_file',
+    'create_new_sticker_set',
+    'add_sticker_to_set',
+    'set_sticker_position_in_set',
+    'delete_sticker_from_set',
+    'replace_sticker_in_set',
+    'set_sticker_emoji_list',
+    'set_sticker_keywords',
+    'set_sticker_mask_position',
+    'set_sticker_set_title',
+    'set_sticker_set_thumbnail',
+    'set_custom_emoji_sticker_set_thumbnail',
+    'delete_sticker_set',
+    'send_rich_message',
+    'send_rich_message_draft',
+    'answer_inline_query',
+    'send_invoice',
+    'create_invoice_link',
+    'answer_shipping_query',
+    'answer_pre_checkout_query',
+    'get_my_star_balance',
+    'get_star_transactions',
+    'refund_star_payment',
+    'edit_user_star_subscription',
+    'set_passport_data_errors',
+    'send_game',
+    'set_game_score',
+    'get_game_high_scores',
+]

teleflow_sdk-0.0.1/teleflow/methods/add_sticker_to_set.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..objects.input_sticker import InputSticker
+    from ..bot import TelegramBot
+
+def add_sticker_to_set(bot: TelegramBot, user_id: int, name: str, sticker_: InputSticker) -> bool:
+    """Use this method to add a new sticker to a set created by the bot. Emoji sticker sets can have up to 200 stickers. Other sticker sets can have up to 120 stickers. Returns True on success."""
+    payload = {
+        'user_id': user_id,
+        'name': name,
+    }
+    files = {
+        'sticker': sticker_,
+    }
+    files = {k: v for k, v in files.items() if v is not None}
+    return bot.request('addStickerToSet', payload, files=files if files else None)

teleflow_sdk-0.0.1/teleflow/methods/answer_callback_query.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..bot import TelegramBot
+
+def answer_callback_query(bot: TelegramBot, callback_query_id: str, text: str | None = None, show_alert: bool | None = None, url: str | None = None, cache_time: int | None = None) -> bool:
+    """Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned."""
+    payload = {
+        'callback_query_id': callback_query_id,
+        'text': text,
+        'show_alert': show_alert,
+        'url': url,
+        'cache_time': cache_time,
+    }
+    return bot.request('answerCallbackQuery', payload)

teleflow_sdk-0.0.1/teleflow/methods/answer_chat_join_request_query.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..bot import TelegramBot
+
+def answer_chat_join_request_query(bot: TelegramBot, chat_join_request_query_id: str, result: str) -> bool:
+    """Use this method to process a received chat join request query. Returns True on success."""
+    payload = {
+        'chat_join_request_query_id': chat_join_request_query_id,
+        'result': result,
+    }
+    return bot.request('answerChatJoinRequestQuery', payload)

teleflow_sdk-0.0.1/teleflow/methods/answer_guest_query.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..objects.inline_query_result import InlineQueryResult
+    from ..objects.sent_guest_message import SentGuestMessage
+    from ..bot import TelegramBot
+
+def answer_guest_query(bot: TelegramBot, guest_query_id: str, result: InlineQueryResult) -> SentGuestMessage:
+    """Use this method to reply to a received guest message. On success, a SentGuestMessage object is returned."""
+    payload = {
+        'guest_query_id': guest_query_id,
+        'result': result,
+    }
+    return bot.request('answerGuestQuery', payload)

teleflow_sdk-0.0.1/teleflow/methods/answer_inline_query.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..objects.inline_query_result import InlineQueryResult
+    from ..objects.inline_query_results_button import InlineQueryResultsButton
+    from ..bot import TelegramBot
+
+def answer_inline_query(bot: TelegramBot, inline_query_id: str, results: list[InlineQueryResult], cache_time: int | None = None, is_personal: bool | None = None, next_offset: str | None = None, button: InlineQueryResultsButton | None = None) -> bool:
+    """Use this method to send answers to an inline query. On success, True is returned. No more than 50 results per query are allowed."""
+    payload = {
+        'inline_query_id': inline_query_id,
+        'results': results,
+        'cache_time': cache_time,
+        'is_personal': is_personal,
+        'next_offset': next_offset,
+        'button': button,
+    }
+    return bot.request('answerInlineQuery', payload)

teleflow_sdk-0.0.1/teleflow/methods/answer_pre_checkout_query.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..bot import TelegramBot
+
+def answer_pre_checkout_query(bot: TelegramBot, pre_checkout_query_id: str, ok: bool, error_message: str | None = None) -> bool:
+    """Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmation in the form of an Update with the field pre_checkout_query. Use this method to respond to such pre-checkout queries. On success, True is returned. Note: The Bot API must receive an answer within 10 seconds after the pre-checkout query was sent."""
+    payload = {
+        'pre_checkout_query_id': pre_checkout_query_id,
+        'ok': ok,
+        'error_message': error_message,
+    }
+    return bot.request('answerPreCheckoutQuery', payload)