docs

docs/code_snippets/input_flag/snippet1.py

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

docs/code_snippets/input_flag/snippet2.py

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

docs/code_snippets/input_flag/snippet3.py

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

docs/code_snippets/input_flag/snippet4.py

@@ -0,0 +1,12 @@
+from argenta.command.flag import InputFlag, ValidationStatus
+
+flag = InputFlag(
+    name="config",
+    prefix="--",
+    input_value="settings.json",
+    status=ValidationStatus.VALID
+)
+
+# Отладочное представление объекта
+print(repr(flag))
+# InputFlag<prefix='--', name='config', value='settings.json', status=ValidationStatus.VALID>

docs/code_snippets/input_flag/snippet5.py

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