Ссылка на GitHub:

Все изменения уже доступны в репозитории: Ссылка на репозиторий. Жду ваших отзывов и предложений!

Друзья, обещанная подробная статья про Pydantic уже опубликована на Хабре! 🎉

В ней я подробно рассмотрел Pydantic 2 - мощный инструмент для валидации данных в Python, который используется в более чем 30% всех Python-проектов.

Основные темы статьи:

• Что такое Pydantic и зачем он нужен
• Модели и поля в Pydantic
• Встроенные и кастомные механизмы валидации
• Автогенерируемые поля
• Настройка моделей через ConfigDict
• Наследование моделей
• Интеграция с ORM (на примере SQLAlchemy)
• Преобразование данных в словари и JSON

Статья подойдет как новичкам, так и опытным разработчикам. Вы узнаете, как применять Pydantic 2 в своих проектах и почему он стал неотъемлемой частью экосистемы Python.

Ссылка на статью: Pydantic 2: Полное руководство для Python-разработчиков — от основ до продвинутых техник

Приятного чтения! Буду рад вашим комментариям и вопросам. 👨‍💻📚

Упрощенное тестирование Pydantic с имитацией ORM

При изучении Pydantic по моей статье, вы можете столкнуться с необходимостью тестирования метода model_validate(my_obj, from_attributes=True). Чтобы избежать развертывания отдельной базы данных с описанием модели таблицы SQLAlchemy, можно использовать следующий элегантный подход:

1. Создание имитации ORM-класса

Создайте простой класс, имитирующий ORM-модель. Например:

from datetime import date

class MyUser:
    id = 3
    name = "Алексей"
    surname = "Яковенко"
    birthday_date = date(1993, 2, 19)

2. Определение Pydantic-модели

Создайте соответствующую Pydantic-модель. Например:

from pydantic import BaseModel, computed_field
from dateutil.relativedelta import relativedelta

class User(BaseModel):
    id: int
    name: str
    surname: str
    birthday_date: date

    @computed_field
    def full_name(self) -> str:
        return f"{self.name} {self.surname}"

    @computed_field
    def age(self) -> str:
        today = date.today()
        delta = relativedelta(today, self.birthday_date)
        return f"{delta.years} лет, {delta.months} месяцев и {delta.days} дней"

3. Использование модели

Теперь вы можете использовать вашу "ORM-модель" с Pydantic:

my_obj = MyUser()
alex = User.model_validate(my_obj, from_attributes=True)
print(alex.model_dump())

Результат

{
    'id': 3,
    'name': 'Алексей',
    'surname': 'Яковенко',
    'birthday_date': datetime.date(1993, 2, 19),
    'full_name': 'Алексей Яковенко',
    'age': '31 лет, 7 месяцев и 29 дней'
}

Почему это работает

Этот подход эффективен благодаря мощи объектно-ориентированного программирования в Python. Создавая простой класс MyUser, вы фактически имитируете поведение ORM-модели. Pydantic способен работать с этим классом так же, как он работал бы с реальной ORM-моделью, извлекая атрибуты и применяя свою логику валидации и преобразования.

Такой метод позволяет легко тестировать и демонстрировать функциональность Pydantic без необходимости настройки полноценной базы данных, что особенно удобно для обучения и быстрого прототипирования.

Друзья, решил поделиться с вами универсальным методом получения UserID пользователя в приложениях Telegram-ботов с MiniApp. Этот подход позволит получить UserID из командного меню, текстовых и инлайн кнопок.

1. Выполняем импорт JS TelegramWEBApp

<script src="https://telegram.org/js/telegram-web-app.js"></script>

2. Пишем функцию

async function getUserID() {
    const tg = window.Telegram.WebApp;
    if (tg.initDataUnsafe?.user?.id) {
        console.log("User data from Telegram:", JSON.stringify(tg.initDataUnsafe.user));
        return tg.initDataUnsafe.user.id;
    }

    const urlParams = new URLSearchParams(window.location.search);
    const userID = urlParams.get('user_id');
    if (userID) {
        console.log("User ID from URL:", userID);
        return userID;
    }

    throw new Error("User ID not available");
}

