chutils 2.7.0__tar.gz → 2.7.2__tar.gz

{chutils-2.7.0 → chutils-2.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chutils
-Version: 2.7.0
+Version: 2.7.2
 Summary: Набор простых и удобных утилит для Python, который избавляет от рутины при работе с конфигурацией и логированием в новых проектах.
 License-Expression: MIT
 License-File: LICENSE

{chutils-2.7.0 → chutils-2.7.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "chutils"
-version = "2.7.0"
+version = "2.7.2"
 description = "Набор простых и удобных утилит для Python, который избавляет от рутины при работе с конфигурацией и логированием в новых проектах."
 authors = [{name = "Chu4hel", email = "sergeiivanov636@gmail.com"}]
 license = "MIT"

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/__init__.py

@@ -70,6 +70,13 @@ _LAZY_MAPPING = {
     'generate_yaml_template': ('.config', 'generate_yaml_template'),
     'generate_env_template': ('.config', 'generate_env_template'),
     'generate_json_schema': ('.config', 'generate_json_schema'),
+    'get_base_dir': ('.config', 'get_base_dir'),
+    'get_config_file_path': ('.config', 'get_config_file_path'),
+    'is_config_loaded': ('.config', 'is_config_loaded'),
+    'are_paths_initialized': ('.config', 'are_paths_initialized'),
+    'get_config_paths': ('.config', 'get_config_paths'),
+    'get_all_config_paths': ('.config', 'get_all_config_paths'),
+    'export_schema': ('.config', 'export_schema'),
 
     # features
     'is_feature_enabled': ('.features', 'is_feature_enabled'),
@@ -78,7 +85,31 @@ _LAZY_MAPPING = {
     # logger
     'setup_logger': ('.logger', 'setup_logger'),
     'ChutilsLogger': ('.logger', 'ChutilsLogger'),
+    'LogLevel': ('.logger', 'LogLevel'),
+    'SecretMaskingFilter': ('.logger', 'SecretMaskingFilter'),
+    'ChutilsJsonFormatter': ('.logger', 'ChutilsJsonFormatter'),
     'SafeTimedRotatingFileHandler': ('.logger', 'SafeTimedRotatingFileHandler'),
+    'CompressingRotatingFileHandler': ('.logger', 'CompressingRotatingFileHandler'),
+    'CompressingTimedRotatingFileHandler': ('.logger', 'CompressingTimedRotatingFileHandler'),
+    'DEVDEBUG_LEVEL_NUM': ('.logger', 'DEVDEBUG_LEVEL_NUM'),
+    'MEDIUMDEBUG_LEVEL_NUM': ('.logger', 'MEDIUMDEBUG_LEVEL_NUM'),
+
+    # cli_utils
+    'get_console': ('.cli_utils', 'get_console'),
+
+    # env (Discovery)
+    'is_rich_enabled': ('.env', 'is_rich_enabled'),
+    'is_otel_enabled': ('.env', 'is_otel_enabled'),
+    'RICH_AVAILABLE': ('.env', 'RICH_AVAILABLE'),
+    'PYDANTIC_AVAILABLE': ('.env', 'PYDANTIC_AVAILABLE'),
+    'WATCHDOG_AVAILABLE': ('.env', 'WATCHDOG_AVAILABLE'),
+    'JSON_LOGGER_AVAILABLE': ('.env', 'JSON_LOGGER_AVAILABLE'),
+    'OTEL_AVAILABLE': ('.env', 'OTEL_AVAILABLE'),
+
+    # cache
+    'cache_with_ttl': ('.cache', 'cache_with_ttl'),
+    'BaseCacheBackend': ('.cache', 'BaseCacheBackend'),
+    'InMemoryCacheBackend': ('.cache', 'InMemoryCacheBackend'),
 
     # context
     'bind_context': ('.context', 'bind_context'),
@@ -122,6 +153,7 @@ _LAZY_MAPPING = {
     'WatcherInitializationError': ('.exceptions', 'WatcherInitializationError'),
     'OptionalDependencyError': ('.exceptions', 'OptionalDependencyError'),
     'ChutilsTimeoutError': ('.exceptions', 'ChutilsTimeoutError'),
+    'CacheError': ('.exceptions', 'CacheError'),
 }
 
 

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/cli_utils.py

@@ -1,26 +1,14 @@
-import os
 import re
 import sys
 from typing import Any
 
-# Пытаемся импортировать rich
-RICH_AVAILABLE = False
-try:
+from .env import RICH_AVAILABLE, is_rich_enabled
+
+if RICH_AVAILABLE:
     from rich.console import Console
     from rich.table import Table
     from rich.panel import Panel
 
-    RICH_AVAILABLE = True
-except ImportError:
-    pass
-
-
-def is_color_enabled() -> bool:
-    """Проверяет, включена ли цветовая индикация."""
-    no_color = os.getenv("NO_COLOR", "").lower() in ["true", "1", "yes", "y"]
-    ch_no_color = os.getenv("CH_NO_COLOR", "").lower() in ["true", "1", "yes", "y"]
-    return not (no_color or ch_no_color)
-
 
 class FallbackConsole:
     """
@@ -79,7 +67,7 @@ def get_console(stderr: bool = False) -> Any:
     if stderr:
         if _err_console is not None:
             return _err_console
-        if RICH_AVAILABLE and is_color_enabled():
+        if is_rich_enabled():
             _err_console = Console(stderr=True)
         else:
             _err_console = FallbackConsole(stderr=True)
@@ -88,7 +76,7 @@ def get_console(stderr: bool = False) -> Any:
     if _console is not None:
         return _console
 
-    if RICH_AVAILABLE and is_color_enabled():
+    if is_rich_enabled():
         _console = Console()
     else:
         _console = FallbackConsole()

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/commands/config.py

@@ -25,7 +25,13 @@ class ConfigCommand(BaseCommand):
         debug_parser = config_subparsers.add_parser(
             "debug",
             help="Интерактивный отладчик конфигурации (Trace)",
-            description="Показывает итоговую конфигурацию и историю её изменения из разных источников."
+            description="Показывает итоговую конфигурацию и историю её изменения из разных источников.",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+            epilog="""Примеры использования:
+  chutils config debug
+  chutils config debug --format table
+  chutils config debug --show-secrets --format json
+"""
         )
         debug_parser.add_argument(
             "-f", "--format",
@@ -44,7 +50,12 @@ class ConfigCommand(BaseCommand):
         schema_parser = config_subparsers.add_parser(
             "generate-schema",
             help="Генерация JSON Schema на основе Pydantic модели",
-            description="Создает JSON схему для валидации файлов конфигурации в IDE или AI-агентах."
+            description="Создает JSON схему для валидации файлов конфигурации в IDE или AI-агентах.",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+            epilog="""Примеры использования:
+  chutils config generate-schema --model my_app.models:Settings -o config.schema.json
+  chutils config generate-schema --model chutils.config.schema:TestModel --stdout
+"""
         )
         schema_parser.add_argument(
             "--model",

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/commands/dev.py

@@ -28,7 +28,13 @@ class DevCommand(BaseCommand):
         gen_parser = dev_subparsers.add_parser(
             "generate-context",
             help="Сгенерировать карту публичного API (экспорты)",
-            description="Сканирует chutils и создает отчет о доступных функциях, классах и декораторах."
+            description="Сканирует chutils и создает отчет о доступных функциях, классах и декораторах.",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+            epilog="""Примеры использования:
+  chutils dev generate-context -o api_map.md
+  chutils dev generate-context --tree -o project_index.json
+  chutils dev generate-context -f json --no-weights
+"""
         )
         gen_parser.add_argument(
             "-f", "--format",
@@ -127,7 +133,11 @@ class DevCommand(BaseCommand):
             self.console.print(
                 f"[bold green] [OK] [/bold green] Контекст успешно сохранен в: [cyan]{args.output}[/cyan]")
         else:
-            self.console.print("\n" + output_content)
+            if args.format == "json":
+                # В stdout выводим чистый JSON для парсинга ИИ
+                print(output_content)
+            else:
+                self.console.print("\n" + output_content)
 
     def _handle_tree_index(self, args: argparse.Namespace):
         """Генерация иерархического индекса (Phase 5)."""

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/commands/paths.py

@@ -2,6 +2,7 @@ import argparse
 import json
 
 from chutils import config
+
 from .base import BaseCommand
 
 
@@ -35,7 +36,7 @@ class ShowPathsCommand(BaseCommand):
             config.get_base_dir()
 
         base_dir = config.get_base_dir()
-        main_path, env_path, local_path = config.get_config_paths()
+        main_path, env_path, local_path = config.get_all_config_paths()
 
         paths_data = {
             "base_dir": base_dir,
@@ -48,10 +49,9 @@ class ShowPathsCommand(BaseCommand):
         if args.json:
             print(json.dumps(paths_data, indent=4, ensure_ascii=False))
         else:
-            from chutils.cli_utils import RICH_AVAILABLE
-            import os
+            from chutils.env import is_rich_enabled
 
-            if RICH_AVAILABLE and not os.getenv("CH_NO_RICH"):
+            if is_rich_enabled():
                 from rich.table import Table
 
                 table = Table(title="Диагностика путей конфигурации", show_header=True, header_style="bold magenta")

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/commands/secrets.py

@@ -27,7 +27,12 @@ class SecretsCommand(BaseCommand):
         set_parser = secrets_subparsers.add_parser(
             "set",
             help="Сохранить или обновить секрет",
-            description="Сохраняет зашифрованное значение в системное хранилище."
+            description="Сохраняет зашифрованное значение в системное хранилище.",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+            epilog="""Примеры использования:
+  chutils secrets set DB_PASSWORD "mypassword"
+  chutils secrets set STRIPE_KEY "sk_test_..." --service my_app
+"""
         )
         set_parser.add_argument("key", help="Имя ключа (например, DB_PASSWORD)")
         set_parser.add_argument("value", help="Значение секрета")
@@ -41,7 +46,12 @@ class SecretsCommand(BaseCommand):
         delete_parser = secrets_subparsers.add_parser(
             "delete",
             help="Удалить секрет из хранилища",
-            description="Навсегда удаляет указанный ключ из системного хранилища."
+            description="Навсегда удаляет указанный ключ из системного хранилища.",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+            epilog="""Примеры использования:
+  chutils secrets delete DB_PASSWORD
+  chutils secrets delete STRIPE_KEY --service my_app
+"""
         )
         delete_parser.add_argument("key", help="Имя ключа для удаления")
         delete_parser.add_argument(

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/config/__init__.py

@@ -73,6 +73,7 @@ __all__ = [
     'is_config_loaded',
     'are_paths_initialized',
     'get_config_paths',
+    'get_all_config_paths',
     'on_config_change',
     'start_config_watcher',
     'stop_config_watcher',
@@ -207,7 +208,25 @@ def are_paths_initialized() -> bool:
     return _cm.paths_initialized
 
 
-def get_config_paths(cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str], Optional[str]]:
+def get_config_paths(cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str]]:
+    """
+    Возвращает пути к основному и локальному файлам конфигурации.
+
+    Legacy API для обратной совместимости. Возвращает кортеж из 2 элементов.
+    Для получения всех путей (включая env) используйте get_all_config_paths().
+
+    Args:
+        cfg_file: Опциональный путь к основному файлу.
+
+    Returns:
+        Кортеж (путь_к_основному, путь_к_локальному).
+    """
+    if not _cm.paths_initialized:
+        _cm.initialize_paths(find_project_root)
+    return _cm.get_config_paths(cfg_file)
+
+
+def get_all_config_paths(cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str], Optional[str]]:
     """
     Возвращает пути к основному, специфичному для окружения и локальному файлам конфигурации.
 
@@ -219,4 +238,4 @@ def get_config_paths(cfg_file: Optional[str] = None) -> Tuple[Optional[str], Opt
     """
     if not _cm.paths_initialized:
         _cm.initialize_paths(find_project_root)
-    return _cm.get_config_paths(cfg_file)
+    return _cm.get_all_config_paths(cfg_file)

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/config/core.py

@@ -70,7 +70,7 @@ def get_config(
 
         _cm.acquire_file_lock()
         try:
-            main_path, env_path, local_path = _cm.get_config_paths()
+            main_path, env_path, local_path = _cm.get_all_config_paths()
             config_data: Dict = {}
 
             def load_from_path(path: str) -> Dict:
@@ -207,7 +207,7 @@ def save_config_value(
     if cfg_file:
         path = cfg_file
     else:
-        main_path, env_path, local_path = _cm.get_config_paths()
+        main_path, _, local_path = _cm.get_all_config_paths()
         if save_to_local and local_path:
             path = local_path
             logger.debug("Для сохранения выбран локальный файл конфигурации: %s", path)

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/config/diagnostics.py

@@ -5,7 +5,8 @@
 import json
 from typing import Dict, List, Any
 
-from chutils.cli_utils import RICH_AVAILABLE, get_console
+from chutils.cli_utils import get_console
+from chutils.env import is_rich_enabled
 
 # Список ключевых слов, значения которых должны маскироваться по умолчанию
 SECRET_KEYWORDS = {
@@ -59,9 +60,10 @@ def _format_json(trace_data: Dict[str, Dict[str, List[Dict[str, Any]]]], show_se
 
 def _format_table(trace_data: Dict[str, Dict[str, List[Dict[str, Any]]]], show_secrets: bool) -> str:
     """Форматирует трассировку в таблицу (Rich или текст)."""
+    use_rich = is_rich_enabled()
     console = get_console()
 
-    if RICH_AVAILABLE:
+    if use_rich:
         from rich.table import Table
         table = Table(title="Трассировка конфигурации (Diagnostics)", show_lines=True)
         table.add_column("Секция", style="cyan")
@@ -100,9 +102,10 @@ def _format_table(trace_data: Dict[str, Dict[str, List[Dict[str, Any]]]], show_s
 
 def _format_tree(trace_data: Dict[str, Dict[str, List[Dict[str, Any]]]], show_secrets: bool) -> str:
     """Форматирует трассировку в дерево (Rich или текст)."""
+    use_rich = is_rich_enabled()
     console = get_console()
 
-    if RICH_AVAILABLE:
+    if use_rich:
         from rich.tree import Tree
         root = Tree("📁 [bold blue]Configuration Root[/bold blue]")
 

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/config/manager.py

@@ -330,7 +330,16 @@ class _ConfigManager:
 
             self.paths_initialized = True
 
-    def get_config_paths(self, cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str], Optional[str]]:
+    def get_config_paths(self, cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str]]:
+        """
+        Возвращает пути к основному и локальному файлам конфигурации (Legacy API).
+        
+        Для получения всех путей (включая env) используйте get_all_config_paths().
+        """
+        main, _, local = self.get_all_config_paths(cfg_file)
+        return main, local
+
+    def get_all_config_paths(self, cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str], Optional[str]]:
         """
         Возвращает пути к основному, специфичному для окружения и локальному файлам конфигурации.
         """

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/config/schema.py

@@ -7,19 +7,24 @@ import json
 from pathlib import Path
 from typing import Optional, Type, Union
 
-try:
-    from pydantic import BaseModel
+from ..env import PYDANTIC_AVAILABLE
 
-    PYDANTIC_AVAILABLE = True
-except ImportError:
+if PYDANTIC_AVAILABLE:
+    try:
+        from pydantic import BaseModel
+    except ImportError:
+        # Редкий случай рассинхрона
+        PYDANTIC_AVAILABLE = False
+
+
+        class BaseModel:  # type: ignore
+            pass
+else:
     class BaseModel:  # type: ignore
         """Заглушка для работы без Pydantic."""
         pass
 
 
-    PYDANTIC_AVAILABLE = False
-
-
 def _check_pydantic() -> None:
     """Проверяет наличие Pydantic."""
     if not PYDANTIC_AVAILABLE:

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/config/watcher.py

@@ -4,8 +4,10 @@ from pathlib import Path
 from typing import List, Callable
 
 from chutils.exceptions import OptionalDependencyError
+
 from .manager import _cm
 from .utils import find_project_root
+from .. import env
 
 # Настраиваем логгер
 logger = logging.getLogger(__name__)
@@ -82,15 +84,15 @@ def start_config_watcher() -> bool:
     Raises:
         OptionalDependencyError: Если пакет `watchdog` не установлен.
     """
-    try:
-        from watchdog.observers import Observer
-    except ImportError:
+    if not env.WATCHDOG_AVAILABLE:
         raise OptionalDependencyError(
             "Пакет 'watchdog' необходим для работы hot-reload. "
             "Установите его с помощью 'pip install chutils[watch]' или 'poetry add watchdog'.",
             dependency="watchdog"
         )
 
+    from watchdog.observers import Observer
+
     if _cm.observer and _cm.observer.is_alive():
         logger.debug("Watcher конфигурации уже запущен.")
         return True
@@ -98,7 +100,7 @@ def start_config_watcher() -> bool:
     if not _cm.paths_initialized:
         _cm.initialize_paths(find_project_root)
 
-    main_path, env_path, local_path = _cm.get_config_paths()
+    main_path, env_path, local_path = _cm.get_all_config_paths()
     files_to_watch = []
     if main_path and Path(main_path).exists():
         files_to_watch.append(main_path)

chutils-2.7.2/src/chutils/env.py

@@ -0,0 +1,48 @@
+import importlib.util
+import os
+
+
+# --- Проверка доступности внешних библиотек (Discovery) ---
+
+def _is_installed(package_name: str) -> bool:
+    """Проверяет наличие пакета в системе без его импорта."""
+    return importlib.util.find_spec(package_name) is not None
+
+
+RICH_AVAILABLE = _is_installed("rich")
+PYDANTIC_AVAILABLE = _is_installed("pydantic")
+WATCHDOG_AVAILABLE = _is_installed("watchdog")
+JSON_LOGGER_AVAILABLE = _is_installed("pythonjsonlogger")
+OTEL_AVAILABLE = _is_installed("opentelemetry.trace")
+
+
+def is_rich_enabled() -> bool:
+    """
+    Централизованная проверка: доступен ли Rich и разрешен ли он настройками.
+    
+    Учитывает:
+    - Наличие установленного пакета rich.
+    - Переменные окружения NO_COLOR, CH_NO_COLOR.
+    - Специальную переменную CH_NO_RICH (для тестов и headless).
+    """
+    if not RICH_AVAILABLE:
+        return False
+
+    no_color = os.getenv("NO_COLOR", "").lower() in ["true", "1", "yes", "y"]
+    ch_no_color = os.getenv("CH_NO_COLOR", "").lower() in ["true", "1", "yes", "y"]
+    ch_no_rich = os.getenv("CH_NO_RICH", "").lower() in ["true", "1", "yes", "y"]
+
+    return not (no_color or ch_no_color or ch_no_rich)
+
+
+def is_otel_enabled() -> bool:
+    """Проверяет, доступен ли OpenTelemetry и не отключен ли он.
+
+    Учитывает:
+    - Наличие установленного пакета opentelemetry.
+    - Переменную окружения CH_DISABLE_TRACING
+    """
+    if not OTEL_AVAILABLE:
+        return False
+
+    return os.getenv("CH_DISABLE_TRACING", "").lower() not in ["true", "1", "yes", "y"]

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/logger/core.py

@@ -26,7 +26,7 @@ from .masking import (
     _update_mask_re,
     PREDEFINED_PATTERNS
 )
-from .. import config
+from .. import config, env
 from ..context import ContextFilter
 
 # --- Глобальное состояние для асинхронного логирования ---
@@ -50,32 +50,6 @@ def _stop_all_async_loggers():
 
 atexit.register(_stop_all_async_loggers)
 
-# --- Опциональная интеграция с Rich ---
-
-RICH_AVAILABLE = False
-try:
-    from rich.logging import RichHandler
-    from rich.console import Console
-
-    RICH_AVAILABLE = True
-except ImportError:
-    pass
-
-
-def is_rich_enabled() -> bool:
-    """
-    Проверяет, доступен ли Rich и не отключены ли цвета через переменные окружения.
-    """
-    if not RICH_AVAILABLE:
-        return False
-
-    # Проверка стандартных переменных отключения цвета
-    no_color = os.getenv("NO_COLOR", "").lower() in ["true", "1", "yes", "y"]
-    ch_no_color = os.getenv("CH_NO_COLOR", "").lower() in ["true", "1", "yes", "y"]
-
-    return not (no_color or ch_no_color)
-
-
 # --- Пользовательские уровни логирования ---
 
 DEVDEBUG_LEVEL_NUM = 9
@@ -404,8 +378,11 @@ def setup_logger(
     else:
         formatter = logging.Formatter(log_format)
 
-    if is_rich_enabled() and not final_json_format:
+    if env.is_rich_enabled() and not final_json_format:
+        from rich.logging import RichHandler
+        from chutils.cli_utils import get_console
         console_handler = RichHandler(
+            console=get_console(stderr=True),
             rich_tracebacks=True,
             markup=True,
             tracebacks_show_locals=True,

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/logger/formatters.py

@@ -2,16 +2,24 @@
 Форматтеры для логов.
 """
 
-try:
+from chutils.env import JSON_LOGGER_AVAILABLE
+
+if JSON_LOGGER_AVAILABLE:
     try:
-        from pythonjsonlogger import json as json_mod
+        try:
+            from pythonjsonlogger import json as json_mod
 
-        jsonlogger = json_mod
+            jsonlogger = json_mod
+        except ImportError:
+            from pythonjsonlogger import jsonlogger
     except ImportError:
-        from pythonjsonlogger import jsonlogger
-    JSON_LOGGER_AVAILABLE = True
-
+        # Редкий случай, когда spec найден, но импорт не удался
+        JSON_LOGGER_AVAILABLE = False
+else:
+    ChutilsJsonFormatter = None
+    jsonlogger = None
 
+if JSON_LOGGER_AVAILABLE:
     class ChutilsJsonFormatter(jsonlogger.JsonFormatter):
         """
         Кастомный JSON-форматтер, который группирует контекстные данные
@@ -40,6 +48,5 @@ try:
                 log_record['trace_id'] = record.trace_id
             if 'span_id' not in log_record and hasattr(record, 'span_id'):
                 log_record['span_id'] = record.span_id
-
-except ImportError:
-    JSON_LOGGER_AVAILABLE = False
+else:
+    ChutilsJsonFormatter = None

{chutils-2.7.0 → chutils-2.7.2}/src/chutils/tracing.py

@@ -9,15 +9,21 @@ import functools
 import inspect
 from typing import Any, Callable, Optional, TypeVar, cast
 
+from .env import OTEL_AVAILABLE
+
 T = TypeVar("T", bound=Callable[..., Any])
 
-try:
-    from opentelemetry import trace as otel_trace
+# Совместимость с внутренним кодом
+IS_OTEL_AVAILABLE = OTEL_AVAILABLE
 
-    IS_OTEL_AVAILABLE = True
-except ImportError:
+if IS_OTEL_AVAILABLE:
+    try:
+        from opentelemetry import trace as otel_trace
+    except ImportError:
+        otel_trace = None  # type: ignore
+        IS_OTEL_AVAILABLE = False
+else:
     otel_trace = None  # type: ignore
-    IS_OTEL_AVAILABLE = False
 
 
 def get_tracer(name: str = "chutils") -> Any: