python-trueconf-bot 1.4.1__tar.gz → 1.4.2__tar.gz

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/.github/workflows/docs.yml

@@ -14,20 +14,20 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
-          persist-credentials: true
+          sparse-checkout: |
+            docs
+            trueconf 
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
         with:
-          python-version: "3.10"
+          enable-cache: true
 
       - name: Install docs dependencies
-        run: |
-          python -m pip install --upgrade pip
-          if [ -f requirements-docs.txt ]; then pip install -r requirements-docs.txt; fi
+        run: uv sync --group docs
 
       - name: Preflight check (mkdocs.yml has mike plugin)
         run: |
@@ -61,12 +61,12 @@ jobs:
         env:
           VERSION: ${{ steps.ver.outputs.version }}
         run: |
-          mike deploy --push --branch gh-pages --update-aliases "$VERSION" latest
-          mike set-default --push --branch gh-pages latest
+          uv run mike deploy --push --branch gh-pages --update-aliases "$VERSION" latest
+          uv run mike set-default --push --branch gh-pages latest
 
       - name: Deploy docs with mike (no alias update)
         if: ${{ github.event.inputs.alias_latest == 'false' }}
         env:
           VERSION: ${{ steps.ver.outputs.version }}
         run: |
-          mike deploy --push --branch gh-pages "$VERSION"
+          uv run mike deploy --push --branch gh-pages "$VERSION"

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/.gitignore

@@ -178,9 +178,9 @@ cython_debug/
 config_models.py
 
 trueconf/_version.py
-
+.opencode
 .idea
-
+.workfiles
 *.DS_Store
 
 .venv*

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-trueconf-bot
-Version: 1.4.1
+Version: 1.4.2
 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

python_trueconf_bot-1.4.2/context7.json

@@ -0,0 +1,4 @@
+{
+  "url": "https://context7.com/trueconf/python-trueconf-bot",
+  "public_key": "pk_oAuw9GgMszB6caKRldtnP"
+}

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/examples/index.md

@@ -1,5 +1,6 @@
 ---
 title: Code examples
+description: Ready-to-use code examples for common bot scenarios
 icon: material/console
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/features.md

@@ -1,5 +1,6 @@
 ---
 title: Features
+description: 'What the library offers: async, aiogram-like API, WebSocket, and more'
 icon: material/feather
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/index.md

@@ -1,5 +1,6 @@
 ---
 title: Home
+description: How to build chatbots for TrueConf Server with Python
 icon: material/home-variant
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/enums.md

@@ -1,5 +1,6 @@
 ---
 title: Using enumerations
+description: Use enums for ParseMode, ChatType, FileReadyState and other parameters
 icon: material/alphabet-latin
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/files.md

@@ -1,6 +1,7 @@
 ---
 title: Working with files
-icon: material/file-sync 
+description: How to send and receive files of any type
+icon: material/file-sync
 ---
 
 # Working with Files

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/filters.md

@@ -1,5 +1,6 @@
 ---
 title: Filters
+description: How to route events to the right handlers using filters
 icon: material/filter
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/fsm.md

@@ -1,5 +1,6 @@
 ---
 title: FSM (Finite State Machine)
+description: How to build multi-step dialogs with a finite state machine
 icon: material/transit-connection-variant
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/getting-started.md

@@ -1,5 +1,6 @@
 ---
 title: Getting Started
+description: How to install the library and create your first bot
 icon: material/run
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/middleware.md

@@ -1,5 +1,6 @@
 ---
 title: Middleware
+description: How to intercept and modify events before they reach handlers
 icon: material/layers-triple
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/parse-messages.md

@@ -1,5 +1,6 @@
 ---
 title: Handling Requests
+description: How to handle incoming events with routers and dispatcher
 icon: material/routes
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/restrictions.md

@@ -1,5 +1,6 @@
 ---
 title: Restrictions
+description: What limits apply to messages, files, and chat titles
 icon: material/alert-octagon-outline
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/send_message.md

@@ -1,5 +1,6 @@
 ---
 title: Sending messages
+description: How to send, reply, forward, and format messages
 icon: material/message-text-fast-outline
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/shortcuts.md

@@ -1,5 +1,6 @@
 ---
 title: Shortcuts
