telebot-mtproto 1.0.0__tar.gz

telebot_mtproto-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Telebot MTProto Developer
+
+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.

telebot_mtproto-1.0.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: telebot-mtproto
+Version: 1.0.0
+Summary: A lightweight wrapper that brings pyTelegramBotAPI (Telebot) syntax to the powerful MTProto protocol using Telethon under the hood
+Author-email: Telebot MTProto Developer <developer@tenmiencuaban.com>
+Keywords: telegram,bot,userbot,mtproto,telebot,pytelegrambotapi,telethon
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Telethon>=1.24.0
+Dynamic: license-file
+
+# Telebot MTProto for Python
+
+A lightweight wrapper that brings the simple and familiar decorator-based syntax of `pyTelegramBotAPI` (Telebot) to the high-performance **MTProto** protocol (using Telethon under the hood).
+
+## Why Telebot MTProto?
+
+When building Telegram bots with `pyTelegramBotAPI` (`telebot`), you are limited by the HTTP-based Bot API:
+- Cannot download files larger than **20MB**.
+- Cannot upload files larger than **50MB**.
+- HTTP overhead slows down responses.
+
+**Telebot MTProto** solves this! By running directly over MTProto (TCP):
+- **Send & Download files up to 2GB** (or 4GB with Telegram Premium).
+- **Run as a Bot** (using bot token) or as a **Userbot** (using phone login session).
+- Enjoy direct TCP speed with zero-change friendly Telebot syntax.
+
+## Installation
+
+Install using pip:
+
+```bash
+pip install telebot-mtproto
+```
+
+## Quick Start
+
+### 1. Run as a Bot Account (with Token)
+
+```python
+from telebot_mtproto import MTProtoTeleBot
+
+# Get api_id and api_hash from https://my.telegram.org
+bot = MTProtoTeleBot(
+    api_id=123456,
+    api_hash="your_api_hash",
+    bot_token="your_bot_token_from_botfather"
+)
+
+@bot.message_handler(commands=['start', 'help'])
+def send_welcome(message):
+    bot.reply_to(message, "Hello! I am running on MTProto protocol.")
+
+@bot.message_handler(func=lambda message: True)
+def echo_all(message):
+    bot.reply_to(message, f"You said: {message.text}")
+
+# Start the bot
+bot.run()
+```
+
+### 2. Run as a Userbot Account (with Phone Login)
+
+If you don't provide a `bot_token`, it will act as a Userbot. During the first run, it will prompt you in the terminal to enter your phone number and the OTP code sent by Telegram.
+
+```python
+from telebot_mtproto import MTProtoTeleBot
+
+bot = MTProtoTeleBot(
+    api_id=123456,
+    api_hash="your_api_hash",
+    session_name="my_userbot_session"
+)
+
+@bot.message_handler(commands=['ping'])
+def ping(message):
+    bot.reply_to(message, "Pong from userbot!")
+
+bot.run()
+```
+
+### 3. Send and Download Large Files (> 20MB)
+
+```python
+@bot.message_handler(commands=['download'])
+def get_large_file(message):
+    if message.reply_to_message:
+        bot.reply_to(message, "Downloading large file... (up to 2GB supported)")
+        
+        # Download file directly over MTProto TCP
+        dest = "./downloads/large_file.zip"
+        bot.download_file(message.reply_to_message, dest)
+        
+        bot.reply_to(message, f"File saved to {dest}")
+```
+
+## License
+
+MIT License.

telebot_mtproto-1.0.0/README.md

