BaleClient 1.0.0__tar.gz

baleclient-1.0.0/BaleClient.egg-info/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: BaleClient
+Version: 1.0.0
+Author-email: "foad.kheirabady" <foad.kheirabady@gmail.com>
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp<4.0,>=3.9
+Requires-Dist: aiofiles<24.0,>=23.1
+Requires-Dist: colorama<1.0,>=0.4.6
+Requires-Dist: pydantic<3.0,>=2.0
+Requires-Dist: typing_extensions<5.0,>=4.0
+Requires-Dist: blackboxprotobuf<2.0,>=1.0.1
+Requires-Dist: magic-filter<2.0,>=1.0
+Dynamic: license-file
+
+# BaleClient
+
+⚡ **BaleClient** is a maintained fork / rework of **Aiobale**, an asynchronous Python client for **Bale Messenger**.
+
+The original library is great but contains several bugs and incomplete implementations.
+This project fixes those issues and adds improvements for reliability, stability, and usability.
+
+---
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install baleclient
+```
+
+Upgrade to the latest version:
+
+```bash
+pip install -U baleclient
+```
+
+Install from source:
+
+```bash
+git clone https://github.com/Foad-KhAb/baleclient.git
+cd baleclient
+pip install -e .
+```
+
+---
+
+## Requirements
+
+* Python **3.11+**
+
+---
+
+## Quick Example
+
+```python
+from baleclient import Client
+
+async def main():
+    async with Client("session") as client:
+        me = await client.get_me()
+        print(me)
+```
+
+---
+
+## Features
+
+* Fully **asynchronous** API
+* Lightweight and fast
+* Improved parsing reliability
+* Better error handling
+* Maintained fork of Aiobale
+
+---
+
+## Based On
+
+This project is based on:
+
+**Aiobale**
+https://github.com/Enalite/aiobale
+
+Credit to the original author for the initial implementation.
+
+---
+
+## Why BaleClient?
+
+While using Aiobale in real projects, I encountered several issues such as:
+
+* parsing bugs
+* inconsistent API responses
+* missing validations
+* edge cases not handled
+
+**BaleClient** fixes these problems and introduces improvements to make the library more stable for production usage.
+
+---
+
+## Fixes
+
+List of fixes applied to the original library:
+
+* [x] Fix dialog response parsing
+* [x] Fix message caption parsing
+* [x] Fix incorrect type validations
+
+*(this list will grow as more issues are discovered)*
+
+---
+
+## Added Improvements
+
+Additional features and improvements:
+
+* [x] Better error handling when reading corrupted or modified session files
+
+---
+
+## Changelog
+
+### v0.1.0
+
+* Initial release
+* Fork of Aiobale with several fixes
+* Improved session error handling
+
+---
+
+## Documentation
+
+Documentation will be expanded in future releases.
+
+For now, refer to:
+
+* The source code
+* Example usage in the repository
+
+---
+
+## Notes
+
+* BaleClient is **not an official Bale API library**
+* The Bale API is internal and may change without notice
+
+---
+
+## License
+
+This project follows the same license as the original project unless otherwise specified.

baleclient-1.0.0/BaleClient.egg-info/SOURCES.txt

@@ -0,0 +1,236 @@
+LICENSE
+README.md
+pyproject.toml
+BaleClient.egg-info/PKG-INFO
+BaleClient.egg-info/SOURCES.txt
+BaleClient.egg-info/dependency_links.txt
+BaleClient.egg-info/requires.txt
+BaleClient.egg-info/top_level.txt
+baleclient/__init__.py
+baleclient/exceptions.py
+baleclient/logger.py
+baleclient/client/auth_cli.py
+baleclient/client/client.py
+baleclient/client/context_controller.py
+baleclient/client/session/__init__.py
+baleclient/client/session/aiohttp.py
+baleclient/client/session/base.py
+baleclient/dispatcher/__init__.py
+baleclient/dispatcher/dispatcher.py
+baleclient/dispatcher/router.py
+baleclient/dispatcher/event/__init__.py
+baleclient/dispatcher/event/handler.py
+baleclient/dispatcher/event/observer.py
+baleclient/enums/__init__.py
+baleclient/enums/auth_errors.py
+baleclient/enums/chat_type.py
+baleclient/enums/gift_openning.py
+baleclient/enums/giving_type.py
+baleclient/enums/group_type.py
+baleclient/enums/list_load_mode.py
+baleclient/enums/peer_source.py
+baleclient/enums/peer_type.py
+baleclient/enums/privacy_mode.py
+baleclient/enums/report_kind.py
+baleclient/enums/restriction.py
+baleclient/enums/send_code.py
+baleclient/enums/send_type.py
+baleclient/enums/services.py
+baleclient/enums/typing_type.py
+baleclient/filters/__init__.py
+baleclient/filters/base.py
+baleclient/filters/chat.py
+baleclient/filters/content.py
+baleclient/filters/logic.py
+baleclient/filters/regex.py
+baleclient/methods/__init__.py
+baleclient/methods/base.py
+baleclient/methods/abacus/__init__.py
+baleclient/methods/abacus/get_message_reactions_list.py
+baleclient/methods/abacus/get_messages_reaction.py
+baleclient/methods/abacus/get_messages_views.py
+baleclient/methods/abacus/message_remove_reaction.py
+baleclient/methods/abacus/message_set_reaction.py
+baleclient/methods/auth/__init__.py
+baleclient/methods/auth/sign_out.py
+baleclient/methods/auth/sign_up.py
+baleclient/methods/auth/start_phone_auth.py
+baleclient/methods/auth/validate_code.py
+baleclient/methods/auth/validate_password.py
+baleclient/methods/configs/__init__.py
+baleclient/methods/configs/edit_parameter.py
+baleclient/methods/configs/get_parameters.py
+baleclient/methods/files/__init__.py
+baleclient/methods/files/get_file_upload_url.py
+baleclient/methods/files/get_file_url.py
+baleclient/methods/giftpacket/__init__.py
+baleclient/methods/giftpacket/open_packet.py
+baleclient/methods/giftpacket/send_gift_packet_with_wallet.py
+baleclient/methods/groups/__init__.py
+baleclient/methods/groups/create_group.py
+baleclient/methods/groups/edit_channel_username.py
+baleclient/methods/groups/edit_group_about.py
+baleclient/methods/groups/edit_group_title.py
+baleclient/methods/groups/get_banned_users.py
+baleclient/methods/groups/get_full_group.py
+baleclient/methods/groups/get_group_invite_url.py
+baleclient/methods/groups/get_group_preview.py
+baleclient/methods/groups/get_member_permissions.py
+baleclient/methods/groups/get_pins.py
+baleclient/methods/groups/invite_users.py
+baleclient/methods/groups/join_group.py
+baleclient/methods/groups/join_public_group.py
+baleclient/methods/groups/kick_user.py
+baleclient/methods/groups/leave_group.py
+baleclient/methods/groups/load_members.py
+baleclient/methods/groups/make_user_admin.py
+baleclient/methods/groups/pin_message.py
+baleclient/methods/groups/remove_pin.py
+baleclient/methods/groups/remove_single_pin.py
+baleclient/methods/groups/remove_user_admin.py
+baleclient/methods/groups/revoke_invite_url.py
+baleclient/methods/groups/set_group_default_permissions.py
+baleclient/methods/groups/set_member_permissions.py
+baleclient/methods/groups/set_restriction.py
+baleclient/methods/groups/transfer_ownership.py
+baleclient/methods/groups/unban_user.py
+baleclient/methods/kifpool/__init__.py
+baleclient/methods/kifpool/get_my_kifpools.py
+baleclient/methods/magazine/__init__.py
+baleclient/methods/magazine/get_message_upvoters.py
+baleclient/methods/magazine/revoke_upvoted_post.py
+baleclient/methods/magazine/upvote_post.py
+baleclient/methods/messaging/__init__.py
+baleclient/methods/messaging/clear_chat.py
+baleclient/methods/messaging/delete_chat.py
+baleclient/methods/messaging/delete_message.py
+baleclient/methods/messaging/forward_message.py
+baleclient/methods/messaging/load_dialogs.py
+baleclient/methods/messaging/load_history.py
+baleclient/methods/messaging/load_pinned.py
+baleclient/methods/messaging/message_read.py
+baleclient/methods/messaging/pin_message.py
+baleclient/methods/messaging/send_message.py
+baleclient/methods/messaging/unpin_messages.py
+baleclient/methods/messaging/update_message.py
+baleclient/methods/presence/__init__.py
+baleclient/methods/presence/set_online.py
+baleclient/methods/presence/stop_typing.py
+baleclient/methods/presence/typing.py
+baleclient/methods/report/__init__.py
+baleclient/methods/report/send_report.py
+baleclient/methods/user/__init__.py
+baleclient/methods/user/add_contact.py
+baleclient/methods/user/block_user.py
+baleclient/methods/user/check_nickname.py
+baleclient/methods/user/edit_about.py
+baleclient/methods/user/edit_name.py
+baleclient/methods/user/edit_nickname.py
+baleclient/methods/user/edit_user_local_name.py
+baleclient/methods/user/get_contacts.py
+baleclient/methods/user/import_contacts.py
+baleclient/methods/user/load_blocked_users.py
+baleclient/methods/user/load_full_users.py
+baleclient/methods/user/load_users.py
+baleclient/methods/user/remove_contact.py
+baleclient/methods/user/reset_contacts.py
+baleclient/methods/user/search_contact.py
+baleclient/methods/user/unblock_user.py
+baleclient/types/__init__.py
+baleclient/types/auth.py
+baleclient/types/ban_data.py
+baleclient/types/base.py
+baleclient/types/block_updates.py
+baleclient/types/chat.py
+baleclient/types/chat_data.py
+baleclient/types/client.py
+baleclient/types/condition.py
+baleclient/types/contact_request.py
+baleclient/types/ext.py
+baleclient/types/file_details.py
+baleclient/types/file_ext.py
+baleclient/types/file_info.py
+baleclient/types/file_input.py
+baleclient/types/file_upload_info.py
+baleclient/types/file_url.py
+baleclient/types/full_group.py
+baleclient/types/full_user.py
+baleclient/types/gift_packet.py
+baleclient/types/group.py
+baleclient/types/info_changed.py
+baleclient/types/info_message.py
+baleclient/types/info_peer.py
+baleclient/types/inline_keyboard.py
+baleclient/types/int_bool.py
+baleclient/types/member.py
+baleclient/types/message.py
+baleclient/types/message_content.py
+baleclient/types/message_data.py
+baleclient/types/message_reaction.py
+baleclient/types/message_report.py
+baleclient/types/message_updates.py
+baleclient/types/message_views.py
+baleclient/types/other_message.py
+baleclient/types/peer.py
+baleclient/types/peer_data.py
+baleclient/types/peer_report.py
+baleclient/types/permissions.py
+baleclient/types/quoted_message.py
+baleclient/types/reaction.py
+baleclient/types/reaction_data.py
+baleclient/types/report.py
+baleclient/types/request.py
+baleclient/types/response.py
+baleclient/types/selected_messages.py
+baleclient/types/send_type.py
+baleclient/types/service_ext.py
+baleclient/types/service_message.py
+baleclient/types/short_peer.py
+baleclient/types/thumbnail.py
+baleclient/types/update.py
+baleclient/types/updated_message.py
+baleclient/types/upvote.py
+baleclient/types/user.py
+baleclient/types/values.py
+baleclient/types/wallet.py
+baleclient/types/winner.py
+baleclient/types/responses/__init__.py
+baleclient/types/responses/auth.py
+baleclient/types/responses/banned_users.py
+baleclient/types/responses/blocked_users.py
+baleclient/types/responses/contacts.py
+baleclient/types/responses/create_group.py
+baleclient/types/responses/default.py
+baleclient/types/responses/dialogs.py
+baleclient/types/responses/file_url.py
+baleclient/types/responses/full_group.py
+baleclient/types/responses/get_pins.py
+baleclient/types/responses/history.py
+baleclient/types/responses/invite.py
+baleclient/types/responses/invite_url.py
+baleclient/types/responses/join_group.py
+baleclient/types/responses/load_members.py
+baleclient/types/responses/load_users.py
+baleclient/types/responses/member_permissions.py
+baleclient/types/responses/message.py
+baleclient/types/responses/messages_reactions.py
+baleclient/types/responses/nickname_available.py
+baleclient/types/responses/open_packet.py
+baleclient/types/responses/parameters.py
+baleclient/types/responses/reaction_list.py
+baleclient/types/responses/reaction_sent.py
+baleclient/types/responses/search_contact.py
+baleclient/types/responses/upvote_response.py
+baleclient/types/responses/upvoters_response.py
+baleclient/types/responses/validate_code.py
+baleclient/types/responses/views_response.py
+baleclient/types/responses/wallet.py
+baleclient/utils/__init__.py
+baleclient/utils/file_helper.py
+baleclient/utils/grpc_post.py
+baleclient/utils/int64.py
+baleclient/utils/jwt_checker.py
+baleclient/utils/links.py
+baleclient/utils/magic_filter.py
+baleclient/utils/protobuf.py
+baleclient/utils/random.py

baleclient-1.0.0/BaleClient.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

baleclient-1.0.0/BaleClient.egg-info/requires.txt

@@ -0,0 +1,7 @@
+aiohttp<4.0,>=3.9
+aiofiles<24.0,>=23.1
+colorama<1.0,>=0.4.6
+pydantic<3.0,>=2.0
+typing_extensions<5.0,>=4.0
+blackboxprotobuf<2.0,>=1.0.1
+magic-filter<2.0,>=1.0

baleclient-1.0.0/BaleClient.egg-info/top_level.txt

@@ -0,0 +1 @@
+baleclient

baleclient-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alireza Jahani | Enalite LD
+
+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.

baleclient-1.0.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: BaleClient
+Version: 1.0.0
+Author-email: "foad.kheirabady" <foad.kheirabady@gmail.com>
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp<4.0,>=3.9
+Requires-Dist: aiofiles<24.0,>=23.1
+Requires-Dist: colorama<1.0,>=0.4.6
+Requires-Dist: pydantic<3.0,>=2.0
+Requires-Dist: typing_extensions<5.0,>=4.0
+Requires-Dist: blackboxprotobuf<2.0,>=1.0.1
+Requires-Dist: magic-filter<2.0,>=1.0
+Dynamic: license-file
+
+# BaleClient
+
+⚡ **BaleClient** is a maintained fork / rework of **Aiobale**, an asynchronous Python client for **Bale Messenger**.
+
+The original library is great but contains several bugs and incomplete implementations.
+This project fixes those issues and adds improvements for reliability, stability, and usability.
+
+---
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install baleclient
+```
+
+Upgrade to the latest version:
+
+```bash
+pip install -U baleclient
+```
+
+Install from source:
+
+```bash
+git clone https://github.com/Foad-KhAb/baleclient.git
+cd baleclient
+pip install -e .
+```
+
+---
+
+## Requirements
+
+* Python **3.11+**
+
+---
+
+## Quick Example
+
+```python
+from baleclient import Client
+
+async def main():
+    async with Client("session") as client:
+        me = await client.get_me()
+        print(me)
+```
+
+---
+
+## Features
+
+* Fully **asynchronous** API
+* Lightweight and fast
+* Improved parsing reliability
+* Better error handling
+* Maintained fork of Aiobale
+
+---
+
+## Based On
+
+This project is based on:
+
+**Aiobale**
+https://github.com/Enalite/aiobale
+
+Credit to the original author for the initial implementation.
+
+---
+
+## Why BaleClient?
+
+While using Aiobale in real projects, I encountered several issues such as:
+
+* parsing bugs
+* inconsistent API responses
+* missing validations
+* edge cases not handled
+
+**BaleClient** fixes these problems and introduces improvements to make the library more stable for production usage.
+
+---
+
+## Fixes
+
+List of fixes applied to the original library:
+
+* [x] Fix dialog response parsing
+* [x] Fix message caption parsing
+* [x] Fix incorrect type validations
+
+*(this list will grow as more issues are discovered)*
+
+---
+
+## Added Improvements
+
+Additional features and improvements:
+
+* [x] Better error handling when reading corrupted or modified session files
+
+---
+
+## Changelog
+
+### v0.1.0
+
+* Initial release
+* Fork of Aiobale with several fixes
+* Improved session error handling
+
+---
+
+## Documentation
+
+Documentation will be expanded in future releases.
+
+For now, refer to:
+
+* The source code
+* Example usage in the repository
+
+---
+
+## Notes
+
+* BaleClient is **not an official Bale API library**
+* The Bale API is internal and may change without notice
+
+---
+
+## License
+
+This project follows the same license as the original project unless otherwise specified.