pyjetra 1.0.0__tar.gz

pyjetra-1.0.0/AUTHORS.md

@@ -0,0 +1,12 @@
+# Authors & Contributors
+### [EN] Project Developer
+### [FA] توسعه‌دهنده پروژه
+
+* **Name / نام**: Ali VEX
+* **Email / ایمیل**: lyrdaadhrpyk802@gmail.com
+* **Jetra Profile / پروفایل جترا**: https://jetra.ir/UserBoT
+* **GitHub / گیت‌هاب**: https://github.com/lyrdaadhrpyk802-ux/pyjetra
+
+---
+*This library was built with passion for the Jetra community.*
+*این کتابخانه با عشق برای جامعه جترا ساخته شده است.*

pyjetra-1.0.0/LICENSE

@@ -0,0 +1,5 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction.

pyjetra-1.0.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: pyjetra
+Version: 1.0.0
+Summary: A modern, bilingual (Sync/Async) Python wrapper for the Jetra Bot API.
+Author-email: Ali VEX <lyrdaadhrpyk802@gmail.com>
+Project-URL: Homepage, https://github.com/lyrdaadhrpyk802-ux/pyjetra
+Project-URL: Documentation, https://github.com/lyrdaadhrpyk802-ux/pyjetra/blob/main/README.md
+Project-URL: Jetra, https://jetra.ir/UserBoT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: requests>=2.25.0
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: license-file
+
+# PyJetra Library
+### [EN] A Modern Python Wrapper for Jetra Bot API
+### [FA] یک کتابخانه مدرن پایتون برای API ربات جترا
+
+---
+
+## [EN] Features / [FA] امکانات
+* **Sync & Async Support** / پشتیبانی از Sync و Async
+* **State Management** / مدیریت وضعیت
+* **Advanced Filters** / فیلترهای پیشرفته
+* **Full Media Support** / پشتیبانی کامل از رسانه‌ها
+
+## [EN] Installation / [FA] نصب
+```bash
+pip install requests aiohttp
+```
+
+## [EN] Quick Start (Sync) / [FA] شروع سریع (همزمان)
+```python
+from pyjetra import JetraBot, CommandFilter
+
+bot = JetraBot('YOUR_TOKEN')
+
+@bot.on_message(filters=[CommandFilter('start')])
+def start(msg):
+    msg.reply('Hello from PyJetra!')
+
+bot.poll()
+```
+
+## [EN] Quick Start (Async) / [FA] شروع سریع (غیرهمزمان)
+```python
+from pyjetra import AsyncJetraBot, CommandFilter
+import asyncio
+
+bot = AsyncJetraBot('YOUR_TOKEN')
+
+@bot.on_message(filters=[CommandFilter('start')])
+async def start(msg):
+    await msg.reply('Hello Fast!')
+
+asyncio.run(bot.start_polling())
+```
+
+## [EN] Testing / [FA] تست کردن
+Navigate to the `tests/` folder and run the files.
+Read the comments inside each test file.
+
+## [EN] Developer / [FA] توسعه‌دهنده
+Created with ❤️ by Ali VEX
+GitHub: https://github.com/lyrdaadhrpyk802-ux

pyjetra-1.0.0/README.md

