argenta 1.0.2__py3-none-any.whl → 1.0.4__py3-none-any.whl

argenta/app/defaults.py

@@ -1,12 +1,10 @@
-from dataclasses import dataclass
+from enum import Enum
 
 
-@dataclass
-class PredefinedMessages:
+class PredefinedMessages(Enum):
     """
     Public. A dataclass with predetermined messages for quick use
     """
-
     USAGE = "[b dim]Usage[/b dim]: [i]<command> <[green]flags[/green]>[/i]"
     HELP = "[b dim]Help[/b dim]: [i]<command>[/i] [b red]--help[/b red]"
     AUTOCOMPLETE = "[b dim]Autocomplete[/b dim]: [i]<part>[/i] [bold]<tab>"

argenta/app/models.py

@@ -22,20 +22,18 @@ from argenta.response import Response
 
 
 class BaseApp:
-    def __init__(
-        self,
-        prompt: str,
-        initial_message: str,
-        farewell_message: str,
-        exit_command: Command,
-        system_router_title: str | None,
-        ignore_command_register: bool,
-        dividing_line: StaticDividingLine | DynamicDividingLine,
-        repeat_command_groups: bool,
-        override_system_messages: bool,
-        autocompleter: AutoCompleter,
-        print_func: Callable[[str], None],
-    ) -> None:
+    def __init__(self,
+                 prompt: str,
+                 initial_message: str,
+                 farewell_message: str,
+                 exit_command: Command,
+                 system_router_title: str | None,
+                 ignore_command_register: bool,
+                 dividing_line: StaticDividingLine | DynamicDividingLine,
+                 repeat_command_groups: bool,
+                 override_system_messages: bool,
+                 autocompleter: AutoCompleter,
+                 print_func: Callable[[str], None]) -> None:
         self._prompt = prompt
         self._print_func = print_func
         self._exit_command = exit_command
@@ -49,30 +47,18 @@ class BaseApp:
         self._farewell_message = farewell_message
         self._initial_message = initial_message
 
-        self._description_message_gen: Callable[[str, str], str] = (
-            lambda command, description: f"[{command}] *=*=* {description}"
-        )
+        self._description_message_gen: Callable[[str, str], str] = (lambda command, description: f"[{command}] *=*=* {description}")
         self._registered_routers: RegisteredRouters = RegisteredRouters()
         self._messages_on_startup: list[str] = []
 
-        self._all_registered_triggers_in_lower: list[str] = []
+        self._all_registered_triggers_in_lower_case: list[str] = []
         self._all_registered_triggers_in_default_case: list[str] = []
 
-        self._incorrect_input_syntax_handler: Callable[[str], None] = (
-            lambda raw_command: print_func(f"Incorrect flag syntax: {raw_command}")
-        )
-        self._repeated_input_flags_handler: Callable[[str], None] = (
-            lambda raw_command: print_func(f"Repeated input flags: {raw_command}")
-        )
-        self._empty_input_command_handler: Callable[[], None] = lambda: print_func(
-            "Empty input command"
-        )
-        self._unknown_command_handler: Callable[[InputCommand], None] = (
-            lambda command: print_func(f"Unknown command: {command.get_trigger()}")
-        )
-        self._exit_command_handler: Callable[[Response], None] = (
-            lambda response: print_func(self._farewell_message)
-        )
+        self._incorrect_input_syntax_handler: Callable[[str], None] = (lambda raw_command: print_func(f"Incorrect flag syntax: {raw_command}"))
+        self._repeated_input_flags_handler: Callable[[str], None] = (lambda raw_command: print_func(f"Repeated input flags: {raw_command}"))
+        self._empty_input_command_handler: Callable[[], None] = lambda: print_func("Empty input command")
+        self._unknown_command_handler: Callable[[InputCommand], None] = (lambda command: print_func(f"Unknown command: {command.get_trigger()}"))
+        self._exit_command_handler: Callable[[Response], None] = (lambda response: print_func(self._farewell_message))
 
     def set_description_message_pattern(self, _: Callable[[str, str], str]) -> None:
         """
@@ -208,7 +194,7 @@ class BaseApp:
         """
         input_command_trigger = command.get_trigger()
         if self._ignore_command_register:
