# Django Telegram Framework
Библиотека (Framework) для быстрого создания **Telegram** ботов и интеграции с django
[Тут][documentation_path] можно найти **Полную документацию проекта**
<hr>
#### Workflows
[![Tests](https://github.com/quillcraftsman/django-telegram-framework/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/quillcraftsman/django-telegram-framework/actions/workflows/run-tests.yml)
[![Pylint](https://github.com/quillcraftsman/django-telegram-framework/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/quillcraftsman/django-telegram-framework/actions/workflows/lint.yml)
#### Package
[![Version](https://img.shields.io/pypi/v/django-telegram-framework.svg)](https://pypi.python.org/pypi/django-telegram-framework/)
[![Development Status](https://img.shields.io/pypi/status/django-telegram-framework.svg)](https://pypi.python.org/pypi/django-telegram-framework)
[![Python version](https://img.shields.io/pypi/pyversions/django-telegram-framework.svg)](https://pypi.python.org/pypi/django-telegram-framework/)
[![License](https://img.shields.io/pypi/l/django-telegram-framework)](https://github.com/quillcraftsman/django-telegram-framework/blob/main/LICENSE)
[![Wheel](https://img.shields.io/pypi/wheel/django-telegram-framework.svg)](https://pypi.python.org/pypi/django-telegram-framework/)
#### Support
[![Documentation](https://img.shields.io/badge/docs-0094FF.svg)][documentation_path]
[![Discussions](https://img.shields.io/badge/discussions-ff0068.svg)](https://github.com/quillcraftsman/django-telegram-framework/discussions/)
[![Issues](https://img.shields.io/badge/issues-11AE13.svg)](https://github.com/quillcraftsman/django-telegram-framework/issues/)
#### Downloads
[![Day Downloads](https://img.shields.io/pypi/dd/django-telegram-framework)](https://pepy.tech/project/django-telegram-framework)
[![Week Downloads](https://img.shields.io/pypi/dw/django-telegram-framework)](https://pepy.tech/project/django-telegram-framework)
[![Month Downloads](https://img.shields.io/pypi/dm/django-telegram-framework)](https://pepy.tech/project/django-telegram-framework)
[![All Downloads](https://img.shields.io/pepy/dt/django-telegram-framework)](https://pepy.tech/project/django-telegram-framework)
#### Languages
[![Languages](https://img.shields.io/github/languages/count/quillcraftsman/django-telegram-framework)](https://github.com/quillcraftsman/django-telegram-framework)
[![Top Language](https://img.shields.io/github/languages/top/quillcraftsman/django-telegram-framework)](https://github.com/quillcraftsman/django-telegram-framework)
#### Development
- [![Release date](https://img.shields.io/github/release-date/quillcraftsman/django-telegram-framework
)](https://github.com/quillcraftsman/django-telegram-framework/releases)
[![Last Commit](https://img.shields.io/github/last-commit/quillcraftsman/django-telegram-framework/main
)](https://github.com/quillcraftsman/django-telegram-framework)
- [![Issues](https://img.shields.io/github/issues/quillcraftsman/django-telegram-framework
)](https://github.com/quillcraftsman/django-telegram-framework/issues/)
[![Closed Issues](https://img.shields.io/github/issues-closed/quillcraftsman/django-telegram-framework
)](https://github.com/quillcraftsman/django-telegram-framework/issues/)
- [![Pull Requests](https://img.shields.io/github/issues-pr/quillcraftsman/django-telegram-framework
)](https://github.com/quillcraftsman/django-telegram-framework/pulls)
[![Closed Pull Requests](https://img.shields.io/github/issues-pr-closed-raw/quillcraftsman/django-telegram-framework
)](https://github.com/quillcraftsman/django-telegram-framework/pulls)
- [![Discussions](https://img.shields.io/github/discussions/quillcraftsman/django-telegram-framework
)](https://github.com/quillcraftsman/django-telegram-framework/discussions/)
[//]: # (#### Repository Stats)
[//]: # ([![Stars](https://img.shields.io/github/stars/quillcraftsman/django-telegram-framework)
[//]: # ()](https://github.com/quillcraftsman/django-telegram-framework))
[//]: # ([![Contributors](https://img.shields.io/github/contributors/quillcraftsman/django-telegram-framework)
[//]: # ()](https://github.com/quillcraftsman/django-telegram-frameworkgraphs/contributors))
[//]: # ([![Forks](https://img.shields.io/github/forks/quillcraftsman/django-telegram-framework)
[//]: # ()](https://github.com/quillcraftsman/django-telegram-framework))
<hr>
## Menu
- [Идея проекта](#идея-проекта)
- [Проект с открытым исходным кодом](#проект-с-открытым-исходным-кодом)
- [Отличие от других Telegram проектов](#отличие-от-других-telegram-проектов)
- [Функции библиотеки](#функции-библиотеки)
- [Зависимости](#зависимости)
- [Статус разработки](#статус-разработки)
- [Установка](#установка)
- [Быстрый старт](#быстрый-старт)
- [Внести свой вклад в проект](#внести-свой-вклад-в-проект)
## Идея проекта
Создать удобный и надежный framework для быстрого и удобного создания telegram ботов который:
- Имеет чёткую структуру модулей
- Может использовать разные библиотеки для взаимодействия с telegram (pyTelegramBotAPI, Telethone, python-telegram-bot, aiogram и другие)
- Позволяет быстро реализовать start-up проект одному разработчику или в небольшой команде
- Имеет интеграцию с django для соднаия web страниц и использования django admin
- Быстро подключается к базе данных с помощью Django ORM
## Проект с открытым исходным кодом
Это проект с открытым исходным кодом с лицензией [Happy Code](LICENSE).
- Свободное использование
- создание Forks
- публикация issues и bugs
- contributions
очень приветствуются
## Отличие от других Telegram проектов
В отличие от библиотек для создания telegram ботов, таких как pyTelegramBotAPI, aiogram, python-telegram-bot и других,
этот проект (Framework) имеет чёткую структуру, похожую на структуру django проектов. Framework содержит следующие элементы:
- models - модели данных связанные с базой данных с помощью Django ORM
- handlers - обработчики событий telegram bot-а (аналогия с django views)
- bot - связь команд и событий бота с обработчиками (аналогия с django urls)
- settings - настройки для всего проекта - django settings
- tests - тесты логики бота с использованием специального Dummy Bot
Под капотом Framework может использовать разные библиотеки в синхронном и асинхронном исполнении. Можно переключать одни библиотеки на другие.
Без соединения с telegram (например в DEV) режиме, можно использовать Dummy Bot для разработки и тестирования.
Интеграция с django позволяет:
- Добавить web site
- Использовать django админку
- Использовать django ORM
## Функции библиотеки
- Интеграция telegram бота в django проект (В разработке)
- Понятная структура и интерфейсы для разработки бота (В разработке)
- Функции автоматического тестирования бота (В разработке)
- Совместимость с синхронным pyTelegramBotAPI (В разработке)
- Совместимость с асинхронным pyTelegramBotAPI (В разработке)
- DummyBot для тестирования и работы без подключения к telegram (В разработке)
- Основные функции телеграм бота (В разработке)
- Все функции телеграм бота (На этапе планирования)
- Совместимость с aiogram, python-telegram-bot, Telethone (На этапе планирования)
## Зависимости
- django > 5
- pyTelegramBotAPi
- Подробности в [Полной документации](https://quillcraftsman.github.io/django-telegram-framework/about.html#requirements)
## Статус разработки
Разработка только началась
- Пакет уже доступен в [PyPi](https://pypi.org/project/django-telegram-framework/)
- Подробности в [Полной документации](https://quillcraftsman.github.io/django-telegram-framework/about.html#development-status)
## Установка
### with pip
```commandline
pip install django-telegram-framework
```
Подробности в [Полной документации](https://quillcraftsman.github.io/django-telegram-framework/install.html)
## Быстрый старт
Добавить пакет в `INSTALLED_APPS` django проекта
```python
INSTALLED_APPS = [
...,
'telegram_framework',
]
```
Запустить команду с информацией
```commandline
python manage.py package_info
```
### Больше примеров в [Полной документации][documentation_path]
## Внести свой вклад в проект
Без проблем! Для быстрого старта можно ознакомиться с:
- [Полной документацией][documentation_path]
- [Как внести свой вклад](CONTRIBUTING.md)
- [Документацией для разработчиков](https://quillcraftsman.github.io/django-telegram-framework/dev_documentation.html)
- [Нормами поведения](CODE_OF_CONDUCT.md)
- [Политикой безопасности](SECURITY.md)
- [Структурой управления проектом](GOVERNANCE.md)
- [Файлом поддержки](SUPPORT.md)
[documentation_path]: https://quillcraftsman.github.io/django-telegram-framework
Raw data
{
"_id": null,
"home_page": "https://github.com/quillcraftsman/django-telegram-framework",
"name": "django-telegram-framework",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": null,
"keywords": "django, telegram, telegram-bot, framework, testing",
"author": "quillcraftsman",
"author_email": "quill@craftsman.lol",
"download_url": "https://files.pythonhosted.org/packages/62/a0/7f81a020c5fe540231ac8e2ccb0f3b89116dd422ba775ab43d2ab58600c2/django_telegram_framework-0.0.2.tar.gz",
"platform": null,
"description": "# Django Telegram Framework\n\n\u0411\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 (Framework) \u0434\u043b\u044f \u0431\u044b\u0441\u0442\u0440\u043e\u0433\u043e \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f **Telegram** \u0431\u043e\u0442\u043e\u0432 \u0438 \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u0438 \u0441 django\n\n[\u0422\u0443\u0442][documentation_path] \u043c\u043e\u0436\u043d\u043e \u043d\u0430\u0439\u0442\u0438 **\u041f\u043e\u043b\u043d\u0443\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044e \u043f\u0440\u043e\u0435\u043a\u0442\u0430** \n\n<hr>\n\n#### Workflows\n[![Tests](https://github.com/quillcraftsman/django-telegram-framework/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/quillcraftsman/django-telegram-framework/actions/workflows/run-tests.yml)\n[![Pylint](https://github.com/quillcraftsman/django-telegram-framework/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/quillcraftsman/django-telegram-framework/actions/workflows/lint.yml)\n\n#### Package\n[![Version](https://img.shields.io/pypi/v/django-telegram-framework.svg)](https://pypi.python.org/pypi/django-telegram-framework/)\n[![Development Status](https://img.shields.io/pypi/status/django-telegram-framework.svg)](https://pypi.python.org/pypi/django-telegram-framework)\n[![Python version](https://img.shields.io/pypi/pyversions/django-telegram-framework.svg)](https://pypi.python.org/pypi/django-telegram-framework/)\n[![License](https://img.shields.io/pypi/l/django-telegram-framework)](https://github.com/quillcraftsman/django-telegram-framework/blob/main/LICENSE)\n[![Wheel](https://img.shields.io/pypi/wheel/django-telegram-framework.svg)](https://pypi.python.org/pypi/django-telegram-framework/)\n\n#### Support\n[![Documentation](https://img.shields.io/badge/docs-0094FF.svg)][documentation_path]\n[![Discussions](https://img.shields.io/badge/discussions-ff0068.svg)](https://github.com/quillcraftsman/django-telegram-framework/discussions/)\n[![Issues](https://img.shields.io/badge/issues-11AE13.svg)](https://github.com/quillcraftsman/django-telegram-framework/issues/)\n\n#### Downloads\n[![Day Downloads](https://img.shields.io/pypi/dd/django-telegram-framework)](https://pepy.tech/project/django-telegram-framework)\n[![Week Downloads](https://img.shields.io/pypi/dw/django-telegram-framework)](https://pepy.tech/project/django-telegram-framework)\n[![Month Downloads](https://img.shields.io/pypi/dm/django-telegram-framework)](https://pepy.tech/project/django-telegram-framework)\n[![All Downloads](https://img.shields.io/pepy/dt/django-telegram-framework)](https://pepy.tech/project/django-telegram-framework)\n\n#### Languages\n[![Languages](https://img.shields.io/github/languages/count/quillcraftsman/django-telegram-framework)](https://github.com/quillcraftsman/django-telegram-framework)\n[![Top Language](https://img.shields.io/github/languages/top/quillcraftsman/django-telegram-framework)](https://github.com/quillcraftsman/django-telegram-framework)\n\n#### Development\n- [![Release date](https://img.shields.io/github/release-date/quillcraftsman/django-telegram-framework\n)](https://github.com/quillcraftsman/django-telegram-framework/releases)\n[![Last Commit](https://img.shields.io/github/last-commit/quillcraftsman/django-telegram-framework/main\n)](https://github.com/quillcraftsman/django-telegram-framework)\n- [![Issues](https://img.shields.io/github/issues/quillcraftsman/django-telegram-framework\n)](https://github.com/quillcraftsman/django-telegram-framework/issues/)\n[![Closed Issues](https://img.shields.io/github/issues-closed/quillcraftsman/django-telegram-framework\n)](https://github.com/quillcraftsman/django-telegram-framework/issues/)\n- [![Pull Requests](https://img.shields.io/github/issues-pr/quillcraftsman/django-telegram-framework\n)](https://github.com/quillcraftsman/django-telegram-framework/pulls)\n[![Closed Pull Requests](https://img.shields.io/github/issues-pr-closed-raw/quillcraftsman/django-telegram-framework\n)](https://github.com/quillcraftsman/django-telegram-framework/pulls)\n- [![Discussions](https://img.shields.io/github/discussions/quillcraftsman/django-telegram-framework\n)](https://github.com/quillcraftsman/django-telegram-framework/discussions/)\n\n[//]: # (#### Repository Stats)\n\n[//]: # ([![Stars](https://img.shields.io/github/stars/quillcraftsman/django-telegram-framework)\n\n[//]: # ()](https://github.com/quillcraftsman/django-telegram-framework))\n\n[//]: # ([![Contributors](https://img.shields.io/github/contributors/quillcraftsman/django-telegram-framework)\n\n[//]: # ()](https://github.com/quillcraftsman/django-telegram-frameworkgraphs/contributors))\n\n[//]: # ([![Forks](https://img.shields.io/github/forks/quillcraftsman/django-telegram-framework)\n\n[//]: # ()](https://github.com/quillcraftsman/django-telegram-framework))\n\n<hr>\n\n## Menu\n\n- [\u0418\u0434\u0435\u044f \u043f\u0440\u043e\u0435\u043a\u0442\u0430](#\u0438\u0434\u0435\u044f-\u043f\u0440\u043e\u0435\u043a\u0442\u0430)\n- [\u041f\u0440\u043e\u0435\u043a\u0442 \u0441 \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u043c \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u043c \u043a\u043e\u0434\u043e\u043c](#\u043f\u0440\u043e\u0435\u043a\u0442-\u0441-\u043e\u0442\u043a\u0440\u044b\u0442\u044b\u043c-\u0438\u0441\u0445\u043e\u0434\u043d\u044b\u043c-\u043a\u043e\u0434\u043e\u043c)\n- [\u041e\u0442\u043b\u0438\u0447\u0438\u0435 \u043e\u0442 \u0434\u0440\u0443\u0433\u0438\u0445 Telegram \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432](#\u043e\u0442\u043b\u0438\u0447\u0438\u0435-\u043e\u0442-\u0434\u0440\u0443\u0433\u0438\u0445-telegram-\u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432)\n- [\u0424\u0443\u043d\u043a\u0446\u0438\u0438 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438](#\u0444\u0443\u043d\u043a\u0446\u0438\u0438-\u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438)\n- [\u0417\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438](#\u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438)\n- [\u0421\u0442\u0430\u0442\u0443\u0441 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438](#\u0441\u0442\u0430\u0442\u0443\u0441-\u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438)\n- [\u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430](#\u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430)\n- [\u0411\u044b\u0441\u0442\u0440\u044b\u0439 \u0441\u0442\u0430\u0440\u0442](#\u0431\u044b\u0441\u0442\u0440\u044b\u0439-\u0441\u0442\u0430\u0440\u0442)\n- [\u0412\u043d\u0435\u0441\u0442\u0438 \u0441\u0432\u043e\u0439 \u0432\u043a\u043b\u0430\u0434 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442](#\u0432\u043d\u0435\u0441\u0442\u0438-\u0441\u0432\u043e\u0439-\u0432\u043a\u043b\u0430\u0434-\u0432-\u043f\u0440\u043e\u0435\u043a\u0442)\n\n## \u0418\u0434\u0435\u044f \u043f\u0440\u043e\u0435\u043a\u0442\u0430\n\n\u0421\u043e\u0437\u0434\u0430\u0442\u044c \u0443\u0434\u043e\u0431\u043d\u044b\u0439 \u0438 \u043d\u0430\u0434\u0435\u0436\u043d\u044b\u0439 framework \u0434\u043b\u044f \u0431\u044b\u0441\u0442\u0440\u043e\u0433\u043e \u0438 \u0443\u0434\u043e\u0431\u043d\u043e\u0433\u043e \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f telegram \u0431\u043e\u0442\u043e\u0432 \u043a\u043e\u0442\u043e\u0440\u044b\u0439:\n\n- \u0418\u043c\u0435\u0435\u0442 \u0447\u0451\u0442\u043a\u0443\u044e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443 \u043c\u043e\u0434\u0443\u043b\u0435\u0439\n- \u041c\u043e\u0436\u0435\u0442 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0440\u0430\u0437\u043d\u044b\u0435 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u0434\u043b\u044f \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f \u0441 telegram (pyTelegramBotAPI, Telethone, python-telegram-bot, aiogram \u0438 \u0434\u0440\u0443\u0433\u0438\u0435)\n- \u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u0431\u044b\u0441\u0442\u0440\u043e \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u0442\u044c start-up \u043f\u0440\u043e\u0435\u043a\u0442 \u043e\u0434\u043d\u043e\u043c\u0443 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0443 \u0438\u043b\u0438 \u0432 \u043d\u0435\u0431\u043e\u043b\u044c\u0448\u043e\u0439 \u043a\u043e\u043c\u0430\u043d\u0434\u0435\n- \u0418\u043c\u0435\u0435\u0442 \u0438\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044e \u0441 django \u0434\u043b\u044f \u0441\u043e\u0434\u043d\u0430\u0438\u044f web \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u0438 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f django admin\n- \u0411\u044b\u0441\u0442\u0440\u043e \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u0442\u0441\u044f \u043a \u0431\u0430\u0437\u0435 \u0434\u0430\u043d\u043d\u044b\u0445 \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e Django ORM\n\n## \u041f\u0440\u043e\u0435\u043a\u0442 \u0441 \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u043c \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u043c \u043a\u043e\u0434\u043e\u043c\n\n\u042d\u0442\u043e \u043f\u0440\u043e\u0435\u043a\u0442 \u0441 \u043e\u0442\u043a\u0440\u044b\u0442\u044b\u043c \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u043c \u043a\u043e\u0434\u043e\u043c \u0441 \u043b\u0438\u0446\u0435\u043d\u0437\u0438\u0435\u0439 [Happy Code](LICENSE). \n\n- \u0421\u0432\u043e\u0431\u043e\u0434\u043d\u043e\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\n- \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u0435 Forks\n- \u043f\u0443\u0431\u043b\u0438\u043a\u0430\u0446\u0438\u044f issues \u0438 bugs\n- contributions\n\n\u043e\u0447\u0435\u043d\u044c \u043f\u0440\u0438\u0432\u0435\u0442\u0441\u0442\u0432\u0443\u044e\u0442\u0441\u044f\n\n## \u041e\u0442\u043b\u0438\u0447\u0438\u0435 \u043e\u0442 \u0434\u0440\u0443\u0433\u0438\u0445 Telegram \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432\n\u0412 \u043e\u0442\u043b\u0438\u0447\u0438\u0435 \u043e\u0442 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a \u0434\u043b\u044f \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f telegram \u0431\u043e\u0442\u043e\u0432, \u0442\u0430\u043a\u0438\u0445 \u043a\u0430\u043a pyTelegramBotAPI, aiogram, python-telegram-bot \u0438 \u0434\u0440\u0443\u0433\u0438\u0445,\n\u044d\u0442\u043e\u0442 \u043f\u0440\u043e\u0435\u043a\u0442 (Framework) \u0438\u043c\u0435\u0435\u0442 \u0447\u0451\u0442\u043a\u0443\u044e \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443, \u043f\u043e\u0445\u043e\u0436\u0443\u044e \u043d\u0430 \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0443 django \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u0432. Framework \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0435 \u044d\u043b\u0435\u043c\u0435\u043d\u0442\u044b:\n\n- models - \u043c\u043e\u0434\u0435\u043b\u0438 \u0434\u0430\u043d\u043d\u044b\u0445 \u0441\u0432\u044f\u0437\u0430\u043d\u043d\u044b\u0435 \u0441 \u0431\u0430\u0437\u043e\u0439 \u0434\u0430\u043d\u043d\u044b\u0445 \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e Django ORM\n- handlers - \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0438 \u0441\u043e\u0431\u044b\u0442\u0438\u0439 telegram bot-\u0430 (\u0430\u043d\u0430\u043b\u043e\u0433\u0438\u044f \u0441 django views)\n- bot - \u0441\u0432\u044f\u0437\u044c \u043a\u043e\u043c\u0430\u043d\u0434 \u0438 \u0441\u043e\u0431\u044b\u0442\u0438\u0439 \u0431\u043e\u0442\u0430 \u0441 \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u0430\u043c\u0438 (\u0430\u043d\u0430\u043b\u043e\u0433\u0438\u044f \u0441 django urls)\n- settings - \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u0434\u043b\u044f \u0432\u0441\u0435\u0433\u043e \u043f\u0440\u043e\u0435\u043a\u0442\u0430 - django settings\n- tests - \u0442\u0435\u0441\u0442\u044b \u043b\u043e\u0433\u0438\u043a\u0438 \u0431\u043e\u0442\u0430 \u0441 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\u043c \u0441\u043f\u0435\u0446\u0438\u0430\u043b\u044c\u043d\u043e\u0433\u043e Dummy Bot\n\n\u041f\u043e\u0434 \u043a\u0430\u043f\u043e\u0442\u043e\u043c Framework \u043c\u043e\u0436\u0435\u0442 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c \u0440\u0430\u0437\u043d\u044b\u0435 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u0432 \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u043e\u043c \u0438 \u0430\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u043e\u043c \u0438\u0441\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u0438. \u041c\u043e\u0436\u043d\u043e \u043f\u0435\u0440\u0435\u043a\u043b\u044e\u0447\u0430\u0442\u044c \u043e\u0434\u043d\u0438 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 \u043d\u0430 \u0434\u0440\u0443\u0433\u0438\u0435.\n\u0411\u0435\u0437 \u0441\u043e\u0435\u0434\u0438\u043d\u0435\u043d\u0438\u044f \u0441 telegram (\u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440 \u0432 DEV) \u0440\u0435\u0436\u0438\u043c\u0435, \u043c\u043e\u0436\u043d\u043e \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c Dummy Bot \u0434\u043b\u044f \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0438 \u0442\u0435\u0441\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f.\n\n\u0418\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f \u0441 django \u043f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442:\n- \u0414\u043e\u0431\u0430\u0432\u0438\u0442\u044c web site\n- \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c django \u0430\u0434\u043c\u0438\u043d\u043a\u0443\n- \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c django ORM\n\n## \u0424\u0443\u043d\u043a\u0446\u0438\u0438 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438\n\n- \u0418\u043d\u0442\u0435\u0433\u0440\u0430\u0446\u0438\u044f telegram \u0431\u043e\u0442\u0430 \u0432 django \u043f\u0440\u043e\u0435\u043a\u0442 (\u0412 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435)\n- \u041f\u043e\u043d\u044f\u0442\u043d\u0430\u044f \u0441\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u0430 \u0438 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u044b \u0434\u043b\u044f \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0431\u043e\u0442\u0430 (\u0412 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435)\n- \u0424\u0443\u043d\u043a\u0446\u0438\u0438 \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u043e\u0433\u043e \u0442\u0435\u0441\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0431\u043e\u0442\u0430 (\u0412 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435)\n- \u0421\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u0441 \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u043c pyTelegramBotAPI (\u0412 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435)\n- \u0421\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u0441 \u0430\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u043c pyTelegramBotAPI (\u0412 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435)\n- DummyBot \u0434\u043b\u044f \u0442\u0435\u0441\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0438 \u0440\u0430\u0431\u043e\u0442\u044b \u0431\u0435\u0437 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f \u043a telegram (\u0412 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435)\n- \u041e\u0441\u043d\u043e\u0432\u043d\u044b\u0435 \u0444\u0443\u043d\u043a\u0446\u0438\u0438 \u0442\u0435\u043b\u0435\u0433\u0440\u0430\u043c \u0431\u043e\u0442\u0430 (\u0412 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0435)\n- \u0412\u0441\u0435 \u0444\u0443\u043d\u043a\u0446\u0438\u0438 \u0442\u0435\u043b\u0435\u0433\u0440\u0430\u043c \u0431\u043e\u0442\u0430 (\u041d\u0430 \u044d\u0442\u0430\u043f\u0435 \u043f\u043b\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f)\n- \u0421\u043e\u0432\u043c\u0435\u0441\u0442\u0438\u043c\u043e\u0441\u0442\u044c \u0441 aiogram, python-telegram-bot, Telethone (\u041d\u0430 \u044d\u0442\u0430\u043f\u0435 \u043f\u043b\u0430\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f)\n\n## \u0417\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438\n\n- django > 5\n- pyTelegramBotAPi\n- \u041f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0438 \u0432 [\u041f\u043e\u043b\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438](https://quillcraftsman.github.io/django-telegram-framework/about.html#requirements)\n\n## \u0421\u0442\u0430\u0442\u0443\u0441 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438\n\n\u0420\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0430 \u0442\u043e\u043b\u044c\u043a\u043e \u043d\u0430\u0447\u0430\u043b\u0430\u0441\u044c\n\n- \u041f\u0430\u043a\u0435\u0442 \u0443\u0436\u0435 \u0434\u043e\u0441\u0442\u0443\u043f\u0435\u043d \u0432 [PyPi](https://pypi.org/project/django-telegram-framework/)\n- \u041f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0438 \u0432 [\u041f\u043e\u043b\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438](https://quillcraftsman.github.io/django-telegram-framework/about.html#development-status)\n\n## \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\n\n### with pip\n\n```commandline\npip install django-telegram-framework\n```\n\n\u041f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0438 \u0432 [\u041f\u043e\u043b\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438](https://quillcraftsman.github.io/django-telegram-framework/install.html)\n\n## \u0411\u044b\u0441\u0442\u0440\u044b\u0439 \u0441\u0442\u0430\u0440\u0442\n\n\u0414\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043f\u0430\u043a\u0435\u0442 \u0432 `INSTALLED_APPS` django \u043f\u0440\u043e\u0435\u043a\u0442\u0430\n\n```python\nINSTALLED_APPS = [\n ...,\n 'telegram_framework',\n]\n```\n\n\u0417\u0430\u043f\u0443\u0441\u0442\u0438\u0442\u044c \u043a\u043e\u043c\u0430\u043d\u0434\u0443 \u0441 \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u0435\u0439\n\n```commandline\npython manage.py package_info\n```\n\n### \u0411\u043e\u043b\u044c\u0448\u0435 \u043f\u0440\u0438\u043c\u0435\u0440\u043e\u0432 \u0432 [\u041f\u043e\u043b\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438][documentation_path]\n\n## \u0412\u043d\u0435\u0441\u0442\u0438 \u0441\u0432\u043e\u0439 \u0432\u043a\u043b\u0430\u0434 \u0432 \u043f\u0440\u043e\u0435\u043a\u0442\n\n\u0411\u0435\u0437 \u043f\u0440\u043e\u0431\u043b\u0435\u043c! \u0414\u043b\u044f \u0431\u044b\u0441\u0442\u0440\u043e\u0433\u043e \u0441\u0442\u0430\u0440\u0442\u0430 \u043c\u043e\u0436\u043d\u043e \u043e\u0437\u043d\u0430\u043a\u043e\u043c\u0438\u0442\u044c\u0441\u044f \u0441:\n- [\u041f\u043e\u043b\u043d\u043e\u0439 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439][documentation_path]\n- [\u041a\u0430\u043a \u0432\u043d\u0435\u0441\u0442\u0438 \u0441\u0432\u043e\u0439 \u0432\u043a\u043b\u0430\u0434](CONTRIBUTING.md)\n- [\u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439 \u0434\u043b\u044f \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u0447\u0438\u043a\u043e\u0432](https://quillcraftsman.github.io/django-telegram-framework/dev_documentation.html)\n- [\u041d\u043e\u0440\u043c\u0430\u043c\u0438 \u043f\u043e\u0432\u0435\u0434\u0435\u043d\u0438\u044f](CODE_OF_CONDUCT.md)\n- [\u041f\u043e\u043b\u0438\u0442\u0438\u043a\u043e\u0439 \u0431\u0435\u0437\u043e\u043f\u0430\u0441\u043d\u043e\u0441\u0442\u0438](SECURITY.md)\n- [\u0421\u0442\u0440\u0443\u043a\u0442\u0443\u0440\u043e\u0439 \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u044f \u043f\u0440\u043e\u0435\u043a\u0442\u043e\u043c](GOVERNANCE.md)\n- [\u0424\u0430\u0439\u043b\u043e\u043c \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0438](SUPPORT.md)\n\n[documentation_path]: https://quillcraftsman.github.io/django-telegram-framework\n",
"bugtrack_url": null,
"license": "Happy Code",
"summary": "Python Django package repository template",
"version": "0.0.2",
"project_urls": {
"Changelog": "https://github.com/quillcraftsman/django-telegram-framework/releases",
"Documentation": "https://quillcraftsman.github.io/django-telegram-framework",
"Download": "https://pypi.org/project/django-telegram-framework/",
"Homepage": "https://github.com/quillcraftsman/django-telegram-framework",
"Release notes": "https://github.com/quillcraftsman/django-telegram-framework/releases",
"Source": "https://github.com/quillcraftsman/django-telegram-framework",
"Tracker": "https://github.com/quillcraftsman/django-telegram-framework/issues"
},
"split_keywords": [
"django",
" telegram",
" telegram-bot",
" framework",
" testing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d3ab1e1e84f299900bb978a9580bb4f72d7894b7f67b105d8ad1437feb13a193",
"md5": "4d5d48370a55b104f2271e59090c8fd7",
"sha256": "ea06576462d7d3240efc7ecce5dd2c155ab90846a89ba27948989027885b2c67"
},
"downloads": -1,
"filename": "django_telegram_framework-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4d5d48370a55b104f2271e59090c8fd7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 8505,
"upload_time": "2025-01-15T20:40:29",
"upload_time_iso_8601": "2025-01-15T20:40:29.726388Z",
"url": "https://files.pythonhosted.org/packages/d3/ab/1e1e84f299900bb978a9580bb4f72d7894b7f67b105d8ad1437feb13a193/django_telegram_framework-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "62a07f81a020c5fe540231ac8e2ccb0f3b89116dd422ba775ab43d2ab58600c2",
"md5": "900d410c98f44faf021b7a8545f7a241",
"sha256": "83690f337ba93e0891238d81f9483e38151e46121900aa09d4f65a829969bb84"
},
"downloads": -1,
"filename": "django_telegram_framework-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "900d410c98f44faf021b7a8545f7a241",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 7427,
"upload_time": "2025-01-15T20:40:31",
"upload_time_iso_8601": "2025-01-15T20:40:31.446273Z",
"url": "https://files.pythonhosted.org/packages/62/a0/7f81a020c5fe540231ac8e2ccb0f3b89116dd422ba775ab43d2ab58600c2/django_telegram_framework-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-15 20:40:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "quillcraftsman",
"github_project": "django-telegram-framework",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "wheel",
"specs": []
},
{
"name": "Django",
"specs": [
[
">=",
"5"
]
]
}
],
"lcname": "django-telegram-framework"
}