Мне с периодичностью требуется создать бота в Telegram для моих клиентов. Я понимаю, что есть достаточно библиотек, для их создания, но я всегда испытывал некоторые проблемы используя их.
- Мне хотелось иметь минимальный набор функций, а именно описание Telegram типов и методов. Чтобы моя IDE (PHPStorm) могла мне подсказывать какие параметры нужно заполнить, для того или иного метода Telegram.
- Все библиотеки которые я использовал до этого, не могли обновляться часто, новые функции из API приходили слишком поздно.
- Некоторые библиотеки содержат кучу не нужного мне функционала или логики.
В ручную отслеживать, что изменилось с момента последнего обновления Telegram Bot API, сложно, или невозможно. Изучив HTML-разметку документации, мне пришла идея создать парсер, который решит проблему поиска изменений в API. Благодаря которой, я теперь могу получать документированную последнюю версию Bot API, буквально за несколько команд в консоли.
🎁 Пример работы генератора: mahlenko/telegram-bot-casts - вы можете использовать его в своем проекте.
Просто склонируйте репозиторий себе, и запустите несколько команд:
php console telegram:parse- для парсинга актуальной документации в JSON файл.php console telegram:generate- для генерации PHP файлов.
✅ Готово! Заберите сгенерированные файлы из директории build себе в проект.
ParserDocumentation- Парсит документацию Telegram в JSON файл. Результат его работы можно наблюдать в файле versions/7.2.jsonCodeGenerator/Generator/PHPGenerator- Использует полученный JSON с документацией, генерируя PHP файлы для типов и методов в каталогbuildв корне проекта. Результат его работы можно увидеть тут mahlenko/telegram-bot-casts. Используйте данный репозиторий в своем проекте, если не хотите заморочек с генерацией.
Вы можете, написать собственный генератор для других ЯП, например файлы TypeScript для NodeJS. Поделитесь со мной, вашим генератором, я добавлю его в репозиторий :)
Вы всегда можете отправить благодарность на чашку кофе или больше 😉 с помощью TON на мой кошелек
appto-wallet.ton