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

pyrobale-0.3.5.dist-info/METADATA

@@ -0,0 +1,176 @@
+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")
+```

pyrobale-0.3.5.dist-info/RECORD

@@ -0,0 +1,43 @@
+pyrobale/__init__.py,sha256=JHnoAuKziwl7pysBJLpmXDN4YoKeDXhiL6joscEFh_Y,78
+pyrobale/client/__init__.py,sha256=ehsCuqAVpJuXzwolZCCcySHZZJawqNT-yr2LIgP52II,21104
+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/animation.py,sha256=jpM9V8AOaGLWkcENTDmsxKf57Abf-MArYBLfU6GwkD0,978
+pyrobale/objects/audio.py,sha256=q14wz5WpC3SgKZkAlH-D9M554RYQNDwuCT2z7v7IZYU,696
+pyrobale/objects/callbackquery.py,sha256=VlogbysCpdPjAIvrF6CvcJeSUco4WKPXjrvUprEaF1g,1281
+pyrobale/objects/chat.py,sha256=gQ1wpmB63Ot51aeSBAiWzbw9lFgCpJjlm9hlYNBQJ88,16566
+pyrobale/objects/chatmember.py,sha256=CyoX4R4vkNoPjki7U4tgslmEc51g1nn9Q7tUyPeHa58,6868
+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/file.py,sha256=4PBfjouP0knd1vFDNs7mx_jwBoDQVBKS7ESjzF4Y6E8,360
+pyrobale/objects/inlinekeyboardbutton.py,sha256=w4HehdisD7RQodS66gG-DJjaf0gO2U-6wYaVXaatTN8,617
+pyrobale/objects/inlinekeyboardmarkup.py,sha256=shNpYUT25EqT0PQFa-c1tEma_6mJIpBwXQ0IqcTGg4M,2887
+pyrobale/objects/inputfile.py,sha256=vjw96uJZzp4UargWd2p3OQKyvTpHu2PH_dR_RwwshRI,621
+pyrobale/objects/inputmedias.py,sha256=2h5YKWNjrrLD1QKZ5J_iOfpCZIRpAZST9q7eBd8edo0,6248
+pyrobale/objects/invoice.py,sha256=hI225mtsSSV7fYre6aFHp-o1NxUT8MLugJAD6NfAeIs,375
+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/messageid.py,sha256=DrWKV8y9m9H8G_Fj68KgiJKwDJOGduNJGJ-Dyn8N580,95
+pyrobale/objects/photosize.py,sha256=I4hnmi46uoU-cW7hPN_tTT9kn0u80BtG5QJ3uRjoUiE,298
+pyrobale/objects/precheckoutquery.py,sha256=Rtjh1qqRc9TRZMJU1W5r0B8y7K5dayLMXX6WH9h1Ul4,470
+pyrobale/objects/replykeyboardmarkup.py,sha256=3dBiOs29q54tf281qKYcoO1Yjvn63WZfdkrbIoDUfck,1645
+pyrobale/objects/sticker.py,sha256=yLzWAm1fikMVISExdCG0R-rVu1_M31LLw6sHt0sBehE,381
+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/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.5.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+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.