docs

docs/code_snippets/argparser/snippet.py

@@ -1,7 +1,7 @@
 from argenta import App, Orchestrator
 from argenta.orchestrator.argparser import ArgParser, BooleanArgument
 
-arg_parser = ArgParser(processed_args=[BooleanArgument('config')])
+arg_parser = ArgParser(processed_args=[BooleanArgument("config")])
 orchestrator = Orchestrator(
     arg_parser=arg_parser,
 )

docs/code_snippets/argspace/snippet.py

@@ -3,23 +3,13 @@ from argenta.orchestrator.argparser import ArgParser, ValueArgument
 
 # Определение аргументов приложения
 arguments = [
-    ValueArgument(
-        "host",
-        help="Server host",
-        default="localhost"
-    ),
-    ValueArgument(
-        "port",
-        help="Server port",
-        default="8080"
-    ),
+    ValueArgument("host", help="Server host", default="localhost"),
+    ValueArgument("port", help="Server port", default="8080"),
 ]
 
 # Создание и запуск парсера
 argparser = ArgParser(
-    processed_args=arguments,
-    name="WebServer",
-    description="Simple web server"
+    processed_args=arguments, name="WebServer", description="Simple web server"
 )
 
 app = App()
@@ -40,6 +30,6 @@ def main():
 
     orchestrator.start_polling(app)
 
+
 if __name__ == "__main__":
     main()
-    

docs/code_snippets/argspace/snippet2.py

@@ -4,7 +4,7 @@ from argenta.orchestrator.argparser import ArgSpace
 
 router = Router()
 
-@router.command('get_args')
+
+@router.command("get_args")
 async def get_args(response: Response, argspace: FromDishka[ArgSpace]):
     print(argspace.all_arguments)
-    

docs/code_snippets/argspace/snippet3.py

@@ -1,11 +1,11 @@
 from argenta import Response, Router
 from argenta.di import FromDishka
-from argenta.orchestrator.argparser import (ArgSpace, BooleanArgument,
-                                            ValueArgument)
+from argenta.orchestrator.argparser import ArgSpace, BooleanArgument, ValueArgument
 
 router = Router()
 
-@router.command('get_args')
+
+@router.command("get_args")
 def get_args(response: Response, argspace: FromDishka[ArgSpace]):
     # Получение всех булевых флагов
     boolean_flags = argspace.get_by_type(BooleanArgument)

docs/code_snippets/command/snippet.py

@@ -2,25 +2,20 @@ from argenta import Command
 from argenta.command import Flag, Flags
 
 # Простая команда без флагов
-hello_cmd = Command(
-    "hello",
-    description="Greet the user"
-)
+hello_cmd = Command("hello", description="Greet the user")
 
 # Команда с описанием и псевдонимами
-quit_cmd = Command(
-    "quit",
-    description="Exit the application",
-    aliases=["exit", "q"]
-)
+quit_cmd = Command("quit", description="Exit the application", aliases=["exit", "q"])
 
 # Команда с флагами
 deploy_cmd = Command(
     "deploy",
     description="Deploy application to server",
-    flags=Flags([
+    flags=Flags(
+        [
             Flag("env", help="Environment name", possible_values=["dev", "prod"]),
-        Flag("force", help="Force deployment")
-    ]),
-    aliases=["dep"]
+            Flag("force", help="Force deployment"),
+        ]
+    ),
+    aliases=["dep"],
 )

docs/code_snippets/command/snippet2.py

@@ -2,17 +2,18 @@ from argenta import Command, Response, Router
 
 router = Router(title="User Management")
 
-@router.command(Command(
-    "create-user",
-    description="Create a new user account"
-))
+
+@router.command(Command("create-user", description="Create a new user account"))
 def handle_create_user(response):
     print("Creating new user...")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "delete-user",
         description="Delete existing user account",
-    aliases=["remove-user", "rm-user"]
-))
+        aliases=["remove-user", "rm-user"],
+    )
+)
 def handle_delete_user(response: Response):
     print("Deleting user...")

docs/code_snippets/command/snippet3.py

@@ -3,16 +3,21 @@ from argenta.command import Flag, Flags
 
 router = Router(title="Server Management")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "start",
         description="Start the server",
-    flags=Flags([
+        flags=Flags(
+            [
                 Flag("port", help="Server port", default="8080"),
                 Flag("host", help="Server host", default="localhost"),
-        Flag("debug", help="Enable debug mode")
-    ]),
-    aliases=["run"]
-))
+                Flag("debug", help="Enable debug mode"),
+            ]
+        ),
+        aliases=["run"],
+    )
+)
 def handle_start(response: Response):
     input_flags = response.input_flags
     port_flag = input_flags.get_flag_by_name("port")