- Сначала она пытается получить ID из объекта Telegram Web App, что работает для командного меню и инлайн-кнопок.
- Если первый метод не сработал, функция ищет параметр 'user_id' в URL, что позволяет передавать ID через текстовые кнопки (не забудьте только подставить параметр запроса, чтоб получилась ссылка такого вида: https://your_site.ru?user_id=12345).
- Если оба метода не дали результата, функция выбрасывает ошибку.

Проект QRCodeMaster наконец-то готов! В ходе разработки пришлось пересмотреть несколько подходов, но теперь я полностью доволен результатом.

Бот представляет собой MiniApp + Telegram-бота с функциями:

📷 Сканирование QR-кодов в реальном времени через камеру.
📤 Распознавание QR-кодов на загруженных изображениях.
✨ Создание новых QR-кодов с возможностью кастомизации.

Как и в предыдущем проекте, всё работает в одном приложении на FastAPI, которое использует вебхуки для высокой скорости обработки запросов. В боте я использовал две JavaScript библиотеки:

jsQR — для сканирования QR-кодов через камеру и загрузку изображений.
EasyQRCodeJS — для генерации QR-кодов.

Проект уже доступен на GitHub, а бота можно протестировать здесь: @qr_code_masterBOT.

К среде постараюсь выложить на Хабре подробную статью о разработке с детальным описанием всех этапов.

Новая статья готова. Сегодня ее вечером вычитаю и завтра к утру, если без форс-мажоров, выполню публикацию. Будете ждать?

​​Друзья, доброе утро! ☀️

Я рад представить вам новую статью на Хабре, где я подробно разобрал проект Telegram-бота с вебхуками и MiniApp, обслуживаемого на FastAPI. В этот раз я постарался максимально упростить подачу материала, сосредоточив внимание на самой теме статьи. 📚

Проект представляет собой бота, который умеет генерировать QR-коды, сканировать их с камеры устройства в реальном времени, а также работать с QR-кодами, загруженными с фото. 🎥📱 Информация, сгенерированная ботом (QR-код или данные с отсканированного кода), возвращается пользователю прямо в бота.

Особое внимание в статье я уделил передаче данных между ботом и MiniApp. После прочтения у вас точно не останется вопросов о том, как получить информацию о пользователе на странице MiniApp и отправить её обратно в бот, независимо от способа входа. 🔄

Из новинок вы также узнаете, как отправлять медиа с помощью Aiogram 3, используя Base64 строки, и работать с BuferInputFile. 🛠

Проект получился действительно интересным, так что не пропустите! 😉

Ссылку на статью, проект на GitHub и на работающего бота закрепил под этим постом. 🤖

С нетерпением жду ваши отзывы и комментарии! ✉️

Оставить комментарии к статье "Создание Telegram Web App с FastAPI: Генерация, сканирование QR-кодов камерой устройства и деплой за 5 минут" можно тут👇

У меня уже давно лежит исходник игры 2048. HTML + CSS + пару JavaScript библиотек. Подумал о том, что можно было бы прикрутить эту легендарную игру к телеграмм боту.

Концепт такой. В боте можно будет смотреть свой рекорд + список рекордов других игроков (топ-10). Прикрутим к этому делу базу данных.

А в самой игре как на скрине будет.

То есть. Полноценный телеграмм бот-игра. Хотели бы чтоб я сделал такой проект, а потом рассказал как такое пишется?

Процесс идет. Если получится то сегодня полный исходник презентую, а к понедельнику будет готова статья.

Наконец-то проект завершён! 🎉

Представляю вам 2048Bot — MiniApp и Telegram-бот для классической игры 2048 прямо в вашем мессенджере! Бот не только позволяет сыграть в увлекательную головоломку, но и сохраняет ваш лучший результат, чтобы вы могли соревноваться с другими игроками. Среди основных функций:

- Сохранение рекордов
- Просмотр списка лучших достижений
- Удобное локальное хранилище прогресса

На днях я также опубликую статью на Хабре, где поделюсь процессом разработки и основными решениями, применёнными в этом проекте. Ждите её во вторник, а может и раньше 😉

Исходный код проекта: GitHub
Поклацать бота: @fast_api_2048BOT

Все по-плану. Завтра в течении дня вычитаю и во вторник публикация

📢 Доброе утро, друзья!

На Хабре уже доступна моя новая статья: "Игра 2048 в вашем Telegram-боте: как создать MiniApp с помощью FastAPI и Aiogram". В ней я постарался максимально подробно разобрать, как внедрить легендарную головоломку 2048 в Telegram-бот.

Что я использовал для разработки:

- FastAPI — для реализации API методов и обработки вебхуков,
- Aiogram — для создания Telegram-бота и управления его сообщениями,
- SQLAlchemy + Alembic — для работы с базой данных и миграций,
- SQLite — для хранения рекордов игроков.

Функции бота:

🎮 Играйте в 2048: получите доступ к классической игре прямо в Telegram.
🏆 Рекорды: сохраняйте личные достижения и сравнивайте с другими игроками.
📋 Локальное хранилище: текущие данные сохраняются локально, чтобы можно было быстро продолжить игру.
🔄 Просмотр и очистка рекордов: можете увидеть свои лучшие результаты или обновить их, если решите начать с чистого листа.

Бот уже полностью рабочий — можно попробовать свои силы и побить рекорды! Все ссылки здесь:

👾 Попробовать 2048Bot

📝 Статья на Хабре

💻 Исходный код на GitHub

Надеюсь на вашу поддержку — буду рад комментариям и лайкам!

Я не забыл. Сегодня презентация😉