@@ -0,0 +1,51 @@
+# PyJetra Library
+### [EN] A Modern Python Wrapper for Jetra Bot API
+### [FA] یک کتابخانه مدرن پایتون برای API ربات جترا
+
+---
+
+## [EN] Features / [FA] امکانات
+* **Sync & Async Support** / پشتیبانی از Sync و Async
+* **State Management** / مدیریت وضعیت
+* **Advanced Filters** / فیلترهای پیشرفته
+* **Full Media Support** / پشتیبانی کامل از رسانه‌ها
+
+## [EN] Installation / [FA] نصب
+```bash
+pip install requests aiohttp
+```
+
+## [EN] Quick Start (Sync) / [FA] شروع سریع (همزمان)
+```python
+from pyjetra import JetraBot, CommandFilter
+
+bot = JetraBot('YOUR_TOKEN')
+
+@bot.on_message(filters=[CommandFilter('start')])
+def start(msg):
+    msg.reply('Hello from PyJetra!')
+
+bot.poll()
+```
+
+## [EN] Quick Start (Async) / [FA] شروع سریع (غیرهمزمان)
+```python
+from pyjetra import AsyncJetraBot, CommandFilter
+import asyncio
+
+bot = AsyncJetraBot('YOUR_TOKEN')
+
+@bot.on_message(filters=[CommandFilter('start')])
+async def start(msg):
+    await msg.reply('Hello Fast!')
+
+asyncio.run(bot.start_polling())
+```
+
+## [EN] Testing / [FA] تست کردن
+Navigate to the `tests/` folder and run the files.
+Read the comments inside each test file.
+
+## [EN] Developer / [FA] توسعه‌دهنده
+Created with ❤️ by Ali VEX
+GitHub: https://github.com/lyrdaadhrpyk802-ux

pyjetra-1.0.0/pyjetra/__init__.py

@@ -0,0 +1,12 @@
+from .client import JetraBot
+from .async_client import AsyncJetraBot
+from .exceptions import JetraError
+from .types import User, Chat, Message, CallbackQuery, InlineKeyboardMarkup, InlineKeyboardButton
+from .filters import CommandFilter, TextFilter
+from .dev_info import get_info, DEVELOPER_NAME, VERSION
+
+__all__ = [
+    "JetraBot", "AsyncJetraBot", "JetraError", "User", "Chat", "Message",
+    "CallbackQuery", "InlineKeyboardMarkup", "InlineKeyboardButton",
+    "CommandFilter", "TextFilter", "get_info", "DEVELOPER_NAME", "VERSION"
+]

pyjetra-1.0.0/pyjetra/async_client.py

@@ -0,0 +1,61 @@
+import aiohttp
+import asyncio
+from typing import List, Optional, Callable, Any
+from .exceptions import JetraError
+from .types import User, Message, CallbackQuery, InlineKeyboardMarkup
+
+class AsyncJetraBot:
+    def __init__(self, token: str):
+        self.token = token
+        self.base_url = f"https://jetra.ir/bot{token}/"
+        self._message_handlers = []
+        self._callback_handlers = []
+
+    async def _request(self, method: str, **params) -> Any:
+        async with aiohttp.ClientSession() as session:
+            async with session.post(self.base_url + method, json=params) as resp:
+                data = await resp.json()
+                if not data.get("ok"): raise JetraError(f"API Error: {data.get('description')}")
+                return data.get("result")
+
+    async def send_message(self, chat_id: int, text: str, reply_to_message_id: Optional[int] = None, reply_markup: Optional[InlineKeyboardMarkup] = None) -> dict:
+        params = {"chat_id": chat_id, "text": text}
+        if reply_to_message_id: params["reply_to_message_id"] = reply_to_message_id
+        if reply_markup: params["reply_markup"] = reply_markup.to_dict()
+        return await self._request("sendMessage", **params)
+
+    async def answer_callback_query(self, callback_query_id: str, text: Optional[str] = None, show_alert: bool = False) -> dict:
+        return await self._request("answerCallbackQuery", callback_query_id=callback_query_id, text=text, show_alert=show_alert)
+
+    async def get_updates(self, offset: int = 0) -> List[dict]:
+        return await self._request("getUpdates", offset=offset, timeout=30)
+
+    def on_message(self, func: Callable = None, filters: list = None):
+        def decorator(f):
+            self._message_handlers.append({"func": f, "filters": filters or []})
+            return f
+        return decorator(func) if func else decorator
+
+    def on_callback_query(self, func: Callable):
+        self._callback_handlers.append(func)
+        return func
+
+    async def start_polling(self):
+        print("Async Bot polling...")
+        offset = 0
+        while True:
+            try:
+                updates = await self.get_updates(offset)
+                for update in updates:
+                    offset = update["update_id"] + 1
+                    if "message" in update:
+                        msg = Message(update["message"], self)
+                        for handler in self._message_handlers:
+                            if all(f(msg) for f in handler["filters"]):
+                                await handler["func"](msg)
+                    elif "callback_query" in update:
+                        cb = CallbackQuery(update["callback_query"], self)
+                        for handler in self._callback_handlers:
+                            await handler(cb)
+            except Exception:
+                await asyncio.sleep(2)

