feat: impl docs (#4)

The entire public api is covered with documentation in two languages - Russian and English.

the library now supports the latest three versions of python - 3.12, 3.13 and 3.14

minor design changes: now, when a Boolean flag is entered, its value is an empty string, not None.

tests have been adapted to the supported versions of python, readmi has been redesigned in two languages, German is no longer available.

docs/code_snippets/command/snippet.py

@@ -0,0 +1,20 @@
+from argenta.command import Flag, Flags, Command
+
+# Simple command without flags
+hello_cmd = Command("hello", description="Greet the user")
+
+# Command with description and aliases
+quit_cmd = Command("quit", description="Exit the application", aliases=["exit", "q"])
+
+# Command with flags
+deploy_cmd = Command(
+    "deploy",
+    description="Deploy application to server",
+    flags=Flags(
+        [
+            Flag("env", possible_values=["dev", "prod"]),
+            Flag("force"),
+        ]
+    ),
+    aliases=["dep"],
+)

docs/code_snippets/command/snippet2.py

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

docs/code_snippets/command/snippet3.py

@@ -0,0 +1,33 @@
+from argenta import Command, Response, Router
+from argenta.command import Flag, Flags
+
+router = Router(title="Server Management")
+
+
+@router.command(
+    Command(
+        "start",
+        description="Start the server",
+        flags=Flags(
+            [
+                Flag("port"),
+                Flag("host"),
+                Flag("debug"),
+            ]
+        ),
+        aliases=["run"],
+    )
+)
+def handle_start(response: Response):
+    input_flags = response.input_flags
+    port_flag = input_flags.get_flag_by_name("port")
+    host_flag = input_flags.get_flag_by_name("host")
+    debug_flag = input_flags.get_flag_by_name("debug")
+
+    host = host_flag.input_value if host_flag else "localhost"
+    port = port_flag.input_value if port_flag else "8080"
+    debug = debug_flag and debug_flag.input_value
+
+    print(f"Starting server on {host}:{port}")
+    if debug:
+        print("Debug mode: ON")

docs/code_snippets/command/snippet4.py

@@ -0,0 +1,11 @@
+from argenta.command import InputCommand
+
+# Parse command without flags
+cmd1 = InputCommand.parse("hello")
+print(cmd1.trigger)  # "hello"
+print(len(cmd1.input_flags))  # 0
+
+# Parse command with flags
+cmd2 = InputCommand.parse("deploy --env prod --force")
+print(cmd2.trigger)  # "deploy"
+print(len(cmd2.input_flags))  # 2

docs/code_snippets/command/snippet5.py

@@ -0,0 +1,11 @@
+from argenta import Router, Command, Response
+
+router = Router(title="System")
+
+@router.command(Command(
+    "shutdown",
+    description="Shutdown the system",
+    aliases=["poweroff", "halt", "stop"]
+))
+def handle_shutdown(response: Response):
+    print("Shutting down the system...")