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.

src/argenta/router/__init__.py

@@ -1,4 +1 @@
-from argenta.router.entity import Router
-
-
-__all__ = ["Router"]
+from argenta.router.entity import Router as Router

src/argenta/router/command_handler/entity.py

@@ -1,3 +1,5 @@
+__all__ = ["CommandHandler", "CommandHandlers"]
+
 from collections.abc import Iterator
 from typing import Callable
 
@@ -30,9 +32,7 @@ class CommandHandlers:
         Private. The model that unites all CommandHandler of the routers
         :param command_handlers: list of CommandHandlers for register
         """
-        self.command_handlers: list[CommandHandler] = (
-            command_handlers if command_handlers else []
-        )
+        self.command_handlers: list[CommandHandler] = command_handlers if command_handlers else []
 
     def add_handler(self, command_handler: CommandHandler) -> None:
         """

src/argenta/router/defaults.py

@@ -1,4 +1,5 @@
+__all__ = ["system_router"]
+
 from argenta.router import Router
 
-
 system_router = Router(title="System points:")

src/argenta/router/entity.py

@@ -1,27 +1,29 @@
+__all__ = ["Router"]
+
+from inspect import get_annotations, getfullargspec, getsourcefile, getsourcelines
 from typing import Callable, TypeAlias
-from inspect import getfullargspec, get_annotations, getsourcefile, getsourcelines
+
 from rich.console import Console
 
 from argenta.command import Command, InputCommand
 from argenta.command.flag import ValidationStatus
-from argenta.response import Response, ResponseStatus
-from argenta.router.command_handler.entity import CommandHandlers, CommandHandler
 from argenta.command.flag.flags import Flags, InputFlags
+from argenta.response import Response, ResponseStatus
+from argenta.router.command_handler.entity import CommandHandler, CommandHandlers
 from argenta.router.exceptions import (
     RepeatedFlagNameException,
     RequiredArgumentNotPassedException,
     TriggerContainSpacesException,
 )
 
-
 HandlerFunc: TypeAlias = Callable[..., None]
 
 
 class Router:
     def __init__(
         self,
-        *,
         title: str | None = "Default title",
+        *,
         disable_redirect_stdout: bool = False,
     ):
         """
@@ -76,9 +78,7 @@ class Router:
             if input_command_name.lower() in handle_command.aliases:
                 self.process_input_command(input_command_flags, command_handler)
 
-    def process_input_command(
-        self, input_command_flags: InputFlags, command_handler: CommandHandler
-    ) -> None:
+    def process_input_command(self, input_command_flags: InputFlags, command_handler: CommandHandler) -> None:
         """
         Private. Processes input command with the appropriate handler
         :param input_command_flags: input command flags as InputFlags
@@ -88,9 +88,7 @@ class Router:
         handle_command = command_handler.handled_command
         if handle_command.registered_flags.flags:
             if input_command_flags.flags:
-                response: Response = _structuring_input_flags(
-                    handle_command, input_command_flags
-                )
+                response: Response = _structuring_input_flags(handle_command, input_command_flags)
                 command_handler.handling(response)
             else:
                 response = Response(ResponseStatus.ALL_FLAGS_VALID)
@@ -101,9 +99,7 @@ class Router:
                 for input_flag in input_command_flags:
                     input_flag.status = ValidationStatus.UNDEFINED
                     undefined_flags.add_flag(input_flag)
-                response = Response(
-                    ResponseStatus.UNDEFINED_FLAGS, input_flags=undefined_flags
-                )
+                response = Response(ResponseStatus.UNDEFINED_FLAGS, input_flags=undefined_flags)
                 command_handler.handling(response)
             else:
                 response = Response(ResponseStatus.ALL_FLAGS_VALID)
@@ -140,15 +136,11 @@ class CommandDecorator:
 
     def __call__(self, handler_func: Callable[..., None]) -> Callable[..., None]:
         _validate_func_args(handler_func)
-        self.router.command_handlers.add_handler(
-            CommandHandler(handler_func, self.command)
-        )
+        self.router.command_handlers.add_handler(CommandHandler(handler_func, self.command))
         return handler_func
 
 
-def _structuring_input_flags(
-    handled_command: Command, input_flags: InputFlags
-) -> Response:
+def _structuring_input_flags(handled_command: Command, input_flags: InputFlags) -> Response:
     """
     Private. Validates flags of input command
     :param handled_command: entity of the handled command

src/argenta/router/exceptions.py

@@ -1,3 +1,5 @@
+__all__ = ["RepeatedFlagNameException", "RequiredArgumentNotPassedException", "TriggerContainSpacesException"]
+
 from typing import override