-            if input_command_trigger.lower() in self._all_registered_triggers_in_lower:
+            if input_command_trigger.lower() in self._all_registered_triggers_in_lower_case:
                 return False
         else:
             if input_command_trigger in self._all_registered_triggers_in_default_case:
@@ -249,7 +235,7 @@ class BaseApp:
 
     def _most_similar_command(self, unknown_command: str) -> str | None:
         all_commands = (
-            self._all_registered_triggers_in_lower
+            self._all_registered_triggers_in_lower_case
             if self._ignore_command_register
             else self._all_registered_triggers_in_default_case
         )
@@ -318,21 +304,22 @@ class BaseApp:
         self._setup_system_router()
 
         for router_entity in self._registered_routers:
-            self._all_registered_triggers_in_default_case.extend(
-                router_entity.get_triggers()
-            )
-            self._all_registered_triggers_in_default_case.extend(
-                router_entity.get_aliases()
-            )
+            self._all_registered_triggers_in_default_case.extend(router_entity.get_triggers())
+            self._all_registered_triggers_in_default_case.extend(router_entity.get_aliases())
 
-            self._all_registered_triggers_in_lower.extend(
-                [x.lower() for x in router_entity.get_triggers()]
-            )
-            self._all_registered_triggers_in_lower.extend(
-                [x.lower() for x in router_entity.get_aliases()]
-            )
+            self._all_registered_triggers_in_lower_case.extend([x.lower() for x in router_entity.get_triggers()])
+            self._all_registered_triggers_in_lower_case.extend([x.lower() for x in router_entity.get_aliases()])
+
+        self._autocompleter.initial_setup(self._all_registered_triggers_in_lower_case)
 
-        self._autocompleter.initial_setup(self._all_registered_triggers_in_lower)
+        if self._ignore_command_register:
+            for cmd in set(self._all_registered_triggers_in_lower_case):
+                if self._all_registered_triggers_in_lower_case.count(cmd) != 1:
+                    Console().print(f"\n[b red]WARNING:[/b red] Overlapping trigger or alias: [b blue]{cmd}[/b blue]")
+        else:
+            for cmd in set(self._all_registered_triggers_in_default_case):
+                if self._all_registered_triggers_in_default_case.count(cmd) != 1:
+                    Console().print(f"\n[b red]WARNING:[/b red] Overlapping trigger or alias: [b blue]{cmd}[/b blue]")
 
         if not self._override_system_messages:
             self._setup_default_view()
@@ -349,20 +336,18 @@ class BaseApp:
 
 
 class App(BaseApp):
-    def __init__(
-        self,
-        prompt: str = "What do you want to do?\n",
-        initial_message: str = "\nArgenta\n",
-        farewell_message: str = "\nSee you\n",
-        exit_command: Command = Command("Q", "Exit command"),
-        system_router_title: str | None = "System points:",
-        ignore_command_register: bool = True,
-        dividing_line: StaticDividingLine | DynamicDividingLine = StaticDividingLine(),
-        repeat_command_groups: bool = True,
-        override_system_messages: bool = False,
-        autocompleter: AutoCompleter = AutoCompleter(),
-        print_func: Callable[[str], None] = Console().print,
-    ) -> None:
+    def __init__(self,
+                 prompt: str = "What do you want to do?\n",
+                 initial_message: str = "Argenta\n",
+                 farewell_message: str = "\nSee you\n",
+                 exit_command: Command = Command("Q", "Exit command"),
+                 system_router_title: str | None = "System points:",
+                 ignore_command_register: bool = True,
+                 dividing_line: StaticDividingLine | DynamicDividingLine = StaticDividingLine(),
+                 repeat_command_groups: bool = True,
+                 override_system_messages: bool = False,
+                 autocompleter: AutoCompleter = AutoCompleter(),
+                 print_func: Callable[[str], None] = Console().print) -> None:
         """
         Public. The essence of the application itself.
         Configures and manages all aspects of the behavior and presentation of the user interacting with the user
@@ -379,19 +364,17 @@ class App(BaseApp):
         :param print_func: system messages text output function
         :return: None
         """