docs/code_snippets/dependency_injection/snippet.py

@@ -5,7 +5,7 @@ from argenta.di import FromDishka
 
 router = Router()
 
-@router.command('connect')
-def connect_handler(response: Response, connection: FromDishka[Connection]):
-	connection.execute('...')
 
+@router.command("connect")
+def connect_handler(response: Response, connection: FromDishka[Connection]):
+    connection.execute("...")

docs/code_snippets/dependency_injection/snippet4.py

@@ -4,7 +4,7 @@ from argenta.orchestrator.argparser import ArgSpace
 
 router = Router()
 
-@router.command('info')
-def connect_handler(response: Response, argspace: FromDishka[ArgSpace]):
-	print(argspace.get_by_name('type'))
 
+@router.command("info")
+def connect_handler(response: Response, argspace: FromDishka[ArgSpace]):
+    print(argspace.get_by_name("type"))

docs/code_snippets/error_handling/snippet.py

@@ -4,5 +4,6 @@ from argenta import App
 def empty_command_handler():
     print("Empty command handler called")
 
+
 app: App = App()
 app.set_empty_command_handler(empty_command_handler)

docs/code_snippets/error_handling/snippet2.py

@@ -4,5 +4,6 @@ from argenta import App
 def incorrect_input_syntax_handler(raw_command: str):
     print(f"Incorrect input syntax for command: {raw_command}")
 
+
 app: App = App()
 app.set_incorrect_input_syntax_handler(incorrect_input_syntax_handler)

docs/code_snippets/error_handling/snippet3.py

@@ -4,5 +4,6 @@ from argenta import App
 def repeated_input_flags_handler(raw_command: str):
     print(f"Repeated input flags: {raw_command}")
 
+
 app: App = App()
 app.set_repeated_input_flags_handler(repeated_input_flags_handler)

docs/code_snippets/error_handling/snippet4.py

@@ -4,5 +4,6 @@ from argenta import App
 def empty_command_handler():
     print("Empty input command")
 
+
 app: App = App()
 app.set_empty_command_handler(empty_command_handler)

docs/code_snippets/error_handling/snippet5.py

@@ -5,5 +5,6 @@ from argenta.command import InputCommand
 def unknown_command_handler(command: InputCommand):
     print(f"Unknown input command with trigger: {command.trigger}")
 
+
 app: App = App()
 app.set_unknown_command_handler(unknown_command_handler)

docs/code_snippets/error_handling/snippet6.py

@@ -4,5 +4,6 @@ from argenta import App, Response
 def exit_command_handler(response: Response):
     print("Exit command handler")
 
+
 app: App = App()
 app.set_exit_command_handler(exit_command_handler)

docs/code_snippets/flag/predefined_flags.py

@@ -2,17 +2,21 @@ from argenta.command import Flags
 from argenta.command.flag.defaults import PredefinedFlags
 
 # Использование предопределенных флагов при создании команды
-command_flags = Flags([
+command_flags = Flags(
+    [
         PredefinedFlags.HELP,
         PredefinedFlags.SHORT_HELP,
         PredefinedFlags.INFO,
-])
+    ]
+)
 
 # Использование сетевых флагов
-network_flags = Flags([
+network_flags = Flags(
+    [
         PredefinedFlags.HOST,
         PredefinedFlags.PORT,
-])
+    ]
+)
 
 # Валидация значений предопределенных флагов
 print(PredefinedFlags.HOST.validate_input_flag_value("192.168.1.1"))  # True

docs/code_snippets/flag/snippet.py

@@ -12,13 +12,10 @@ short_flag = Flag(name="v", prefix="-")
 help_flag = Flag(name="help", possible_values=PossibleValues.NEITHER)
 
 # Флаг со списком допустимых значений
-format_flag = Flag(
-    name="format",
-    possible_values=["json", "xml", "csv"]
-)
+format_flag = Flag(name="format", possible_values=["json", "xml", "csv"])
 
 # Флаг с регулярным выражением для валидации
 email_flag = Flag(
     name="email",
-    possible_values=re.compile(r"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$")
+    possible_values=re.compile(r"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$"),
 )

docs/code_snippets/flags/snippet.py

@@ -4,14 +4,14 @@ from argenta import Command
 from argenta.command import Flag, Flags
 
 # Создание коллекции с флагами
-flags = Flags([
-    Flag("host", possible_values=re.compile(r"^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$")),
-    Flag("port", possible_values=re.compile(r"^\d{1,5}$"))
-])
+flags = Flags(
+    [
+        Flag(
+            "host", possible_values=re.compile(r"^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$")
+        ),
+        Flag("port", possible_values=re.compile(r"^\d{1,5}$")),
+    ]
+)
 
 # Использование в команде
-cmd = Command(
-    "start",
-    description="Start the server",
-    flags=flags
-)
+cmd = Command("start", description="Start the server", flags=flags)

docs/code_snippets/flags/snippet3.py

@@ -2,16 +2,14 @@ from argenta.command import Flag, Flags
 from argenta.command.flag.defaults import PredefinedFlags
 
 # Начальная коллекция
-flags = Flags([
-    PredefinedFlags.HOST
-])
+flags = Flags([PredefinedFlags.HOST])
 
 # Дополнительные флаги
 additional_flags = [
     PredefinedFlags.PORT,
     Flag("database"),
     Flag("ssl"),
-    Flag("verbose")
+    Flag("verbose"),
 ]
 
 # Добавление списка флагов

docs/code_snippets/flags/snippet4.py

@@ -1,11 +1,7 @@
 from argenta.command import Flag, Flags
 from argenta.command.flag.defaults import PredefinedFlags
 
-flags = Flags([
-    PredefinedFlags.HOST,
-    PredefinedFlags.PORT,
-    Flag("verbose")
-])
+flags = Flags([PredefinedFlags.HOST, PredefinedFlags.PORT, Flag("verbose")])
 
 # Получение флага по имени
 host_flag = flags.get_flag_by_name("host")

docs/code_snippets/flags/snippet5.py

@@ -1,11 +1,7 @@
 from argenta.command import Flag, Flags
 from argenta.command.flag.defaults import PredefinedFlags
 
-flags = Flags([
-    PredefinedFlags.HOST,
-    PredefinedFlags.PORT,
-    Flag("verbose")
-])
+flags = Flags([PredefinedFlags.HOST, PredefinedFlags.PORT, Flag("verbose")])
 
 # Итерация по всем флагам
 for flag in flags:

docs/code_snippets/flags/snippet6.py

@@ -1,10 +1,6 @@
 from argenta.command import Flag, Flags
 
-flags = Flags([
-    Flag("first"),
-    Flag("second"),
-    Flag("third")
-])
+flags = Flags([Flag("first"), Flag("second"), Flag("third")])
 
 print(flags[0].name)
 # first

docs/code_snippets/input_flag/snippet1.py

@@ -2,16 +2,10 @@ from argenta.command.flag import InputFlag, ValidationStatus
 
 # Создание InputFlag с полным набором параметров
 output_flag = InputFlag(
-    name="output",
-    prefix="--",
-    input_value="result.txt",
-    status=ValidationStatus.VALID
+    name="output", prefix="--", input_value="result.txt", status=ValidationStatus.VALID
 )
 
 # Флаг без значения
 help_flag = InputFlag(
-    name="help",
-    prefix="-",
-    input_value=None,
-    status=ValidationStatus.VALID
+    name="help", prefix="-", input_value=None, status=ValidationStatus.VALID
 )

docs/code_snippets/input_flag/snippet2.py

@@ -1,10 +1,7 @@
 from argenta.command.flag import InputFlag, ValidationStatus
 
 flag = InputFlag(
-    name="verbose",
-    prefix="-",
-    input_value=None,
-    status=ValidationStatus.VALID
+    name="verbose", prefix="-", input_value=None, status=ValidationStatus.VALID
 )
 
 # Получение строкового представления флага

docs/code_snippets/input_flag/snippet3.py

@@ -1,17 +1,11 @@
 from argenta.command.flag import InputFlag, ValidationStatus
 
 flag_with_value = InputFlag(
-    name="output",
-    prefix="--",
-    input_value="result.txt",
-    status=ValidationStatus.VALID
+    name="output", prefix="--", input_value="result.txt", status=ValidationStatus.VALID
 )
 
 flag_without_value = InputFlag(
-    name="help",
-    prefix="-",
-    input_value=None,
-    status=ValidationStatus.VALID
+    name="help", prefix="-", input_value=None, status=ValidationStatus.VALID
 )
 
 # Строковое представление включает значение

docs/code_snippets/input_flag/snippet4.py

@@ -4,7 +4,7 @@ flag = InputFlag(
     name="config",
     prefix="--",
     input_value="settings.json",
-    status=ValidationStatus.VALID
+    status=ValidationStatus.VALID,
 )
 
 # Отладочное представление объекта

docs/code_snippets/input_flag/snippet5.py

@@ -1,17 +1,11 @@
 from argenta.command.flag import InputFlag, ValidationStatus
 
 flag1 = InputFlag(
-    name="debug",
-    prefix="--",
-    input_value=None,
-    status=ValidationStatus.VALID
+    name="debug", prefix="--", input_value=None, status=ValidationStatus.VALID
 )
 
 flag2 = InputFlag(
-    name="debug",
-    prefix="-",
-    input_value="true",
-    status=ValidationStatus.INVALID
+    name="debug", prefix="-", input_value="true", status=ValidationStatus.INVALID
 )
 
 # Сравнение по имени (префикс и значение не учитываются)