+description: How to use shortcut methods on the Message object
 icon: material/knife
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/learn/types.md

@@ -1,5 +1,6 @@
 ---
 title: Data Types
+description: How to use type hints for autocompletion and type checking
 icon: material/database-search
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/reference/Bot.md

@@ -1,3 +1,9 @@
+---
+title: Bot
+description: 'Reference for the Bot class: methods, parameters, and attributes'
+icon: material/robot
+---
+
 # Class `Bot`
 
 Here is the reference information for the `Bot` class, including all its parameters, attributes, and methods.  

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/reference/Dispatcher.md

@@ -1,3 +1,9 @@
+---
+title: Dispatcher
+description: 'Reference for the Dispatcher class: routers, events, and storage'
+icon: material/sitemap
+---
+
 # Class `Dispatcher`
 
 Here is the reference information for the `Dispatcher` class, including all its parameters, attributes, and methods.  

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/reference/Enums.md

@@ -1,3 +1,9 @@
+---
+title: Enums
+description: 'Reference for all enums: ParseMode, MessageType, ChatType, and more'
+icon: material/numeric
+---
+
 You can import all enums at once:
 
 ```python

python_trueconf_bot-1.4.2/docs/en/reference/Exceptions.md

@@ -0,0 +1,11 @@
+---
+title: Exceptions
+description: Reference for all exception classes and validation errors
+icon: material/alert-circle-outline
+---
+
+::: trueconf.exceptions
+    options:
+        filters:
+            - "!^_"
+            - "!^__"

python_trueconf_bot-1.4.2/docs/en/reference/Formatting.md

@@ -0,0 +1,11 @@
+---
+title: Formatting
+description: Reference for formatting utilities to build HTML and Markdown messages
+icon: material/format-text
+---
+
+::: trueconf.utils.formatting
+    options:
+        filters:
+            - "!^_"
+            - "!^__"

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/reference/Responses.md

@@ -1,3 +1,9 @@
+---
+title: Responses
+description: Response types for bot API methods
+icon: material/file-document-multiple
+---
+
 # Responses
 
 ```python

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/reference/Router.md

@@ -1,3 +1,9 @@
+---
+title: Router
+description: Router class reference — event handler decorators
+icon: material/router-network
+---
+
 # Class `Router`
 
 Here is the reference information for the `Router` class, including all its parameters, attributes, and methods.  

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/reference/Types.md

@@ -1,6 +1,7 @@
 ---
 title: Types
-icon: 
+description: 'Reference for all data types: Message, events, and file classes'
+icon: material/code-braces-box
 ---
 
 #  Types

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/en/release_notes.md

@@ -1,11 +1,12 @@
 ---
 title: Release notes
+description: Changelog — features, fixes, and deprecations
 icon: material/note-text
 ---
 
 # List of Changes
 
-## 1.4.0b1
+## 1.4.0
 
 **Added:**
 

python_trueconf_bot-1.4.2/docs/hooks/sitemap_dates.py

@@ -0,0 +1,4 @@
+def on_page_content(html, page, config, files):
+    raw_date = page.meta.get("git_revision_date_localized_raw_iso_date")
+    if raw_date:
+        page.update_date = raw_date

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/overrides/main.html

@@ -8,6 +8,11 @@
 {% endblock %}
 
 {% block extrahead %}
+  {{ super() }}
+  {% if page and page.file %}
+    {% set src = page.file.src_uri.replace('en/', '').replace('ru/', '') %}
+  <link rel="alternate" type="text/markdown" href="{{ config.site_url.rstrip('/') }}/{{ src }}">
+  {% endif %}
   <script
           src="https://context7.com/widget.js"
           data-library="/websites/trueconf_github_io_python-trueconf-bot"

