diff --git a/docs/conf.py b/docs/conf.py index dadabd2..3bba94d 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -9,7 +9,7 @@ project = "Argenta" copyright = "2025, kolo" author = "kolo" -root_doc = "root/index" +root_doc = "index" # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration diff --git a/docs/root/index.rst b/docs/index.rst similarity index 96% rename from docs/root/index.rst rename to docs/index.rst index a8d7950..b28a336 100644 --- a/docs/root/index.rst +++ b/docs/index.rst @@ -37,18 +37,18 @@ Argenta нужна для создания приложений, которым :hidden: :caption: Контент: - quickstart - error_handling - dependency_injection - overriding_formatting - redirect_stdout - ../api/index + root/quickstart + root/error_handling + root/dependency_injection + root/overriding_formatting + root/redirect_stdout + root/api/index .. toctree:: :hidden: :caption: Для разработчиков: - contributing + root/contributing .. toctree:: :hidden: diff --git a/docs/locales/en/LC_MESSAGES/index.po b/docs/locales/en/LC_MESSAGES/index.po index aec3378..bd8d539 100644 --- a/docs/locales/en/LC_MESSAGES/index.po +++ b/docs/locales/en/LC_MESSAGES/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 14:19+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,43 +19,40 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../index.rst:35 +#: ../../index.rst:36 msgid "Контент:" -msgstr "Content:" +msgstr "" -#: ../../index.rst:45 +#: ../../index.rst:47 msgid "Для разработчиков:" -msgstr "For developers:" +msgstr "" -#: ../../index.rst:51 +#: ../../index.rst:53 msgid "GitHub" msgstr "" -#: ../../index.rst:51 +#: ../../index.rst:53 msgid "PyPI" msgstr "" -#: ../../index.rst:51 +#: ../../index.rst:53 msgid "Ссылки проекта:" -msgstr "Project Links" +msgstr "" #: ../../index.rst:7 msgid "Argenta" msgstr "" #: ../../index.rst:9 -#, fuzzy msgid "" "**Библиотека для построения модульных CLI-приложений с простым и приятным" " API.**" msgstr "" -"Python library for building modular CLI applications with simple and " -"agreeable API." #: ../../index.rst:11 msgid "" "У вас есть некая функциональность и вы хотите распространять её в виде " -"cli? Argenta поможет вам. Основная цель библиотеки дать возможность " +"CLI? Argenta поможет вам. Основная цель библиотеки дать возможность " "разработчикам сфокусироваться на реализации своих идей, предоставляя для " "этого удобные абстракциию." msgstr "" @@ -68,59 +65,63 @@ msgstr "" msgid "" "Argenta нужна для создания приложений, которым необходим свой скоуп, то " "есть: при запуске приложения юзер входит в абстрагированный скоуп, в " -"котором у него есть доступ к созданной функциональности Один из основных " -"принципов библиотеки это цикличность, это значит, что после ввода юзером " -"команды он не выходит из скоупа, в этом основное отличие от таких " -"библиотек, как ``argparse``, ``click`` и ``typer``. Выход из скоупа " -"контролируется самим юзером." +"котором у него есть доступ к созданной функциональности." msgstr "" -#: ../../index.rst:22 +#: ../../index.rst:20 +msgid "" +"Один из основных принципов библиотеки это цикличность, это значит, что " +"после ввода юзером команды он не выходит из скоупа, в этом основное " +"отличие от таких библиотек, как ``argparse``, ``click`` и ``typer``. " +"Выход из скоупа контролируется самим юзером." +msgstr "" + +#: ../../index.rst:23 msgid "**Ключевые особенности:**" msgstr "" -#: ../../index.rst:24 +#: ../../index.rst:25 msgid "" "**Обработчики**. Объекты представления приложения, непосредственные " "обработчики введённых команд. Создание обработчиков максимально " "декларативно" msgstr "" -#: ../../index.rst:25 +#: ../../index.rst:26 msgid "" "**Маршрутизаторы**. Объекты маршрутизации, которые регистрируют " "обработчиков, позволяя создавать кастомные настройки для групп " "обработчиков, а также семантически их разделять." msgstr "" -#: ../../index.rst:26 +#: ../../index.rst:27 msgid "" "**Приложение**. Объект управления жизненным циклом приложения, " "подключения созданных маршрутизаторов, конфигурирования различных " "вторичных утилит, таких как автокомплит, логирование и т.д." msgstr "" -#: ../../index.rst:27 +#: ../../index.rst:28 msgid "" "**Оркестратор**. Объект *оркестрации*, который конфигурирует, запускает и" " управляет всеми остальными компонентами программы." msgstr "" -#: ../../index.rst:28 +#: ../../index.rst:29 msgid "" "**Внедрение зависимостей**. ``Argenta`` нативно поддерживает ``dishka`` и" " предоставляет возможность инжектирования зависимостей в хэндлерах, " "резолвя тайпхинты, подробнее_." msgstr "" -#: ../../index.rst:32 +#: ../../index.rst:33 msgid "" "**Поддержка флагов**. Библиотека поддерживает определение флагов, " "введённых вместе с командой, ``Argenta`` сама парсит и валидирует их, " "отдавая понятные сущности." msgstr "" -#: ../../index.rst:33 +#: ../../index.rst:34 msgid "" "**Поддержка аргументов**. Осуществленна поддержка аргументов командной " "строки, позволяя пользователю передавать различные параметры при запуске " diff --git a/docs/locales/en/LC_MESSAGES/api/app/autocompleter.po b/docs/locales/en/LC_MESSAGES/root/api/app/autocompleter.po similarity index 87% rename from docs/locales/en/LC_MESSAGES/api/app/autocompleter.po rename to docs/locales/en/LC_MESSAGES/root/api/app/autocompleter.po index 8e8fca7..11d5bac 100644 --- a/docs/locales/en/LC_MESSAGES/api/app/autocompleter.po +++ b/docs/locales/en/LC_MESSAGES/root/api/app/autocompleter.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/app/autocompleter.rst:4 +#: ../../root/api/app/autocompleter.rst:4 msgid "Autocompleter" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/app/dividing_lines.po b/docs/locales/en/LC_MESSAGES/root/api/app/dividing_lines.po similarity index 87% rename from docs/locales/en/LC_MESSAGES/api/app/dividing_lines.po rename to docs/locales/en/LC_MESSAGES/root/api/app/dividing_lines.po index e7b7c31..31f9ae8 100644 --- a/docs/locales/en/LC_MESSAGES/api/app/dividing_lines.po +++ b/docs/locales/en/LC_MESSAGES/root/api/app/dividing_lines.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/app/dividing_lines.rst:4 +#: ../../root/api/app/dividing_lines.rst:4 msgid "DividingLines" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/app/index.po b/docs/locales/en/LC_MESSAGES/root/api/app/index.po similarity index 88% rename from docs/locales/en/LC_MESSAGES/api/app/index.po rename to docs/locales/en/LC_MESSAGES/root/api/app/index.po index faf7f26..bb3db40 100644 --- a/docs/locales/en/LC_MESSAGES/api/app/index.po +++ b/docs/locales/en/LC_MESSAGES/root/api/app/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/app/index.rst:2 +#: ../../root/api/app/index.rst:2 msgid "App" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/command/flags.po b/docs/locales/en/LC_MESSAGES/root/api/command/flags.po similarity index 87% rename from docs/locales/en/LC_MESSAGES/api/command/flags.po rename to docs/locales/en/LC_MESSAGES/root/api/command/flags.po index f92662b..31c4f77 100644 --- a/docs/locales/en/LC_MESSAGES/api/command/flags.po +++ b/docs/locales/en/LC_MESSAGES/root/api/command/flags.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/command/flags.rst:4 +#: ../../root/api/command/flags.rst:4 msgid "Flags" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/command/index.po b/docs/locales/en/LC_MESSAGES/root/api/command/index.po similarity index 87% rename from docs/locales/en/LC_MESSAGES/api/command/index.po rename to docs/locales/en/LC_MESSAGES/root/api/command/index.po index 5495841..c9c826c 100644 --- a/docs/locales/en/LC_MESSAGES/api/command/index.po +++ b/docs/locales/en/LC_MESSAGES/root/api/command/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/command/index.rst:2 +#: ../../root/api/command/index.rst:2 msgid "Command" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/command/possible_values.po b/docs/locales/en/LC_MESSAGES/root/api/command/possible_values.po similarity index 81% rename from docs/locales/en/LC_MESSAGES/api/command/possible_values.po rename to docs/locales/en/LC_MESSAGES/root/api/command/possible_values.po index d486fed..9ed112a 100644 --- a/docs/locales/en/LC_MESSAGES/api/command/possible_values.po +++ b/docs/locales/en/LC_MESSAGES/root/api/command/possible_values.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,11 +19,11 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/command/possible_values.rst:4 +#: ../../root/api/command/possible_values.rst:4 msgid "PossibleValues" msgstr "" -#: ../../api/command/possible_values.rst:6 +#: ../../root/api/command/possible_values.rst:6 msgid "mda" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/command/validation_status.po b/docs/locales/en/LC_MESSAGES/root/api/command/validation_status.po similarity index 81% rename from docs/locales/en/LC_MESSAGES/api/command/validation_status.po rename to docs/locales/en/LC_MESSAGES/root/api/command/validation_status.po index bb46e83..18ac021 100644 --- a/docs/locales/en/LC_MESSAGES/api/command/validation_status.po +++ b/docs/locales/en/LC_MESSAGES/root/api/command/validation_status.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,11 +19,11 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/command/validation_status.rst:4 +#: ../../root/api/command/validation_status.rst:4 msgid "ValidationStatus" msgstr "" -#: ../../api/command/validation_status.rst:6 +#: ../../root/api/command/validation_status.rst:6 msgid "case" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/index.po b/docs/locales/en/LC_MESSAGES/root/api/index.po similarity index 85% rename from docs/locales/en/LC_MESSAGES/api/index.po rename to docs/locales/en/LC_MESSAGES/root/api/index.po index 4529f62..55ba8df 100644 --- a/docs/locales/en/LC_MESSAGES/api/index.po +++ b/docs/locales/en/LC_MESSAGES/root/api/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 13:40+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,10 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/index.rst:2 +#: ../../root/api/index.rst:2 msgid "Публичный API" msgstr "" -#~ msgid "Public API" -#~ msgstr "" - diff --git a/docs/locales/en/LC_MESSAGES/api/orchestrator/argparser.po b/docs/locales/en/LC_MESSAGES/root/api/orchestrator/argparser.po similarity index 81% rename from docs/locales/en/LC_MESSAGES/api/orchestrator/argparser.po rename to docs/locales/en/LC_MESSAGES/root/api/orchestrator/argparser.po index 6f504e9..62ef841 100644 --- a/docs/locales/en/LC_MESSAGES/api/orchestrator/argparser.po +++ b/docs/locales/en/LC_MESSAGES/root/api/orchestrator/argparser.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,11 +19,11 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/orchestrator/argparser.rst:4 +#: ../../root/api/orchestrator/argparser.rst:4 msgid "Argparser" msgstr "" -#: ../../api/orchestrator/argparser.rst:6 +#: ../../root/api/orchestrator/argparser.rst:6 msgid "nu" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/orchestrator/arguments.po b/docs/locales/en/LC_MESSAGES/root/api/orchestrator/arguments.po similarity index 81% rename from docs/locales/en/LC_MESSAGES/api/orchestrator/arguments.po rename to docs/locales/en/LC_MESSAGES/root/api/orchestrator/arguments.po index cd44d5f..0c4266e 100644 --- a/docs/locales/en/LC_MESSAGES/api/orchestrator/arguments.po +++ b/docs/locales/en/LC_MESSAGES/root/api/orchestrator/arguments.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,11 +19,11 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/orchestrator/arguments.rst:4 +#: ../../root/api/orchestrator/arguments.rst:4 msgid "Arguments" msgstr "" -#: ../../api/orchestrator/arguments.rst:6 +#: ../../root/api/orchestrator/arguments.rst:6 msgid "prikol" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/orchestrator/index.po b/docs/locales/en/LC_MESSAGES/root/api/orchestrator/index.po similarity index 87% rename from docs/locales/en/LC_MESSAGES/api/orchestrator/index.po rename to docs/locales/en/LC_MESSAGES/root/api/orchestrator/index.po index 7be01ec..c72d04a 100644 --- a/docs/locales/en/LC_MESSAGES/api/orchestrator/index.po +++ b/docs/locales/en/LC_MESSAGES/root/api/orchestrator/index.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/orchestrator/index.rst:2 +#: ../../root/api/orchestrator/index.rst:2 msgid "Orchestrator" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/response.po b/docs/locales/en/LC_MESSAGES/root/api/response.po similarity index 88% rename from docs/locales/en/LC_MESSAGES/api/response.po rename to docs/locales/en/LC_MESSAGES/root/api/response.po index e1fb1eb..200c74e 100644 --- a/docs/locales/en/LC_MESSAGES/api/response.po +++ b/docs/locales/en/LC_MESSAGES/root/api/response.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/response.rst:4 +#: ../../root/api/response.rst:4 msgid "Response" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/api/router.po b/docs/locales/en/LC_MESSAGES/root/api/router.po similarity index 88% rename from docs/locales/en/LC_MESSAGES/api/router.po rename to docs/locales/en/LC_MESSAGES/root/api/router.po index 7cd86cd..6bf2423 100644 --- a/docs/locales/en/LC_MESSAGES/api/router.po +++ b/docs/locales/en/LC_MESSAGES/root/api/router.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../api/router.rst:4 +#: ../../root/api/router.rst:4 msgid "Router" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/contributing.po b/docs/locales/en/LC_MESSAGES/root/contributing.po similarity index 83% rename from docs/locales/en/LC_MESSAGES/contributing.po rename to docs/locales/en/LC_MESSAGES/root/contributing.po index 63b15f8..f0368c7 100644 --- a/docs/locales/en/LC_MESSAGES/contributing.po +++ b/docs/locales/en/LC_MESSAGES/root/contributing.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 13:40+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,20 +19,17 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../contributing.rst:2 +#: ../../root/contributing.rst:4 msgid "Вклад в проект" msgstr "" -#: ../../contributing.rst:4 +#: ../../root/contributing.rst:6 msgid "" "``argenta`` открытый проект и мы рады новым разработчикам в нашем " "сообществе." msgstr "" -#: ../../contributing.rst:7 +#: ../../root/contributing.rst:9 msgid "Getting started" msgstr "" -#~ msgid "Contributing" -#~ msgstr "" - diff --git a/docs/locales/en/LC_MESSAGES/dependency_injection.po b/docs/locales/en/LC_MESSAGES/root/dependency_injection.po similarity index 88% rename from docs/locales/en/LC_MESSAGES/dependency_injection.po rename to docs/locales/en/LC_MESSAGES/root/dependency_injection.po index 5260c22..bf2a468 100644 --- a/docs/locales/en/LC_MESSAGES/dependency_injection.po +++ b/docs/locales/en/LC_MESSAGES/root/dependency_injection.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../dependency_injection.rst:4 +#: ../../root/dependency_injection.rst:4 msgid "Внедрение зависимостей" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/error_handling.po b/docs/locales/en/LC_MESSAGES/root/error_handling.po similarity index 82% rename from docs/locales/en/LC_MESSAGES/error_handling.po rename to docs/locales/en/LC_MESSAGES/root/error_handling.po index ea10419..cdb3285 100644 --- a/docs/locales/en/LC_MESSAGES/error_handling.po +++ b/docs/locales/en/LC_MESSAGES/root/error_handling.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 11:06+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,15 +19,15 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../error_handling.rst:2 +#: ../../root/error_handling.rst:2 msgid "Обработка ошибок" msgstr "" -#: ../../error_handling.rst:5 +#: ../../root/error_handling.rst:5 msgid "Конфигурация" msgstr "" -#: ../../error_handling.rst:7 +#: ../../root/error_handling.rst:7 msgid "привет" msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/root/overriding_formatting.po b/docs/locales/en/LC_MESSAGES/root/overriding_formatting.po new file mode 100644 index 0000000..647e3f6 --- /dev/null +++ b/docs/locales/en/LC_MESSAGES/root/overriding_formatting.po @@ -0,0 +1,25 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2025, kolo +# This file is distributed under the same license as the Argenta package. +# FIRST AUTHOR , 2025. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Argenta \n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language: en\n" +"Language-Team: en \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.17.0\n" + +#: ../../root/overriding_formatting.rst:4 +msgid "Переопределение форматирования" +msgstr "" + diff --git a/docs/locales/en/LC_MESSAGES/quickstart.po b/docs/locales/en/LC_MESSAGES/root/quickstart.po similarity index 79% rename from docs/locales/en/LC_MESSAGES/quickstart.po rename to docs/locales/en/LC_MESSAGES/root/quickstart.po index 1da81db..318b426 100644 --- a/docs/locales/en/LC_MESSAGES/quickstart.po +++ b/docs/locales/en/LC_MESSAGES/root/quickstart.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 14:19+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,15 +19,15 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../quickstart.rst:4 +#: ../../root/quickstart.rst:4 msgid "Быстрый старт" msgstr "" -#: ../../quickstart.rst:6 +#: ../../root/quickstart.rst:6 msgid "**Установка** ``Argenta``" msgstr "" -#: ../../quickstart.rst:12 +#: ../../root/quickstart.rst:12 msgid "" "**Определение роутера и хэндлеров**, за регистрацию функции как " "обработчика отвечает декоратор ``@router.command``, хэндлер всегда должен" @@ -35,7 +35,7 @@ msgid "" "`." msgstr "" -#: ../../quickstart.rst:17 +#: ../../root/quickstart.rst:17 msgid "" "**Определение приложения и оркестратора**, для запуска приложения " "необходимо вызвать ``.include_router()`` у созданного приложения и " @@ -44,12 +44,11 @@ msgid "" "приложение." msgstr "" -#~ msgid "Quickstart" -#~ msgstr "" +#: ../../root/quickstart.rst:22 +msgid "**Запуск приложения**, запускаем приложение как обычный процесс." +msgstr "" -#~ msgid "**Install Argenta**" -#~ msgstr "" - -#~ msgid "**Установка**" -#~ msgstr "" +#: ../../root/quickstart.rst:25 +msgid "Quickstart Example" +msgstr "" diff --git a/docs/locales/en/LC_MESSAGES/redirect_stdout.po b/docs/locales/en/LC_MESSAGES/root/redirect_stdout.po similarity index 89% rename from docs/locales/en/LC_MESSAGES/redirect_stdout.po rename to docs/locales/en/LC_MESSAGES/root/redirect_stdout.po index 11a53b5..b69c8f5 100644 --- a/docs/locales/en/LC_MESSAGES/redirect_stdout.po +++ b/docs/locales/en/LC_MESSAGES/root/redirect_stdout.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Argenta \n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-10-15 13:40+0300\n" +"POT-Creation-Date: 2025-10-15 16:09+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: en\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.17.0\n" -#: ../../redirect_stdout.rst:2 +#: ../../root/redirect_stdout.rst:2 msgid "Перенаправление стандартного вывода" msgstr "" diff --git a/docs/api/App/Autocompleter.rst b/docs/root/api/app/autocompleter.rst similarity index 100% rename from docs/api/App/Autocompleter.rst rename to docs/root/api/app/autocompleter.rst diff --git a/docs/api/App/dividing_lines.rst b/docs/root/api/app/dividing_lines.rst similarity index 100% rename from docs/api/App/dividing_lines.rst rename to docs/root/api/app/dividing_lines.rst diff --git a/docs/api/App/index.rst b/docs/root/api/app/index.rst similarity index 100% rename from docs/api/App/index.rst rename to docs/root/api/app/index.rst diff --git a/docs/api/Command/Flags.rst b/docs/root/api/command/flags.rst similarity index 100% rename from docs/api/Command/Flags.rst rename to docs/root/api/command/flags.rst diff --git a/docs/api/Command/index.rst b/docs/root/api/command/index.rst similarity index 100% rename from docs/api/Command/index.rst rename to docs/root/api/command/index.rst diff --git a/docs/api/Command/possible_values.rst b/docs/root/api/command/possible_values.rst similarity index 100% rename from docs/api/Command/possible_values.rst rename to docs/root/api/command/possible_values.rst diff --git a/docs/api/Command/validation_status.rst b/docs/root/api/command/validation_status.rst similarity index 100% rename from docs/api/Command/validation_status.rst rename to docs/root/api/command/validation_status.rst diff --git a/docs/api/index.rst b/docs/root/api/index.rst similarity index 100% rename from docs/api/index.rst rename to docs/root/api/index.rst diff --git a/docs/api/Orchestrator/Argparser.rst b/docs/root/api/orchestrator/argparser.rst similarity index 100% rename from docs/api/Orchestrator/Argparser.rst rename to docs/root/api/orchestrator/argparser.rst diff --git a/docs/api/Orchestrator/Arguments.rst b/docs/root/api/orchestrator/arguments.rst similarity index 100% rename from docs/api/Orchestrator/Arguments.rst rename to docs/root/api/orchestrator/arguments.rst diff --git a/docs/api/Orchestrator/index.rst b/docs/root/api/orchestrator/index.rst similarity index 100% rename from docs/api/Orchestrator/index.rst rename to docs/root/api/orchestrator/index.rst diff --git a/docs/api/Response.rst b/docs/root/api/response.rst similarity index 100% rename from docs/api/Response.rst rename to docs/root/api/response.rst diff --git a/docs/api/Router.rst b/docs/root/api/router.rst similarity index 100% rename from docs/api/Router.rst rename to docs/root/api/router.rst diff --git a/docs/root/quickstart.rst b/docs/root/quickstart.rst index cf0cc5c..839e6ea 100644 --- a/docs/root/quickstart.rst +++ b/docs/root/quickstart.rst @@ -9,17 +9,17 @@ pip install argenta -2. **Определение роутера и хэндлеров**, за регистрацию функции как обработчика отвечает декоратор ``@router.command``, хэндлер всегда должен принимать аргумент с типом ``Response``, подробнее в :ref:`разделе `. +2. **Определение роутера и хэндлеров**. За регистрацию функции как обработчика отвечает декоратор ``@router.command``, хэндлер всегда должен принимать аргумент с типом ``Response``, подробнее в :ref:`разделе `. .. literalinclude:: ../code_snippets/quickstart_example_routers.py :language: python -3. **Определение приложения и оркестратора**, для запуска приложения необходимо вызвать ``.include_router()`` у созданного приложения и передать ему раннее созданный роутер, после этого необходимо вызвать ``.start_polling()`` у созданного оркестратора и передать ему созданное приложение. +3. **Определение приложения и оркестратора**. Для запуска приложения необходимо вызвать ``.include_router()`` у созданного приложения и передать ему раннее созданный роутер, после этого необходимо вызвать ``.start_polling()`` у созданного оркестратора и передать ему созданное приложение. .. literalinclude:: ../code_snippets/quickstart_example_main.py :language: python -4. **Запуск приложения**, запускаем приложение как обычный процесс. +4. **Запуск приложения**. Запускаем приложение как обычный скрипт. .. image:: https://github.com/koloideal/Argenta/blob/docs/create_docs/imgs/mock_app_preview6.png?raw=true