mirror of
https://github.com/koloideal/Argenta.git
synced 2026-06-10 18:15:28 +03:00
Update documentation
This commit is contained in:
+2
-2
@@ -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/), вы можете легко внедрять зависимости прямо в обработчики команд, что упрощает их тестирование, позволяет избежать мутабельных глобалов и многое другое.
|
||||||
* **Автоматическая валидация и парсинг**: Библиотека берёт на себя обработку флагов и аргументов командной строки, включая их парсинг, валидацию и преобразование типов.
|
* **Автоматическая валидация и парсинг**: Библиотека берёт на себя обработку флагов и аргументов командной строки, включая их парсинг, валидацию и преобразование типов.
|
||||||
* **Гибкая настройка**: Вы можете легко кастомизировать системные сообщения, форматирование вывода, ссоздавать кастомные обработчики нестандартного поведения и т.д.
|
* **Гибкая настройка**: Вы можете легко кастомизировать системные сообщения, форматирование вывода, создавать кастомные обработчики нестандартного поведения и т.д.
|
||||||
|
|
||||||
-----
|
-----
|
||||||
|
|
||||||
|
|||||||
@@ -91,14 +91,14 @@ msgstr ""
|
|||||||
#: ../../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 "Архитектура и жизненный цикл"
|
||||||
|
|||||||
Reference in New Issue
Block a user