python_trueconf_bot-1.4.2/docs/overrides/sitemap.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">
+{%- for locale, i18n_files in i18n_alternates.items() %}
+{%- for file in i18n_files %}
+    {%- if file.page.is_link or not file.page %}{% continue %}{% endif %}
+    {%- if file.page.canonical_url %}
+        {%- set page_href = file.page.canonical_url | e %}
+    {%- elif file.page.abs_url %}
+        {%- set page_href = file.page.abs_url | e %}
+    {%- else %}
+        {%- set page_href = config.site_url ~ file.url %}
+    {%- endif %}
+    <url>
+        <loc>{{ page_href }}</loc>
+    {%- if file.page.update_date %}
+        <lastmod>{{ file.page.update_date }}</lastmod>
+    {%- endif %}
+    {%- for i18n_locale, i18n_file in file.alternates.items() %}
+        {%- if i18n_file.page.canonical_url %}
+            {%- set i18n_href = i18n_file.page.canonical_url | e %}
+        {%- elif i18n_file.page.abs_url %}
+            {%- set i18n_href = i18n_file.page.abs_url | e %}
+        {%- else %}
+            {%- if i18n_file.url == "./" %}
+                {%- set i18n_href = config.site_url %}
+            {%- else %}
+                {%- set i18n_href = config.site_url ~ i18n_file.url %}
+            {%- endif %}
+        {%- endif %}
+        <xhtml:link rel="alternate" hreflang="{{ i18n_locale }}" href="{{ i18n_href }}"/>
+    {%- endfor %}
+    </url>
+{%- endfor %}
+{%- endfor %}
+</urlset>

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/examples/index.md

@@ -1,5 +1,6 @@
 ---
 title: Примеры кода
+description: Готовые примеры кода для распространённых сценариев
 icon: material/console
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/features.md

@@ -1,5 +1,6 @@
 ---
 title: Возможности
+description: 'Что умеет библиотека: асинхронность, API в стиле aiogram, WebSocket и другое'
 icon: material/feather
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/index.md

@@ -1,5 +1,6 @@
 ---
 title: Главная
+description: Как создавать чат-ботов для TrueConf Server на Python
 icon: material/home-variant
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/enums.md

@@ -1,5 +1,6 @@
 ---
 title: Перечисления (Enums)
+description: Как использовать перечисления для безопасной передачи параметров
 icon: material/alphabet-latin
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/files.md

@@ -1,5 +1,6 @@
 ---
 title: Работа с файлами
+description: Как отправлять и получать файлы любого типа
 icon: material/file-sync
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/filters.md

@@ -1,5 +1,6 @@
 ---
 title: Фильтры
+description: Как направить события к нужным обработчикам с помощью фильтров
 icon: material/filter
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/fsm.md

@@ -1,5 +1,6 @@
 ---
 title: FSM (Машина состояний)
+description: Как строить многошаговые диалоги с помощью машины состояний
 icon: material/transit-connection-variant
 ---
 
@@ -60,7 +61,7 @@ dp.include_router(router)
 
 !!! info
     `MemoryStorage` хранит состояния в оперативной памяти. После перезапуска бота все состояния сбрасываются. 