pyjetra-1.0.0/pyjetra/client.py

@@ -0,0 +1,72 @@
+import requests
+import time
+from typing import List, Optional, Callable, Any
+from .exceptions import JetraError
+from .types import User, Message, CallbackQuery, InlineKeyboardMarkup
+
+class JetraBot:
+    def __init__(self, token: str):
+        self.token = token
+        self.base_url = f"https://jetra.ir/bot{token}/"
+        self.session = requests.Session()
+        self._message_handlers = []
+        self._callback_handlers = []
+        self._states = {}
+
+    def set_state(self, user_id, state): self._states[user_id] = state
+    def get_state(self, user_id): return self._states.get(user_id)
+    def clear_state(self, user_id):
+        if user_id in self._states: del self._states[user_id]
+
+    def _request(self, method: str, **params) -> Any:
+        url = self.base_url + method
+        try:
+            response = self.session.post(url, json=params, timeout=30)
+            data = response.json()
+            if not data.get("ok"): raise JetraError(f"API Error: {data.get('description')}")
+            return data.get("result")
+        except requests.exceptions.ReadTimeout: return []
+        except Exception as e: raise JetraError(f"Network Error: {e}")
+
+    def send_message(self, chat_id: int, text: str, reply_to_message_id: Optional[int] = None, reply_markup: Optional[InlineKeyboardMarkup] = None) -> dict:
+        params = {"chat_id": chat_id, "text": text}
+        if reply_to_message_id: params["reply_to_message_id"] = reply_to_message_id
+        if reply_markup: params["reply_markup"] = reply_markup.to_dict()
+        return self._request("sendMessage", **params)
+
+    def answer_callback_query(self, callback_query_id: str, text: Optional[str] = None, show_alert: bool = False) -> dict:
+        params = {"callback_query_id": callback_query_id, "text": text, "show_alert": show_alert}
+        return self._request("answerCallbackQuery", **params)
+
+    def get_updates(self, offset: int = 0) -> List[dict]:
+        return self._request("getUpdates", offset=offset, timeout=30)
+
+    def on_message(self, func: Callable = None, filters: list = None):
+        def decorator(f):
+            self._message_handlers.append({"func": f, "filters": filters or []})
+            return f
+        return decorator(func) if func else decorator
+
+    def on_callback_query(self, func: Callable):
+        self._callback_handlers.append(func)
+        return func
+
+    def poll(self):
+        print("Bot polling...")
+        offset = 0
+        while True:
+            try:
+                updates = self.get_updates(offset)
+                for update in updates:
+                    offset = update["update_id"] + 1
+                    if "message" in update:
+                        msg = Message(update["message"], self)
+                        for handler in self._message_handlers:
+                            if all(f(msg) for f in handler["filters"]):
+                                handler["func"](msg)
+                    elif "callback_query" in update:
+                        cb = CallbackQuery(update["callback_query"], self)
+                        for handler in self._callback_handlers:
+                            handler(cb)
+            except Exception:
+                time.sleep(2)

pyjetra-1.0.0/pyjetra/dev_info.py