-        super().__init__(
-            prompt=prompt,
-            initial_message=initial_message,
-            farewell_message=farewell_message,
-            exit_command=exit_command,
-            system_router_title=system_router_title,
-            ignore_command_register=ignore_command_register,
-            dividing_line=dividing_line,
-            repeat_command_groups=repeat_command_groups,
-            override_system_messages=override_system_messages,
-            autocompleter=autocompleter,
-            print_func=print_func,
-        )
+        super().__init__(prompt=prompt,
+                         initial_message=initial_message,
+                         farewell_message=farewell_message,
+                         exit_command=exit_command,
+                         system_router_title=system_router_title,
+                         ignore_command_register=ignore_command_register,
+                         dividing_line=dividing_line,
+                         repeat_command_groups=repeat_command_groups,
+                         override_system_messages=override_system_messages,
+                         autocompleter=autocompleter,
+                         print_func=print_func)
 
     def run_polling(self) -> None:
         """
@@ -420,7 +403,7 @@ class App(BaseApp):
                 system_router.finds_appropriate_handler(input_command)
                 if self._ignore_command_register:
                     self._autocompleter.exit_setup(
-                        self._all_registered_triggers_in_lower
+                        self._all_registered_triggers_in_lower_case
                     )
                 else:
                     self._autocompleter.exit_setup(

argenta/router/entity.py

@@ -192,14 +192,12 @@ class Router:
                 pass
             else:
                 file_path: str = getsourcefile(func)
-                source_line: int = getsourcelines(func)[1] + 1
+                source_line: int = getsourcelines(func)[1]
                 fprint = Console().print
-                fprint(
-                    f'\nFile "{file_path}", line {source_line}\n[b red]WARNING:[/b red] [i]The typehint '
+                fprint(f'\nFile "{file_path}", line {source_line}\n[b red]WARNING:[/b red] [i]The typehint '
                     f"of argument([green]{transferred_arg}[/green]) passed to the handler is [/i][bold blue]{Response}[/bold blue],"
-                    f" [i]but[/i] [bold blue]{arg_annotation}[/bold blue] [i]is specified[/i]\n",
-                    highlight=False,
-                )
+                    f" [i]but[/i] [bold blue]{arg_annotation}[/bold blue] [i]is specified[/i]",
+                    highlight=False)
 
     def set_command_register_ignore(self, _: bool) -> None:
         """

