chutils 2.7.4__tar.gz → 2.8.0__tar.gz

{chutils-2.7.4 → chutils-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chutils
-Version: 2.7.4
+Version: 2.8.0
 Summary: Набор простых и удобных утилит для Python, который избавляет от рутины при работе с конфигурацией и логированием в новых проектах.
 License-Expression: MIT
 License-File: LICENSE
@@ -46,6 +46,7 @@ Requires-Dist: python-json-logger (>=3.2.1) ; extra == "json"
 Requires-Dist: pyyaml (>=6.0.3)
 Requires-Dist: rich (>=15.0.0) ; extra == "full"
 Requires-Dist: rich (>=15.0.0) ; extra == "rich"
+Requires-Dist: typing-extensions (>=4.15.0,<5.0.0)
 Requires-Dist: watchdog (>=6.0.0) ; extra == "full"
 Requires-Dist: watchdog (>=6.0.0) ; extra == "watch"
 Description-Content-Type: text/markdown
@@ -95,6 +96,10 @@ Every time you start a new project, you have to solve the same tasks:
 - **🌐 Remote Configuration:** Load settings from HTTP/HTTPS endpoints with background polling and fallback support.
 - **🔄 Hot-Reload:** Support for automatic configuration reloading on file changes without restart (requires
   `pip install chutils[watch]`).
+- **🛡️ Secure Paths:** Prevent Path Traversal attacks by safely resolving file paths against a base directory using
+  `resolve_safe_path()`.
+- **🤖 AI Linter:** Run static analysis checks on your codebase to ensure AI readiness (strict type hints, structured
+  docstrings, API map sync) via `chutils dev ai-lint`.
 - **⚡ Async Ready:** Most core functions have asynchronous versions (prefixed with `a`) for non-blocking execution.
 - **🚀 Ready to Use:** Just install and use.
 
@@ -282,6 +287,22 @@ In environments like Docker or CI/CD where `keyring` is unavailable, you can sup
 - Set `CH_DISABLE_KEYRING_WARNING=true` in environment.
 - Or add `disable_keyring: true` under `secrets` section in `config.yml`.
 
+### 4. Safe Path Resolution
+
+Safely resolve relative and absolute paths against a base directory to prevent directory traversal vulnerabilities:
+
+```python
+from chutils.fs import resolve_safe_path
+from chutils.exceptions import PathTraversalError
+
+try:
+    # Resolves path relative to the base directory and checks if it's safe
+    safe_path = resolve_safe_path("user_file.txt", base_dir="./sandbox")
+    print(f"Safe absolute path: {safe_path}")
+except PathTraversalError as e:
+    print(f"Path traversal detected! Attempted: {e.context.get('attempted_path')}")
+```
+
 ## API Overview
 
 ### Configuration (`chutils.config`)
@@ -310,6 +331,11 @@ In environments like Docker or CI/CD where `keyring` is unavailable, you can sup
 - `@retry`: Automatically retries a function if it fails. Supports sync/async, backoff, jitter, and exception filtering.
 - `@cli_command`: Turns any function into a standalone CLI script with automatic argument parsing.
 
+### File System (`chutils.fs`)
+
+- `resolve_safe_path(path, base_dir)`: Safely resolves path and checks for Path Traversal attempts.
+- `ensure_dir(path)`: Ensures directory exists.
+
 ### Time & Dates (`chutils.time`)
 
 - `utc_now()`: Returns a timezone-aware UTC datetime.
@@ -388,6 +414,20 @@ Trace exactly where each configuration value comes from:
 chutils config debug
 ```
 
+### 6. AI-Readiness Linter
+
+Perform a static audit of your codebase to ensure it is optimized for AI developers and agents:
+
+```bash
+# Run linter on the current project
+chutils dev ai-lint
+
+# Run linter in strict mode with ignored paths
+chutils dev ai-lint --strict --ignore "temp/,build/"
+```
+
+See [docs/ai_lint.md](docs/ai_lint.md) for more details.
+
 ## License
 
 The project is distributed under the MIT License.

{chutils-2.7.4 → chutils-2.8.0}/README.md

@@ -43,6 +43,10 @@ Every time you start a new project, you have to solve the same tasks:
 - **🌐 Remote Configuration:** Load settings from HTTP/HTTPS endpoints with background polling and fallback support.
 - **🔄 Hot-Reload:** Support for automatic configuration reloading on file changes without restart (requires
   `pip install chutils[watch]`).
+- **🛡️ Secure Paths:** Prevent Path Traversal attacks by safely resolving file paths against a base directory using
+  `resolve_safe_path()`.
+- **🤖 AI Linter:** Run static analysis checks on your codebase to ensure AI readiness (strict type hints, structured
+  docstrings, API map sync) via `chutils dev ai-lint`.
 - **⚡ Async Ready:** Most core functions have asynchronous versions (prefixed with `a`) for non-blocking execution.
 - **🚀 Ready to Use:** Just install and use.
 
@@ -230,6 +234,22 @@ In environments like Docker or CI/CD where `keyring` is unavailable, you can sup
 - Set `CH_DISABLE_KEYRING_WARNING=true` in environment.
 - Or add `disable_keyring: true` under `secrets` section in `config.yml`.
 
+### 4. Safe Path Resolution
+
+Safely resolve relative and absolute paths against a base directory to prevent directory traversal vulnerabilities:
+
+```python
+from chutils.fs import resolve_safe_path
+from chutils.exceptions import PathTraversalError
+
+try:
+    # Resolves path relative to the base directory and checks if it's safe
+    safe_path = resolve_safe_path("user_file.txt", base_dir="./sandbox")
+    print(f"Safe absolute path: {safe_path}")
+except PathTraversalError as e:
+    print(f"Path traversal detected! Attempted: {e.context.get('attempted_path')}")
+```
+
 ## API Overview
 
 ### Configuration (`chutils.config`)
@@ -258,6 +278,11 @@ In environments like Docker or CI/CD where `keyring` is unavailable, you can sup
 - `@retry`: Automatically retries a function if it fails. Supports sync/async, backoff, jitter, and exception filtering.
 - `@cli_command`: Turns any function into a standalone CLI script with automatic argument parsing.
 
+### File System (`chutils.fs`)
+
+- `resolve_safe_path(path, base_dir)`: Safely resolves path and checks for Path Traversal attempts.
+- `ensure_dir(path)`: Ensures directory exists.
+
 ### Time & Dates (`chutils.time`)
 
 - `utc_now()`: Returns a timezone-aware UTC datetime.
@@ -336,6 +361,20 @@ Trace exactly where each configuration value comes from:
 chutils config debug
 ```
 
+### 6. AI-Readiness Linter
+
+Perform a static audit of your codebase to ensure it is optimized for AI developers and agents:
+
+```bash
+# Run linter on the current project
+chutils dev ai-lint
+
+# Run linter in strict mode with ignored paths
+chutils dev ai-lint --strict --ignore "temp/,build/"
+```
+
+See [docs/ai_lint.md](docs/ai_lint.md) for more details.
+
 ## License
 
 The project is distributed under the MIT License.

{chutils-2.7.4 → chutils-2.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "chutils"
-version = "2.7.4"
+version = "2.8.0"
 description = "Набор простых и удобных утилит для Python, который избавляет от рутины при работе с конфигурацией и логированием в новых проектах."
 authors = [{name = "Chu4hel", email = "sergeiivanov636@gmail.com"}]
 license = "MIT"
@@ -10,7 +10,8 @@ dependencies = [
     "keyring (>=25.7.0)",
     "pyyaml (>=6.0.3)",
     "python-dotenv (>=1.2.1) ; python_full_version < '3.10'",
-    "python-dotenv (>=1.2.2) ; python_full_version >= '3.10'"
+    "python-dotenv (>=1.2.2) ; python_full_version >= '3.10'",
+    "typing-extensions (>=4.15.0,<5.0.0)"
 ]
 
 [project.optional-dependencies]
@@ -80,6 +81,7 @@ pytest-cov = "^7.1.0"
 pytest-asyncio = { version = "^1.3.0", python = ">=3.10" }
 ruff = "^0.15.12"
 rich = "^15.0.0"
+mypy = { version = "^2.1.0", python = ">=3.10" }
 
 [build-system]
 requires = ["poetry-core>=2.0.0,<3.0.0"]
@@ -88,4 +90,29 @@ build-backend = "poetry.core.masonry.api"
 [tool.pytest.ini_options]
 pythonpath = [
     "src"
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+ignore_missing_imports = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+check_untyped_defs = true
+disallow_untyped_defs = true
+
+[tool.chutils.ai-lint]
+strict = false
+ignore = [
+    ".git",
+    ".venv",
+    "__pycache__",
+    "build",
+    "dist",
+    "tests",
+    "site",
+    "examples",
+    "docs",
+    "src/chutils/testing",
+    "src/chutils/typing.py"
 ]

{chutils-2.7.4 → chutils-2.8.0}/src/chutils/__init__.py

@@ -51,6 +51,7 @@ _LAZY_MAPPING = {
     'time': ('.time', None),
     'tracing': ('.tracing', None),
     'testing': ('.testing', None),
+    'dev': ('.dev', None),
 
     # config
     'get_config': ('.config', 'get_config'),
@@ -77,6 +78,8 @@ _LAZY_MAPPING = {
     'get_config_paths': ('.config', 'get_config_paths'),
     'get_all_config_paths': ('.config', 'get_all_config_paths'),
     'export_schema': ('.config', 'export_schema'),
+    'load_ai_lint_config': ('.config', 'load_ai_lint_config'),
+    'parse_chutils_ignore': ('.config', 'parse_chutils_ignore'),
 
     # features
     'is_feature_enabled': ('.features', 'is_feature_enabled'),

{chutils-2.7.4 → chutils-2.8.0}/src/chutils/__init__.pyi

@@ -1,5 +1,6 @@
 import datetime
 import logging
+from enum import Enum
 from typing import Any, Optional, List, Dict, Type, TypeVar, Union, Tuple, Callable
 
 # Тип для Pydantic моделей
@@ -11,8 +12,12 @@ F = TypeVar("F", bound=Callable[..., Any])
 def init(base_dir: str) -> None: ...
 
 
-# --- config ---
-def get_config(model: Optional[Type[T]] = None) -> Union[Dict[str, Any], T]: ...
+def get_config(
+        model: Optional[Type[T]] = None,
+        remote_url: Optional[str] = None,
+        remote_auth: Optional[Tuple[str, str]] = None,
+        polling_interval: Optional[int] = None,
+) -> Union[Dict[str, Any], T]: ...
 
 
 def get_config_value(section: str, key: str, fallback: Any = None, config: Optional[Dict[str, Any]] = None) -> Any: ...
@@ -71,6 +76,27 @@ def generate_env_template(model_class: Type[T], prefix: str = "CH") -> str: ...
 def generate_json_schema(model_class: Type[T]) -> str: ...
 
 
+def get_base_dir() -> Optional[str]: ...
+
+
+def get_config_file_path() -> Optional[str]: ...
+
+
+def is_config_loaded() -> bool: ...
+
+
+def are_paths_initialized() -> bool: ...
+
+
+def get_config_paths(cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str]]: ...
+
+
+def get_all_config_paths(cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str], Optional[str]]: ...
+
+
+def export_schema(model: Union[Type[T], str], output_path: Optional[Union[str, Any]] = None) -> str: ...
+
+
 # --- features ---
 def is_feature_enabled(feature_name: str, context: Optional[Dict[str, Any]] = None) -> bool: ...
 
@@ -87,14 +113,59 @@ class ChutilsLogger(logging.Logger):
     def add_mask(self, secret: str) -> None: ...
 
 
-def setup_logger(name: Optional[str] = None, level: Optional[Union[str, int]] = None,
-                 log_file: Optional[str] = None, config_section_name: Optional[str] = None,
-                 json_format: Optional[bool] = None, use_async: Optional[bool] = None) -> ChutilsLogger: ...
+def setup_logger(
+        name: str = 'app_logger',
+        config_section_name: Optional[str] = None,
+        log_level: Optional[LogLevel] = None,
+        log_file_name: Optional[str] = None,
+        force_reconfigure: bool = False,
+        rotation_type: Optional[str] = None,
+        max_bytes: Optional[int] = None,
+        compress: Optional[bool] = None,
+        backup_count: Optional[int] = None,
+        encoding: Optional[str] = None,
+        when: Optional[str] = None,
+        interval: Optional[int] = None,
+        utc: Optional[bool] = None,
+        at_time: Any = None,
+        json_format: Optional[bool] = None,
+        use_async: Optional[bool] = None,
+        max_queue_size: Optional[int] = None,
+) -> ChutilsLogger: ...
+
+
+class LogLevel(str, Enum):
+    DEVDEBUG = "DEVDEBUG"
+    DEBUG = "DEBUG"
+    MEDIUMDEBUG = "MEDIUMDEBUG"
+    INFO = "INFO"
+    WARNING = "WARNING"
+    ERROR = "ERROR"
+    CRITICAL = "CRITICAL"
+
+
+def get_console(stderr: bool = False) -> Any: ...
+
+
+class SecretMaskingFilter(logging.Filter): ...
+
+
+class ChutilsJsonFormatter(logging.Formatter): ...
 
 
 class SafeTimedRotatingFileHandler(logging.Handler): ...
 
 
+class CompressingRotatingFileHandler(logging.Handler): ...
+
+
+class CompressingTimedRotatingFileHandler(logging.Handler): ...
+
+
+DEVDEBUG_LEVEL_NUM: int
+MEDIUMDEBUG_LEVEL_NUM: int
+
+
 # --- context ---
 def bind_context(**kwargs: Any) -> Any: ...
 
@@ -123,7 +194,22 @@ def utc_now() -> datetime.datetime: ...
 def parse_datetime(value: Union[str, int, float]) -> datetime.datetime: ...
 
 
-def humanize_timedelta(dt: datetime.datetime, locale: str = 'ru', custom_locales: Optional[dict] = None) -> str: ...
+def humanize_timedelta(dt: datetime.datetime, locale: str = 'ru',
+                       custom_locales: Optional[Dict[str, Any]] = None) -> str: ...
+
+
+# --- env (Discovery) ---
+def is_rich_enabled() -> bool: ...
+
+
+def is_otel_enabled() -> bool: ...
+
+
+RICH_AVAILABLE: bool
+PYDANTIC_AVAILABLE: bool
+WATCHDOG_AVAILABLE: bool
+JSON_LOGGER_AVAILABLE: bool
+OTEL_AVAILABLE: bool
 
 
 # --- secret_manager ---
@@ -224,3 +310,4 @@ from . import lifecycle as lifecycle
 from . import features as features
 from . import time as time
 from . import tracing as tracing
+from . import dev as dev

chutils-2.8.0/src/chutils/__main__.py

@@ -0,0 +1,4 @@
+from chutils.cli import main
+
+if __name__ == "__main__":
+    main()

{chutils-2.7.4 → chutils-2.8.0}/src/chutils/cache/base.py

@@ -1,8 +1,10 @@
 from abc import ABC, abstractmethod
-from typing import Any, Optional
+from typing import Optional, TypeVar, Generic
 
+T = TypeVar("T")
 
-class BaseCacheBackend(ABC):
+
+class BaseCacheBackend(ABC, Generic[T]):
     """
     Базовый абстрактный класс для всех бэкендов кэширования.
     
@@ -10,7 +12,7 @@ class BaseCacheBackend(ABC):
     """
 
     @abstractmethod
-    def get(self, key: str) -> Any:
+    def get(self, key: str) -> Optional[T]:
         """
         Получить значение из кэша.
         
@@ -18,18 +20,18 @@ class BaseCacheBackend(ABC):
             key (str): Ключ кэша.
             
         Returns:
-            Any: Значение или None, если ключ не найден или просрочен.
+            Значение или None, если ключ не найден или просрочен.
         """
         pass
 
     @abstractmethod
-    def set(self, key: str, value: Any, ttl: Optional[int] = None) -> None:
+    def set(self, key: str, value: T, ttl: Optional[int] = None) -> None:
         """
         Сохранить значение в кэше.
-        
+
         Args:
             key (str): Ключ кэша.
-            value (Any): Значение для сохранения.
+            value: Значение для сохранения.
             ttl (Optional[int]): Время жизни в секундах. Если None, используется вечное хранение.
         """
         pass
@@ -38,7 +40,7 @@ class BaseCacheBackend(ABC):
     def delete(self, key: str) -> None:
         """
         Удалить ключ из кэша.
-        
+
         Args:
             key (str): Ключ кэша.
         """
@@ -48,10 +50,10 @@ class BaseCacheBackend(ABC):
     def exists(self, key: str) -> bool:
         """
         Проверить наличие ключа в кэше.
-        
+
         Args:
             key (str): Ключ кэша.
-            
+
         Returns:
             bool: True, если ключ существует и не просрочен.
         """
@@ -64,17 +66,17 @@ class BaseCacheBackend(ABC):
 
     # --- Асинхронные методы (по умолчанию вызывают синхронные) ---
 
-    async def aget(self, key: str) -> Any:
+    async def aget(self, key: str) -> Optional[T]:
         """Асинхронное получение значения."""
         return self.get(key)
 
-    async def aset(self, key: str, value: Any, ttl: Optional[int] = None) -> None:
+    async def aset(self, key: str, value: T, ttl: Optional[int] = None) -> None:
         """Асинхронное сохранение значения."""
-        return self.set(key, value, ttl)
+        self.set(key, value, ttl)
 
     async def adelete(self, key: str) -> None:
         """Асинхронное удаление значения."""
-        return self.delete(key)
+        self.delete(key)
 
     async def aexists(self, key: str) -> bool:
         """Асинхронная проверка наличия ключа."""
@@ -82,4 +84,4 @@ class BaseCacheBackend(ABC):
 
     async def aclear(self) -> None:
         """Асинхронная очистка кэша."""
-        return self.clear()
+        self.clear()

{chutils-2.7.4 → chutils-2.8.0}/src/chutils/cache/decorator.py

@@ -1,12 +1,12 @@
 import asyncio
 import functools
-from typing import Any, Callable, Optional
+from typing import Callable, Optional, Any
 
 from .in_memory import InMemoryCacheBackend
 from .utils import generate_cache_key, LockManager, AsyncLockManager
 
 # Экземпляры по умолчанию
-_default_backend = InMemoryCacheBackend()
+_default_backend: InMemoryCacheBackend[Any] = InMemoryCacheBackend()
 _sync_lock_manager = LockManager()
 _async_lock_manager = AsyncLockManager()
 
@@ -15,23 +15,23 @@ def cache_with_ttl(
         ttl: int = 60,
         key_prefix: str = "",
         sliding: bool = True,
-        backend: Optional[InMemoryCacheBackend] = None
-) -> Callable:
+        backend: Optional[InMemoryCacheBackend[Any]] = None
+) -> Callable[..., Any]:
     """
     Декоратор для кэширования результатов выполнения функций с поддержкой TTL.
-    
+
     Args:
         ttl (int): Время жизни закэшированного значения в секундах. По умолчанию 60.
         key_prefix (str): Префикс для ключа кэша.
         sliding (bool): Если True, TTL продлевается при каждом успешном чтении из кэша.
         backend: Инстанс бэкенда для хранения (по умолчанию InMemoryCacheBackend).
-        
+
     Returns:
         Callable: Обернутая функция.
     """
-    cache = backend or _default_backend
+    cache: InMemoryCacheBackend[Any] = backend or _default_backend
 
-    def decorator(func: Callable) -> Callable:
+    def decorator(func: Callable[..., Any]) -> Callable[..., Any]:
         func_name = f"{func.__module__}.{func.__name__}"
         is_async = asyncio.iscoroutinefunction(func)
 

{chutils-2.7.4 → chutils-2.8.0}/src/chutils/cache/in_memory.py

@@ -1,28 +1,30 @@
 import threading
 import time
-from typing import Any, Dict, Optional, Tuple
+from typing import Dict, Optional, Tuple, TypeVar
 
 from .base import BaseCacheBackend
 
+T = TypeVar("T")
 
-class InMemoryCacheBackend(BaseCacheBackend):
+
+class InMemoryCacheBackend(BaseCacheBackend[T]):
     """
     Реализация кэша в оперативной памяти на базе словаря.
-    
+
     Поддерживает TTL, потокобезопасность и ленивую очистку просроченных записей.
     """
 
     def __init__(self) -> None:
         # Структура: {key: (value, expires_at)}
-        self._cache: Dict[str, Tuple[Any, Optional[float]]] = {}
+        self._cache: Dict[str, Tuple[T, Optional[float]]] = {}
         self._lock = threading.Lock()
 
-    def get(self, key: str) -> Any:
+    def get(self, key: str) -> Optional[T]:
         """Получить значение. Если просрочено - удаляет его."""
         with self._lock:
             return self._get_without_lock(key)
 
-    def _get_without_lock(self, key: str) -> Any:
+    def _get_without_lock(self, key: str) -> Optional[T]:
         """Внутренний метод получения без блокировки (для использования внутри других методов)."""
         if key not in self._cache:
             return None
@@ -34,7 +36,7 @@ class InMemoryCacheBackend(BaseCacheBackend):
 
         return value
 
-    def set(self, key: str, value: Any, ttl: Optional[int] = None) -> None:
+    def set(self, key: str, value: T, ttl: Optional[int] = None) -> None:
         """Сохранить значение с TTL."""
         expires_at = time.time() + ttl if ttl is not None else None
         with self._lock:

chutils-2.8.0/src/chutils/cli.py

@@ -0,0 +1,112 @@
+from __future__ import annotations
+
+import argparse
+import sys
+
+from chutils.commands import get_commands
+
+
+def main() -> None:
+    """Точка входа в CLI."""
+    parser = argparse.ArgumentParser(
+        prog="chutils",
+        description="""
+Набор утилит chutils для командной строки.
+Помогает инициализировать проекты, управлять секретами и проверять конфигурацию.
+""",
+        epilog="""
+Примеры использования:
+  chutils init -y
+  chutils secrets set API_KEY "value"
+  chutils validate --model myapp.config:Settings
+  chutils show-paths --json
+""",
+        formatter_class=argparse.RawDescriptionHelpFormatter
+    )
+    subparsers = parser.add_subparsers(
+        title="Доступные команды",
+        dest="command",
+        metavar="COMMAND",
+        help="Используйте 'chutils COMMAND --help' для получения справки по конкретной команде"
+    )
+
+    # Регистрируем все доступные команды
+    for cmd_class in get_commands():
+        cmd_instance = cmd_class()
+        cmd_instance.register(subparsers)
+
+    # Если аргументы не переданы, выводим help
+    if len(sys.argv) == 1:
+        parser.print_help()
+        sys.exit(0)
+
+    args = parser.parse_args()
+
+    # Диспетчеризация выполнения
+    if hasattr(args, 'handler'):
+        from chutils.exceptions import ChutilsException, PathTraversalError
+        from chutils.cli_utils import get_console
+        from chutils.env import RICH_AVAILABLE
+        import logging
+
+        console = get_console(stderr=True)
+
+        try:
+            args.handler(args)
+        except PathTraversalError as e:
+            # Специфичное логирование для PathTraversal
+            logger = logging.getLogger("chutils.security")
+            logger.error(
+                "Попытка Path Traversal! Исходный путь: %s, Базовый путь: %s",
+                e.context.get('attempted_path'),
+                e.context.get('base_path')
+            )
+
+            if RICH_AVAILABLE:
+                from rich.text import Text
+                console.print()
+                console.print(Text("ОШИБКА БЕЗОПАСНОСТИ: ", style="bold red") + Text(e.message))
+                if e.hint:
+                    console.print(Text("СОВЕТ: ", style="bold yellow") + Text(e.hint))
+            else:
+                console.print(f"\nОШИБКА БЕЗОПАСНОСТИ: {e.message}", markup=False)
+                if e.hint:
+                    console.print(f"СОВЕТ: {e.hint}", markup=False)
+            sys.exit(1)
+
+        except ChutilsException as e:
+            if RICH_AVAILABLE:
+                from rich.text import Text
+                from rich.panel import Panel
+                # Выводим префикс стилизованно, а сообщение как чистый текст (защита от markup)
+                console.print()
+                console.print(Text("ОШИБКА: ", style="bold red") + Text(e.message))
+
+                if e.hint:
+                    # Внутри панели используем Text для защиты от markup
+                    console.print(
+                        Panel(Text(e.hint), title="[bold yellow]Подсказка[/bold yellow]", border_style="yellow"))
+            else:
+                console.print(f"\nОШИБКА: {e.message}", markup=False)
+                if e.hint:
+                    console.print(f"СОВЕТ: {e.hint}", markup=False)
+            sys.exit(1)
+
+        except Exception as e:
+            if RICH_AVAILABLE:
+                from rich.text import Text
+                console.print()
+                console.print(Text("НЕПРЕДВИДЕННАЯ ОШИБКА: ", style="bold red") + Text(str(e)))
+            else:
+                console.print(f"\nНЕПРЕДВИДЕННАЯ ОШИБКА: {e}", markup=False)
+            sys.exit(1)
+
+
+    else:
+        parser.print_help()
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()