{"id":22156239,"url":"https://github.com/appto-dev/telegram-api-parser","last_synced_at":"2025-10-12T15:31:37.574Z","repository":{"id":152141654,"uuid":"555754189","full_name":"appto-dev/telegram-api-parser","owner":"appto-dev","description":"Парсинг Telegram Bot API и генерация PHP файлов типов и методов.","archived":false,"fork":false,"pushed_at":"2025-01-02T01:45:54.000Z","size":730,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-02T02:52:58.705Z","etag":null,"topics":["bot","parser","parser-library","telegram","telegram-bot","telegram-parser"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/appto-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-22T08:43:48.000Z","updated_at":"2025-01-02T01:45:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"1c221726-e2e8-43d4-8ed2-2959878812a0","html_url":"https://github.com/appto-dev/telegram-api-parser","commit_stats":null,"previous_names":["appto-dev/telegram-api-parser"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appto-dev%2Ftelegram-api-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appto-dev%2Ftelegram-api-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appto-dev%2Ftelegram-api-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appto-dev%2Ftelegram-api-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appto-dev","download_url":"https://codeload.github.com/appto-dev/telegram-api-parser/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236240277,"owners_count":19117343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","parser","parser-library","telegram","telegram-bot","telegram-parser"],"created_at":"2024-12-02T02:38:56.371Z","updated_at":"2025-10-12T15:31:37.569Z","avatar_url":"https://github.com/appto-dev.png","language":"PHP","readme":"# Парсер документации Telegram\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nМне с периодичностью требуется создать бота в Telegram для моих клиентов.\nЯ понимаю, что есть достаточно библиотек, для их создания, \nно я всегда испытывал некоторые проблемы используя их.\n\n - Мне хотелось иметь минимальный набор функций, а именно описание Telegram типов и методов. Чтобы моя IDE (PHPStorm) могла мне подсказывать какие параметры нужно заполнить, для того или иного метода Telegram.\n - Все библиотеки которые я использовал до этого, не могли обновляться часто, новые функции из API приходили слишком поздно.\n - Некоторые библиотеки содержат кучу не нужного мне функционала или логики.\n\nВ ручную отслеживать, что изменилось с момента последнего обновления Telegram Bot API, сложно, или невозможно.\nИзучив HTML-разметку документации, мне пришла идея создать парсер, который решит проблему поиска изменений в API.\nБлагодаря которой, я теперь могу получать документированную последнюю версию Bot API, буквально за несколько команд в консоли.\n\n🎁 Пример работы генератора: [mahlenko/telegram-bot-cast-laravel](https://github.com/mahlenko/telegram-bot-cast-laravel) - вы можете использовать его в своем проекте.\n\n## 🚀 GitHub Action\nДобавлен workflow, который раз в день получает последнюю версию Telegram Bot API. \nЕсли версия обновилась, сгенерирует новые файлы для репозитория [mahlenko/telegram-bot-cast-laravel](https://github.com/mahlenko/telegram-bot-cast-laravel)\nтеперь там всегда \"свежая\" сборка.\n\n## Установка и использование\nПросто склонируйте репозиторий себе, и запустите несколько команд:\n - `php console telegram:parse` - для парсинга актуальной документации в JSON файл.\n - `php console telegram:generate` - для генерации PHP файлов.\n\n✅ Готово! Заберите сгенерированные файлы из директории `build` себе в проект.\n\n## Расширение сгенерированных классов\nДля простой работы с классами, может понадобится их расширить собственным классом.\nНапример, для работы в Laravel, я использую библиотеку [Spatie Laravel Data](https://github.com/spatie/laravel-data), по сути библиотека делает удобной работу с DTO.\nТакже библиотека дает подсказки IDE по ключам, при создании класса.\n\n```php\n\\Method\\SendMessage::from([\n    'chat_id' =\u003e 0000000,\n    'text' =\u003e 'Your message'\n])\n```\n\nДля генерации расширенных классов используйте аргумент `--extends`:\n```shell\nphp console telegram:generate --extends=\\\\Spatie\\\\LaravelData\\\\Data\n```\n\nПосле чего, сгенерированные классы получат ваше расширение и все возможности нового класса:\n```php\nfinal class SendMessage extends \\Spatie\\LaravelData\\Data {\n    // ...\n}\n```\n\nВажно! Ваш класс должен реализовывать метод `toArray()`.\n\n## Зависимости\n\n- [imangazaliev/didom](https://github.com/nette/php-generatorhttps://github.com/Imangazaliev/DiDOM)\n- [nette/php-generator](https://github.com/nette/php-generator)\n- [symfony/console](https://symfony.com/components/Console)\n\n## ✨ Благодарности\n\n![TonBlockchainLogo](/ton_logo_dark_background.svg#gh-dark-mode-only)\n![TonBlockchainLogo](/ton_logo_light_background.svg#gh-light-mode-only)\n\nВы всегда можете отправить благодарность на чашку кофе или больше 😉 с помощью TON на мой кошелек\n`developer01.ton`","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappto-dev%2Ftelegram-api-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappto-dev%2Ftelegram-api-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappto-dev%2Ftelegram-api-parser/lists"}