@@ -0,0 +1,88 @@
+# Telebot MTProto for Python
+
+A lightweight wrapper that brings the simple and familiar decorator-based syntax of `pyTelegramBotAPI` (Telebot) to the high-performance **MTProto** protocol (using Telethon under the hood).
+
+## Why Telebot MTProto?
+
+When building Telegram bots with `pyTelegramBotAPI` (`telebot`), you are limited by the HTTP-based Bot API:
+- Cannot download files larger than **20MB**.
+- Cannot upload files larger than **50MB**.
+- HTTP overhead slows down responses.
+
+**Telebot MTProto** solves this! By running directly over MTProto (TCP):
+- **Send & Download files up to 2GB** (or 4GB with Telegram Premium).
+- **Run as a Bot** (using bot token) or as a **Userbot** (using phone login session).
+- Enjoy direct TCP speed with zero-change friendly Telebot syntax.
+
+## Installation
+
+Install using pip:
+
+```bash
+pip install telebot-mtproto
+```
+
+## Quick Start
+
+### 1. Run as a Bot Account (with Token)
+
+```python
+from telebot_mtproto import MTProtoTeleBot
+
+# Get api_id and api_hash from https://my.telegram.org
+bot = MTProtoTeleBot(
+    api_id=123456,
+    api_hash="your_api_hash",
+    bot_token="your_bot_token_from_botfather"
+)
+
+@bot.message_handler(commands=['start', 'help'])
+def send_welcome(message):
+    bot.reply_to(message, "Hello! I am running on MTProto protocol.")
+
+@bot.message_handler(func=lambda message: True)
+def echo_all(message):
+    bot.reply_to(message, f"You said: {message.text}")
+
+# Start the bot
+bot.run()
+```
+
+### 2. Run as a Userbot Account (with Phone Login)
+
+If you don't provide a `bot_token`, it will act as a Userbot. During the first run, it will prompt you in the terminal to enter your phone number and the OTP code sent by Telegram.
+
+```python
+from telebot_mtproto import MTProtoTeleBot
+
+bot = MTProtoTeleBot(
+    api_id=123456,
+    api_hash="your_api_hash",
+    session_name="my_userbot_session"
+)
+
+@bot.message_handler(commands=['ping'])
+def ping(message):
+    bot.reply_to(message, "Pong from userbot!")
+
+bot.run()
+```
+
+### 3. Send and Download Large Files (> 20MB)
+
+```python
+@bot.message_handler(commands=['download'])
+def get_large_file(message):
+    if message.reply_to_message:
+        bot.reply_to(message, "Downloading large file... (up to 2GB supported)")
+        
+        # Download file directly over MTProto TCP
+        dest = "./downloads/large_file.zip"
+        bot.download_file(message.reply_to_message, dest)
+        
+        bot.reply_to(message, f"File saved to {dest}")
+```
+
+## License
+
+MIT License.

telebot_mtproto-1.0.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "telebot-mtproto"
+version = "1.0.0"
+authors = [
+    { name = "Telebot MTProto Developer", email = "developer@tenmiencuaban.com" }
+]
+description = "A lightweight wrapper that brings pyTelegramBotAPI (Telebot) syntax to the powerful MTProto protocol using Telethon under the hood"
+readme = "README.md"
+requires-python = ">=3.7"
+keywords = ["telegram", "bot", "userbot", "mtproto", "telebot", "pytelegrambotapi", "telethon"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Communications :: Chat",
+]
+dependencies = [
+    "Telethon>=1.24.0"
+]
+
+[tool.setuptools.packages.find]
+include = ["telebot_mtproto*"]

telebot_mtproto-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

telebot_mtproto-1.0.0/telebot_mtproto/__init__.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+from .bot import MTProtoTeleBot
+
+__all__ = ["MTProtoTeleBot"]

telebot_mtproto-1.0.0/telebot_mtproto/bot.py