{argenta-1.0.2.dist-info → argenta-1.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: argenta
-Version: 1.0.2
+Version: 1.0.4
 Summary: Python library for building modular CLI applications
 Author-email: kolo <kolo.is.main@gmail.com>
 License: MIT
@@ -13,13 +13,15 @@ Description-Content-Type: text/markdown
 
 # Argenta
 
-### Библиотека для создания модульных CLI приложeний
+### Library for creating modular CLI applications
+
+#### RU - [README.ru.md](https://github.com/koloideal/Argenta/blob/kolo/README.ru.md)
 
 ![preview](https://github.com/koloideal/Argenta/blob/kolo/imgs/mock_app_preview4.png?raw=True)  
 
 ---
 
-# Установка
+# Installing
 ```bash
 pip install argenta
 ```
@@ -30,9 +32,9 @@ poetry add argenta
 
 ---
 
-# Быстрый старт
+# Quick start
 
-Пример простейшего приложения
+An example of a simple application
 ```python
 # routers.py
 from argenta.router import Router
@@ -65,7 +67,15 @@ def main() -> None:
 if __name__ == '__main__':
     main()
 ```
-## Полная [документация](https://argenta-docs.vercel.app) | MIT 2025 kolo | made by [kolo](https://t.me/kolo_id)
+
+---
+
+# Features in development
+
+- Full support for autocompleter on Linux
+- Ability to configure stdout capture when handling input by the handler
+
+## Full [docs](https://argenta-docs.vercel.app) | MIT 2025 kolo | made by [kolo](https://t.me/kolo_id)
 
 
 

{argenta-1.0.2.dist-info → argenta-1.0.4.dist-info}/RECORD

@@ -1,7 +1,7 @@
 argenta/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 argenta/app/__init__.py,sha256=I8FTXU17ajDI-hbC6Rw0LxLmvDYipdQaos3v1pmu14E,57
-argenta/app/defaults.py,sha256=z65HUXd1ogTk95-IWwluPDPz4MkZk1_3jfaSjdTZ4ME,393
-argenta/app/models.py,sha256=yG3IhR9IrEd2YwrtqoZni6wht2rDOyocfoe5SmPv6cw,19153
+argenta/app/defaults.py,sha256=nh_h5yxnXEGmsUwrb_BPdmiprshW6MDJwZyMS7p_AFw,373
+argenta/app/models.py,sha256=k1hQEaYlh4X_qTaWKvUCJt7gdjIIJ68CtQoSPKgISYM,19797
 argenta/app/autocompleter/__init__.py,sha256=VT_p3QA78UnczV7pYR2NnwQ0Atd8mnDUnLazvUQNqJk,93
 argenta/app/autocompleter/entity.py,sha256=QgEZ2Tzfp9liWBCd-BdRpUE-ELUOxAhPpW7KBLVcPRE,3556
 argenta/app/dividing_line/__init__.py,sha256=jJZDDZix8XYCAUWW4FzGJH0JmJlchYcx0FPWifjgv1I,147
@@ -27,11 +27,11 @@ argenta/response/entity.py,sha256=YcuKLnr7iiFewNqUH7bsdv-PccHfpitq-sm06tmSCjE,10
 argenta/response/status.py,sha256=bWFMHvyIHpOA4LxUQFoSpld-F8gu183M9nY-zN-MiZM,244
 argenta/router/__init__.py,sha256=rvqAx80IXHFdVw7cWBRGaTtb94a4OQQEsMJ5f7YA1gU,68
 argenta/router/defaults.py,sha256=vvkwFYCQdwjtMntfyrJuisxFX8XxeyhDMA-RwteHZGg,87
-argenta/router/entity.py,sha256=Z3QZpntlZgt2bkJCb3zUsQ1_a05c61iN59-PBG0r7wg,9656
+argenta/router/entity.py,sha256=bu4t3E3POy4N6H8mBHcLuCEXlBQerzKj02Uw_56GsWE,9609
 argenta/router/exceptions.py,sha256=5k0mTHYYItWHzGC0NU5oHHYrHxU0M5fEbO5wne_wFg8,860
 argenta/router/command_handler/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 argenta/router/command_handler/entity.py,sha256=xmHgbXBvD_-JMLpUPc5w3VVe-upTJ-y4lR13rUiiygo,2387
-argenta-1.0.2.dist-info/METADATA,sha256=xL4q7-KZ6sHcKTy9IAl5fNzao2o1JyG8nDy-3K4OAKI,1442
-argenta-1.0.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-argenta-1.0.2.dist-info/licenses/LICENSE,sha256=zmqoGh2n5rReBv4s8wPxF_gZEZDgauJYSPMuPczgOiU,1082
-argenta-1.0.2.dist-info/RECORD,,
+argenta-1.0.4.dist-info/METADATA,sha256=B6-Jb3HD1c2qqrigaTlmLE0ICqRUlYJSr654BfgVGac,1564
+argenta-1.0.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+argenta-1.0.4.dist-info/licenses/LICENSE,sha256=zmqoGh2n5rReBv4s8wPxF_gZEZDgauJYSPMuPczgOiU,1082
+argenta-1.0.4.dist-info/RECORD,,