argenta 1.0.3__tar.gz → 1.0.5__tar.gz

{argenta-1.0.3 → argenta-1.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: argenta
-Version: 1.0.3
+Version: 1.0.5
 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) • DE - [README.de.md](https://github.com/koloideal/Argenta/blob/kolo/README.de.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
@@ -68,12 +70,12 @@ if __name__ == '__main__':
 
 ---
 
-# Фичи в разработке
+# Features in development
 
-- Полноценная поддержка автокомплитера на Linux
-- Возможность настройки захвата stdout при обработке хэндлером ввода
+- Full support for autocompleter on Linux
+- Ability to configure stdout capture when handling input by the handler
 
-## Полная [документация](https://argenta-docs.vercel.app) | MIT 2025 kolo | made by [kolo](https://t.me/kolo_id)
+## Full [docs](https://argenta-docs.vercel.app) | MIT 2025 kolo | made by [kolo](https://t.me/kolo_id)
 
 
 

argenta-1.0.5/README.de.md

@@ -0,0 +1,66 @@
+# Argenta
+
+### Bibliothek zum Erstellen modularer CLI-Anwendungen
+
+![preview](https://github.com/koloideal/Argenta/blob/kolo/imgs/mock_app_preview4.png?raw=True)  
+
+---
+
+# Installation
+```bash
+pip install argenta
+```
+or
+```bash
+poetry add argenta
+```
+
+---
+
+# Schnellstart
+
+Ein Beispiel für eine einfache Anwendung
+```python
+# routers.py
+from argenta.router import Router
+from argenta.command import Command
+from argenta.response import Response
+
+
+router = Router()
+
+@router.command(Command("hello"))
+def handler(response: Response):
+    print("Hello, world!")
+```
+
+```python
+# main.py
+from argenta.app import App
+from argenta.orchestrator import Orchestrator
+from routers import router
+
+app: App = App()
+orchestrator: Orchestrator = Orchestrator()
+
+
+def main() -> None:
+    app.include_router(router)
+    orchestrator.start_polling(app)
+
+
+if __name__ == '__main__':
+    main()
+```
+
+---
+
+# Funktionen in der Entwicklung
+
+- Vollständige Unterstützung für Autocompleter unter Linux
+- Möglichkeit zur Konfiguration der Standardausgabeerfassung bei der Verarbeitung von Eingaben durch den Handler
+
+## Vollständige [Dokumentation](https://argenta-docs.vercel.app) | MIT 2025 kolo | made by [kolo](https://t.me/kolo_id)
+
+
+

argenta-1.0.5/README.md

@@ -0,0 +1,68 @@
+# Argenta
+
+### Library for creating modular CLI applications
+
+#### RU - [README.ru.md](https://github.com/koloideal/Argenta/blob/kolo/README.ru.md) • DE - [README.de.md](https://github.com/koloideal/Argenta/blob/kolo/README.de.md)
+
+![preview](https://github.com/koloideal/Argenta/blob/kolo/imgs/mock_app_preview4.png?raw=True)  
+
+---
+
+# Installing
+```bash
+pip install argenta
+```
+or
+```bash
+poetry add argenta
+```
+
+---
+
+# Quick start
+
+An example of a simple application
+```python
+# routers.py
+from argenta.router import Router
+from argenta.command import Command
+from argenta.response import Response
+
+
+router = Router()
+
+@router.command(Command("hello"))
+def handler(response: Response):
+    print("Hello, world!")
+```
+
+```python
+# main.py
+from argenta.app import App
+from argenta.orchestrator import Orchestrator
+from routers import router
+
+app: App = App()
+orchestrator: Orchestrator = Orchestrator()
+
+
+def main() -> None:
+    app.include_router(router)
+    orchestrator.start_polling(app)
+
+
+if __name__ == '__main__':
+    main()
+```
+
+---
+
+# 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.5/mock/local_test.py

@@ -0,0 +1,32 @@
+from argenta.router import Router
+from argenta.command import Command
+from argenta.response import Response
+from argenta.metrics import get_time_of_pre_cycle_setup
+from argenta.response.status import Status
+from argenta.command.flag import Flag, Flags
+from argenta.app import App
+from argenta.orchestrator import Orchestrator
+
+
+router = Router()
+
+for i in range(10000):
+    trigger = f"cmd{i}"
+
+    @router.command(Command(trigger, aliases=[f'dfs{i}', f'fds{i}']))
+    def handler(response: Response):
+        print(response.status)
+
+
+
+app = App(repeat_command_groups=False)
+app.include_router(router)
+
+print(get_time_of_pre_cycle_setup(app))
+
+
+
+
+
+
+

{argenta-1.0.3 → argenta-1.0.5}/mock/mock_app/main.py

@@ -1,4 +1,4 @@
-from mock.mock_app.handlers.routers import work_router
+from mock.mock_app.routers import work_router
 
 from argenta.app import App
 from argenta.app.defaults import PredefinedMessages

{argenta-1.0.3/mock/mock_app/handlers → argenta-1.0.5/mock/mock_app}/routers.py

@@ -2,7 +2,7 @@ from rich.console import Console
 
 from argenta.command import Command
 from argenta.command.flag.defaults import PredefinedFlags
-from argenta.command.flags import Flags
+from argenta.command.flag import Flags
 from argenta.response import Response
 from argenta.router import Router
 

{argenta-1.0.3 → argenta-1.0.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "argenta"
-version = "1.0.3"
+version = "1.0.5"
 description = "Python library for building modular CLI applications"
 authors = [{ name = "kolo", email = "kolo.is.main@gmail.com" }]
 requires-python = ">=3.8"

{argenta-1.0.3 → argenta-1.0.5}/src/argenta/app/defaults.py

@@ -1,7 +1,7 @@
-from enum import Enum
+from enum import StrEnum
 
 
-class PredefinedMessages(Enum):
+class PredefinedMessages(StrEnum):
     """
     Public. A dataclass with predetermined messages for quick use
     """

{argenta-1.0.3 → argenta-1.0.5}/src/argenta/app/models.py

@@ -201,9 +201,7 @@ class BaseApp:
                 return False
         return True
 
-    def _error_handler(
-        self, error: BaseInputCommandException, raw_command: str
-    ) -> None:
+    def _error_handler(self, error: BaseInputCommandException, raw_command: str) -> None:
         """
         Private. Handles parsing errors of the entered command
         :param error: error being handled
@@ -296,7 +294,7 @@ class BaseApp:
 
         self._unknown_command_handler = unknown_command_handler
 
-    def _pre_cycle_setup(self) -> None:
+    def pre_cycle_setup(self) -> None:
         """
         Private. Configures various aspects of the application before the start of the cycle
         :return: None
@@ -330,7 +328,6 @@ class BaseApp:
             self._print_func(message)
         if self._messages_on_startup:
             print("\n")
-
         if not self._repeat_command_groups_description:
             self._print_command_group_description()
 
@@ -381,7 +378,7 @@ class App(BaseApp):
         Private. Starts the user input processing cycle
         :return: None
         """
-        self._pre_cycle_setup()
+        self.pre_cycle_setup()
         while True:
             if self._repeat_command_groups_description:
                 self._print_command_group_description()

argenta-1.0.5/src/argenta/command/flag/__init__.py

@@ -0,0 +1,7 @@
+__all__ = ["Flag", "InputFlag", "UndefinedInputFlags", "ValidInputFlags", "InvalidValueInputFlags", "Flags"]
+
+
+from argenta.command.flag.models import Flag, InputFlag
+from argenta.command.flag.flags.models import (UndefinedInputFlags,
+                                               ValidInputFlags, Flags,
+                                               InvalidValueInputFlags)

{argenta-1.0.3/src/argenta/command → argenta-1.0.5/src/argenta/command/flag}/flags/__init__.py

@@ -7,7 +7,7 @@ __all__ = [
 ]
 
 
-from argenta.command.flags.models import (
+from argenta.command.flag.flags.models import (
     Flags,
     InputFlags,
     UndefinedInputFlags,

{argenta-1.0.3 → argenta-1.0.5}/src/argenta/command/models.py

@@ -1,5 +1,5 @@
 from argenta.command.flag.models import Flag, InputFlag
-from argenta.command.flags.models import InputFlags, Flags
+from argenta.command.flag.flags.models import InputFlags, Flags
 from argenta.command.exceptions import (
     UnprocessedInputFlagException,
     RepeatedInputFlagsException,

argenta-1.0.5/src/argenta/metrics/__init__.py

@@ -0,0 +1,4 @@
+__all__ = ["get_time_of_pre_cycle_setup"]
+
+
+from argenta.metrics.main import get_time_of_pre_cycle_setup

argenta-1.0.5/src/argenta/metrics/main.py

@@ -0,0 +1,26 @@
+import io
+from contextlib import redirect_stdout
+from time import time
+
+from argenta.router import Router
+from argenta.command import Command
+from argenta.response import Response
+from argenta.response.status import Status
+from argenta.command.flag import Flag, Flags
+from argenta.app import App
+
+
+def get_time_of_pre_cycle_setup(app: App) -> float:
+    start = time()
+    with redirect_stdout(io.StringIO()):
+        app.pre_cycle_setup()
+    end = time()
+    return end - start
+
+
+
+
+
+
+
+

{argenta-1.0.3 → argenta-1.0.5}/src/argenta/response/entity.py

@@ -1,5 +1,5 @@
 from argenta.response.status import Status
-from argenta.command.flags import (
+from argenta.command.flag.flags import (
     ValidInputFlags,
     UndefinedInputFlags,
     InvalidValueInputFlags,

{argenta-1.0.3 → argenta-1.0.5}/src/argenta/router/entity.py

@@ -6,7 +6,7 @@ from argenta.command import Command
 from argenta.command.models import InputCommand
 from argenta.response import Response, Status
 from argenta.router.command_handler.entity import CommandHandlers, CommandHandler
-from argenta.command.flags.models import (
+from argenta.command.flag.flags import (
     Flags,
     InputFlags,
     UndefinedInputFlags,

argenta-1.0.3/mock/default_mock_app/main.py

@@ -1,27 +0,0 @@
-from mock.mock_app.handlers.routers import work_router
-
-from argenta.app import App
-from argenta.app.defaults import PredefinedMessages
-from argenta.app.autocompleter import AutoCompleter
-from argenta.orchestrator import Orchestrator
-from argenta.orchestrator.argparser import ArgParser
-from argenta.orchestrator.argparser.arguments import BooleanArgument
-
-
-arg_parser = ArgParser(processed_args=[BooleanArgument("repeat")])
-app: App = App(autocompleter=AutoCompleter(".hist"))
-orchestrator: Orchestrator = Orchestrator()
-
-
-def main():
-    app.include_router(work_router)
-
-    app.add_message_on_startup(PredefinedMessages.USAGE)
-    app.add_message_on_startup(PredefinedMessages.AUTOCOMPLETE)
-    app.add_message_on_startup(PredefinedMessages.HELP)
-
-    orchestrator.start_polling(app)
-
-
-if __name__ == "__main__":
-    main()

argenta-1.0.3/mock/local_test.py

@@ -1,89 +0,0 @@
-from argenta.router import Router
-from argenta.command import Command
-from argenta.response import Response
-from argenta.response.status import Status
-from argenta.command.flag import Flag
-from argenta.command.flags import Flags
-from argenta.app import App
-from argenta.orchestrator import Orchestrator
-
-# Создание маршрутизатора
-file_router = Router("Операции с файлами")
-
-# Определение флагов для команды копирования
-copy_flags = Flags(
-    Flag('source', '--'),
-    Flag('destination', '--'),
-    Flag('recursive', '--', False),  # Булевый флаг без значения
-    Flag('force', '-', False)        # Короткий булевый флаг
-)
-@file_router.command(Command('case', aliases=['cp', 'ch']))
-def handler(response: Response):
-    print('test')
-
-# Регистрация команды копирования
-@file_router.command(Command(
-    trigger="ch",
-    description="Копирование файлов",
-    flags=copy_flags,
-    aliases=["cp"]
-))
-def copy_files(response: Response):
-    # Получаем значения корректных флагов
-    source = None
-    destination = None
-    recursive = False
-    force = False
-
-    for flag in response.valid_flags:
-        if flag.get_name() == "source":
-            source = flag.get_value()
-        elif flag.get_name() == "destination":
-            destination = flag.get_value()
-        elif flag.get_name() == "recursive":
-            recursive = True
-        elif flag.get_name() == "force":
-            force = True
-
-    # Проверка обязательных параметров
-    if not source or not destination:
-        print("Ошибка: необходимо указать источник и назначение")
-        return
-
-    print(f"Копирование из {source} в {destination}")
-    if recursive:
-        print("Рекурсивное копирование включено")
-    if force:
-        print("Принудительное копирование включено")
-
-    # Обработка неопределенных флагов
-    if response.undefined_flags:
-        print("\nПредупреждение: обнаружены незарегистрированные флаги:")
-        for flag in response.undefined_flags:
-            print(f"  - {flag.get_name()}" +
-                 (f" = {flag.get_value()}" if flag.get_value() else ""))
-
-    # Обработка флагов с некорректными значениями
-    if response.invalid_value_flags:
-        print("\nПредупреждение: обнаружены флаги с некорректными значениями:")
-        for flag in response.invalid_value_flags:
-            print(f"  - {flag.get_name()} = {flag.get_value()}")
-
-    # Принятие решения на основе статуса
-    if response.status != Status.ALL_FLAGS_VALID:
-        print("\nВыполнение с предупреждениями из-за проблем с флагами.")
-
-
-
-app = App()
-app.include_router(file_router)
-orchestrator = Orchestrator()
-
-orchestrator.start_polling(app)
-
-
-
-
-
-
-

argenta-1.0.3/mock/mock_app/handlers/handlers_implementation/help_command.py

@@ -1,12 +0,0 @@
-from rich.console import Console
-
-
-console = Console()
-
-
-def help_command():
-    console.print(
-        "[italic bold]The main functionality of the script is to convert an expression from a string "
-        "to a mathematical one and then calculate this expression. "
-        "Project GitHub: https://github.com/koloideal/WordMath[/italic bold]"
-    )

argenta-1.0.3/src/argenta/command/flag/__init__.py

@@ -1,4 +0,0 @@
-__all__ = ["Flag", "InputFlag"]
-
-
-from argenta.command.flag.models import Flag, InputFlag