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/response/data_sharing.py

@@ -0,0 +1,42 @@
+from argenta import Router, Response, Command, DataBridge
+from argenta.command import Flag
+from argenta.di import FromDishka
+
+router = Router(title="Authentication")
+
+def authenticate_user(username: str) -> str:
+    return f"token_for_{username}"
+
+
+@router.command(Command("login", flags=Flag("username")))
+def login_handler(response: Response, data_bridge: FromDishka[DataBridge]):
+    username_flag = response.input_flags.get_flag_by_name("username")
+    if not username_flag or not username_flag.input_value:
+        print("Error: username must be specified using the --username flag.")
+        return
+
+    username = username_flag.input_value
+    token = authenticate_user(username)
+
+    data_bridge.update({"auth_token": token})
+    print(f"Login successful! User '{username}' authenticated.")
+
+
+@router.command("get-profile")
+def get_profile_handler(response: Response, data_bridge: FromDishka[DataBridge]):
+    token = data_bridge.get_by_key("auth_token")
+
+    if not token:
+        print("Error: you are not authenticated. Please run the 'login' command first.")
+        return
+
+    print(f"Loading profile using token: [yellow]{token}[/yellow]")
+
+
+@router.command("logout")
+def logout_handler(response: Response, data_bridge: FromDishka[DataBridge]):
+    try:
+        data_bridge.delete_by_key("auth_token")
+        print("Logout successful. Session data cleared.")
+    except KeyError:
+        print("You were not authenticated anyway.")