bendbandbot 1.0.0__tar.gz

bendbandbot-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 bendband
+
+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.

bendbandbot-1.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

bendbandbot-1.0.0/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: bendbandbot
+Version: 1.0.0
+Summary: Проста бібліотека для створення Telegram ботів для навчання
+Home-page: https://github.com/bendband/bendbandbot
+Author: bendband
+Author-email: contact@bendband.net
+License: MIT
+Project-URL: Homepage, https://github.com/bendband/bendbandbot
+Project-URL: Documentation, https://bendband.net/bot-course
+Keywords: telegram,bot,education,learning,bendband
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-telegram-bot<22.0,>=21.0
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# BendBandBot
+
+Проста бібліотека для створення Telegram ботів, спеціально розроблена для навчання школярів програмуванню.
+
+## Особливості
+
+- ✅ **Просто** - без декораторів, async/await, складних конструкцій
+- ✅ **Зрозуміло** - коментарі українською, зрозумілі назви методів
+- ✅ **Для початківців** - підходить для учнів 6-9 класів
+- ✅ **Два режими** - прості команди з текстом або функції для складнішої логіки
+
+## Встановлення
+
+```bash
+pip install bendbandbot
+```
+
+## Швидкий старт
+
+```python
+from simple_bot import SimpleBot
+
+# Створюємо бота
+bot = SimpleBot("ВАШ_ТОКЕН_ВІД_BOTFATHER")
+
+# Додаємо команди (простий спосіб)
+bot.on_command("start", "Привіт! 👋")
+bot.on_command("help", "Я простий бот!")
+
+# Запускаємо
+bot.start()
+```
+
+## Приклад з функціями
+
+```python
+from simple_bot import SimpleBot
+
+bot = SimpleBot("ВАШ_ТОКЕН")
+
+def greeting(message):
+    name = bot.get_name(message)
+    bot.send(message, f"Привіт, {name}! 😊")
+
+bot.on_command("start", greeting)
+bot.start()
+```
+
+## Документація
+
+Повний курс з 14 уроків: [bendband.net/bot-course](https://bendband.net/bot-course)
+
+## API
+
+### Створення бота
+```python
+bot = SimpleBot(token: str)
+```
+
+### Команди
+```python
+# Простий спосіб - тільки текст
+bot.on_command("start", "Привіт!")
+
+# Складніший - з функцією
+def hello(message):
+    bot.send(message, "Привіт!")
+bot.on_command("start", hello)
+```
+
+### Отримання даних
+```python
+text = bot.get_text(message)  # Текст повідомлення
+name = bot.get_name(message)  # Ім'я користувача
+```
+
+### Надсилання
+```python
+bot.send(message, "Текст")
+bot.send_photo(message, "photo.jpg", "Підпис")
+```
+
+### Обробка повідомлень
+```python
+def echo(message):
+    text = bot.get_text(message)
+    bot.send(message, text)
+
+bot.on_message(echo)
+```
+
+## Приклади
+
+### Калькулятор
+```python
+def calculate(message):
+    text = bot.get_text(message)
+    parts = text.split()
+    
+    if len(parts) == 3:
+        num1 = float(parts[0])
+        op = parts[1]
+        num2 = float(parts[2])
+        
+        if op == "+":
+            result = num1 + num2
+        elif op == "-":
+            result = num1 - num2
+        elif op == "*":
+            result = num1 * num2
+        elif op == "/":
+            result = num1 / num2 if num2 != 0 else "Помилка"
+        
+        bot.send(message, f"= {result}")
+
+bot.on_message(calculate)
+```
+
+### Випадковий вибір
+```python
+import random
+
+jokes = ["Жарт 1", "Жарт 2", "Жарт 3"]
+
+def joke(message):
+    bot.send(message, random.choice(jokes))
+
+bot.on_command("joke", joke)
+```
+
+## Ліцензія
+
+MIT License - вільно для навчальних цілей
+
+## Автор
+
+Створено **bendband** для навчання школярів програмуванню
+
+🌐 https://bendband.net

bendbandbot-1.0.0/README.md

@@ -0,0 +1,139 @@
+# BendBandBot
+
+Проста бібліотека для створення Telegram ботів, спеціально розроблена для навчання школярів програмуванню.
+
+## Особливості
+
+- ✅ **Просто** - без декораторів, async/await, складних конструкцій
+- ✅ **Зрозуміло** - коментарі українською, зрозумілі назви методів
+- ✅ **Для початківців** - підходить для учнів 6-9 класів
+- ✅ **Два режими** - прості команди з текстом або функції для складнішої логіки
+
+## Встановлення
+
+```bash
+pip install bendbandbot
+```
+
+## Швидкий старт
+
+```python
+from simple_bot import SimpleBot
+
+# Створюємо бота
+bot = SimpleBot("ВАШ_ТОКЕН_ВІД_BOTFATHER")
+
+# Додаємо команди (простий спосіб)
+bot.on_command("start", "Привіт! 👋")
+bot.on_command("help", "Я простий бот!")
+
+# Запускаємо
+bot.start()
+```
+
+## Приклад з функціями
+
+```python
+from simple_bot import SimpleBot
+
+bot = SimpleBot("ВАШ_ТОКЕН")
+
+def greeting(message):
+    name = bot.get_name(message)
+    bot.send(message, f"Привіт, {name}! 😊")
+
+bot.on_command("start", greeting)
+bot.start()
+```
+
+## Документація
+
+Повний курс з 14 уроків: [bendband.net/bot-course](https://bendband.net/bot-course)
+
+## API
+
+### Створення бота
+```python
+bot = SimpleBot(token: str)
+```
+
+### Команди
+```python
+# Простий спосіб - тільки текст
+bot.on_command("start", "Привіт!")
+
+# Складніший - з функцією
+def hello(message):
+    bot.send(message, "Привіт!")
+bot.on_command("start", hello)
+```
+
+### Отримання даних
+```python
+text = bot.get_text(message)  # Текст повідомлення
+name = bot.get_name(message)  # Ім'я користувача
+```
+
+### Надсилання
+```python
+bot.send(message, "Текст")
+bot.send_photo(message, "photo.jpg", "Підпис")
+```
+
+### Обробка повідомлень
+```python
+def echo(message):
+    text = bot.get_text(message)
+    bot.send(message, text)
+
+bot.on_message(echo)
+```
+
+## Приклади
+
+### Калькулятор
+```python
+def calculate(message):
+    text = bot.get_text(message)
+    parts = text.split()
+    
+    if len(parts) == 3:
+        num1 = float(parts[0])
+        op = parts[1]
+        num2 = float(parts[2])
+        
+        if op == "+":
+            result = num1 + num2
+        elif op == "-":
+            result = num1 - num2
+        elif op == "*":
+            result = num1 * num2
+        elif op == "/":
+            result = num1 / num2 if num2 != 0 else "Помилка"
+        
+        bot.send(message, f"= {result}")
+
+bot.on_message(calculate)
+```
+
+### Випадковий вибір
+```python
+import random
+
+jokes = ["Жарт 1", "Жарт 2", "Жарт 3"]
+
+def joke(message):
+    bot.send(message, random.choice(jokes))
+
+bot.on_command("joke", joke)
+```
+
+## Ліцензія
+
+MIT License - вільно для навчальних цілей
+
+## Автор
+
+Створено **bendband** для навчання школярів програмуванню
+
+🌐 https://bendband.net

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

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: bendbandbot
+Version: 1.0.0
+Summary: Проста бібліотека для створення Telegram ботів для навчання
+Home-page: https://github.com/bendband/bendbandbot
+Author: bendband
+Author-email: contact@bendband.net
+License: MIT
+Project-URL: Homepage, https://github.com/bendband/bendbandbot
+Project-URL: Documentation, https://bendband.net/bot-course
+Keywords: telegram,bot,education,learning,bendband
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Topic :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-telegram-bot<22.0,>=21.0
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# BendBandBot
+
+Проста бібліотека для створення Telegram ботів, спеціально розроблена для навчання школярів програмуванню.
+
+## Особливості
+
+- ✅ **Просто** - без декораторів, async/await, складних конструкцій
+- ✅ **Зрозуміло** - коментарі українською, зрозумілі назви методів
+- ✅ **Для початківців** - підходить для учнів 6-9 класів
+- ✅ **Два режими** - прості команди з текстом або функції для складнішої логіки
+
+## Встановлення
+
+```bash
+pip install bendbandbot
+```
+
+## Швидкий старт
+
+```python
+from simple_bot import SimpleBot
+
+# Створюємо бота
+bot = SimpleBot("ВАШ_ТОКЕН_ВІД_BOTFATHER")
+
+# Додаємо команди (простий спосіб)
+bot.on_command("start", "Привіт! 👋")
+bot.on_command("help", "Я простий бот!")
+
+# Запускаємо
+bot.start()
+```
+
+## Приклад з функціями
+
+```python
+from simple_bot import SimpleBot
+
+bot = SimpleBot("ВАШ_ТОКЕН")
+
+def greeting(message):
+    name = bot.get_name(message)
+    bot.send(message, f"Привіт, {name}! 😊")
+
+bot.on_command("start", greeting)
+bot.start()
+```
+
+## Документація
+
+Повний курс з 14 уроків: [bendband.net/bot-course](https://bendband.net/bot-course)
+
+## API
+
+### Створення бота
+```python
+bot = SimpleBot(token: str)
+```
+
+### Команди
+```python
+# Простий спосіб - тільки текст
+bot.on_command("start", "Привіт!")
+
+# Складніший - з функцією
+def hello(message):
+    bot.send(message, "Привіт!")
+bot.on_command("start", hello)
+```
+
+### Отримання даних
+```python
+text = bot.get_text(message)  # Текст повідомлення
+name = bot.get_name(message)  # Ім'я користувача
+```
+
+### Надсилання
+```python
+bot.send(message, "Текст")
+bot.send_photo(message, "photo.jpg", "Підпис")
+```
+
+### Обробка повідомлень
+```python
+def echo(message):
+    text = bot.get_text(message)
+    bot.send(message, text)
+
+bot.on_message(echo)
+```
+
+## Приклади
+
+### Калькулятор
+```python
+def calculate(message):
+    text = bot.get_text(message)
+    parts = text.split()
+    
+    if len(parts) == 3:
+        num1 = float(parts[0])
+        op = parts[1]
+        num2 = float(parts[2])
+        
+        if op == "+":
+            result = num1 + num2
+        elif op == "-":
+            result = num1 - num2
+        elif op == "*":
+            result = num1 * num2
+        elif op == "/":
+            result = num1 / num2 if num2 != 0 else "Помилка"
+        
+        bot.send(message, f"= {result}")
+
+bot.on_message(calculate)
+```
+
+### Випадковий вибір
+```python
+import random
+
+jokes = ["Жарт 1", "Жарт 2", "Жарт 3"]
+
+def joke(message):
+    bot.send(message, random.choice(jokes))
+
+bot.on_command("joke", joke)
+```
+
+## Ліцензія
+
+MIT License - вільно для навчальних цілей
+
+## Автор
+
+Створено **bendband** для навчання школярів програмуванню
+
+🌐 https://bendband.net

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

@@ -0,0 +1,11 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+bendbandbot.egg-info/PKG-INFO
+bendbandbot.egg-info/SOURCES.txt
+bendbandbot.egg-info/dependency_links.txt
+bendbandbot.egg-info/requires.txt
+bendbandbot.egg-info/top_level.txt
+simple_bot/__init__.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+python-telegram-bot<22.0,>=21.0

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

@@ -0,0 +1 @@
+simple_bot

bendbandbot-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bendbandbot"
+version = "1.0.0"
+description = "Проста бібліотека для створення Telegram ботів для навчання"
+readme = "README.md"
+authors = [{name = "bendband"}]
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Education",
+    "Topic :: Education",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+keywords = ["telegram", "bot", "education", "learning", "bendband"]
+dependencies = [
+    "python-telegram-bot>=21.0,<22.0",
+]
+requires-python = ">=3.8"
+
+[project.urls]
+Homepage = "https://github.com/bendband/bendbandbot"
+Documentation = "https://bendband.net/bot-course"

bendbandbot-1.0.0/setup.cfg

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

bendbandbot-1.0.0/setup.py

@@ -0,0 +1,33 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="bendbandbot",
+    version="1.0.0",
+    author="bendband",
+    author_email="contact@bendband.net",
+    description="Проста бібліотека для створення Telegram ботів для навчання",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/bendband/bendbandbot",
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Education",
+        "Topic :: Education",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    python_requires=">=3.8",
+    install_requires=[
+        "python-telegram-bot>=21.0,<22.0",
+    ],
+    keywords="telegram bot education learning школа навчання bendband",
+)

bendbandbot-1.0.0/simple_bot/__init__.py

@@ -0,0 +1,292 @@
+"""
+Проста бібліотека для створення Telegram ботів
+Спеціально для школярів - без складних конструкцій!
+
+Simple library for creating Telegram bots
+Specially for students - no complex constructs!
+"""
+
+from telegram import Update
+from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes
+import asyncio
+from typing import Callable, Optional
+import traceback
+import sys
+
+
+class SimpleBot:
+    """
+    Простий Telegram бот для навчання
+    
+    Приклад використання:
+        bot = SimpleBot("YOUR_TOKEN")
+        
+        bot.on_command("start", "Hello!")
+        bot.start()
+    """
+    
+    def __init__(self, token: str):
+        """
+        Створює нового бота
+        
+        token: токен від @BotFather в Telegram
+        """
+        if not token or token == "YOUR_TOKEN" or token == "ВАШ_ТОКЕН":
+            print("""
+❌ ПОМИЛКА: Ти не вказав токен бота!
+
+📝 Як отримати токен:
+1. Відкрий Telegram
+2. Знайди @BotFather
+3. Напиши йому: /newbot
+4. Дай ім'я своєму боту
+5. Скопіюй токен (довгий рядок типу 1234567890:ABCdef...)
+
+💡 Потім вставте його в код:
+   bot = SimpleBot("1234567890:ABCdef...")
+""")
+            sys.exit(1)
+        
+        self._token = token
+        self._app = None
+        self._command_handlers = {}
+        self._message_handlers = []
+        self._error_handler = None
+        
+    def on_command(self, command: str, function_or_text):
+        """
+        Що робити коли користувач надсилає команду
+        
+        command: назва команди без / (наприклад: "start", "help")
+        function_or_text: або функція, або просто текст для відправки
+        
+        Приклад 1 (дуже просто - тільки текст):
+            bot.on_command("start", "Привіт! 👋")
+            bot.on_command("help", "Я можу тобі допомогти!")
+        
+        Приклад 2 (з функцією):
+            def hello(message):
+                bot.send(message, "Hello!")
+            bot.on_command("start", hello)
+        """
+        if command.startswith('/'):
+            command = command[1:]
+        
+        # Якщо це рядок, створюємо просту функцію яка його надсилає
+        if isinstance(function_or_text, str):
+            text = function_or_text
+            def simple_handler(message):
+                self.send(message, text)
+            self._command_handlers[command] = simple_handler
+        else:
+            # Це функція, реєструємо її
+            self._command_handlers[command] = function_or_text
+        
+    def on_message(self, function):
+        """
+        Що робити коли користувач надсилає звичайне повідомлення
+        
+        function: яку функцію викликати. Отримує message як параметр
+        
+        Приклад:
+            def echo(message):
+                text = bot.get_text(message)
+                bot.send(message, f"Ти написав: {text}")
+            
+            bot.on_message(echo)
+        """
+        self._message_handlers.append(function)
+    
+    def on_error(self, function):
+        """
+        Що робити якщо виникла помилка
+        
+        function: функція для обробки помилки. Отримує текст помилки
+        
+        Приклад:
+            def handle_error(error):
+                print(f"Щось пішло не так: {error}")
+            
+            bot.on_error(handle_error)
+        """
+        self._error_handler = function
+        
+    def send(self, message, text: str):
+        """
+        Надіслати відповідь користувачу
+        
+        message: повідомлення від користувача
+        text: що надіслати
+        
+        Приклад:
+            bot.send(message, "Привіт!")
+        """
+        try:
+            chat_id = self._get_chat_id(message)
+            loop = asyncio.get_event_loop()
+            if loop.is_running():
+                asyncio.create_task(
+                    self._app.bot.send_message(chat_id=chat_id, text=text)
+                )
+            else:
+                loop.run_until_complete(
+                    self._app.bot.send_message(chat_id=chat_id, text=text)
+                )
+        except Exception as e:
+            self._handle_error(f"Помилка при надсиланні: {e}")
+    
+    def send_photo(self, message, photo_path: str, caption: str = ""):
+        """
+        Надіслати фото користувачу
+        
+        message: повідомлення від користувача
+        photo_path: шлях до файлу з фото
+        caption: текст під фото (не обов'язково)
+        
+        Приклад:
+            bot.send_photo(message, "cat.jpg", "Ось кіт!")
+        """
+        try:
+            chat_id = self._get_chat_id(message)
+            loop = asyncio.get_event_loop()
+            
+            async def _send():
+                with open(photo_path, 'rb') as photo:
+                    await self._app.bot.send_photo(
+                        chat_id=chat_id, 
+                        photo=photo, 
+                        caption=caption
+                    )
+            
+            if loop.is_running():
+                asyncio.create_task(_send())
+            else:
+                loop.run_until_complete(_send())
+        except Exception as e:
+            self._handle_error(f"Помилка при надсиланні фото: {e}")
+    
+    def get_text(self, message) -> str:
+        """
+        Отримати текст з повідомлення користувача
+        
+        message: повідомлення від користувача
+        
+        Повертає: текст повідомлення
+        
+        Приклад:
+            text = bot.get_text(message)
+            print(f"Користувач написав: {text}")
+        """
+        if hasattr(message, 'message') and message.message:
+            return message.message.text or ""
+        return ""
+    
+    def get_name(self, message) -> str:
+        """
+        Отримати ім'я користувача
+        
+        message: повідомлення від користувача
+        
+        Повертає: ім'я користувача
+        """
+        if hasattr(message, 'message') and message.message:
+            user = message.message.from_user
+            return user.first_name or user.username or "Анонім"
+        return "Анонім"
+    
+    def _get_chat_id(self, message):
+        """Внутрішня функція для отримання chat_id"""
+        if hasattr(message, 'message') and message.message:
+            return message.message.chat_id
+        elif hasattr(message, 'chat_id'):
+            return message.chat_id
+        else:
+            raise ValueError("Неможливо знайти chat_id")
+    
+    def _handle_error(self, error_text: str):
+        """Внутрішня функція для обробки помилок"""
+        print(f"❌ ПОМИЛКА: {error_text}")
+        print("─" * 50)
+        
+        if self._error_handler:
+            try:
+                self._error_handler(error_text)
+            except Exception as e:
+                print(f"Помилка в обробнику помилок: {e}")
+    
+    def _create_command_handler(self, command: str):
+        """Внутрішня функція для створення обробника команди"""
+        function = self._command_handlers[command]
+        
+        async def handler(update: Update, context: ContextTypes.DEFAULT_TYPE):
+            try:
+                # Викликаємо функцію користувача
+                result = function(update)
+                # Якщо це coroutine, await його
+                if asyncio.iscoroutine(result):
+                    await result
+            except Exception as e:
+                error = f"Помилка в команді /{command}:\n{traceback.format_exc()}"
+                self._handle_error(error)
+        
+        return handler
+    
+    def _create_message_handler(self, function: Callable):
+        """Внутрішня функція для створення обробника повідомлень"""
+        async def handler(update: Update, context: ContextTypes.DEFAULT_TYPE):
+            try:
+                result = function(update)
+                if asyncio.iscoroutine(result):
+                    await result
+            except Exception as e:
+                error = f"Помилка при обробці повідомлення:\n{traceback.format_exc()}"
+                self._handle_error(error)
+        
+        return handler
+    
+    def start(self):
+        """
+        Запустити бота
+        
+        Після виклику цієї функції бот почне працювати.
+        Програма буде чекати повідомлень від користувачів.
+        
+        Приклад:
+            bot.start()
+        """
+        print("🤖 Запускаю бота...")
+        print("─" * 50)
+        
+        try:
+            # Створюємо додаток
+            self._app = Application.builder().token(self._token).build()
+            
+            # Додаємо обробники команд
+            for command, function in self._command_handlers.items():
+                handler = self._create_command_handler(command)
+                self._app.add_handler(CommandHandler(command, handler))
+                print(f"✅ Команда /{command} готова")
+            
+            # Додаємо обробники повідомлень
+            for function in self._message_handlers:
+                handler = self._create_message_handler(function)
+                self._app.add_handler(
+                    MessageHandler(filters.TEXT & ~filters.COMMAND, handler)
+                )
+                print(f"✅ Обробник повідомлень готовий")
+            
+            print("─" * 50)
+            print("🎉 Бот працює! Натисни Ctrl+C щоб зупинити")
+            print("─" * 50)
+            
+            # Запускаємо
+            self._app.run_polling(allowed_updates=Update.ALL_TYPES)
+            
+        except Exception as e:
+            error = f"Критична помилка при запуску:\n{traceback.format_exc()}"
+            self._handle_error(error)
+            print("\n💡 Підказки:")
+            print("1. Перевір чи правильний токен від @BotFather")
+            print("2. Перевір підключення до інтернету")
+            print("3. Переконайся що бібліотека python-telegram-bot встановлена")
+            print("   Встанови командою: pip install python-telegram-bot")