docs/code_snippets/input_flags/snippet1.py

@@ -3,14 +3,14 @@ from argenta.command import Flag, Flags
 
 router = Router(title="Example")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "example",
         description="Example command with flags",
-    flags=Flags([
-        Flag("name"),
-        Flag("age")
-    ])
-))
+        flags=Flags([Flag("name"), Flag("age")]),
+    )
+)
 def example_handler(response: Response):
     # response.input_flags содержит коллекцию InputFlags
     input_flags = response.input_flags
@@ -20,4 +20,3 @@ def example_handler(response: Response):
         print(f"Received {len(input_flags.flags)} flag(s)")
     else:
         print("No flags provided")
-

docs/code_snippets/input_flags/snippet10.py

@@ -4,15 +4,20 @@ from argenta.command.flag import ValidationStatus
 
 router = Router(title="Comprehensive Example")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "validate",
         description="Validate all flags",
-    flags=Flags([
+        flags=Flags(
+            [
                 Flag("format", possible_values=["json", "xml"]),
                 Flag("output"),
-        Flag("force")
-    ])
-))
+                Flag("force"),
+            ]
+        ),
+    )
+)
 def validate_handler(response: Response):
     input_flags = response.input_flags
 
@@ -45,4 +50,3 @@ def validate_handler(response: Response):
         print("\nProcessing valid flags:")
         for flag in valid_flags:
             print(f"  Processing {flag.name} = {flag.input_value}")
-

docs/code_snippets/input_flags/snippet2.py

@@ -3,15 +3,14 @@ from argenta.command import Flag, Flags
 
 router = Router(title="Get Flag Example")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "config",
         description="Configure settings",
-    flags=Flags([
-        Flag("host"),
-        Flag("port"),
-        Flag("debug")
-    ])
-))
+        flags=Flags([Flag("host"), Flag("port"), Flag("debug")]),
+    )
+)
 def config_handler(response: Response):
     input_flags = response.input_flags
 
@@ -33,4 +32,3 @@ def config_handler(response: Response):
     missing_flag = input_flags.get_flag_by_name("nonexistent")
     if missing_flag is None:
         print("Flag 'nonexistent' not found")
-

docs/code_snippets/input_flags/snippet3.py

@@ -3,6 +3,7 @@ from argenta.command.flag import InputFlag, InputFlags, ValidationStatus
 
 router = Router(title="Add Flag Example")
 
+
 @router.command(Command("test", description="Test command"))
 def test_handler(response: Response):
     # Создаём новую коллекцию InputFlags
@@ -10,13 +11,9 @@ def test_handler(response: Response):
 
     # Добавляем один флаг
     test_flag = InputFlag(
-        name="test",
-        prefix="--",
-        input_value="value",
-        status=ValidationStatus.VALID
+        name="test", prefix="--", input_value="value", status=ValidationStatus.VALID
     )
     new_flags.add_flag(test_flag)
 
     print(f"Flags count: {len(new_flags.flags)}")
     print(f"First flag: {new_flags.flags[0].name}")
-

docs/code_snippets/input_flags/snippet4.py

@@ -5,24 +5,15 @@ flags = InputFlags()
 
 # Создаём несколько флагов
 flag1 = InputFlag(
-    name="option1",
-    prefix="--",
-    input_value="value1",
-    status=ValidationStatus.VALID
+    name="option1", prefix="--", input_value="value1", status=ValidationStatus.VALID
 )
 
 flag2 = InputFlag(
-    name="option2",
-    prefix="--",
-    input_value="value2",
-    status=ValidationStatus.VALID
+    name="option2", prefix="--", input_value="value2", status=ValidationStatus.VALID
 )
 
 flag3 = InputFlag(
-    name="option3",
-    prefix="---",
-    input_value="value3",
-    status=ValidationStatus.VALID
+    name="option3", prefix="---", input_value="value3", status=ValidationStatus.VALID
 )
 
 # Добавляем все флаги одним вызовом
@@ -31,4 +22,3 @@ flags.add_flags([flag1, flag2, flag3])
 print(f"Total flags: {len(flags.flags)}")
 for flag in flags:
     print(f"  - {flag.string_entity}: {flag.input_value}")
-

docs/code_snippets/input_flags/snippet5.py

@@ -3,15 +3,14 @@ from argenta.command import Flag, Flags
 
 router = Router(title="Iterate Example")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "process",
         description="Process with multiple flags",