@@ -0,0 +1,11 @@
+# [EN] Developer Information
+# [FA] مشخصات توسعه‌دهنده
+
+DEVELOPER_NAME = "Ali VEX"
+DEVELOPER_EMAIL = "lyrdaadhrpyk802@gmail.com"
+JETRA_LINK = "https://jetra.ir/UserBoT"
+GITHUB_URL = "https://github.com/lyrdaadhrpyk802-ux/pyjetra"
+VERSION = "1.0.0"
+
+def get_info():
+    return f"PyJetra v{VERSION} | Developed by {DEVELOPER_NAME} | {GITHUB_URL}"

pyjetra-1.0.0/pyjetra/exceptions.py

@@ -0,0 +1,2 @@
+class JetraError(Exception):
+    pass

pyjetra-1.0.0/pyjetra/filters.py

@@ -0,0 +1,16 @@
+class Filter:
+    def __call__(self, message): return True
+
+class CommandFilter(Filter):
+    def __init__(self, commands):
+        self.commands = commands if isinstance(commands, list) else [commands]
+    def __call__(self, message):
+        if not message.text: return False
+        cmd = message.text.split()[0].lower()
+        return cmd in [f"/{c}" for c in self.commands]
+
+class TextFilter(Filter):
+    def __init__(self, text):
+        self.text = text
+    def __call__(self, message):
+        return bool(message.text and message.text.lower() == self.text.lower())

pyjetra-1.0.0/pyjetra/types/__init__.py

@@ -0,0 +1,7 @@
+from .user import User
+from .chat import Chat
+from .message import Message
+from .callback import CallbackQuery
+from .markup import InlineKeyboardMarkup, InlineKeyboardButton
+
+__all__ = ["User", "Chat", "Message", "CallbackQuery", "InlineKeyboardMarkup", "InlineKeyboardButton"]

pyjetra-1.0.0/pyjetra/types/callback.py

@@ -0,0 +1,21 @@
+from typing import Optional
+from .user import User
+from .message import Message
+
+class CallbackQuery:
+    def __init__(self, data: dict, bot_instance):
+        self.id = data.get("id")
+        self.from_user = None
+        if "from" in data:
+            u = data["from"]
+            self.from_user = User(
+                id=u.get("id", 0), is_bot=u.get("is_bot", False),
+                first_name=u.get("first_name", ""), last_name=u.get("last_name"),
+                username=u.get("username")
+            )
+        self.data = data.get("data")
+        self.message = Message(data["message"], bot_instance) if "message" in data else None
+        self._bot = bot_instance
+
+    def answer(self, text: Optional[str] = None, show_alert: bool = False):
+        return self._bot.answer_callback_query(self.id, text, show_alert)

pyjetra-1.0.0/pyjetra/types/chat.py

@@ -0,0 +1,11 @@
+from dataclasses import dataclass
+from typing import Optional
+
+@dataclass
+class Chat:
+    id: int
+    type: str
+    title: Optional[str] = None
+    first_name: Optional[str] = None
+    last_name: Optional[str] = None
+    username: Optional[str] = None

pyjetra-1.0.0/pyjetra/types/markup.py

@@ -0,0 +1,18 @@
+from typing import List, Optional
+
+class InlineKeyboardButton:
+    def __init__(self, text: str, callback_data: Optional[str] = None, url: Optional[str] = None):
+        self.text = text
+        self.callback_data = callback_data
+        self.url = url
+    def to_dict(self) -> dict:
+        data = {"text": self.text}
+        if self.callback_data: data["callback_data"] = self.callback_data
+        if self.url: data["url"] = self.url
+        return data
+
+class InlineKeyboardMarkup:
+    def __init__(self, inline_keyboard: List[List[InlineKeyboardButton]]):
+        self.inline_keyboard = inline_keyboard
+    def to_dict(self) -> dict:
+        return {"inline_keyboard": [[btn.to_dict() for btn in row] for row in self.inline_keyboard]}

pyjetra-1.0.0/pyjetra/types/message.py

