{"id":29871343,"url":"https://github.com/falbue/telegramtextapp","last_synced_at":"2025-08-10T14:08:43.183Z","repository":{"id":226507552,"uuid":"766900364","full_name":"falbue/TelegramTextApp","owner":"falbue","description":"TTA - надстройка, для упрощения создания ботов в telegram","archived":false,"fork":false,"pushed_at":"2025-08-09T19:03:38.000Z","size":368,"stargazers_count":0,"open_issues_count":8,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-09T20:36:11.708Z","etag":null,"topics":["automation","falpin","python","python-3","telegram","telegram-api","telegram-bot","telegram-bot-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/falbue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2024-03-04T10:42:25.000Z","updated_at":"2025-08-09T19:03:29.000Z","dependencies_parsed_at":"2024-09-13T04:39:56.682Z","dependency_job_id":"02c5b794-17cf-4091-a379-d7158dfa8b3a","html_url":"https://github.com/falbue/TelegramTextApp","commit_stats":null,"previous_names":["falbue/chenk-timetable","falbue/telegram-text-apps","falbue/telegramtextapp","falpin/telegramtextapp"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/falbue/TelegramTextApp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falbue%2FTelegramTextApp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falbue%2FTelegramTextApp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falbue%2FTelegramTextApp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falbue%2FTelegramTextApp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/falbue","download_url":"https://codeload.github.com/falbue/TelegramTextApp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/falbue%2FTelegramTextApp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269734149,"owners_count":24466554,"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","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["automation","falpin","python","python-3","telegram","telegram-api","telegram-bot","telegram-bot-api"],"created_at":"2025-07-30T19:19:32.950Z","updated_at":"2025-08-10T14:08:43.165Z","avatar_url":"https://github.com/falbue.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TelegramTextApp\n**TelegramTextApp** — это надстройка над [telebot](https://github.com/aiogram/aiogram), которая упрощает создание бота в **telegram**\n\n## 🌟 Особенности\n- Создание всех меню в одном файле\n- Для запуска, нужен только API-ключ\n- Быстрое создание макета бота\n\n## ⚙️ Установка и настройка\n\n### Требования\n- Python 3.10 или новее\n- Аккаунт Telegram\n\n### Шаги:\n#### Установка библиотеки\n```bash\npip install TelegramTextApp\n```\n#### Первый запуск\n```python\nimport TelegramTextApp\nif __name__ == \"__main__\":\n    TelegramTextApp.start(\n        token=\"bot_token\",\n        json_file=\"путь_к_json_файлу.json\",\n        database=\"путь_к_базе_данных.db\",\n        debug=False\n        )\n```\n# Минимальная структура бота\n\n## Структура для хранения атрибутов\n```json\n{\n    \"bot\":{},\n    \"menu\":{},\n    \"mini_menu\":{},\n    \"buttons\":{},\n    \"commands\":{}\n}\n```\n\n## Создание меню\n```json\n\"название_меню\":{\n  \"row\":2, // ширина клавиатуры,\n\n  \"text\":\"Любой текст. *Можно* _использовать_ __markdown__ ||разметку|| [telegram](telegram.com)\",\n\n  \"keyboard\":{\n    \"название_меню_которое_нужно_открыть\":\"Текст_кнопки\",\n    \"menu_name|{динамическая_вставка_данных}\":\"Текст_кнопки\"\n  },\n  \"keyboard\":\"название_вашей_функции\", // создание своей клавиатуры \n\n  \"return\":\"название_меню\", // кнопка возврата в указаное меню\n\n  \"function\":\"название_вашей функции\", // выполнение вашей функции, при открытии меню (можно передавать динамические параметры)\n\n  \"input\": { // ожидание отправки сообщения от пользователя с последующим выполнением\n    \"function\":\"название_вашей_функции\",\n    \"menu\":\"название_меню_которое_откроется\",\n    \"data\":\"название динамического параматра\"\n  }\n}\n```\n\n## Создание команды\n```json\n\"название_команды\":{\n  \"menu\":\"название_меню_которое_откроется\",\n  \"description\":\"Краткое описание команды\"\n},\n```\n\n## Обязательные кнопки\n```json\n\"buttons\":{\n    \"return\":\"🔙 Назад\",\n    \"notification\":\"Прочитано\"\n},\n```\n\n# Кастомные функции\n\n## Функция для создания кнопок\n```python\nasync def create_my_buttons(tta_data):\n    buttons = {}\n    buttons['название_меню'] = \"Текст кнопки\"\n    return {\"название_меню_которое_нужно_открыть\":\"Текст_кнопки\"}\n```\n\n## Функция с возвратом динамического параметра\n```python\ndef my_text(tta_data=None):\n    text = \"Это мой текст\"\n    return {\"название_параметра\":\"значение параметра\"}\n```\n\n# 🤝 Как внести вклад\n- Форкните репозиторий\n- Создайте ветку с фичей/исправлением:\n- Зафиксируйте изменения и отправьте в форк\n- Создайте Pull Request с описанием изменений\n\n# 📬 Обратная связь\n- **Автор:** [falbue](https://github.com/falbue)\n- **Баги и предложения:** [Issues](https://github.com/falpin/TelegramTextApp/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffalbue%2Ftelegramtextapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffalbue%2Ftelegramtextapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffalbue%2Ftelegramtextapp/lists"}