Update documentation

This commit is contained in:
2025-12-04 21:49:31 +03:00
parent e1327c278c
commit 5c933ab656
2 changed files with 14 additions and 14 deletions
+2 -2
View File
@@ -14,7 +14,7 @@ Argenta
Если у вас есть функциональность, которую вы хотите предоставить в виде CLI-приложения, Argenta поможет вам в этом. Если у вас есть функциональность, которую вы хотите предоставить в виде CLI-приложения, Argenta поможет вам в этом.
Основная цель библиотеки — дать разработчикам возможность сосредоточиться на реализации своих идей, предоставляя для этого удобные абстракции. Основная цель библиотеки — дать разработчикам возможность сосредоточиться на реализации своих идей, предоставляя для этого удобные абстракции.
.. image:: https://github.com/koloideal/Argenta/blob/main/imgs/mock_app_preview4.png?raw=True .. image:: https://i.ibb.co/fzWcfgFq/2025-12-04-173045.png
:alt: App example :alt: App example
Argenta предназначена для создания приложений, работающих в собственном контексте (scope). Это означает, что приложение запускается один раз и создаёт интерактивную сессию, похожую на Python REPL или MySQL консоль. При запуске пользователь входит в эту сессию, где ему доступна вся реализованная вами функциональность. Argenta предназначена для создания приложений, работающих в собственном контексте (scope). Это означает, что приложение запускается один раз и создаёт интерактивную сессию, похожую на Python REPL или MySQL консоль. При запуске пользователь входит в эту сессию, где ему доступна вся реализованная вами функциональность.
@@ -27,7 +27,7 @@ Argenta предназначена для создания приложений,
* **Декларативный синтаксис**: Команды и их обработчики объявляются с помощью простых декораторов, что делает код интуитивно понятным и позволяет сосредоточиться на том, "что" вы хотите сделать, а не "как". * **Декларативный синтаксис**: Команды и их обработчики объявляются с помощью простых декораторов, что делает код интуитивно понятным и позволяет сосредоточиться на том, "что" вы хотите сделать, а не "как".
* **Нативный DI**: Благодаря интеграции с [dishka](https://dishka.readthedocs.io/en/stable/), вы можете легко внедрять зависимости прямо в обработчики команд, что упрощает их тестирование, позволяет избежать мутабельных глобалов и многое другое. * **Нативный DI**: Благодаря интеграции с [dishka](https://dishka.readthedocs.io/en/stable/), вы можете легко внедрять зависимости прямо в обработчики команд, что упрощает их тестирование, позволяет избежать мутабельных глобалов и многое другое.
* **Автоматическая валидация и парсинг**: Библиотека берёт на себя обработку флагов и аргументов командной строки, включая их парсинг, валидацию и преобразование типов. * **Автоматическая валидация и парсинг**: Библиотека берёт на себя обработку флагов и аргументов командной строки, включая их парсинг, валидацию и преобразование типов.
* **Гибкая настройка**: Вы можете легко кастомизировать системные сообщения, форматирование вывода, ссоздавать кастомные обработчики нестандартного поведения и т.д. * **Гибкая настройка**: Вы можете легко кастомизировать системные сообщения, форматирование вывода, создавать кастомные обработчики нестандартного поведения и т.д.
----- -----
+12 -12
View File
@@ -85,20 +85,20 @@ msgstr ""
"Argenta is designed for creating applications that work in their own " "Argenta is designed for creating applications that work in their own "
"context (scope). This means that the application starts once and creates " "context (scope). This means that the application starts once and creates "
"an interactive session, similar to Python REPL or MySQL console. When " "an interactive session, similar to Python REPL or MySQL console. When "
"launched, the user enters this session where all the functionality you've " "launched, the user enters this session where all the functionality you've"
"implemented is available." " implemented is available."
#: ../../index.rst:22 #: ../../index.rst:22
msgid "" msgid ""
"Один из ключевых принципов библиотеки — цикличность. После выполнения " "Один из ключевых принципов библиотеки — цикличность. После выполнения "
"команды пользователь остаётся в интерактивной сессии и может выполнять " "команды пользователь остаётся в интерактивной сессии, в отличие от таких "
"следующие команды, в отличие от таких библиотек, как ``argparse``, " "библиотек, как ``argparse``, ``click`` и ``typer``, где приложение "
"``click`` и ``typer``, где приложение завершается после каждой команды. " "завершается после каждой команды. Выход из сессии контролируется "
"Выход из сессии контролируется пользователем." "пользователем."
msgstr "" msgstr ""
"One of the key principles of the library is cyclicity. After executing a " "One of the key principles of the library is cyclicity. After executing a "
"command, the user remains in the interactive session and can execute " "command, the user remains in the interactive session, "
"subsequent commands, unlike libraries such as ``argparse``, ``click``, " "unlike libraries such as ``argparse``, ``click``, "
"and ``typer``, where the application terminates after each command. " "and ``typer``, where the application terminates after each command. "
"Exiting the session is controlled by the user." "Exiting the session is controlled by the user."
@@ -124,8 +124,8 @@ msgid ""
"\"как\"." "\"как\"."
msgstr "" msgstr ""
"**Declarative syntax**: Commands and their handlers are declared using " "**Declarative syntax**: Commands and their handlers are declared using "
"simple decorators, making the code intuitive and allowing you to focus " "simple decorators, making the code intuitive and allowing you to focus on"
"on \"what\" you want to do, not \"how\"." " \"what\" you want to do, not \"how\"."
#: ../../index.rst:28 #: ../../index.rst:28
msgid "" msgid ""
@@ -156,8 +156,8 @@ msgid ""
"нестандартного поведения и т.д." "нестандартного поведения и т.д."
msgstr "" msgstr ""
"**Flexible configuration**: You can easily customize system messages, " "**Flexible configuration**: You can easily customize system messages, "
"output formatting, create custom handlers for non-standard behavior, " "output formatting, create custom handlers for non-standard behavior, and "
"and more." "more."
#: ../../index.rst:35 #: ../../index.rst:35
msgid "Архитектура и жизненный цикл" msgid "Архитектура и жизненный цикл"