@@ -0,0 +1,30 @@
+from typing import Optional, TYPE_CHECKING
+from .user import User
+from .chat import Chat
+
+class Message:
+    def __init__(self, data: dict, bot_instance):
+        self.message_id = data.get("message_id")
+        chat_data = data.get("chat", {})
+        self.chat = Chat(
+            id=chat_data.get("id", 0), type=chat_data.get("type", "private"),
+            title=chat_data.get("title"), first_name=chat_data.get("first_name"),
+            last_name=chat_data.get("last_name"), username=chat_data.get("username")
+        )
+        self.text = data.get("text")
+        self.caption = data.get("caption")
+        self.raw = data
+        self._bot = bot_instance
+        
+        user_data = data.get("from")
+        if user_data:
+            self.from_user = User(
+                id=user_data.get("id", 0), is_bot=user_data.get("is_bot", False),
+                first_name=user_data.get("first_name", ""), last_name=user_data.get("last_name"),
+                username=user_data.get("username")
+            )
+        else:
+            self.from_user = None
+
+    def reply(self, text: str, reply_markup: Optional['InlineKeyboardMarkup'] = None):
+        return self._bot.send_message(self.chat.id, text, reply_to_message_id=self.message_id, reply_markup=reply_markup)

pyjetra-1.0.0/pyjetra/types/user.py

@@ -0,0 +1,10 @@
+from dataclasses import dataclass
+from typing import Optional
+
+@dataclass
+class User:
+    id: int
+    is_bot: bool
+    first_name: str
+    last_name: Optional[str] = None
+    username: Optional[str] = None

pyjetra-1.0.0/pyjetra.egg-info/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: pyjetra
+Version: 1.0.0
+Summary: A modern, bilingual (Sync/Async) Python wrapper for the Jetra Bot API.
+Author-email: Ali VEX <lyrdaadhrpyk802@gmail.com>
+Project-URL: Homepage, https://github.com/lyrdaadhrpyk802-ux/pyjetra
+Project-URL: Documentation, https://github.com/lyrdaadhrpyk802-ux/pyjetra/blob/main/README.md
+Project-URL: Jetra, https://jetra.ir/UserBoT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: requests>=2.25.0
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: license-file
+
+# PyJetra Library
+### [EN] A Modern Python Wrapper for Jetra Bot API
+### [FA] یک کتابخانه مدرن پایتون برای API ربات جترا
+
+---
+
+## [EN] Features / [FA] امکانات
+* **Sync & Async Support** / پشتیبانی از Sync و Async
+* **State Management** / مدیریت وضعیت
+* **Advanced Filters** / فیلترهای پیشرفته
+* **Full Media Support** / پشتیبانی کامل از رسانه‌ها
+
+## [EN] Installation / [FA] نصب
+```bash
+pip install requests aiohttp
+```
+
+## [EN] Quick Start (Sync) / [FA] شروع سریع (همزمان)
+```python
+from pyjetra import JetraBot, CommandFilter
+
+bot = JetraBot('YOUR_TOKEN')
+
+@bot.on_message(filters=[CommandFilter('start')])
+def start(msg):
+    msg.reply('Hello from PyJetra!')
+
+bot.poll()
+```
+
+## [EN] Quick Start (Async) / [FA] شروع سریع (غیرهمزمان)
+```python
+from pyjetra import AsyncJetraBot, CommandFilter
+import asyncio
+
+bot = AsyncJetraBot('YOUR_TOKEN')
+
+@bot.on_message(filters=[CommandFilter('start')])
+async def start(msg):
+    await msg.reply('Hello Fast!')
+
+asyncio.run(bot.start_polling())
+```
+
+## [EN] Testing / [FA] تست کردن
+Navigate to the `tests/` folder and run the files.
+Read the comments inside each test file.
+
+## [EN] Developer / [FA] توسعه‌دهنده
+Created with ❤️ by Ali VEX
+GitHub: https://github.com/lyrdaadhrpyk802-ux

pyjetra-1.0.0/pyjetra.egg-info/SOURCES.txt

