python-trueconf-bot 1.1.8__tar.gz → 1.1.9__tar.gz

{python_trueconf_bot-1.1.8 → python_trueconf_bot-1.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-trueconf-bot
-Version: 1.1.8
+Version: 1.1.9
 Summary: Lightweight and powerful framework for the TrueConf Server Chatbot API
 Author-email: TrueConf LLC <info@trueconf.com>, Anton Baadzhi <baadzhianton@gmail.com>
 License-Expression: BSD-3-Clause-Clear
@@ -77,6 +77,23 @@ Dynamic: license-file
 > 
 > We were inspired by the popular [aiogram](https://github.com/aiogram/aiogram/) library, so, the transition will be **simple** for developers already familiar with this library.
 
+---
+
+## 📦 Version Compatibility
+
+| TrueConf Server Version | Required Library Version |
+|:------------------------|:-------------------------|
+| < 5.5.0                 | ❌ Not supported         |
+| 5.5.0 — 5.5.2           | v1.1.x                   |
+| >= 5.5.3                | **v1.2.0** (or higher)   |
+
+> ⚠️ IMPORTANT
+> 
+> If you are using server version **5.5.3** or higher, you must upgrade the library. If the stable release is not yet available, install the latest beta:
+> ```bash
+> uv pip install --pre "python-trueconf-bot>=1.2.0b0"
+> ```
+
 ## 📌 Key Features
 
 * Easy integration with the [TrueConf Server Chatbot API](https://trueconf.com/docs/chatbot-connector/en/overview/)

{python_trueconf_bot-1.1.8 → python_trueconf_bot-1.1.9}/README-PyPI.md

@@ -40,6 +40,23 @@
 > 
 > We were inspired by the popular [aiogram](https://github.com/aiogram/aiogram/) library, so, the transition will be **simple** for developers already familiar with this library.
 
+---
+
+## 📦 Version Compatibility
+
+| TrueConf Server Version | Required Library Version |
+|:------------------------|:-------------------------|
+| < 5.5.0                 | ❌ Not supported         |
+| 5.5.0 — 5.5.2           | v1.1.x                   |
+| >= 5.5.3                | **v1.2.0** (or higher)   |
+
+> ⚠️ IMPORTANT
+> 
+> If you are using server version **5.5.3** or higher, you must upgrade the library. If the stable release is not yet available, install the latest beta:
+> ```bash
+> uv pip install --pre "python-trueconf-bot>=1.2.0b0"
+> ```
+
 ## 📌 Key Features
 
 * Easy integration with the [TrueConf Server Chatbot API](https://trueconf.com/docs/chatbot-connector/en/overview/)

{python_trueconf_bot-1.1.8 → python_trueconf_bot-1.1.9}/README-ru.md

@@ -42,7 +42,22 @@
 > При разработке мы вдохновлялись популярной библиотекой [aiogram](https://github.com/aiogram/aiogram/), поэтому разработчикам,
 > знакомым с ней, переход будет **простым** и **безболезненным**.
 
-## Ключевые возможности
+---
+
+## 📦 Совместимость версий
+| Версия сервера TrueConf | Требуемая версия библиотеки |
+|:------------------------|:---------------------------|
+| < 5.5.0                 | ❌ Не поддерживается                         |
+| 5.5.0 — 5.5.2           | v1.1.x                     |
+| \>= 5.5.3               | **v1.2.0** (или выше)      |
+
+> [!IMPORTANT] 
+> Если вы используете сервер версии **5.5.3** или выше, вам необходимо обновить библиотеку. Если стабильный релиз еще не доступен, установите последнюю бету:
+> ```bash
+> uv pip install --pre "python-trueconf-bot>=1.2.0b0"
+> ```
+
+## 📌 Ключевые возможности
 
 - Простая интеграция с [API чат-ботов TrueConf Server](https://trueconf.ru/docs/chatbot-connector/ru/overview/);
 - Быстрый старт с пакетом `python-trueconf-bot`;
@@ -52,7 +67,7 @@
 > [!IMPORTANT]
 > Функционал чат-ботов поддерживается начиная с версии TrueConf Server 5.5, а также в TrueConf Enterprise и TrueConf Server Free.
 
-## Пример бота
+## 🚀 Пример бота
 
 ```python
 import asyncio
@@ -81,7 +96,7 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
-## Документация и поддержка
+## 📚 Документация и поддержка
 
 1. [Документация API чат-ботов TrueConf Server](https://trueconf.ru/docs/chatbot-connector/ru/overview/)
 2. [Документация python-trueconf-bot](https://trueconf.github.io/python-trueconf-bot/ru/)

{python_trueconf_bot-1.1.8 → python_trueconf_bot-1.1.9}/README.md

@@ -47,6 +47,20 @@
 
 ---
 
+## 📦 Version Compatibility
+
+| TrueConf Server Version | Required Library Version |
+|:------------------------|:-------------------------|
+| < 5.5.0                 | ❌ Not supported         |
+| 5.5.0 — 5.5.2           | v1.1.x                   |
+| >= 5.5.3                | **v1.2.0** (or higher)   |
+
+> [!IMPORTANT]
+> If you are using server version **5.5.3** or higher, you must upgrade the library. If the stable release is not yet available, install the latest beta:
+> ```bash
+> uv pip install --pre "python-trueconf-bot>=1.2.0b0"
+> ```
+
 ## 📌 Key Features
 
 * Easy integration with the [TrueConf Server Chatbot API](https://trueconf.com/docs/chatbot-connector/en/overview/)

{python_trueconf_bot-1.1.8 → python_trueconf_bot-1.1.9}/python_trueconf_bot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-trueconf-bot
-Version: 1.1.8
+Version: 1.1.9
 Summary: Lightweight and powerful framework for the TrueConf Server Chatbot API
 Author-email: TrueConf LLC <info@trueconf.com>, Anton Baadzhi <baadzhianton@gmail.com>
 License-Expression: BSD-3-Clause-Clear
@@ -77,6 +77,23 @@ Dynamic: license-file
 > 
 > We were inspired by the popular [aiogram](https://github.com/aiogram/aiogram/) library, so, the transition will be **simple** for developers already familiar with this library.
 
+---
+
+## 📦 Version Compatibility
+
+| TrueConf Server Version | Required Library Version |
+|:------------------------|:-------------------------|
+| < 5.5.0                 | ❌ Not supported         |
+| 5.5.0 — 5.5.2           | v1.1.x                   |
+| >= 5.5.3                | **v1.2.0** (or higher)   |
+
+> ⚠️ IMPORTANT
+> 
+> If you are using server version **5.5.3** or higher, you must upgrade the library. If the stable release is not yet available, install the latest beta:
+> ```bash
+> uv pip install --pre "python-trueconf-bot>=1.2.0b0"
+> ```
+
 ## 📌 Key Features
 
 * Easy integration with the [TrueConf Server Chatbot API](https://trueconf.com/docs/chatbot-connector/en/overview/)

{python_trueconf_bot-1.1.8 → python_trueconf_bot-1.1.9}/trueconf/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.1.8'
-__version_tuple__ = version_tuple = (1, 1, 8)
+__version__ = version = '1.1.9'
+__version_tuple__ = version_tuple = (1, 1, 9)
 
-__commit_id__ = commit_id = 'g3398e0444'
+__commit_id__ = commit_id = 'g90ad8c357'

{python_trueconf_bot-1.1.8 → python_trueconf_bot-1.1.9}/trueconf/client/bot.py

@@ -172,6 +172,15 @@ class Bot:
             loggers.chatbot.error(f"Failed to get server domain_name: {e}")
             return None
 
+    async def __get_server_version(self):
+        try:
+            async with httpx.AsyncClient(verify=self.verify_ssl, timeout=5) as client:
+                response = await client.get(f"{self._protocol}://{self.server}:{self.port}/api/v4/server")
+                return response.json().get("product").get("version")
+        except Exception as e:
+            loggers.chatbot.error(f"Failed to get server version: {e}")
+            return None
+
     @property
     def token(self) -> str:
         """
@@ -194,6 +203,33 @@ class Bot:
 
         return await self.__get_domain_name()
 
+    @async_cached_property
+    async def server_version(self) -> str:
+        """
+        Returns the domain name of the TrueConf server.
+
+        Returns:
+            str: Domain name of the connected server.
+        """
+
+        return await self.__get_server_version()
+
+    async def check_version(self):
+        current_version = await self.server_version
+        v = tuple(map(int, current_version.split('.')[:3]))
+
+        if v < (5, 5, 0):
+            raise RuntimeError(
+                f"Error: Server version {current_version} is too old. "
+                "Chatbots are not supported (version 5.5.0+ required)."
+            )
+        if v >= (5, 5, 3):
+            raise RuntimeError(
+                f"\n[!] Server version {current_version} requires library v1.2.0.\n"
+                "Please install the stable release or the latest beta using the following command:\n"
+                'uv pip install --pre "python-trueconf-bot>=1.2.0b0"'
+            )
+
     @async_cached_property
     async def me(self) -> str:
         """
@@ -1407,6 +1443,7 @@ class Bot:
         Returns:
             None
         """
+        await self.check_version()
         if self._connect_task and not self._connect_task.done():
             return
         self._stop = False