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/testing/app_e2e_test.py

@@ -0,0 +1,32 @@
+import sys
+from unittest.mock import patch
+import pytest
+from pytest import CaptureFixture
+
+from argenta import App, Orchestrator, Router, Command, Response
+
+
+@pytest.fixture(autouse=True)
+def patched_argv():
+    with patch.object(sys, 'argv', ['program.py']):
+        yield
+
+def test_input_incorrect_command(capsys: CaptureFixture[str]):
+    router = Router()
+    orchestrator = Orchestrator()
+
+    @router.command(Command('test'))
+    def test(response: Response) -> None:
+        print('test command')
+
+    app = App(override_system_messages=True, print_func=print)
+    app.include_router(router)
+    app.set_unknown_command_handler(
+        lambda command: print(f'Unknown command: {command.trigger}')
+    )
+
+    with patch("builtins.input", side_effect=["help", "q"]):
+        orchestrator.start_polling(app)
+
+    output = capsys.readouterr().out
+    assert "\nUnknown command: help\n" in output

docs/code_snippets/testing/app_integration_unittest.py

@@ -0,0 +1,21 @@
+import io
+from contextlib import redirect_stdout
+
+from argenta import App, Router, Command, Response
+from argenta.command import InputCommand
+
+
+def test_simple_app() -> None:
+    app = App(override_system_messages=True, repeat_command_groups_printing=False)
+    router = Router(title="App")
+
+    @router.command(Command("HELP", description="Show help"))
+    def help_cmd(response: Response):
+        print("Available commands: HELP")
+
+    app.include_router(router)
+
+    with redirect_stdout(io.StringIO()) as stdout:
+        router.finds_appropriate_handler(InputCommand.parse("HELP"))
+        
+    assert "Available commands:" in stdout.getvalue()

docs/code_snippets/testing/di_handler_unittest.py

@@ -0,0 +1,42 @@
+import io
+from contextlib import redirect_stdout
+
+from argenta.command import InputCommand
+from dishka import Provider, make_container, Scope
+
+from argenta import Router, Response
+from argenta.di.integration import setup_dishka, FromDishka
+
+
+class Service:
+    def hello(self) -> str:
+        return "world"
+        
+def get_service() -> Service:
+    return Service()
+        
+
+router = Router(title="DI")
+
+@router.command("HELLO")
+def hello(response: Response, service: FromDishka[Service]) -> None:
+    print(f"hello {service.hello()}")
+    
+    
+class _FakeApp:
+    # Minimal stub for setup_dishka; app object is not used in unit tests
+    registered_routers = [router]
+
+
+def test_hello_uses_service():
+    provider = Provider(scope=Scope.APP)
+    provider.provide(get_service)
+    
+    container = make_container(provider)
+    setup_dishka(app=_FakeApp(), container=container, auto_inject=True)
+
+    # Call handler
+    with redirect_stdout(io.StringIO()) as stdout:
+        router.finds_appropriate_handler(InputCommand.parse('HELLO'))
+
+    assert "hello world" in stdout.getvalue()

docs/code_snippets/testing/simple_handler_unittest.py

@@ -0,0 +1,19 @@
+import io
+from contextlib import redirect_stdout
+
+from argenta import Router, Command, Response
+from argenta.command import InputCommand
+
+
+router = Router(title="Demo")
+
+@router.command(Command("PING", description="Ping command"))
+def ping(response: Response):
+    print("PONG")
+
+
+def test_ping_prints_pong():
+    # Call handler
+    with redirect_stdout(io.StringIO()) as stdout:
+        router.finds_appropriate_handler(InputCommand.parse("PING"))
+    assert "PONG" in stdout.getvalue()