pyrobale 0.3.5__py3-none-any.whl → 0.3.7__py3-none-any.whl

pyrobale/objects/__init__.py

@@ -1,3 +1,6 @@
+"""# objects in pyrobale, we have a lot of objects that are used to represent
+different types of data."""
+
 from .voice import Voice
 from .replykeyboardmarkup import ReplyKeyboardMarkup
 from .inputmedias import (

pyrobale/objects/callbackquery.py

@@ -1,13 +1,4 @@
-from typing import TYPE_CHECKING, Optional
-
-if TYPE_CHECKING:
-    from .user import User
-    from .message import Message
-    from ..client import Client
-
-from .user import User
-from .message import Message
-from .chat import Chat
+from typing import Optional
 
 
 class CallbackQuery:
@@ -16,27 +7,31 @@ class CallbackQuery:
     def __init__(
         self,
         id: Optional[str] = None,
-        user: Optional["User"] = None,
-        message: Optional["Message"] = None,
+        user: Optional[dict] = None,
+        message: Optional[dict] = None,
         data: Optional[str] = None,
         **kwargs
     ):
         self.id = id
-        self.user: "User" = User(**user) if user else None
-        self.message: "Message" = Message(**message) if message else None
-        self.chat: "Chat" = self.message.chat if self.message else None
+        self.user = None
+        self.message = None
+        self.chat = None
         self.data = data if data else None
-        self.bot: "Client" = kwargs.get("kwargs", {}).get("client", None)
+        self.bot = kwargs.get("kwargs", {}).get("client", None)
 
-    async def answer(
-        self, text: Optional[str] = None, show_alert: bool = False
-    ) -> bool:
-        """Sends a response to the callback query.
+        if user:
+            from .user import User
 
-        :param text: The text of the response.
+            self.user = User(**user)
 
-        :param show_alert: Whether to show an alert to the user.
+        if message:
+            from .message import Message
 
-        :return: true if the response was sent successfully.
-        """
+            self.message = Message(**message)
+            self.chat = self.message.chat if self.message else None
+
+    async def answer(
+        self, text: Optional[str] = None, show_alert: bool = False
+    ) -> bool:
+        """Sends a response to the callback query."""
         return await self.bot.answer_callback_query(self.id, text, show_alert)

pyrobale/objects/chatmember.py

@@ -4,10 +4,10 @@ from typing import Optional, Union
 if TYPE_CHECKING:
     from .utils import build_api_url
     from .user import User
+    from ..client import Client
 from .chat import Chat
 from .user import User
 from .enums import ChatType
-from ..client import Client
 
 
 class ChatMember:
@@ -79,8 +79,8 @@ class ChatMember:
         """Bans the chat member from the chat.
 
         :param chat_id: The ID of the chat.
-
-        :return: True if the member was banned successfully, False otherwise.
+        :return: True if the member was banned successfully, False
+            otherwise.
         """
         data = await self.chat.ban(self.user.id)
         return data
@@ -88,7 +88,8 @@ class ChatMember:
     async def unban(self) -> bool:
         """Unbans the chat member from the chat.
 
-        :return: True if the member was unbanned successfully, False otherwise.
+        :return: True if the member was unbanned successfully, False
+            otherwise.
         """
         data = await self.chat.unban(self.user.id)
         return data

pyrobale/objects/enums.py

@@ -10,6 +10,19 @@ class UpdatesTypes(Enum):
     PRE_CHECKOUT_QUERY = "pre_checkout_query"
     MEMBER_JOINED = "member_joined"
     MEMBER_LEFT = "member_left"
+    SUCCESSFUL_PAYMENT = "successful_payment"
+
+
+class Filters(Enum):
+    """Filters that you can use in handlers"""
+
+    TEXT = "text"
+    PHOTO = "photo"
+    VIDEO = "video"
+    AUDIO = "audio"
+    VOICE = "voice"
+    CONTACT = "contact"
+    LOCATION = "location"
 
 
 class ChatAction(Enum):
@@ -18,6 +31,9 @@ class ChatAction(Enum):
     TYPING = "typing"
     PHOTO = "upload_photo"
     VIDEO = "upload_video"
+    REVORDVIDEO = "record_video"
+    VOICE = "upload_voice"
+    DOCUMENT = "upload_document"
 
 
 class ChatType(Enum):

pyrobale/objects/message.py

@@ -24,8 +24,7 @@ if TYPE_CHECKING:
     from ..client import Client
 from ..objects.chat import Chat
 from ..objects.user import User
-import asyncio
-import aiohttp
+from ..objects.inlinekeyboardmarkup import InlineKeyboardMarkup
 
 
 class Message:
@@ -126,7 +125,9 @@ class Message:
             **kwargs: Additional keyword arguments
         """
         self.id: int = message_id
-        self.user: "User" = User(**from_user) if from_user else None
+        self.user: "User" = (
+            User(**from_user, kwargs={"client": self.client}) if from_user else None
+        )
         self.date: int = date
         self.chat: Optional["Chat"] = (
             chat if isinstance(chat, Chat) else Chat(**chat) if chat else None
@@ -168,13 +169,16 @@ class Message:
         """
         if self.chat and self.chat.id:
             await self.client.send_message(
-                self.chat.id, text, reply_markup=reply_markup
+                self.chat.id,
+                text,
+                reply_to_message_id=self.id,
+                reply_markup=reply_markup,
             )
 
     async def edit(
         self,
         text: str,
-        reply_markup: Union["ReplyKeyboardMarkup", "InlineKeyboardMarkup"] = None,
+        reply_markup: Optional[InlineKeyboardMarkup] = None,
     ):
         """Edit the current message text.
 
@@ -216,7 +220,11 @@ class Message:
         """
         if self.chat and self.chat.id:
             await self.client.send_photo(
-                self.chat.id, photo=photo, caption=caption, reply_markup=reply_markup
+                self.chat.id,
+                photo=photo,
+                caption=caption,
+                reply_to_message_id=self.id,
+                reply_markup=reply_markup,
             )
 
     async def reply_video(
@@ -234,7 +242,11 @@ class Message:
         """
         if self.chat and self.chat.id:
             await self.client.send_video(
-                self.chat.id, video=video, caption=caption, reply_markup=reply_markup
+                self.chat.id,
+                video=video,
+                caption=caption,
+                reply_to_message_id=self.id,
+                reply_markup=reply_markup,
             )
 
     async def reply_audio(
@@ -252,7 +264,11 @@ class Message:
         """
         if self.chat and self.chat.id:
             await self.client.send_audio(
-                self.chat.id, audio=audio, caption=caption, reply_markup=reply_markup
+                self.chat.id,
+                audio=audio,
+                caption=caption,
+                reply_to_message_id=self.id,
+                reply_markup=reply_markup,
             )
 
     async def reply_document(
@@ -273,6 +289,7 @@ class Message:
                 self.chat.id,
                 document=document,
                 caption=caption,
+                reply_to_message_id=self.id,
                 reply_markup=reply_markup,
             )
 
@@ -310,6 +327,7 @@ class Message:
                 self.chat.id,
                 latitude=latitude,
                 longitude=longitude,
+                reply_to_message_id=self.id,
                 reply_markup=reply_markup,
             )
 
@@ -331,6 +349,7 @@ class Message:
                 self.chat.id,
                 phone_number=phone_number,
                 first_name=first_name,
+                reply_to_message_id=self.id,
                 reply_markup=reply_markup,
             )
 

