pyrobale 0.3.5__tar.gz → 0.3.8.5__tar.gz

pyrobale-0.3.8.5/.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.8.5/.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.5 → pyrobale-0.3.8.5}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Ali Safamanesh
+Copyright (c) 2025 PyroBale Team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ 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.
+SOFTWARE.

pyrobale-0.3.8.5/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: pyrobale
+Version: 0.3.8.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>, Aydin Rahbaran <codewizaard9@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 PyroBale Team
+        
+        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** - 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: Message):
+    await message.reply("Hello, world!")
+
+bot.run()
+```
+
+## Examples
+
+### Conversation Bot
+```python
+from pyrobale.objects import *
+from pyrobale.client import Client, Message, UpdatesTypes
+
+client = Client("YOUR_BOT_TOKEN")
+
+async def handle_message(message: Message):
+    if message.text == "/start":
+        await message.reply("Hi! Im a pyrobale RoBot!")
+        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.8.5/README.md

@@ -0,0 +1,116 @@
+![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** - 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: Message):
+    await message.reply("Hello, world!")
+
+bot.run()
+```
+
+## Examples
+
+### Conversation Bot
+```python
+from pyrobale.objects import *
+from pyrobale.client import Client, Message, UpdatesTypes
+
+client = Client("YOUR_BOT_TOKEN")
+
+async def handle_message(message: Message):
+    if message.text == "/start":
+        await message.reply("Hi! Im a pyrobale RoBot!")
+        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.8.5/examples/command.py

@@ -0,0 +1,12 @@
+from pyrobale.client import Client
+from pyrobale.objects import Message, UpdatesTypes
+
+token = "YOUR_BOT_TOKEN"
+
+bot = Client(token)
+
+@bot.on_command('start')
+async def start(message: Message):
+    await message.reply("Hello, world!")
+
+bot.run()

pyrobale-0.3.8.5/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.8.5/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.8.5/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.8.5}/pyproject.toml

@@ -1,8 +1,9 @@
 [project]
 name = "pyrobale"
-version = "0.3.5"
+version = "0.3.8.5"
 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.8.5/pyrobale/StateMachine/__init__.py

@@ -0,0 +1,66 @@
+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
+    
+    def save_local(self, file_name: str):
+        """Saves the state of all users to a file
+
+        Args:
+            file_name (string): name of file to save the state of users
+        """
+        with open(file_name, "w") as f:
+            for user_id, state in self.__states.items():
+                f.write(f"{user_id} {state}\n")
+    
+    def load_local(self, file_name: str):
+        """Loads the state of all users from a file
+
+        Args:
+            file_name (string): name of file to load the state of users
+        """
+        with open(file_name, "r") as f:
+            for line in f:
+                user_id, state = line.split()
+                self.__states[user_id] = state

pyrobale-0.3.8.5/pyrobale/__init__.py

@@ -0,0 +1,125 @@
+"""
+![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: Message):
+    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 *
+from .client import Client