@@ -0,0 +1,164 @@
+# -*- coding: utf-8 -*-
+# Core Telebot MTProto implementation (bot.py)
+# Một wrapper dựa trên Telethon giúp lập trình viên viết code với cú pháp đơn giản của pyTelegramBotAPI
+# nhưng chạy trực tiếp trên giao thức MTProto (TCP) tốc độ cao và không giới hạn kích thước file gửi/nhận (hỗ trợ tới 2GB).
+
+import asyncio
+from typing import List, Callable, Any, Optional, Union
+from telethon import TelegramClient, events
+from telethon.tl.types import Message as TelethonMessage, User as TelethonUser
+
+class ChatAdapter:
+    """Giả lập đối tượng Chat của pyTelegramBotAPI"""
+    def __init__(self, chat_id: int):
+        self.id = chat_id
+
+class UserAdapter:
+    """Giả lập đối tượng User của pyTelegramBotAPI"""
+    def __init__(self, user: TelethonUser):
+        self.id = getattr(user, 'id', None)
+        self.first_name = getattr(user, 'first_name', '')
+        self.last_name = getattr(user, 'last_name', '')
+        self.username = getattr(user, 'username', '')
+
+class MessageAdapter:
+    """Giả lập đối tượng Message của pyTelegramBotAPI từ đối tượng Event/Message của Telethon"""
+    def __init__(self, event_message: TelethonMessage, sender: Optional[TelethonUser] = None):
+        self.raw = event_message
+        self.message_id = event_message.id
+        self.text = event_message.message or ""
+        self.caption = event_message.message or ""
+        self.chat = ChatAdapter(event_message.chat_id)
+        self.from_user = UserAdapter(sender) if sender else None
+        
+        # Xử lý tin nhắn reply
+        self.reply_to_message = None
+        if event_message.is_reply:
+            # Lưu ID của tin nhắn được reply
+            self.reply_to_message_id = event_message.reply_to.reply_to_msg_id
+
+class MTProtoTeleBot:
+    """Lớp điều khiển chính giả lập pyTelegramBotAPI chạy trên nền thức MTProto"""
+
+    def __init__(self, api_id: int, api_hash: str, bot_token: Optional[str] = None, session_name: str = "telebot_mtproto"):
+        """
+        Khởi tạo MTProto Bot
+        :param api_id: Telegram API ID (lấy từ my.telegram.org)
+        :param api_hash: Telegram API HASH (lấy từ my.telegram.org)
+        :param bot_token: Bot token (nếu chạy dưới quyền Bot @BotFather). Để trống nếu chạy chế độ Userbot.
+        :param session_name: Tên tệp tin phiên làm việc session
+        """
+        self.api_id = api_id
+        self.api_hash = api_hash
+        self.bot_token = bot_token
+        self.client = TelegramClient(session_name, api_id, api_hash)
+        self.handlers = []
+
+    def message_handler(self, commands: Optional[List[str]] = None, regexp: Optional[str] = None, func: Optional[Callable[[Any], bool]] = None):
+        """
+        Decorator đăng ký hàm xử lý tin nhắn tương tự pyTelegramBotAPI
+        """
+        def decorator(handler_func: Callable[[MessageAdapter], Any]):
+            self.handlers.append({
+                "func": handler_func,
+                "commands": [c.lower() for c in commands] if commands else None,
+                "regexp": regexp,
+                "filter_func": func
+            })
+            return handler_func
+        return decorator
+
+    async def _handle_update(self, event):
+        """Hàm xử lý và lọc sự kiện tin nhắn nội bộ"""
+        msg = event.message
+        if not msg:
+            return
+
+        # Lấy thông tin người gửi
+        sender = await event.get_sender()
+        adapted_msg = MessageAdapter(msg, sender)
+
+        # Trích xuất command nếu có
+        text_lower = adapted_msg.text.strip().lower()
+        is_command = text_lower.startswith("/")
+        command_name = text_lower.split()[0][1:] if is_command else ""
+
+        for handler in self.handlers:
+            # Lọc theo commands
+            if handler["commands"] is not None:
+                if not is_command or command_name not in handler["commands"]:
+                    continue
+            
+            # Lọc theo regexp
+            if handler["regexp"] is not None:
+                import re
+                if not re.search(handler["regexp"], adapted_msg.text):
+                    continue
+            
+            # Lọc theo hàm filter_func tùy biến
+            if handler["filter_func"] is not None:
+                try:
+                    if not handler["filter_func"](adapted_msg):
+                        continue
+                except Exception:
+                    continue
+
+            # Gọi handler (hỗ trợ cả hàm đồng bộ và không đồng bộ)
+            if asyncio.iscoroutinefunction(handler["func"]):
+                await handler["func"](adapted_msg)
+            else:
+                # Chạy hàm đồng bộ trong threadpool để tránh chặn vòng lặp sự kiện
+                loop = asyncio.get_running_loop()
+                await loop.run_in_executor(None, handler["func"], adapted_msg)
+
+    def start(self):
+        """Khởi động client và đăng ký sự kiện"""
+        # Đăng ký sự kiện nhận tin nhắn mới trong Telethon
+        self.client.add_event_handler(self._handle_update, events.NewMessage(incoming=True))
+        
+        if self.bot_token:
+            self.client.start(bot_token=self.bot_token)
+        else:
+            self.client.start()
+
+    def run(self):
+        """Bắt đầu chạy bot (blocking)"""
+        self.start()
+        print("Bot is running over MTProto...")
+        self.client.run_until_disconnected()
+
+    def send_message(self, chat_id: Union[int, str], text: str, reply_to_message_id: Optional[int] = None) -> TelethonMessage:
+        """Gửi tin nhắn văn bản"""
+        loop = asyncio.get_event_loop()
+        coro = self.client.send_message(chat_id, text, reply_to=reply_to_message_id)
+        if loop.is_running():
+            return asyncio.ensure_future(coro)
+        return loop.run_until_complete(coro)
+
+    def reply_to(self, message: MessageAdapter, text: str) -> TelethonMessage:
+        """Trả lời trực tiếp một tin nhắn"""
+        return self.send_message(message.chat.id, text, reply_to_message_id=message.message_id)
+
+    def send_document(self, chat_id: Union[int, str], file_path: str, caption: Optional[str] = None) -> TelethonMessage:
+        """Gửi tài liệu/tệp tin (Hỗ trợ file cực lớn lên tới 2GB)"""
+        loop = asyncio.get_event_loop()
+        coro = self.client.send_file(chat_id, file_path, caption=caption, force_document=True)
+        if loop.is_running():
+            return asyncio.ensure_future(coro)
+        return loop.run_until_complete(coro)
+
+    def send_photo(self, chat_id: Union[int, str], file_path: str, caption: Optional[str] = None) -> TelethonMessage:
+        """Gửi ảnh"""
+        loop = asyncio.get_event_loop()
+        coro = self.client.send_file(chat_id, file_path, caption=caption)
+        if loop.is_running():
+            return asyncio.ensure_future(coro)
+        return loop.run_until_complete(coro)
+
+    def download_file(self, message: MessageAdapter, dest_path: str) -> str:
+        """Tải tệp đính kèm trong tin nhắn về máy (Không giới hạn 20MB của HTTP Bot API)"""
+        loop = asyncio.get_event_loop()
+        coro = self.client.download_media(message.raw, file=dest_path)
+        if loop.is_running():
+            return asyncio.ensure_future(coro)
+        return loop.run_until_complete(coro)