pyrobale/objects/user.py

@@ -1,20 +1,22 @@
-from typing import Optional, Union
-from .utils import build_api_url
-import asyncio
-import aiohttp
+from typing import Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..client import Client
 
 
 class User:
     def __init__(
         self,
-        id: int,
-        is_bot: bool,
-        first_name: str,
-        last_name: Optional[str],
-        username: Optional[str],
+        id: int = None,
+        is_bot: bool = None,
+        first_name: str = None,
+        last_name: Optional[str] = None,
+        username: Optional[str] = None,
+        **kwargs
     ):
         self.id = id
         self.is_bot = is_bot
         self.first_name = first_name
         self.last_name = last_name
         self.username = username
+        self.client: Optional["Client"] = kwargs.get("client", None)

pyrobale/objects/utils.py

@@ -1,4 +1,3 @@
-import asyncio
 import aiohttp
 
 

pyrobale-0.3.7.dist-info/METADATA

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: pyrobale
+Version: 0.3.7
+Summary: A python wrapper for bale api
+Project-URL: github, https://github.com/pyrobale/pyrobale
+Project-URL: website, https://pyrobale.github.io
+Author-email: Ali Safamanesh <darg.q.a.a@gmail.com>, Aydin Rahbaran <codewizaard9@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 Ali Safamanesh
+        
+        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, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Requires-Dist: aiohttp
+Description-Content-Type: text/markdown
+
+![pyrobaletext](https://raw.githubusercontent.com/pyrobale/pyrobale/refs/heads/main/pyrobaletext.png)
+
+# Bale Bot API Python Library
+
+A modern, easy-to-use Python wrapper for the Bale Bot API that makes building Bale bots simple and intuitive.
+
+## Features
+
+- 🚀 **Simple & Intuitive** - Clean, Pythonic API design
+- 📨 **Full Message Support** - Text, photos, videos, documents, and more
+- ⌨️ **Interactive Elements** - Inline keyboards, reply keyboards, and buttons
+- 🔄 **Real-time Updates** - Webhook and polling support
+- 📁 **File Handling** - Easy upload and download of media files
+- 🛡️ **Error Handling** - Comprehensive exception handling
+- 📖 **Type Hints** - Full typing support for better development experience
+- ⚡ **Async Support** - Both synchronous and asynchronous operations
+
+## Installation
+
+```bash
+pip install pyrobale
+```
+
+## Quick Start
+
+```python
+from pyrobale.client import Client
+from pyrobale.objects import Message, UpdatesTypes
+
+bot = Client("YOUR_BOT_TOKEN")
+
+@bot.on_message()
+async def message_handler(message: User):
+    await message.reply("Hello, world!")
+
+bot.run()
+```
+
+## Examples
+
+### Conversation Bot
+```python
+from pyrobale.objects import *
+from pyrobale.client import Client, Message, UpdatesTypes
+import asyncio
+
+client = Client("YOUR_BOT_TOKEN")
+
+async def handle_message(message: Message):
+    if message.text == "/start":
+        await message.reply("سلام! من یک ربات PyRoBale هستم!")
+        await client.wait_for(UpdatesTypes.MESSAGE)
+        await message.reply("Okay! wait_for Test Compeleted")
+
+client.add_handler(UpdatesTypes.MESSAGE, handle_message)
+
+client.run()
+```
+
+### Echo Bot
+```python
+from pyrobale.client import Client
+from pyrobale.objects import Message, UpdatesTypes
+
+bot = Client("YOUR_BOT_TOKEN")
+
+@bot.on_message()
+async def message_handler(message: Message):
+    await message.reply(message.text)
+
+bot.run()
+```
+
+### Inline Keyboard
+```python
+from pyrobale.client import Client
+from pyrobale.objects import Message, UpdatesTypes, InlineKeyboardButton, InlineKeyboardMarkup, CopyTextButton
+
+bot = Client("YOUR_BOT_TOKEN")
+async def message_handler(message: Message):
+    buttons = InlineKeyboardMarkup()
+    buttons.add_button("URL", url="https://google.com")
+    buttons.add_button("Callback", callback_data="callback")
+    buttons.add_row()
+    buttons.add_button("WebApp", web_app="https://daradege.ir")
+    buttons.add_button("Copy", copy_text_button=CopyTextButton("TEXT"))
+    await message.reply("Hello, world!", reply_markup=buttons)
+```
+
+
+## Core Abilities
+
+- **Message Handling** - Process text, commands, and media messages
+- **Callback Queries** - Handle inline keyboard interactions
+- **File Operations** - Send and receive photos, videos, documents
+- **Chat Management** - Get chat info, member management
+- **Custom Keyboards** - Create interactive user interfaces
+- **Webhook Support** - Production-ready webhook handling
+- **Middleware Support** - Add custom processing layers
+
+## Documentation
+
+For detailed documentation and advanced usage, visit our [documentation site](https://pyrobale.readthedocs.io).
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 📖 [Documentation](https://pyrobale.readthedocs.io)
+- 🐛 [Issue Tracker](https://github.com/pyrobale/pyrobale/issues)
+- 💬 [Discussions](https://github.com/pyrobale/pyrobale/discussions)

{pyrobale-0.3.5.dist-info → pyrobale-0.3.7.dist-info}/RECORD

@@ -1,18 +1,19 @@
-pyrobale/__init__.py,sha256=JHnoAuKziwl7pysBJLpmXDN4YoKeDXhiL6joscEFh_Y,78
-pyrobale/client/__init__.py,sha256=ehsCuqAVpJuXzwolZCCcySHZZJawqNT-yr2LIgP52II,21104
+pyrobale/__init__.py,sha256=h5jjU9rJHxzD3V7nBzKQDXskmtlQKbTNROUm_kO8Olw,3620
+pyrobale/StateMachine/__init__.py,sha256=StMaUqpvJw_ViywGO0c-NRKcglpWyZxg-2kEkqgGG8o,1213
+pyrobale/client/__init__.py,sha256=V2SqIOf52iXQxRF1oc2KQib0oX8BMETbUm9oLAO4beo,41447
 pyrobale/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pyrobale/exceptions/common.py,sha256=waAfMFzCsrDr9lS11N0Yzs2v1BX_2ucwV15K1Dq9tYA,159
-pyrobale/objects/__init__.py,sha256=cQP_MKQH4WeJPjhQHt864jUFEBw7jOwIh2w5pCUbbUE,2132
+pyrobale/objects/__init__.py,sha256=uy0xBJc5d-1TnlPD6CgxAaUjBnIvQs-GuAgLeEKoXSQ,2239
 pyrobale/objects/animation.py,sha256=jpM9V8AOaGLWkcENTDmsxKf57Abf-MArYBLfU6GwkD0,978
 pyrobale/objects/audio.py,sha256=q14wz5WpC3SgKZkAlH-D9M554RYQNDwuCT2z7v7IZYU,696
-pyrobale/objects/callbackquery.py,sha256=VlogbysCpdPjAIvrF6CvcJeSUco4WKPXjrvUprEaF1g,1281
+pyrobale/objects/callbackquery.py,sha256=jALmTVXU6tc6OppTTrhGERCzugzazYrT39AhhGE-UeI,1018
 pyrobale/objects/chat.py,sha256=gQ1wpmB63Ot51aeSBAiWzbw9lFgCpJjlm9hlYNBQJ88,16566
-pyrobale/objects/chatmember.py,sha256=CyoX4R4vkNoPjki7U4tgslmEc51g1nn9Q7tUyPeHa58,6868
+pyrobale/objects/chatmember.py,sha256=IyAGmuZZ5HlJVYjrfXEKbLoNc7etMytrK-gOeKKo0CU,6895
 pyrobale/objects/chatphoto.py,sha256=vOb5xzpr3oBiCloi2_ufBnVlUfmcPqSTmMMMTTBYdJo,533
 pyrobale/objects/contact.py,sha256=6LDxT5RoGbY5Tsw64lg5-jvKSRmmvOiIJha1HqdTaG4,411
 pyrobale/objects/copytextbutton.py,sha256=CbFWeY9Ebor7dnHJpQUMB1zYhJWl7b5a2T_cdmo1qQ0,134
 pyrobale/objects/document.py,sha256=cI9_McPzySNKZaQmOma9eX75a3YsyzkVrLvUBDIuwsA,661
-pyrobale/objects/enums.py,sha256=O7n5ErPGuhGMd-JdOgJvCqV5q5ukZ2xNsUb0RoEtboA,554
+pyrobale/objects/enums.py,sha256=EPTKrc_ueAY_KinaVMu9ZQLCSj1VoUjHHCn1p9bjf0A,912
 pyrobale/objects/file.py,sha256=4PBfjouP0knd1vFDNs7mx_jwBoDQVBKS7ESjzF4Y6E8,360
 pyrobale/objects/inlinekeyboardbutton.py,sha256=w4HehdisD7RQodS66gG-DJjaf0gO2U-6wYaVXaatTN8,617
 pyrobale/objects/inlinekeyboardmarkup.py,sha256=shNpYUT25EqT0PQFa-c1tEma_6mJIpBwXQ0IqcTGg4M,2887
@@ -22,7 +23,7 @@ pyrobale/objects/invoice.py,sha256=hI225mtsSSV7fYre6aFHp-o1NxUT8MLugJAD6NfAeIs,3
 pyrobale/objects/keyboardbutton.py,sha256=J7c1ma7swjk3zkgcD7vnMdIMsBGExicmbm1bnP_puzU,459
 pyrobale/objects/labeledprice.py,sha256=d-fbOLzpkBslfor13BXGeVoySKCcSxsXY4QVwub2Z9o,228
 pyrobale/objects/location.py,sha256=w_9sRJRntLpNbn8Jk6JhRJVVigD9Bd4BxbjFyglxWhU,143
-pyrobale/objects/message.py,sha256=5mtVEsC6j8LkwW834IHTEl4AGvoFbKDURjAAV6YUP3E,14094
+pyrobale/objects/message.py,sha256=cKN7gCJNm55E8tLU7wyITOy4_irqGmFUl4UTu2107pk,14657
 pyrobale/objects/messageid.py,sha256=DrWKV8y9m9H8G_Fj68KgiJKwDJOGduNJGJ-Dyn8N580,95
 pyrobale/objects/photosize.py,sha256=I4hnmi46uoU-cW7hPN_tTT9kn0u80BtG5QJ3uRjoUiE,298
 pyrobale/objects/precheckoutquery.py,sha256=Rtjh1qqRc9TRZMJU1W5r0B8y7K5dayLMXX6WH9h1Ul4,470
@@ -31,13 +32,13 @@ pyrobale/objects/sticker.py,sha256=yLzWAm1fikMVISExdCG0R-rVu1_M31LLw6sHt0sBehE,3
 pyrobale/objects/stickerset.py,sha256=xlSdlnb5TCzI_MCkB_bJsZPgELVevbO7R3BAYN2jIt8,269
 pyrobale/objects/successfulpayment.py,sha256=aEAApcd60dByqPw253jEifG_CVsbLYiphB1ep3CEm2E,502
 pyrobale/objects/update.py,sha256=cDR9hpcC8r4bJjixgMQD84Dg_-8ZrlZq1HninVVVDuQ,716
-pyrobale/objects/user.py,sha256=PDPJGq89PARg6Ha38FR1N4ZanpbSMpI_siXh5ZHfsvg,437
-pyrobale/objects/utils.py,sha256=WVR6eTXbVzTZeNPgb_qNEyGv7ctppTsuAL2c5x48ljo,861
+pyrobale/objects/user.py,sha256=uCvG3k7rIbGP73fFQt_uy7-shS-BRWAL2aEcCEZWyWY,554
+pyrobale/objects/utils.py,sha256=2ZghxTTjVOUru06Ka_qOjn8U1PvM37-GJ6X1toaovCI,846
 pyrobale/objects/video.py,sha256=DuZMGHio_w8yQvi87Vc3XpJOpEaltkM4_bNRSeocPZo,509
 pyrobale/objects/voice.py,sha256=ZdsJFH2IsBwelEk4rb4oZfX9xrfJ2_DgfjsMc0e4Tmg,148
 pyrobale/objects/webappdata.py,sha256=QlZlCa8Mylt8VmcdgdoHeyita5CVnz2WsT1yueEY1tY,78
 pyrobale/objects/webappinfo.py,sha256=qnTvfNqx91Yzbc1gO5y4XQ3w6g0RpMUqMuF5wk_EZMc,75
-pyrobale-0.3.5.dist-info/METADATA,sha256=Z_bbIivEemBz3HVdg0-X0ObOp4im-VRF1KABsveI7C4,4214
-pyrobale-0.3.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-pyrobale-0.3.5.dist-info/licenses/LICENSE,sha256=F8U4JY2aXNJspsrcVW0zf6watzK22FMPTF3NkS36tss,1070
-pyrobale-0.3.5.dist-info/RECORD,,
+pyrobale-0.3.7.dist-info/METADATA,sha256=yrnMA_qlgmJsudQHqs0xUA9rHZld8lY7pj6zEqmtc48,5319
+pyrobale-0.3.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pyrobale-0.3.7.dist-info/licenses/LICENSE,sha256=F8U4JY2aXNJspsrcVW0zf6watzK22FMPTF3NkS36tss,1070
+pyrobale-0.3.7.dist-info/RECORD,,

pyrobale-0.3.5.dist-info/METADATA

@@ -1,176 +0,0 @@
-Metadata-Version: 2.4
-Name: pyrobale
-Version: 0.3.5
-Summary: A python wrapper for bale api
-Project-URL: github, https://github.com/pyrobale/pyrobale
-Project-URL: website, https://pyrobale.github.io
-Author-email: Ali Safamanesh <darg.q.a.a@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2025 Ali Safamanesh
-        
-        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, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-License-File: LICENSE
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-
-![pyrobaletext](https://raw.githubusercontent.com/pyrobale/pyrobale/refs/heads/main/pyrobaletext.png)
-
-# Bale Bot API Python Library
-
-A Python wrapper for the Bale Bot API that makes it easy to build Bale bots.
-
-## Features
-
-- Full Bale Bot API support
-- Object-oriented design
-- Easy-to-use interface
-- Support for:
-  - Messages
-  - Photos
-  - Documents
-  - Audio
-  - Video
-  - Voice messages
-  - Location
-  - Contact sharing
-  - Inline keyboards
-  - Menu keyboards
-  - Callback queries
-  - Chat administration
-  - Payment system
-  - Database integration
-
-## Installation
-
-``pip install pyrobale``
-
-## Quick Start
-
-```py
-from bale import Client, MenuKeyboardMarkup, MenuKeyboardButton
-
-# Initialize bot with token
-bot = Client("YOUR_BOT_TOKEN")
-
-# Handle incoming messages
-@bot.on_message
-def handle_message(message):
-    if message.text == "/start":
-        # Create keyboard
-        keyboard = MenuKeyboardMarkup()
-        keyboard.add(MenuKeyboardButton("Hello!"))
-  
-        # Send welcome message
-        message.reply_message("Welcome!", reply_markup=keyboard)
-
-# Start the bot
-bot.run()
-```
-
-## Key Components
-
-### Client
-
-The main class for interacting with Bale API. Handles all API requests and provides event decorators.
-
-### Message
-
-Represents a message in Bale with methods for replying, editing, and deleting messages.
-
-### User
-
-Represents a Bale user with their properties and methods.
-
-### Chat
-
-Represents a chat conversation with methods for sending messages and managing chat settings.
-
-### Keyboards
-
-- `MenuKeyboardMarkup`: For creating text keyboards
-- `InlineKeyboardMarkup`: For creating inline keyboards
-
-### Database
-
-Built-in SQLite database support for storing persistent data.
-
-## Event Handlers
-
-# Message handler
-
-```python
-@bot.on_message
-def handle_message(message):
-    pass
-```
-
-# Callback query handler
-
-```python
-@bot.on_callback_query
-def handle_callback(callback):
-    pass
-```
-
-# Periodic task handler
-
-```python
-@bot.on_tick(60)  # Runs every 60 seconds
-def handle_tick():
-    pass
-```
-
-# Ready event handler
-
-```python
-@bot.on_ready
-def handle_ready():
-    pass
-```
-
-# Member join handler
-
-```python
-@bot.on_member_chat_join
-def handle_join(message, chat, user):
-    pass
-```
-
-# Member leave handler
-
-```python
-@bot.on_member_chat_leave
-def handle_leave(message, chat, user):
-    pass
-```
-
-## Database Usage
-
-# Access database
-
-```py
-with bot.database as db:
-    db.write_key("user_123", {"points": 100})
-  
-    data = db.read_key("user_123")
-```