-    flags=Flags([
-        Flag("file"),
-        Flag("format"),
-        Flag("output")
-    ])
-))
+        flags=Flags([Flag("file"), Flag("format"), Flag("output")]),
+    )
+)
 def process_handler(response: Response):
     input_flags = response.input_flags
 
@@ -25,4 +24,3 @@ def process_handler(response: Response):
     print("\nFlags with indices:")
     for index, flag in enumerate(input_flags):
         print(f"  [{index}] {flag.name}: {flag.input_value}")
-

docs/code_snippets/input_flags/snippet6.py

@@ -3,15 +3,14 @@ from argenta.command import Flag, Flags
 
 router = Router(title="Index Access Example")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "example",
         description="Example with indexed access",
-    flags=Flags([
-        Flag("first"),
-        Flag("second"),
-        Flag("third")
-    ])
-))
+        flags=Flags([Flag("first"), Flag("second"), Flag("third")]),
+    )
+)
 def example_handler(response: Response):
     input_flags = response.input_flags
 
@@ -28,4 +27,3 @@ def example_handler(response: Response):
     if len(input_flags.flags) >= 2:
         first_two = input_flags.flags[:2]
         print(f"First two flags: {[f.name for f in first_two]}")
-

docs/code_snippets/input_flags/snippet7.py

@@ -3,14 +3,14 @@ from argenta.command import Flag, Flags
 
 router = Router(title="Bool Check Example")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "action",
         description="Action with optional flags",
-    flags=Flags([
-        Flag("option1"),
-        Flag("option2")
-    ])
-))
+        flags=Flags([Flag("option1"), Flag("option2")]),
+    )
+)
 def action_handler(response: Response):
     input_flags = response.input_flags
 
@@ -25,4 +25,3 @@ def action_handler(response: Response):
     # Альтернативный способ проверки
     has_flags = bool(input_flags)
     print(f"\nHas flags: {has_flags}")
-

docs/code_snippets/input_flags/snippet8.py

@@ -2,29 +2,36 @@ from argenta.command.flag import InputFlag, ValidationStatus
 from argenta.command.flag.flags.models import InputFlags
 
 # Создаём первую коллекцию
-flags1 = InputFlags([
+flags1 = InputFlags(
+    [
         InputFlag(name="flag1", input_value="value1", status=ValidationStatus.VALID),
-    InputFlag(name="flag2", input_value="value2", status=ValidationStatus.VALID)
-])
+        InputFlag(name="flag2", input_value="value2", status=ValidationStatus.VALID),
+    ]
+)
 
 # Создаём вторую коллекцию с теми же флагами
-flags2 = InputFlags([
+flags2 = InputFlags(
+    [
         InputFlag(name="flag1", input_value="value1", status=ValidationStatus.VALID),
-    InputFlag(name="flag2", input_value="value2", status=ValidationStatus.VALID)
-])
+        InputFlag(name="flag2", input_value="value2", status=ValidationStatus.VALID),
+    ]
+)
 
 # Создаём третью коллекцию с другими флагами
-flags3 = InputFlags([
+flags3 = InputFlags(
+    [
         InputFlag(name="flag1", input_value="different", status=ValidationStatus.VALID),
-    InputFlag(name="flag2", input_value="value2", status=ValidationStatus.VALID)
-])
+        InputFlag(name="flag2", input_value="value2", status=ValidationStatus.VALID),
+    ]
+)
 
 print(f"flags1 == flags2: {flags1 == flags2}")  # True (одинаковые имена)
-print(f"flags1 == flags3: {flags1 == flags3}")  # True (имена одинаковые, значения не учитываются)
+print(
+    f"flags1 == flags3: {flags1 == flags3}"
+)  # True (имена одинаковые, значения не учитываются)
 
 # Разные коллекции
-flags4 = InputFlags([
-    InputFlag(name="flag3", input_value="value3", status=ValidationStatus.VALID)
-])
+flags4 = InputFlags(
+    [InputFlag(name="flag3", input_value="value3", status=ValidationStatus.VALID)]
+)
 print(f"flags1 == flags4: {flags1 == flags4}")  # False (разные флаги)
-

docs/code_snippets/input_flags/snippet9.py

@@ -4,15 +4,14 @@ from argenta.command.flag import InputFlag
 
 router = Router(title="Contains Example")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "check",
         description="Check flags",
-    flags=Flags([
-        Flag("verbose"),
-        Flag("debug"),
-        Flag("quiet")
-    ])
-))
+        flags=Flags([Flag("verbose"), Flag("debug"), Flag("quiet")]),
+    )
+)
 def check_handler(response: Response):
     input_flags = response.input_flags
 