telebot_mtproto-1.0.0/telebot_mtproto.egg-info/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: telebot-mtproto
+Version: 1.0.0
+Summary: A lightweight wrapper that brings pyTelegramBotAPI (Telebot) syntax to the powerful MTProto protocol using Telethon under the hood
+Author-email: Telebot MTProto Developer <developer@tenmiencuaban.com>
+Keywords: telegram,bot,userbot,mtproto,telebot,pytelegrambotapi,telethon
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Telethon>=1.24.0
+Dynamic: license-file
+
+# Telebot MTProto for Python
+
+A lightweight wrapper that brings the simple and familiar decorator-based syntax of `pyTelegramBotAPI` (Telebot) to the high-performance **MTProto** protocol (using Telethon under the hood).
+
+## Why Telebot MTProto?
+
+When building Telegram bots with `pyTelegramBotAPI` (`telebot`), you are limited by the HTTP-based Bot API:
+- Cannot download files larger than **20MB**.
+- Cannot upload files larger than **50MB**.
+- HTTP overhead slows down responses.
+
+**Telebot MTProto** solves this! By running directly over MTProto (TCP):
+- **Send & Download files up to 2GB** (or 4GB with Telegram Premium).
+- **Run as a Bot** (using bot token) or as a **Userbot** (using phone login session).
+- Enjoy direct TCP speed with zero-change friendly Telebot syntax.
+
+## Installation
+
+Install using pip:
+
+```bash
+pip install telebot-mtproto
+```
+
+## Quick Start
+
+### 1. Run as a Bot Account (with Token)
+
+```python
+from telebot_mtproto import MTProtoTeleBot
+
+# Get api_id and api_hash from https://my.telegram.org
+bot = MTProtoTeleBot(
+    api_id=123456,
+    api_hash="your_api_hash",
+    bot_token="your_bot_token_from_botfather"
+)
+
+@bot.message_handler(commands=['start', 'help'])
+def send_welcome(message):
+    bot.reply_to(message, "Hello! I am running on MTProto protocol.")
+
+@bot.message_handler(func=lambda message: True)
+def echo_all(message):
+    bot.reply_to(message, f"You said: {message.text}")
+
+# Start the bot
+bot.run()
+```
+
+### 2. Run as a Userbot Account (with Phone Login)
+
+If you don't provide a `bot_token`, it will act as a Userbot. During the first run, it will prompt you in the terminal to enter your phone number and the OTP code sent by Telegram.
+
+```python
+from telebot_mtproto import MTProtoTeleBot
+
+bot = MTProtoTeleBot(
+    api_id=123456,
+    api_hash="your_api_hash",
+    session_name="my_userbot_session"
+)
+
+@bot.message_handler(commands=['ping'])
+def ping(message):
+    bot.reply_to(message, "Pong from userbot!")
+
+bot.run()
+```
+
+### 3. Send and Download Large Files (> 20MB)
+
+```python
+@bot.message_handler(commands=['download'])
+def get_large_file(message):
+    if message.reply_to_message:
+        bot.reply_to(message, "Downloading large file... (up to 2GB supported)")
+        
+        # Download file directly over MTProto TCP
+        dest = "./downloads/large_file.zip"
+        bot.download_file(message.reply_to_message, dest)
+        
+        bot.reply_to(message, f"File saved to {dest}")
+```
+
+## License
+
+MIT License.

telebot_mtproto-1.0.0/telebot_mtproto.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+telebot_mtproto/__init__.py
+telebot_mtproto/bot.py
+telebot_mtproto.egg-info/PKG-INFO
+telebot_mtproto.egg-info/SOURCES.txt
+telebot_mtproto.egg-info/dependency_links.txt
+telebot_mtproto.egg-info/requires.txt
+telebot_mtproto.egg-info/top_level.txt

telebot_mtproto-1.0.0/telebot_mtproto.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

telebot_mtproto-1.0.0/telebot_mtproto.egg-info/requires.txt

@@ -0,0 +1 @@
+Telethon>=1.24.0

telebot_mtproto-1.0.0/telebot_mtproto.egg-info/top_level.txt

@@ -0,0 +1 @@
+telebot_mtproto