Update documentation and code snippets

docs/code_snippets/flags/snippet.py

@@ -1,17 +1,11 @@
 import re
+from argenta.command import Command, Flag, Flags
 
-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("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)

docs/code_snippets/flags/snippet2.py

@@ -1,11 +1,9 @@
 from argenta.command import Flag, Flags
 
-# Создание коллекции
 flags: Flags = Flags()
 
-# Динамическое добавление флагов
 flags.add_flag(Flag("config"))
 flags.add_flag(Flag("debug"))
 flags.add_flag(Flag("log-level", possible_values=["INFO", "DEBUG", "ERROR"]))
 
-print(len(flags.flags))  # 3
+print(len(flags))  # 3

docs/code_snippets/flags/snippet3.py

@@ -1,10 +1,8 @@
 from argenta.command import Flag, Flags
 from argenta.command.flag.defaults import PredefinedFlags
 
-# Начальная коллекция
 flags = Flags([PredefinedFlags.HOST])
 
-# Дополнительные флаги
 additional_flags = [
     PredefinedFlags.PORT,
     Flag("database"),
@@ -12,7 +10,6 @@ additional_flags = [
     Flag("verbose"),
 ]
 
-# Добавление списка флагов
 flags.add_flags(additional_flags)
 
-print(len(flags.flags))  # 5
+print(len(flags))  # 5

docs/code_snippets/flags/snippet4.py

@@ -1,14 +1,13 @@
 from argenta.command import Flag, Flags
 from argenta.command.flag.defaults import PredefinedFlags
 
+
 flags = Flags([PredefinedFlags.HOST, PredefinedFlags.PORT, Flag("verbose")])
 
-# Получение флага по имени
 host_flag = flags.get_flag_by_name("host")
 if host_flag:
     print(f"Found flag: {host_flag.name}")
 
-# Поиск несуществующего флага
 unknown_flag = flags.get_flag_by_name("nonexistent")
 if unknown_flag is None:
     print("Flag not found")

docs/code_snippets/flags/snippet5.py

@@ -1,12 +0,0 @@
-from argenta.command import Flag, Flags
-from argenta.command.flag.defaults import PredefinedFlags
-
-flags = Flags([PredefinedFlags.HOST, PredefinedFlags.PORT, Flag("verbose")])
-
-# Итерация по всем флагам
-for flag in flags:
-    print(f"Flag: {flag.name} (type: {type(flag).__name__})")
-
-# Использование в list comprehension
-flag_names = [flag.name for flag in flags]
-print(f"All flags: {flag_names}")

docs/code_snippets/flags/snippet6.py

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