python-trueconf-bot 1.1.10__tar.gz → 1.2.0__tar.gz

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/.gitignore

@@ -184,4 +184,5 @@ trueconf/_version.py
 *.DS_Store
 
 .venv*
-venv*
+venv*
+/gitignore/

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-trueconf-bot
-Version: 1.1.10
+Version: 1.2.0
 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
@@ -31,8 +31,9 @@ Requires-Dist: magic-filter
 Requires-Dist: aiohttp
 Requires-Dist: async-property
 Requires-Dist: typing_extensions>=4.15.0
-Provides-Extra: python-magic
-Requires-Dist: python-magic>=0.4.27; extra == "python-magic"
+Requires-Dist: python-magic>=0.4.27; sys_platform != "win32"
+Requires-Dist: python-magic-bin==0.4.14; sys_platform == "win32"
+Requires-Dist: filetype
 Dynamic: license-file
 
 <p align="center">

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/docs/en/learn/files.md

@@ -141,3 +141,49 @@ await bot.download_file_by_id(
     dest_path="document.pdf"
 )
 ```
+
+## MIME Type Detection with python-magic
+
+A file’s MIME type can be detected automatically. The library supports two approaches:
+
+* **By file extension** — works without additional dependencies, but may be inaccurate.
+* **By file content (bytes)** — significantly more accurate, but requires `python-magic`.
+
+### How It Works
+
+The `python-magic` package does not determine MIME types on its own. It is a Python wrapper around the native **libmagic** library written in C, which is what actually identifies a file type based on its contents.
+
+That is why `python-magic` may not work out of the box on some systems: the Python package is installed via `pip`, but the system library `libmagic` must be installed separately.
+
+If `libmagic` is missing, importing `magic` may fail with an error such as:
+
+* `ImportError: failed to find libmagic. Check your installation`
+
+### Installation
+
+Install the system dependencies:
+
+* **macOS (Homebrew):**
+
+  ```bash
+  brew install libmagic
+  ```
+
+* **Linux (Debian/Ubuntu):**
+
+  ```bash
+  sudo apt install libmagic1
+  ```
+
+* **Windows:**
+
+  ```bash
+  pip install python-magic-bin
+  ```
+
+We also recommend reviewing the repository: [https://github.com/ahupp/python-magic](https://github.com/ahupp/python-magic).
+
+### Notes
+
+* When `python-magic` is available, the MIME type is detected **from the file bytes**, which is usually more accurate than detecting it by filename or extension.
+

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/docs/hooks/llms_txt.py

@@ -1,11 +1,10 @@
-
 import os
 import re
 import subprocess
 from datetime import datetime, timezone
 from html import unescape
 from importlib.metadata import PackageNotFoundError, version as package_version
-from urllib.parse import urljoin
+
 
 from mkdocs.utils import log
 
@@ -164,8 +163,12 @@ def html_to_markdown(html: str) -> str:
 
     text = html
 
-    text = re.sub(r"<script\b[^>]*>.*?</script>", "", text, flags=re.DOTALL | re.IGNORECASE)
-    text = re.sub(r"<style\b[^>]*>.*?</style>", "", text, flags=re.DOTALL | re.IGNORECASE)
+    text = re.sub(
+        r"<script\b[^>]*>.*?</script>", "", text, flags=re.DOTALL | re.IGNORECASE
+    )
+    text = re.sub(
+        r"<style\b[^>]*>.*?</style>", "", text, flags=re.DOTALL | re.IGNORECASE
+    )
     text = re.sub(
         r"<a[^>]*class=\"[^\"]*headerlink[^\"]*\"[^>]*>.*?</a>",
         "",
@@ -241,7 +244,9 @@ def html_to_markdown(html: str) -> str:
         pattern = rf"<h{level}[^>]*>(.*?)</h{level}>"
         text = re.sub(
             pattern,
-            lambda match, lvl=level: f"\n\n{'#' * lvl} {strip_tags(match.group(1))}\n\n",
+            lambda match, lvl=level: (
+                f"\n\n{'#' * lvl} {strip_tags(match.group(1))}\n\n"
+            ),
             text,
             flags=re.DOTALL | re.IGNORECASE,
         )
@@ -284,14 +289,11 @@ def get_version() -> str:
         log.debug(f"llms-txt: Failed to read package metadata version: {exc}")
 
     try:
-        return (
-            subprocess.check_output(
-                ["git", "describe", "--tags", "--abbrev=0"],
-                stderr=subprocess.DEVNULL,
-                text=True,
-            )
-            .strip()
-        )
+        return subprocess.check_output(
+            ["git", "describe", "--tags", "--abbrev=0"],
+            stderr=subprocess.DEVNULL,
+            text=True,
+        ).strip()
     except Exception as exc:  # pragma: no cover
         log.debug(f"llms-txt: Failed to read git version: {exc}")
 
@@ -306,7 +308,9 @@ def get_page_title(html: str, fallback: str) -> str:
         if title:
             return title
 
-    title_match = re.search(r"<title[^>]*>(.*?)</title>", html, re.DOTALL | re.IGNORECASE)
+    title_match = re.search(
+        r"<title[^>]*>(.*?)</title>", html, re.DOTALL | re.IGNORECASE
+    )
     if title_match:
         raw_title = strip_tags(title_match.group(1))
         title = re.split(r"\s[-|–—]\s", raw_title)[0].strip()
@@ -360,7 +364,9 @@ def flatten_nav(nav_items) -> list[str]:
 
 def get_section_key(path: str) -> str:
     normalized = path.replace("\\", "/")
-    if normalized == "index.html" or normalized.startswith(("features/", "release_notes/")):
+    if normalized == "index.html" or normalized.startswith(
+        ("features/", "release_notes/")
+    ):
         return "root"
     if normalized.startswith("learn/"):
         return "learn"
@@ -386,19 +392,22 @@ def build_url(base_url: str, rel_path: str) -> str:
     """Build a public URL for a rendered html file."""
     normalized = rel_path.replace("\\", "/").lstrip("/")
     if normalized == "index.html":
-        return base_url
+        return f"{base_url}/index.md"
 
     if normalized.endswith("/index.html"):
-        normalized = normalized[: -len("index.html")]
+        path_without_index = normalized[: -len("index.html")].rstrip("/")
+        return f"{base_url}/{path_without_index}.md"
 
-    return urljoin(base_url + "/", normalized)
+    return f"{base_url}/{normalized.rsplit('.', 1)[0]}.md"
 
 
 def make_indent(level: int) -> str:
     return "  " * max(level, 0)
 
 
-def add_index_entry(index_lines: list[str], title: str, url: str, level: int = 0) -> None:
+def add_index_entry(
+    index_lines: list[str], title: str, url: str, level: int = 0
+) -> None:
     index_lines.append(f"{make_indent(level)}- [{title}]({url})")
 
 
@@ -406,20 +415,28 @@ def build_index_lines(page_entries: list[dict]) -> list[str]:
     """Build the hierarchical INDEX section."""
     index_lines = ["## INDEX"]
 
-    home_entry = next((entry for entry in page_entries if entry["path"] == "index.html"), None)
+    home_entry = next(
+        (entry for entry in page_entries if entry["path"] == "index.html"), None
+    )
     features_entry = next(
         (entry for entry in page_entries if entry["path"] == "features/index.html"),
         None,
     )
     release_notes_entry = next(
-        (entry for entry in page_entries if entry["path"] == "release_notes/index.html"),
+        (
+            entry
+            for entry in page_entries
+            if entry["path"] == "release_notes/index.html"
+        ),
         None,
     )
 
     if home_entry:
         add_index_entry(index_lines, home_entry["title"], home_entry["url"], level=0)
     if features_entry:
-        add_index_entry(index_lines, features_entry["title"], features_entry["url"], level=0)
+        add_index_entry(
+            index_lines, features_entry["title"], features_entry["url"], level=0
+        )
 
     grouped_sections = {"learn": [], "reference": [], "examples": []}
     for entry in page_entries:
@@ -437,7 +454,12 @@ def build_index_lines(page_entries: list[dict]) -> list[str]:
             add_index_entry(index_lines, entry["title"], entry["url"], level=1)
 
     if release_notes_entry:
-        add_index_entry(index_lines, release_notes_entry["title"], release_notes_entry["url"], level=0)
+        add_index_entry(
+            index_lines,
+            release_notes_entry["title"],
+            release_notes_entry["url"],
+            level=0,
+        )
 
     return index_lines
 
@@ -463,7 +485,9 @@ def on_post_build(config):
             if should_include_page(rel_path):
                 discovered_paths.append(rel_path)
 
-    sorted_paths = sorted(set(discovered_paths), key=lambda path: path_sort_key(path, nav_positions))
+    sorted_paths = sorted(
+        set(discovered_paths), key=lambda path: path_sort_key(path, nav_positions)
+    )
 
     page_entries = []
     for rel_path in sorted_paths:
@@ -481,6 +505,18 @@ def on_post_build(config):
         title = get_page_title(html, rel_path)
         url = build_url(base_url, rel_path)
 
+        if rel_path == "index.html":
+            md_filename = "index.md"
+        elif rel_path.endswith("/index.html"):
+            md_filename = rel_path.replace("/index.html", ".md")
+        else:
+            md_filename = rel_path.rsplit(".", 1)[0] + ".md"
+        md_rel_path = os.path.join(site_dir, md_filename)
+        md_dir = os.path.dirname(md_rel_path)
+        os.makedirs(md_dir, exist_ok=True)
+        with open(md_rel_path, "w", encoding="utf-8") as md_file:
+            md_file.write(markdown.strip() + "\n")
+
         page_entries.append(
             {
                 "path": rel_path,

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/docs/ru/learn/files.md

@@ -133,6 +133,51 @@ await bot.download_file_by_id(
 )
 ```
 
