pyrobale 0.3.5__tar.gz → 0.3.7__tar.gz

pyrobale-0.3.7/.github/ISSUE_TEMPLATE/issue-template-/342/204/271/357/270/217.md

@@ -0,0 +1,64 @@
+---
+name: Issue template ℹ️
+about: Report any issue here
+title: Issue Title
+labels: ''
+assignees: Daradege, Code-Wizaard
+
+---
+
+### 🐞 Issue Type
+
+Please select one:
+
+- [ ] Bug Report
+- [ ] Feature Request
+- [ ] Documentation Improvement
+- [ ] Question / Help Needed
+
+---
+
+### 📌 Description
+
+<!-- Clearly describe the issue, suggestion, or question -->
+
+Example:  
+When using `send_file` with a relative path, it raises `FileNotFoundError` even though the file exists.
+
+---
+
+### 🔁 Steps to Reproduce (For Bugs)
+
+1. ...
+2. ...
+3. ...
+4. ...
+
+---
+
+### ✅ Expected Behavior
+
+<!-- What did you expect to happen? -->
+
+---
+
+### 📎 Environment Info
+
+- Python version: e.g., `3.11`
+- Operating System: e.g., `Linux Mint 21.3 KDE`
+- PyroBale version: e.g., `0.2.1`
+- Internet connection / proxy info: e.g., `Direct, no proxy`
+
+---
+
+### 📝 Code Sample (If Applicable)
+
+```python
+# Include a minimal reproducible code sample if relevant
+````
+
+---
+
+### 🙏 Additional Notes
+
+<!-- Any extra notes, thanks, or related info -->

pyrobale-0.3.7/.github/workflows/docs.yml

@@ -0,0 +1,38 @@
+name: Build and Deploy Docs
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          pip install pdoc aiohttp
+
+      - name: Generate documentation
+        run: |
+          pdoc pyrobale --output-dir docs --docformat google
+
+      - name: Deploy to docs branch
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          deploy_key: ${{ secrets.DOCS_DEPLOY_KEY }}
+          external_repository: pyrobale/docs
+          publish_branch: docs
+          publish_dir: ./docs
+          commit_message: "Auto-generate docs from ${{ github.sha }}"

pyrobale-0.3.7/PKG-INFO

@@ -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.7/README.md

@@ -0,0 +1,117 @@
+![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.7/examples/echo_bot.py

@@ -0,0 +1,10 @@
+from pyrobale.client import Client
+from pyrobale.objects import Message, UpdatesTypes
+
+client = Client("YOUR_BOT_TOKEN")
+
+@client.on_message()
+async def message_handler(message: Message):
+    await message.reply(message.text)
+
+client.run()

pyrobale-0.3.7/examples/handler_system.py

@@ -0,0 +1,11 @@
+from ..pyrobale.client import Client
+from ..pyrobale.objects import Message, UpdatesTypes
+
+client = Client("YOUR_BOT_TOKEN")
+
+async def message_handler(message: Message):
+    await message.reply("Hello, world!")
+
+client.add_handler(UpdatesTypes.MESSAGE, message_handler)
+
+client.run()

pyrobale-0.3.7/examples/inline_keyboard.py

@@ -0,0 +1,20 @@
+from pyrobale.client import Client
+from pyrobale.objects import Message, UpdatesTypes, CallbackQuery
+from pyrobale.objects import InlineKeyboardButton, InlineKeyboardMarkup, CopyTextButton
+
+client = Client("YOUR_BOT_TOKEN")
+
+@client.on_message()
+async def message_handler(message: Message):
+    buttons = InlineKeyboardMarkup()
+    buttons.add_button("Callback", callback_data="callback_data")
+    buttons.add_button("Copy Text", copy_text=CopyTextButton("Hello, world!"))
+    buttons.add_button("URL", url="https://www.google.com")
+    buttons.add_button("WebApp", web_app="https://daradege.ir")
+    await message.reply("These are Inline Buttons!", reply_markup=buttons)
+
+@client.on_callback_query()
+async def callback_handler(callback_query: CallbackQuery):
+    await callback_query.answer("Callback Query Received!", show_alert=True)
+
+client.run()

{pyrobale-0.3.5 → pyrobale-0.3.7}/pyproject.toml

@@ -1,8 +1,9 @@
 [project]
 name = "pyrobale"
-version = "0.3.5"
+version = "0.3.7"
 authors = [
     { name = "Ali Safamanesh", email = "darg.q.a.a@gmail.com" },
+    { name = "Aydin Rahbaran", email = "codewizaard9@gmail.com"},
 ]
 description = "A python wrapper for bale api"
 readme = "README.md"
@@ -13,7 +14,7 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 license = { file = "LICENSE" }
-
+dependencies = ["aiohttp"]
 [project.urls]
 github = "https://github.com/pyrobale/pyrobale"
 website = "https://pyrobale.github.io"

pyrobale-0.3.7/pyrobale/StateMachine/__init__.py

@@ -0,0 +1,45 @@
+from typing import Union, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..objects import User
+    from ..client import Client
+
+
+class StateMachine:
+    def __init__(self):
+        self.__states = {}
+
+    def set_state(self, user_id: Union[str, int], state: str):
+        """Sets or updates state of a user
+
+        Args:
+            user_id (string OR integer): unique id of user for setting the state
+            state (string): state of user (it can be anything)
+        """
+        self.__states[user_id] = state
+
+    def get_state(self, user_id: Union[str, int]) -> str:
+        """Gets state of a specified user
+
+        Args:
+            user_id (string OR integer): unique id of user for getting the state
+
+        Returns:
+            Str: the state of user
+        """
+
+        if user_id in self.__states:
+            return self.__states[user_id]
+        else:
+            raise KeyError
+
+    def del_state(self, user_id: Union[str, int]):
+        """Deletes the saved state of user
+
+        Args:
+            user_id (string OR integer): unique if of user to delete its state
+        """
+        if user_id in self.__states:
+            del self.__states[user_id]
+        else:
+            raise KeyError

pyrobale-0.3.7/pyrobale/__init__.py

@@ -0,0 +1,123 @@
+"""
+![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)
+"""
+
+from .objects.utils import *
+from .exceptions import *
+from .objects import *