-    Для разработки и тестирования этого достаточно. Для продакшена вы можете реализовать [свое постоянное хранилище](#_16).
+    Для разработки и тестирования этого достаточно. Для продакшена вы можете реализовать [свое постоянное хранилище](#_13).
 
 ### Шаг 3. Объявление состояний
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/getting-started.md

@@ -1,5 +1,6 @@
 ---
 title: Начало работы
+description: Как установить библиотеку и создать первого бота
 icon: material/run
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/middleware.md

@@ -1,5 +1,6 @@
 ---
 title: Middleware
+description: Как перехватывать и изменять события до попадания в обработчик
 icon: material/layers-triple
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/parse-messages.md

@@ -1,5 +1,6 @@
 ---
 title: Обработка запросов
+description: Как обрабатывать входящие события с помощью роутеров и диспетчера
 icon: material/routes
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/restrictions.md

@@ -1,5 +1,6 @@
 ---
 title: Ограничения
+description: Какие ограничения есть на сообщения, файлы и названия чатов
 icon: material/alert-octagon-outline
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/send_message.md

@@ -1,5 +1,6 @@
 ---
 title: Отправка сообщений
+description: Как отправлять, отвечать, пересылать и форматировать сообщения
 icon: material/message-text-fast-outline
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/shortcuts.md

@@ -1,5 +1,6 @@
 ---
 title: Шорткаты
+description: Как использовать удобные методы на объекте Message
 icon: material/knife
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/learn/types.md

@@ -1,5 +1,6 @@
 ---
 title: Типы данных
+description: Как использовать типизацию для автодополнения и проверки типов
 icon: material/database-search
 ---
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/docs/ru/release_notes.md

@@ -1,11 +1,12 @@
 ---
 title: Список изменений
+description: 'Что нового в каждой версии: возможности, исправления и изменения'
 icon: material/note-text
 ---
 
 # Список изменений
 
-## 1.4.0b1
+## 1.4.0
 
 **Добавлено:**
 

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/mkdocs.yml

@@ -74,6 +74,10 @@ theme:
 
 plugins:
   - mike
+  - social:
+      cards_layout: default/variant
+      cards_layout_options:
+        background_color: "#00B4CC"
   - autorefs:
       resolve_closest: true
   - macros
@@ -152,6 +156,8 @@ plugins:
                 link: https://t.me/trueconf_talks
               - icon: fontawesome/brands/vk
                 link: https://vk.com/trueconf_club
+  - git-revision-date-localized:
+      enable_creation_date: true
   - typeset
 
 nav:
@@ -229,3 +235,4 @@ extra:
 
 hooks:
   - docs/hooks/llms_txt.py
+  - docs/hooks/sitemap_dates.py

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/pyproject.toml

@@ -56,6 +56,23 @@ dependencies = [
     "truststore"
 ]
 
+[dependency-groups]
+
+docs = [
+    "mkdocs==1.6.1",
+    "mkdocs-material==9.7.6",
+    "mkdocs-material-extensions==1.3.1",
+    "mkdocstrings==1.0.4",
+    "mike==2.2.0",
+    "mkdocs-static-i18n>=1.3.1",
+    "mkdocs-minify-plugin==0.8.0",
+    "mkdocs-macros-plugin==1.5.0",
+    "mkdocstrings-python==2.0.5",
+    "griffe-typingdoc==0.3.1",
+    "mkdocs-material[imaging]==9.7.6",
+    "mkdocs-git-revision-date-localized-plugin==1.5.3"
+]
+
 [tool.setuptools]
 packages = ["trueconf"]
 
@@ -71,4 +88,4 @@ Issues = "https://github.com/TrueConf/python-trueconf-bot/issues"
 [tool.setuptools_scm]
 version_file = "trueconf/_version.py"
 version_scheme = "guess-next-dev"
-local_scheme = "no-local-version"
+local_scheme = "no-local-version"

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/python_trueconf_bot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-trueconf-bot
-Version: 1.4.1
+Version: 1.4.2
 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

{python_trueconf_bot-1.4.1 → python_trueconf_bot-1.4.2}/python_trueconf_bot.egg-info/SOURCES.txt

@@ -3,15 +3,13 @@ LICENSE
 README-PyPI.md
 README-ru.md
 README.md
+context7.json
 mkdocs.yml
 pyproject.toml
-requirements-docs.txt
 requirements.txt
-test5.py
 .github/workflows/docs.yml
 .github/workflows/release-test.yml
 .github/workflows/release.yml
-.opencode/plans/2026-05-25-fsm-implementation.md
 assets/head_en.png
 assets/head_ru.png
 assets/logo.svg
@@ -43,10 +41,12 @@ docs/en/reference/Router.md
 docs/en/reference/Types.md
 docs/en/reference/index.md
 docs/hooks/llms_txt.py
+docs/hooks/sitemap_dates.py
 docs/img/chatbot.svg
 docs/img/favicon.ico
 docs/img/logo.svg
 docs/overrides/main.html
+docs/overrides/sitemap.xml
 docs/ru/features.md
 docs/ru/index.md
 docs/ru/release_notes.md
@@ -76,6 +76,8 @@ python_trueconf_bot.egg-info/PKG-INFO
 python_trueconf_bot.egg-info/SOURCES.txt
 python_trueconf_bot.egg-info/dependency_links.txt
 python_trueconf_bot.egg-info/requires.txt
+python_trueconf_bot.egg-info/scm_file_list.json
+python_trueconf_bot.egg-info/scm_version.json
 python_trueconf_bot.egg-info/top_level.txt
 tests/test_fsm.py
 trueconf/__init__.py