+## Определение MIME-типа с помощью python-magic
+
+MIME‑тип файла может определяться автоматически. В библиотеке поддерживаются два подхода:
+
+* **По расширению файла** — работает без дополнительных зависимостей, но может быть неточным.
+* **По содержимому файла (bytes)** — заметно точнее, но требует `python-magic`.
+
+### Как это работает
+
+Пакет `python-magic` сам по себе MIME‑типы не определяет. Это Python‑обёртка над нативной (C‑шной) библиотекой **libmagic**, которая и выполняет распознавание типа файла по содержимому.
+
+Именно поэтому `python-magic` может не работать «из коробки» на некоторых системах: Python‑пакет устанавливается через `pip`, но системная библиотека `libmagic` должна быть установлена отдельно.
+
+Если `libmagic` отсутствует, импорт `magic` может завершиться ошибкой вида:
+
+* `ImportError: failed to find libmagic. Check your installation`
+
+### Установка
+
+Установите системные зависимости:
+
+* **macOS (Homebrew):**
+
+  ```bash
+  brew install libmagic
+  ```
+
+* **Linux (Debian/Ubuntu):**
+
+  ```bash
+  sudo apt install libmagic1
+  ```
+
+* **Windows:**
+
+  ```bash
+  pip install python-magic-bin
+  ```
+
+Также рекомендуем ознакомиться с репозиторием [https://github.com/ahupp/python-magic](https://github.com/ahupp/python-magic).
+
+### Примечания
+
+* При наличии `python-magic` MIME‑тип определяется **по байтам файла**, что обычно точнее, чем определение по имени или расширению.
+
 
 
 

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/pyproject.toml

@@ -49,12 +49,11 @@ dependencies = [
     "aiohttp",
     "async-property",
     "typing_extensions>=4.15.0",
+    "python-magic>=0.4.27 ; sys_platform != 'win32'",
+    "python-magic-bin==0.4.14 ; sys_platform == 'win32'",
+    "filetype"
 ]
 
-[project.optional-dependencies]
-python-magic = ["python-magic>=0.4.27"]
-
-
 [tool.setuptools]
 packages = ["trueconf"]
 

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/python_trueconf_bot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-trueconf-bot
-Version: 1.1.10
+Version: 1.2.0
 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
@@ -31,8 +31,9 @@ Requires-Dist: magic-filter
 Requires-Dist: aiohttp
 Requires-Dist: async-property
 Requires-Dist: typing_extensions>=4.15.0
-Provides-Extra: python-magic
-Requires-Dist: python-magic>=0.4.27; extra == "python-magic"
+Requires-Dist: python-magic>=0.4.27; sys_platform != "win32"
+Requires-Dist: python-magic-bin==0.4.14; sys_platform == "win32"
+Requires-Dist: filetype
 Dynamic: license-file
 
 <p align="center">

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/python_trueconf_bot.egg-info/SOURCES.txt

@@ -98,10 +98,13 @@ trueconf/methods/add_participant_to_chat.py
 trueconf/methods/auth.py
 trueconf/methods/base.py
 trueconf/methods/change_participant_role.py
+trueconf/methods/clear_chat_history.py
 trueconf/methods/create_channel.py
 trueconf/methods/create_favorites_chat.py
 trueconf/methods/create_group_chat.py
 trueconf/methods/create_p2p_chat.py
+trueconf/methods/edit_chat_avatar.py
+trueconf/methods/edit_chat_title.py
 trueconf/methods/edit_message.py
 trueconf/methods/edit_survey.py
 trueconf/methods/forward_message.py
@@ -110,6 +113,7 @@ trueconf/methods/get_chat_history.py
 trueconf/methods/get_chat_participants.py
 trueconf/methods/get_chats.py
 trueconf/methods/get_file_info.py
+trueconf/methods/get_file_upload_limits.py
 trueconf/methods/get_message_by_id.py
 trueconf/methods/get_user_display_name.py
 trueconf/methods/has_chat_participant.py
@@ -135,7 +139,9 @@ trueconf/types/content/attachment.py
 trueconf/types/content/base.py
 trueconf/types/content/chat_created.py
 trueconf/types/content/document.py
+trueconf/types/content/edit_chat_title.py
 trueconf/types/content/forward_message.py
+trueconf/types/content/location.py
 trueconf/types/content/photo.py
 trueconf/types/content/remove_participant.py
 trueconf/types/content/sticker.py
@@ -144,11 +150,15 @@ trueconf/types/content/text.py
 trueconf/types/content/video.py
 trueconf/types/requests/__init__.py
 trueconf/types/requests/added_chat_participant.py
+trueconf/types/requests/changed_file_upload_limits.py
 trueconf/types/requests/changed_participant_role.py
+trueconf/types/requests/cleared_chat_history.py
 trueconf/types/requests/created_channel.py
 trueconf/types/requests/created_favorites_chat.py
 trueconf/types/requests/created_group_chat.py
 trueconf/types/requests/created_personal_chat.py
+trueconf/types/requests/edited_chat_avatar.py
+trueconf/types/requests/edited_chat_title.py
 trueconf/types/requests/edited_message.py
 trueconf/types/requests/removed_chat.py
 trueconf/types/requests/removed_chat_participant.py
@@ -159,10 +169,13 @@ trueconf/types/responses/add_chat_participant_response.py
 trueconf/types/responses/api_error.py
 trueconf/types/responses/auth_response_payload.py
 trueconf/types/responses/change_participant_role_response.py
+trueconf/types/responses/clear_chat_history_response.py
 trueconf/types/responses/create_channel_response.py
 trueconf/types/responses/create_favorites_chat_response.py
 trueconf/types/responses/create_group_chat_response.py
 trueconf/types/responses/create_p2p_chat_response.py
+trueconf/types/responses/edit_chat_avatar_response.py
+trueconf/types/responses/edit_chat_title_response.py
 trueconf/types/responses/edit_message_response.py
 trueconf/types/responses/edit_survey_response.py
 trueconf/types/responses/forward_message_response.py
@@ -171,6 +184,7 @@ trueconf/types/responses/get_chat_history_response.py
 trueconf/types/responses/get_chat_participants_response.py
 trueconf/types/responses/get_chats_response.py
 trueconf/types/responses/get_file_info_response.py
+trueconf/types/responses/get_file_upload_limits_response.py
 trueconf/types/responses/get_message_by_id_response.py
 trueconf/types/responses/get_user_display_name_response.py
 trueconf/types/responses/has_chat_participant_response.py
@@ -185,4 +199,5 @@ trueconf/types/responses/unsubscribe_file_progress_response.py
 trueconf/types/responses/upload_file_response.py
 trueconf/utils/__init__.py
 trueconf/utils/generate_secret_for_survey.py
+trueconf/utils/split_text.py
 trueconf/utils/token.py

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/python_trueconf_bot.egg-info/requires.txt

@@ -6,6 +6,10 @@ magic-filter
 aiohttp
 async-property
 typing_extensions>=4.15.0
+filetype
 
-[python-magic]
+[:sys_platform != "win32"]
 python-magic>=0.4.27
+
+[:sys_platform == "win32"]
+python-magic-bin==0.4.14

{python_trueconf_bot-1.1.10 → python_trueconf_bot-1.2.0}/trueconf/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.1.10'
-__version_tuple__ = version_tuple = (1, 1, 10)
+__version__ = version = '1.2.0'
+__version_tuple__ = version_tuple = (1, 2, 0)
 
-__commit_id__ = commit_id = 'g8ec975402'
+__commit_id__ = commit_id = 'ge5cf988c1'