docs

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

@@ -3,30 +3,33 @@ from argenta import InputFlag, ValidationStatus
 
 def process_input_flag(input_flag: InputFlag) -> None:
     """Обрабатывает входной флаг в зависимости от его статуса валидации"""
-    
+
     if input_flag.status == ValidationStatus.VALID:
         print(f"✓ Обрабатываем валидный флаг: {input_flag.string_entity}")
         # Выполняем основную логику
         execute_flag_logic(input_flag)
-        
+
     elif input_flag.status == ValidationStatus.INVALID:
         print(f"✗ Ошибка валидации флага: {input_flag.string_entity}")
         # Записываем ошибку и прекращаем выполнение
         log_validation_error(input_flag)
-        
+
     elif input_flag.status == ValidationStatus.UNDEFINED:
         print(f"? Неопределённый статус флага: {input_flag.string_entity}")
         # Пытаемся провести валидацию или пропускаем
         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)