@@ -0,0 +1,26 @@
+AUTHORS.md
+LICENSE
+README.md
+pyproject.toml
+pyjetra/__init__.py
+pyjetra/async_client.py
+pyjetra/client.py
+pyjetra/dev_info.py
+pyjetra/exceptions.py
+pyjetra/filters.py
+pyjetra.egg-info/PKG-INFO
+pyjetra.egg-info/SOURCES.txt
+pyjetra.egg-info/dependency_links.txt
+pyjetra.egg-info/requires.txt
+pyjetra.egg-info/top_level.txt
+pyjetra/types/__init__.py
+pyjetra/types/callback.py
+pyjetra/types/chat.py
+pyjetra/types/markup.py
+pyjetra/types/message.py
+pyjetra/types/user.py
+tests/test_advanced_buttons.py
+tests/test_async.py
+tests/test_error_handling.py
+tests/test_registration_fsm.py
+tests/test_sync.py

pyjetra-1.0.0/pyjetra.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyjetra-1.0.0/pyjetra.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.25.0
+aiohttp>=3.8.0

pyjetra-1.0.0/pyjetra.egg-info/top_level.txt

@@ -0,0 +1 @@
+pyjetra

pyjetra-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyjetra"
+version = "1.0.0"
+authors = [
+    {name = "Ali VEX", email = "lyrdaadhrpyk802@gmail.com"}
+]
+description = "A modern, bilingual (Sync/Async) Python wrapper for the Jetra Bot API."
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "requests>=2.25.0",
+    "aiohttp>=3.8.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/lyrdaadhrpyk802-ux/pyjetra"
+Documentation = "https://github.com/lyrdaadhrpyk802-ux/pyjetra/blob/main/README.md"
+Jetra = "https://jetra.ir/UserBoT"

pyjetra-1.0.0/setup.cfg

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

pyjetra-1.0.0/tests/test_advanced_buttons.py

@@ -0,0 +1,44 @@
+# [EN] Test for multi-level Inline Keyboards and Callback Parsing.
+# [FA] تست برای کیبوردهای شیشه‌ای چند سطحی و پردازش کلیک‌ها.
+# How to run: python tests/test_advanced_buttons.py
+# Send /menu in the bot chat.
+
+import sys, os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+from pyjetra import JetraBot, CommandFilter, InlineKeyboardMarkup, InlineKeyboardButton
+
+BOT_TOKEN = "1780246392:3W4m3UParm6nelq3mS2HmjtgV6_pWiIfCj8"
+bot = JetraBot(BOT_TOKEN)
+
+@bot.on_message(filters=[CommandFilter("menu")])
+def show_menu(msg):
+    kb = InlineKeyboardMarkup([
+        [InlineKeyboardButton("Settings ⚙️", callback_data="settings")],
+        [InlineKeyboardButton("Help ❓", callback_data="help")]
+    ])
+    msg.reply("Main Menu:", reply_markup=kb)
+
+@bot.on_callback_query()
+def handle_click(cb):
+    if cb.data == "settings":
+        cb.answer("Opening settings...")
+        kb = InlineKeyboardMarkup([
+            [InlineKeyboardButton("Language 🌐", callback_data="lang")],
+            [InlineKeyboardButton("Back 🔙", callback_data="back")]
+        ])
+        # Editing the message to show the sub-menu
+        bot.edit_message_text(cb.message.chat.id, cb.message.message_id, "Settings Menu:", reply_markup=kb)
+    
+    elif cb.data == "back":
+        cb.answer("Going back...")
+        kb = InlineKeyboardMarkup([
+            [InlineKeyboardButton("Settings ⚙️", callback_data="settings")],
+            [InlineKeyboardButton("Help ❓", callback_data="help")]
+        ])
+        bot.edit_message_text(cb.message.chat.id, cb.message.message_id, "Main Menu:", reply_markup=kb)
+
+    elif cb.data == "help":
+        cb.answer("Help is on the way!", show_alert=True)
+
+if __name__ == "__main__":
+    bot.poll()

