Update documentation and code snippets

This commit is contained in:
2025-12-02 22:59:58 +03:00
parent e6645730f0
commit 2800a7ffc2
30 changed files with 1494 additions and 3962 deletions
+33 -40
View File
@@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Argenta \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-11-03 19:01+0300\n"
"POT-Creation-Date: 2025-12-02 22:27+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: en\n"
@@ -25,77 +25,70 @@ msgstr ""
#: ../../root/api/bridge.rst:6
msgid ""
"`DataBridge` — это сущность, предоставляющая временное хранилище данных, "
"которое существует в рамках одной сессии приложения (от запуска до "
"выхода). Она предназначена для обмена данными между вызовами разных "
"команд."
"``DataBridge`` — это сущность, предоставляющая временное хранилище "
"данных, которое существует в рамках одной сессии приложения (от запуска "
"до выхода). Она предназначена для обмена данными между обработчиками."
msgstr ""
#: ../../root/api/bridge.rst:8
msgid ""
"Основной способ получения доступа к `DataBridge` — через систему "
"внедрения зависимостей (DI)."
msgstr ""
#: ../../root/api/bridge.rst:19
msgid "**Практический пример: Аутентификация**"
msgid "Основной способ получения доступа к ``DataBridge`` — через ``di``."
msgstr ""
#: ../../root/api/bridge.rst:21
msgid "**Практический пример: Аутентификация**"
msgstr ""
#: ../../root/api/bridge.rst:23
msgid ""
"Рассмотрим пример, где команда `login` сохраняет токен аутентификации, а "
"команда `get-profile` использует его."
msgstr ""
#: ../../root/api/bridge.rst:27
msgid "**Как это работает:**"
msgstr ""
#: ../../root/api/bridge.rst:29
msgid ""
"При вызове обработчика `dishka` автоматически внедряет экземпляр "
"`DataBridge`."
msgstr ""
#: ../../root/api/bridge.rst:30
msgid ""
"Команда ``login --username <имя>`` вызывает `login_handler`, который "
"через внедрённый `data_bridge` сохраняет токен."
msgid "**Как это работает:**"
msgstr ""
#: ../../root/api/bridge.rst:31
msgid ""
"Команда `get-profile` вызывает `get_profile_handler`, который так же "
"получает `data_bridge` и извлекает из него токен."
"При вызове обработчика ``dishka`` автоматически внедряет экземпляр "
"``DataBridge``."
msgstr ""
#: ../../root/api/bridge.rst:34
msgid "API класса"
msgstr ""
#: ../../root/api/bridge.rst:40
#: ../../root/api/bridge.rst:32
msgid ""
"Инициализирует хранилище. При использовании через DI вызывается "
"Команда ``login --username <имя>`` вызывает ``login_handler``, который "
"через внедрённый ``data_bridge`` сохраняет токен."
msgstr ""
#: ../../root/api/bridge.rst:33
msgid ""
"Команда ``get-profile`` вызывает ``get_profile_handler``, который так же "
"получает ``data_bridge`` и извлекает из него токен."
msgstr ""
#: ../../root/api/bridge.rst:42
msgid ""
"Инициализирует хранилище. При использовании через ``di`` вызывается "
"автоматически."
msgstr ""
#: ../../root/api/bridge.rst:44
#: ../../root/api/bridge.rst:46
msgid "Обновляет хранилище данными из словаря."
msgstr ""
#: ../../root/api/bridge.rst:48
#: ../../root/api/bridge.rst:50
msgid "Возвращает все данные из хранилища."
msgstr ""
#: ../../root/api/bridge.rst:52
msgid "Возвращает значение по ключу или `None`, если ключ не найден."
#: ../../root/api/bridge.rst:54
msgid "Возвращает значение по ключу или ``None``, если ключ не найден."
msgstr ""
#: ../../root/api/bridge.rst:56
msgid "Удаляет значение по ключу. Вызывает `KeyError`, если ключ не найден."
#: ../../root/api/bridge.rst:58
msgid "Удаляет значение по ключу. Вызывает ``KeyError``, если ключ не найден."
msgstr ""
#: ../../root/api/bridge.rst:60
#: ../../root/api/bridge.rst:62
msgid "Полностью очищает хранилище."
msgstr ""