@@ -28,13 +27,7 @@ def check_handler(response: Response):
         print("Debug flag is present")
 
     # Можно создать флаг для проверки (сравнение идёт по имени)
-    test_flag = InputFlag(
-        name="verbose",
-        prefix="--",
-        input_value="any",
-        status=None
-    )
+    test_flag = InputFlag(name="verbose", prefix="--", input_value="any", status=None)
 
     if test_flag in input_flags:
         print("Verbose flag found using 'in' operator")
-

docs/code_snippets/orchestrator/snippet.py

@@ -14,6 +14,7 @@ class ConnectionProvider(Provider):
         yield conn
         conn.close()
 
+
 # 2. Создаем и настраиваем App
 app = App()
 # ... здесь можно добавить роутеры ...

docs/code_snippets/overriding_formatting/sample.py

@@ -5,6 +5,7 @@ def custom_print_function(text: str) -> None:
     """Простая пользовательская функция вывода с префиксом."""
     print(f"Префикс: {text}")
 
+
 app = App(
     initial_message="My App",
     override_system_messages=True,

docs/code_snippets/possible_values/combined.py

@@ -3,25 +3,13 @@ import re
 from argenta.command import Flag, PossibleValues
 
 # Флаг без значения
-verbose_flag = Flag(
-    name="verbose",
-    possible_values=PossibleValues.NEITHER
-)
+verbose_flag = Flag(name="verbose", possible_values=PossibleValues.NEITHER)
 
 # Флаг с любым значением
-output_flag = Flag(
-    name="output",
-    possible_values=PossibleValues.ALL
-)
+output_flag = Flag(name="output", possible_values=PossibleValues.ALL)
 
 # Флаг со списком допустимых значений
-format_flag = Flag(
-    name="format",
-    possible_values=["json", "xml", "csv", "yaml"]
-)
+format_flag = Flag(name="format", possible_values=["json", "xml", "csv", "yaml"])
 
 # Флаг с регулярным выражением
-email_flag = Flag(
-    name="email",
-    possible_values=re.compile(r"^[\w\.-]+@[\w\.-]+\.\w+$")
-)
+email_flag = Flag(name="email", possible_values=re.compile(r"^[\w\.-]+@[\w\.-]+\.\w+$"))

docs/code_snippets/quickstart/main.py

@@ -6,10 +6,11 @@ from argenta import App, Orchestrator
 app: App = App()
 orchestrator: Orchestrator = Orchestrator()
 
+
 def main() -> None:
     app.include_router(router)
     orchestrator.start_polling(app)
 
-if __name__ == '__main__':
-    main()
 
+if __name__ == "__main__":
+    main()

docs/code_snippets/quickstart/routers.py

@@ -3,7 +3,7 @@ from argenta import Command, Response, Router
 
 router = Router(title="Quickstart Example")
 
+
 @router.command(Command("hello", description="Say hello"))
 def handler(response: Response):
     print("Hello, world!")
-    

docs/code_snippets/quickstart/task_manager/handlers.py

@@ -9,14 +9,17 @@ from .repository import Priority, Task, TaskRepository
 
 router = Router(title="Task Manager")
 
+
 @router.command(
     Command(
         "add-task",
         description="Add a new task",
-        flags=Flags([
+        flags=Flags(
+            [
                 Flag("description"),
                 Flag("priority", possible_values=["low", "medium", "high"]),
-        ])
+            ]
+        ),
     )
 )
 def add_task(response: Response, repo: FromDishka[TaskRepository]):
@@ -40,6 +43,7 @@ def add_task(response: Response, repo: FromDishka[TaskRepository]):
     repo.add_task(task)
     print(f"Added task: '{task.description}' with priority '{task.priority}'")
 
+
 @router.command(Command("list-tasks", description="List all tasks"))
 def list_tasks(response: Response, repo: FromDishka[TaskRepository]):
     tasks = repo.get_all_tasks()

docs/code_snippets/quickstart/task_manager/repository.py

@@ -3,11 +3,13 @@ from typing import Literal
 
 Priority = Literal["low", "medium", "high"]
 
+
 @dataclass
 class Task:
     description: str
     priority: Priority = "medium"
 
+
 class TaskRepository:
     def __init__(self):
         self._tasks: list[Task] = []

docs/code_snippets/redirect_stdout/sample.py

@@ -3,6 +3,7 @@ from argenta.router import Router
 # Для этого роутера перехват stdout будет отключен
 interactive_router = Router(disable_redirect_stdout=True)
 
+
 @interactive_router.command("ask")
 def ask_name(response):
     name = input("Как вас зовут? ")

docs/code_snippets/response/snippet1.py

@@ -3,6 +3,7 @@ from argenta.response import ResponseStatus
 
 router = Router(title="Example")
 
+
 @router.command(Command("greet", description="Greet the user"))
 def greet_handler(response: Response):
     # response автоматически передаётся в обработчик
@@ -13,4 +14,3 @@ def greet_handler(response: Response):
         print("Hello! All flags are valid.")
     else:
         print("Warning: Some flags have issues.")
-

docs/code_snippets/response/snippet2.py

@@ -2,16 +2,20 @@ from argenta import Command, Response, Router
 
 router = Router(title="Data Example")
 
+
 @router.command(Command("set", description="Set data"))
 def set_handler(response: Response):
     # Обновляем глобальное хранилище данных
-    response.update_data({
+    response.update_data(
+        {
             "user_name": "John",
             "timestamp": "2024-01-01",
-        "settings": {"theme": "dark", "language": "ru"}
-    })
+            "settings": {"theme": "dark", "language": "ru"},
+        }
+    )
     print("Data updated successfully")
 
+
 @router.command(Command("show", description="Show data"))
 def show_handler(response: Response):
     # Получаем данные из глобального хранилища
@@ -19,4 +23,3 @@ def show_handler(response: Response):
     if "user_name" in data:
         print(f"User: {data['user_name']}")
         print(f"Settings: {data.get('settings', {})}")
-

docs/code_snippets/response/snippet3.py

@@ -2,6 +2,7 @@ from argenta import Command, Response, Router
 
 router = Router(title="Get Data Example")
 
+
 @router.command(Command("info", description="Show all stored data"))
 def info_handler(response: Response):
     # Получаем все данные из глобального хранилища
@@ -13,4 +14,3 @@ def info_handler(response: Response):
             print(f"  {key}: {value}")
     else:
         print("No data stored")
-

docs/code_snippets/response/snippet4.py

@@ -2,12 +2,14 @@ from argenta import Command, Response, Router
 
 router = Router(title="Clear Data Example")
 
+
 @router.command(Command("clear", description="Clear all stored data"))
 def clear_handler(response: Response):
     # Очищаем всё хранилище данных
     response.clear_data()
     print("All data cleared")
 
+
 @router.command(Command("check", description="Check if data exists"))
 def check_handler(response: Response):
     data = response.get_data()
@@ -15,4 +17,3 @@ def check_handler(response: Response):
         print(f"Storage contains {len(data)} item(s)")
     else:
         print("Storage is empty")
-

docs/code_snippets/response/snippet5.py

@@ -2,15 +2,19 @@ from argenta import Command, Response, Router
 
 router = Router(title="Delete Data Example")
 
+
 @router.command(Command("store", description="Store data"))
 def store_handler(response: Response):
-    response.update_data({
+    response.update_data(
+        {
             "temp_key": "temporary value",
             "important_key": "important value",
-        "another_key": "another value"
-    })
+            "another_key": "another value",
+        }
+    )
     print("Data stored")
 
+
 @router.command(Command("remove", description="Remove specific key"))
 def remove_handler(response: Response):
     # Удаляем конкретный ключ из хранилища
@@ -23,4 +27,3 @@ def remove_handler(response: Response):
         print(f"Remaining keys: {list(remaining.keys())}")
     except KeyError:
         print("Key not found")
-

docs/code_snippets/response/snippet6.py

@@ -4,14 +4,14 @@ from argenta.response import ResponseStatus
 
 router = Router(title="Flags Example")
 
-@router.command(Command(
+
+@router.command(
+    Command(
         "process",
         description="Process with flags",
-    flags=Flags([
-        Flag("format", possible_values=["json", "xml"]),
-        Flag("verbose")
-    ])
-))
+        flags=Flags([Flag("format", possible_values=["json", "xml"]), Flag("verbose")]),
+    )
+)
 def process_handler(response: Response):
     # Проверяем статус валидации флагов
     print(f"Status: {response.status.value}")
@@ -35,4 +35,3 @@ def process_handler(response: Response):
         for flag in response.input_flags:
             if flag.status and flag.status.name == "INVALID":
                 print(f"  Invalid flag: {flag.string_entity} = {flag.input_value}")
-

docs/code_snippets/router/snippet.py

@@ -3,6 +3,7 @@ from argenta.router import Router
 
 user_router = Router(title="User Management")
 
+
 @user_router.command(Command("add-user", description="Adds a new user"))
 def add_user_handler(response):
     # Логика добавления пользователя

docs/code_snippets/validation_status/comprehensive.py

@@ -1,13 +1,12 @@
 import re
 
-from argenta.command.flag import (Flag, InputFlag, PossibleValues,
-                                  ValidationStatus)
+from argenta.command.flag import Flag, InputFlag, PossibleValues, ValidationStatus
 
 # Создаём различные типы флагов
 verbose_flag = Flag("verbose", possible_values=PossibleValues.NEITHER)
 output_flag = Flag("output", possible_values=PossibleValues.ALL)
 level_flag = Flag("level", possible_values=["1", "2", "3"])
-pattern_flag = Flag("pattern", possible_values=re.compile(r'^[a-zA-Z]+$'))
+pattern_flag = Flag("pattern", possible_values=re.compile(r"^[a-zA-Z]+$"))
 
 # Создаём входные флаги с различными статусами
 input_flags = [
@@ -16,12 +15,10 @@ input_flags = [
     InputFlag("output", input_value="result.txt", status=ValidationStatus.VALID),
     InputFlag("level", input_value="2", status=ValidationStatus.VALID),
     InputFlag("pattern", input_value="onlyletters", status=ValidationStatus.VALID),
-    
     # Невалидные флаги
     InputFlag("verbose", input_value="true", status=ValidationStatus.INVALID),
     InputFlag("level", input_value="4", status=ValidationStatus.INVALID),
     InputFlag("pattern", input_value="123", status=ValidationStatus.INVALID),
-    
     # Неопределённые флаги
     InputFlag("unknown", input_value="value", status=ValidationStatus.UNDEFINED),
 ]

docs/code_snippets/validation_status/input_flag.py

@@ -2,21 +2,15 @@ from argenta import InputFlag, ValidationStatus
 
 # Создание входных флагов с различными статусами
 valid_flag = InputFlag(
-    "output",
-    input_value="/path/to/file.txt",
-    status=ValidationStatus.VALID
+    "output", input_value="/path/to/file.txt", status=ValidationStatus.VALID
 )
 
 invalid_flag = InputFlag(
-    "count",
-    input_value="not-a-number",
-    status=ValidationStatus.INVALID
+    "count", input_value="not-a-number", status=ValidationStatus.INVALID
 )
 
 undefined_flag = InputFlag(
-    "experimental",
-    input_value="test",
-    status=ValidationStatus.UNDEFINED
+    "experimental", input_value="test", status=ValidationStatus.UNDEFINED
 )
 
 flags = [valid_flag, invalid_flag, undefined_flag]

docs/code_snippets/validation_status/invalid.py

@@ -1,5 +1,4 @@
-from argenta.command.flag import (Flag, InputFlag, PossibleValues,
-                                  ValidationStatus)
+from argenta.command.flag import Flag, InputFlag, PossibleValues, ValidationStatus
 
 # Создание флага без значения
 help_flag = Flag("help", possible_values=PossibleValues.NEITHER)

docs/code_snippets/validation_status/processing.py

@@ -19,14 +19,17 @@ def process_input_flag(input_flag: InputFlag) -> None:
         # Пытаемся провести валидацию или пропускаем
         attempt_revalidation(input_flag)
 
+
 def execute_flag_logic(flag: InputFlag) -> None:
     """Выполняет логику для валидного флага"""
     pass
 
+
 def log_validation_error(flag: InputFlag) -> None:
     """Записывает ошибку валидации в лог"""
     pass
 
+
 def attempt_revalidation(flag: InputFlag) -> None:
     """Пытается повторно провести валидацию"""
     pass

docs/code_snippets/validation_status/undefined.py

@@ -1,11 +1,15 @@
 from argenta import InputFlag, ValidationStatus
 
 # Создание входного флага без определения статуса
-undefined_input = InputFlag("unknown-flag", input_value="some-value", status=ValidationStatus.UNDEFINED)
+undefined_input = InputFlag(
+    "unknown-flag", input_value="some-value", status=ValidationStatus.UNDEFINED
+)
 
 print(f"Флаг: {undefined_input.string_entity}")
 print(f"Значение: {undefined_input.input_value}")
 print(f"Статус: {undefined_input.status.value}")  # Выведет: UNDEFINED
 
 # Или флаг, для которого валидация ещё не проводилась
-pending_input = InputFlag("pending", input_value=None, status=ValidationStatus.UNDEFINED)
+pending_input = InputFlag(
+    "pending", input_value=None, status=ValidationStatus.UNDEFINED
+)

docs/code_snippets/validation_status/valid.py

@@ -1,7 +1,9 @@
 from argenta.command.flag import Flag, InputFlag, ValidationStatus
 
 # Создание флага, который принимает только определённые значения
-log_level_flag = Flag("log-level", possible_values=["debug", "info", "warning", "error"])
+log_level_flag = Flag(
+    "log-level", possible_values=["debug", "info", "warning", "error"]
+)
 
 # Создание корректного входного флага
 valid_input = InputFlag("log-level", input_value="debug", status=ValidationStatus.VALID)