pyjetra-1.0.0/tests/test_async.py

@@ -0,0 +1,15 @@
+import sys, os, asyncio
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+from pyjetra import AsyncJetraBot, CommandFilter
+
+BOT_TOKEN = "1780246392:3W4m3UParm6nelq3mS2HmjtgV6_pWiIfCj8"
+bot = AsyncJetraBot(BOT_TOKEN)
+
+@bot.on_message(filters=[CommandFilter("start")])
+async def start_handler(msg):
+    await msg.reply("Async Bot is working at lightning speed!")
+    print("Received /start in Async mode.")
+
+if __name__ == "__main__":
+    print("Starting Async Test...")
+    asyncio.run(bot.start_polling())

pyjetra-1.0.0/tests/test_error_handling.py

@@ -0,0 +1,24 @@
+# [EN] Test how the library handles API errors gracefully.
+# [FA] تست اینکه کتابخانه چگونه خطاهای API را مدیریت می‌کند.
+# How to run: python tests/test_error_handling.py
+# Send /error in the bot chat.
+
+import sys, os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+from pyjetra import JetraBot, CommandFilter, JetraError
+
+BOT_TOKEN = "1780246392:3W4m3UParm6nelq3mS2HmjtgV6_pWiIfCj8"
+bot = JetraBot(BOT_TOKEN)
+
+@bot.on_message(filters=[CommandFilter("error")])
+def trigger_error(msg):
+    try:
+        # Trying to send a message to an invalid Chat ID (999999999)
+        bot.send_message(999999999, "This will fail!")
+    except JetraError as e:
+        # Catch the error and inform the user
+        msg.reply(f"Successfully caught an error: {e}")
+        print(f"Error logged: {e}")
+
+if __name__ == "__main__":
+    bot.poll()

pyjetra-1.0.0/tests/test_registration_fsm.py

@@ -0,0 +1,34 @@
+# [EN] Test for State Management (FSM) - A step-by-step registration.
+# [FA] تست برای مدیریت وضعیت (FSM) - یک ثبت‌نام مرحله به مرحله.
+# How to run: python tests/test_registration_fsm.py
+# Send /register in the bot chat.
+
+import sys, os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+from pyjetra import JetraBot, CommandFilter
+
+BOT_TOKEN = "1780246392:3W4m3UParm6nelq3mS2HmjtgV6_pWiIfCj8"
+bot = JetraBot(BOT_TOKEN)
+
+@bot.on_message(filters=[CommandFilter("register")])
+def start_registration(msg):
+    bot.set_state(msg.from_user.id, "waiting_for_name")
+    msg.reply("Welcome! Please type your name:")
+
+@bot.on_message()
+def handle_steps(msg):
+    if not msg.text or msg.text.startswith("/"):
+        return
+
+    state = bot.get_state(msg.from_user.id)
+    
+    if state == "waiting_for_name":
+        bot.set_state(msg.from_user.id, "waiting_for_age")
+        msg.reply(f"Nice to meet you, {msg.text}! How old are you?")
+        
+    elif state == "waiting_for_age":
+        bot.clear_state(msg.from_user.id)
+        msg.reply(f"You are {msg.text} years old. Registration complete! ✅")
+
+if __name__ == "__main__":
+    bot.poll()

pyjetra-1.0.0/tests/test_sync.py

@@ -0,0 +1,15 @@
+import sys, os
+sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+from pyjetra import JetraBot, CommandFilter
+
+BOT_TOKEN = "1780246392:3W4m3UParm6nelq3mS2HmjtgV6_pWiIfCj8"
+bot = JetraBot(BOT_TOKEN)
+
+@bot.on_message(filters=[CommandFilter("start")])
+def start_handler(msg):
+    msg.reply("Sync Bot is working perfectly!")
+    print("Received /start in Sync mode.")
+
+if __name__ == "__main__":
+    print("Starting Sync Test...")
+    bot.poll()