Pytdbot 0.8.8.dev0__tar.gz → 0.9.0__tar.gz

{Pytdbot-0.8.8.dev0 → pytdbot-0.9.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2023 Python TDLib
+Copyright (c) 2022-2025 Pytdbot, AYMENJD
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

pytdbot-0.9.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.2
+Name: Pytdbot
+Version: 0.9.0
+Summary: Easy-to-use asynchronous TDLib wrapper for Python.
+Home-page: https://github.com/pytdbot/client
+Author: AYMEN Mohammed
+Author-email: let.me.code.safe@gmail.com
+License: MIT
+Project-URL: Source, https://github.com/pytdbot/client
+Project-URL: Tracker, https://github.com/pytdbot/client/issues
+Keywords: telegram,tdlib,bot,telegram-client,telegram-bot,bot-api,telegram-bot,tdlib-python,tdlib-bot
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: deepdiff
+Requires-Dist: aio-pika
+Provides-Extra: tdjson
+Requires-Dist: tdjson; extra == "tdjson"
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.45-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot)
+
+Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.
+
+### Features
+
+`Pytdbot` offers numerous advantages, including:
+
+- **Easy to Use**: Designed with simplicity in mind, making it accessible for developers
+- **Performance**: Fast and powerful, making it ready to fight
+- **Asynchronous**: Fully asynchronous that allows for non-blocking requests and improved responsiveness
+- **Scalable**: Easily scalable using [TDLib Server](https://github.com/pytdbot/tdlib-server)
+- **Well-typed**: Provides clear and well-defined methods and types to enhance developer experience
+- **Decorator-Based Updates**: Simplifies the implementation of update handlers through a decorator pattern
+- **Bound Methods**: Features types bound methods for improved usability
+- **Unlimited Support**: Supports **Plugins**, [**filters**](pytdbot/filters.py#L23), [**TDLib**](https://github.com/tdlib/td) types/functions and much more
+
+### Requirements
+
+- Python 3.9+
+- Telegram [API key](https://my.telegram.org/apps)
+- [tdjson](https://github.com/AYMENJD/tdjson) or [TDLib](https://github.com/tdlib/td#building)
+- [deepdiff](https://github.com/seperman/deepdiff)
+- [aio-pika](https://github.com/mosquito/aio-pika)
+
+### Installation
+
+> For better performance, it's recommended to install [orjson](https://github.com/ijl/orjson#install) or [ujson](https://github.com/ultrajson/ultrajson#ultrajson).
+
+You can install Pytdbot with TDLib included using pip:
+
+```bash
+pip install pytdbot[tdjson]
+```
+
+or without **pre-built** TDLib:
+
+```bash
+pip install pytdbot
+```
+
+If the install fails, then you need to build TDLib from [source](https://github.com/tdlib/td#building) and pass it to `Client(lib_path="/path/to/libtdjson.so")`.
+
+You could also install the development version using the following command:
+
+```bash
+pip install --pre pytdbot
+```
+
+### Examples
+
+Basic example:
+
+```python
+
+import asyncio
+
+from pytdbot import Client, types
+
+client = Client(
+    token="1088394097:AAQX2DnWiw4ihwiJUhIHOGog8gGOI",  # Your bot token or phone number if you want to login as user
+    api_id=0,
+    api_hash="API_HASH",
+    lib_path="/path/to/libtdjson.so", # Path to TDjson shared library
+    files_directory="BotDB",  # Path where to store TDLib files
+    database_encryption_key="1234echobot$",
+    td_verbosity=2,  # TDLib verbosity level
+    td_log=types.LogStreamFile("tdlib.log", 104857600),  # Set TDLib log file path
+)
+
+
+@client.on_updateNewMessage()
+async def print_message(c: Client, message: types.UpdateNewMessage):
+    print(message)
+
+
+@client.on_message()
+async def say_hello(c: Client, message: types.Message):
+    msg = await message.reply_text(f"Hey {await message.mention(parse_mode='html')}! I'm cooking up a surprise... 🍳👨‍🍳", parse_mode="html")
+
+    async with message.action("choose_sticker"):
+        await asyncio.sleep(5)
+
+        await msg.edit_text("Boo! 👻 Just kidding.")
+
+
+
+# Run the client
+client.run()
+
+```
+
+For more examples, check the [examples](https://github.com/pytdbot/client/tree/main/examples) folder.
+
+# Thanks to
+
+- You for viewing or using this project.
+
+- [@levlam](https://github.com/levlam) for maintaining [TDLib](https://github.com/tdlib/td) and for the help to create [Pytdbot](https://github.com/pytdbot/client).
+
+# License
+
+MIT [License](https://github.com/pytdbot/client/blob/main/LICENSE)

pytdbot-0.9.0/Pytdbot.egg-info/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.2
+Name: Pytdbot
+Version: 0.9.0
+Summary: Easy-to-use asynchronous TDLib wrapper for Python.
+Home-page: https://github.com/pytdbot/client
+Author: AYMEN Mohammed
+Author-email: let.me.code.safe@gmail.com
+License: MIT
+Project-URL: Source, https://github.com/pytdbot/client
+Project-URL: Tracker, https://github.com/pytdbot/client/issues
+Keywords: telegram,tdlib,bot,telegram-client,telegram-bot,bot-api,telegram-bot,tdlib-python,tdlib-bot
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: deepdiff
+Requires-Dist: aio-pika
+Provides-Extra: tdjson
+Requires-Dist: tdjson; extra == "tdjson"
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.45-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot)
+
+Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.
+
+### Features
+
+`Pytdbot` offers numerous advantages, including:
+
+- **Easy to Use**: Designed with simplicity in mind, making it accessible for developers
+- **Performance**: Fast and powerful, making it ready to fight
+- **Asynchronous**: Fully asynchronous that allows for non-blocking requests and improved responsiveness
+- **Scalable**: Easily scalable using [TDLib Server](https://github.com/pytdbot/tdlib-server)
+- **Well-typed**: Provides clear and well-defined methods and types to enhance developer experience
+- **Decorator-Based Updates**: Simplifies the implementation of update handlers through a decorator pattern
+- **Bound Methods**: Features types bound methods for improved usability
+- **Unlimited Support**: Supports **Plugins**, [**filters**](pytdbot/filters.py#L23), [**TDLib**](https://github.com/tdlib/td) types/functions and much more
+
+### Requirements
+
+- Python 3.9+
+- Telegram [API key](https://my.telegram.org/apps)
+- [tdjson](https://github.com/AYMENJD/tdjson) or [TDLib](https://github.com/tdlib/td#building)
+- [deepdiff](https://github.com/seperman/deepdiff)
+- [aio-pika](https://github.com/mosquito/aio-pika)
+
+### Installation
+
+> For better performance, it's recommended to install [orjson](https://github.com/ijl/orjson#install) or [ujson](https://github.com/ultrajson/ultrajson#ultrajson).
+
+You can install Pytdbot with TDLib included using pip:
+
+```bash
+pip install pytdbot[tdjson]
+```
+
+or without **pre-built** TDLib:
+
+```bash
+pip install pytdbot
+```
+
+If the install fails, then you need to build TDLib from [source](https://github.com/tdlib/td#building) and pass it to `Client(lib_path="/path/to/libtdjson.so")`.
+
+You could also install the development version using the following command:
+
+```bash
+pip install --pre pytdbot
+```
+
+### Examples
+
+Basic example:
+
+```python
+
+import asyncio
+
+from pytdbot import Client, types
+
+client = Client(
+    token="1088394097:AAQX2DnWiw4ihwiJUhIHOGog8gGOI",  # Your bot token or phone number if you want to login as user
+    api_id=0,
+    api_hash="API_HASH",
+    lib_path="/path/to/libtdjson.so", # Path to TDjson shared library
+    files_directory="BotDB",  # Path where to store TDLib files
+    database_encryption_key="1234echobot$",
+    td_verbosity=2,  # TDLib verbosity level
+    td_log=types.LogStreamFile("tdlib.log", 104857600),  # Set TDLib log file path
+)
+
+
+@client.on_updateNewMessage()
+async def print_message(c: Client, message: types.UpdateNewMessage):
+    print(message)
+
+
+@client.on_message()
+async def say_hello(c: Client, message: types.Message):
+    msg = await message.reply_text(f"Hey {await message.mention(parse_mode='html')}! I'm cooking up a surprise... 🍳👨‍🍳", parse_mode="html")
+
+    async with message.action("choose_sticker"):
+        await asyncio.sleep(5)
+
+        await msg.edit_text("Boo! 👻 Just kidding.")
+
+
+
+# Run the client
+client.run()
+
+```
+
+For more examples, check the [examples](https://github.com/pytdbot/client/tree/main/examples) folder.
+
+# Thanks to
+
+- You for viewing or using this project.
+
+- [@levlam](https://github.com/levlam) for maintaining [TDLib](https://github.com/tdlib/td) and for the help to create [Pytdbot](https://github.com/pytdbot/client).
+
+# License
+
+MIT [License](https://github.com/pytdbot/client/blob/main/LICENSE)

pytdbot-0.9.0/Pytdbot.egg-info/SOURCES.txt

@@ -0,0 +1,39 @@
+LICENSE
+MANIFEST.in
+README.md
+requirements.txt
+setup.py
+Pytdbot.egg-info/PKG-INFO
+Pytdbot.egg-info/SOURCES.txt
+Pytdbot.egg-info/dependency_links.txt
+Pytdbot.egg-info/requires.txt
+Pytdbot.egg-info/top_level.txt
+pytdbot/__init__.py
+pytdbot/client.py
+pytdbot/filters.py
+pytdbot/exception/__init__.py
+pytdbot/handlers/__init__.py
+pytdbot/handlers/decorators.py
+pytdbot/handlers/handler.py
+pytdbot/handlers/td_updates.py
+pytdbot/methods/__init__.py
+pytdbot/methods/methods.py
+pytdbot/methods/td_functions.py
+pytdbot/tdjson/__init__.py
+pytdbot/tdjson/tdjson.py
+pytdbot/types/__init__.py
+pytdbot/types/plugins/__init__.py
+pytdbot/types/td_types/__init__.py
+pytdbot/types/td_types/types.py
+pytdbot/types/td_types/bound_methods/__init__.py
+pytdbot/types/td_types/bound_methods/callback_query.py
+pytdbot/types/td_types/bound_methods/chatActions.py
+pytdbot/types/td_types/bound_methods/file.py
+pytdbot/types/td_types/bound_methods/message.py
+pytdbot/utils/__init__.py
+pytdbot/utils/escape.py
+pytdbot/utils/json_utils.py
+pytdbot/utils/obj_encoder.py
+pytdbot/utils/strings.py
+pytdbot/utils/text_format.py
+pytdbot/utils/webapps.py

pytdbot-0.9.0/Pytdbot.egg-info/requires.txt

@@ -0,0 +1,5 @@
+deepdiff
+aio-pika
+
+[tdjson]
+tdjson

pytdbot-0.9.0/README.md

@@ -0,0 +1,103 @@
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.45-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot)
+
+Pytdbot (Python TDLib) is an asynchronous [**TDLib**](https://github.com/tdlib/td) wrapper for **Telegram** users/bots written in **Python**.
+
+### Features
+
+`Pytdbot` offers numerous advantages, including:
+
+- **Easy to Use**: Designed with simplicity in mind, making it accessible for developers
+- **Performance**: Fast and powerful, making it ready to fight
+- **Asynchronous**: Fully asynchronous that allows for non-blocking requests and improved responsiveness
+- **Scalable**: Easily scalable using [TDLib Server](https://github.com/pytdbot/tdlib-server)
+- **Well-typed**: Provides clear and well-defined methods and types to enhance developer experience
+- **Decorator-Based Updates**: Simplifies the implementation of update handlers through a decorator pattern
+- **Bound Methods**: Features types bound methods for improved usability
+- **Unlimited Support**: Supports **Plugins**, [**filters**](pytdbot/filters.py#L23), [**TDLib**](https://github.com/tdlib/td) types/functions and much more
+
+### Requirements
+
+- Python 3.9+
+- Telegram [API key](https://my.telegram.org/apps)
+- [tdjson](https://github.com/AYMENJD/tdjson) or [TDLib](https://github.com/tdlib/td#building)
+- [deepdiff](https://github.com/seperman/deepdiff)
+- [aio-pika](https://github.com/mosquito/aio-pika)
+
+### Installation
+
+> For better performance, it's recommended to install [orjson](https://github.com/ijl/orjson#install) or [ujson](https://github.com/ultrajson/ultrajson#ultrajson).
+
+You can install Pytdbot with TDLib included using pip:
+
+```bash
+pip install pytdbot[tdjson]
+```
+
+or without **pre-built** TDLib:
+
+```bash
+pip install pytdbot
+```
+
+If the install fails, then you need to build TDLib from [source](https://github.com/tdlib/td#building) and pass it to `Client(lib_path="/path/to/libtdjson.so")`.
+
+You could also install the development version using the following command:
+
+```bash
+pip install --pre pytdbot
+```
+
+### Examples
+
+Basic example:
+
+```python
+
+import asyncio
+
+from pytdbot import Client, types
+
+client = Client(
+    token="1088394097:AAQX2DnWiw4ihwiJUhIHOGog8gGOI",  # Your bot token or phone number if you want to login as user
+    api_id=0,
+    api_hash="API_HASH",
+    lib_path="/path/to/libtdjson.so", # Path to TDjson shared library
+    files_directory="BotDB",  # Path where to store TDLib files
+    database_encryption_key="1234echobot$",
+    td_verbosity=2,  # TDLib verbosity level
+    td_log=types.LogStreamFile("tdlib.log", 104857600),  # Set TDLib log file path
+)
+
+
+@client.on_updateNewMessage()
+async def print_message(c: Client, message: types.UpdateNewMessage):
+    print(message)
+
+
+@client.on_message()
+async def say_hello(c: Client, message: types.Message):
+    msg = await message.reply_text(f"Hey {await message.mention(parse_mode='html')}! I'm cooking up a surprise... 🍳👨‍🍳", parse_mode="html")
+
+    async with message.action("choose_sticker"):
+        await asyncio.sleep(5)
+
+        await msg.edit_text("Boo! 👻 Just kidding.")
+
+
+
+# Run the client
+client.run()
+
+```
+
+For more examples, check the [examples](https://github.com/pytdbot/client/tree/main/examples) folder.
+
+# Thanks to
+
+- You for viewing or using this project.
+
+- [@levlam](https://github.com/levlam) for maintaining [TDLib](https://github.com/tdlib/td) and for the help to create [Pytdbot](https://github.com/pytdbot/client).
+
+# License
+
+MIT [License](https://github.com/pytdbot/client/blob/main/LICENSE)

pytdbot-0.9.0/pytdbot/__init__.py

@@ -0,0 +1,11 @@
+from . import types, utils, filters, exception
+from .tdjson import TdJson
+from .client import Client
+
+__all__ = ["types", "utils", "filters", "exception", "TdJson", "Client"]
+
+__version__ = "0.9.0"
+__copyright__ = "Copyright (c) 2022-2025 Pytdbot, AYMENJD"
+__license__ = "MIT License"
+
+VERSION = __version__