From 5c933ab65699a0b9f2585c67aef25a2b87b51841 Mon Sep 17 00:00:00 2001 From: kolo Date: Thu, 4 Dec 2025 21:49:31 +0300 Subject: [PATCH] Update documentation --- docs/index.rst | 4 ++-- docs/locales/en/LC_MESSAGES/index.po | 24 ++++++++++++------------ 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/index.rst b/docs/index.rst index 52e0a42..d14f8fa 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -14,7 +14,7 @@ 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 Argenta предназначена для создания приложений, работающих в собственном контексте (scope). Это означает, что приложение запускается один раз и создаёт интерактивную сессию, похожую на Python REPL или MySQL консоль. При запуске пользователь входит в эту сессию, где ему доступна вся реализованная вами функциональность. @@ -27,7 +27,7 @@ Argenta предназначена для создания приложений, * **Декларативный синтаксис**: Команды и их обработчики объявляются с помощью простых декораторов, что делает код интуитивно понятным и позволяет сосредоточиться на том, "что" вы хотите сделать, а не "как". * **Нативный DI**: Благодаря интеграции с [dishka](https://dishka.readthedocs.io/en/stable/), вы можете легко внедрять зависимости прямо в обработчики команд, что упрощает их тестирование, позволяет избежать мутабельных глобалов и многое другое. * **Автоматическая валидация и парсинг**: Библиотека берёт на себя обработку флагов и аргументов командной строки, включая их парсинг, валидацию и преобразование типов. -* **Гибкая настройка**: Вы можете легко кастомизировать системные сообщения, форматирование вывода, ссоздавать кастомные обработчики нестандартного поведения и т.д. +* **Гибкая настройка**: Вы можете легко кастомизировать системные сообщения, форматирование вывода, создавать кастомные обработчики нестандартного поведения и т.д. ----- diff --git a/docs/locales/en/LC_MESSAGES/index.po b/docs/locales/en/LC_MESSAGES/index.po index f4e7c0e..a3121e9 100644 --- a/docs/locales/en/LC_MESSAGES/index.po +++ b/docs/locales/en/LC_MESSAGES/index.po @@ -85,20 +85,20 @@ msgstr "" "Argenta is designed for creating applications that work in their own " "context (scope). This means that the application starts once and creates " "an interactive session, similar to Python REPL or MySQL console. When " -"launched, the user enters this session where all the functionality you've " -"implemented is available." +"launched, the user enters this session where all the functionality you've" +" implemented is available." #: ../../index.rst:22 msgid "" "Один из ключевых принципов библиотеки — цикличность. После выполнения " -"команды пользователь остаётся в интерактивной сессии и может выполнять " -"следующие команды, в отличие от таких библиотек, как ``argparse``, " -"``click`` и ``typer``, где приложение завершается после каждой команды. " -"Выход из сессии контролируется пользователем." +"команды пользователь остаётся в интерактивной сессии, в отличие от таких " +"библиотек, как ``argparse``, ``click`` и ``typer``, где приложение " +"завершается после каждой команды. Выход из сессии контролируется " +"пользователем." msgstr "" "One of the key principles of the library is cyclicity. After executing a " -"command, the user remains in the interactive session and can execute " -"subsequent commands, unlike libraries such as ``argparse``, ``click``, " +"command, the user remains in the interactive session, " +"unlike libraries such as ``argparse``, ``click``, " "and ``typer``, where the application terminates after each command. " "Exiting the session is controlled by the user." @@ -124,8 +124,8 @@ msgid "" "\"как\"." msgstr "" "**Declarative syntax**: Commands and their handlers are declared using " -"simple decorators, making the code intuitive and allowing you to focus " -"on \"what\" you want to do, not \"how\"." +"simple decorators, making the code intuitive and allowing you to focus on" +" \"what\" you want to do, not \"how\"." #: ../../index.rst:28 msgid "" @@ -156,8 +156,8 @@ msgid "" "нестандартного поведения и т.д." msgstr "" "**Flexible configuration**: You can easily customize system messages, " -"output formatting, create custom handlers for non-standard behavior, " -"and more." +"output formatting, create custom handlers for non-standard behavior, and " +"more." #: ../../index.rst:35 msgid "Архитектура и жизненный цикл"