chutils 2.6.0__tar.gz → 2.6.1__tar.gz

{chutils-2.6.0 → chutils-2.6.1}/PKG-INFO

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

{chutils-2.6.0 → chutils-2.6.1}/pyproject.toml

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

{chutils-2.6.0 → chutils-2.6.1}/src/chutils/config/__init__.py

@@ -23,7 +23,7 @@ import os
 import time
 import warnings
 from pathlib import Path
-from typing import Any, Optional, List, Dict, TYPE_CHECKING, TypeVar, Type, overload, Union
+from typing import Any, Optional, List, Dict, TYPE_CHECKING, TypeVar, Type, overload, Union, Tuple
 
 from .manager import _cm
 from .providers import get_providers
@@ -69,25 +69,30 @@ def __getattr__(name: str) -> Any:
     в новый менеджер состояния с выводом предупреждения об устаревании.
     """
     remap = {
-        '_BASE_DIR': 'base_dir',
-        '_CONFIG_FILE_PATH': 'config_file_path',
-        '_paths_initialized': 'paths_initialized',
-        '_config_object': 'config_object',
-        '_config_loaded': 'config_loaded'
+        '_BASE_DIR': ('base_dir', 'get_base_dir()'),
+        '_CONFIG_FILE_PATH': ('config_file_path', 'get_config_file_path()'),
+        '_paths_initialized': ('paths_initialized', 'are_paths_initialized()'),
+        '_config_object': ('config_object', 'get_config()'),
+        '_config_loaded': ('config_loaded', 'is_config_loaded()'),
+        '_get_config_paths': ('get_config_paths', 'get_config_paths()')
     }
+    "Словарь соответствия: имя -> (атрибут в _cm, рекомендуемая публичная замена)"
 
     if name in remap:
-        warnings.warn(
-            f"Прямое обращение к 'chutils.config.{name}' устарело и будет удалено в будущих версиях. "
-            f"Используйте публичный API модуля.",
-            DeprecationWarning,
-            stacklevel=2
-        )
+        cm_attr, suggestion = remap[name]
+        msg = f"Прямое обращение к 'chutils.config.{name}' устарело и будет удалено в будущих версиях."
+        if suggestion:
+            msg += f" Используйте {suggestion}."
+        else:
+            msg += " Используйте публичный API модуля."
+
+        warnings.warn(msg, DeprecationWarning, stacklevel=2)
+
         # Если пути еще не инициализированы, инициализируем их при первом обращении
-        if name in ['_BASE_DIR', '_CONFIG_FILE_PATH'] and not _cm.paths_initialized:
+        if name in ['_BASE_DIR', '_CONFIG_FILE_PATH', '_get_config_paths'] and not _cm.paths_initialized:
             _cm.initialize_paths(find_project_root)
 
-        return getattr(_cm, remap[name])
+        return getattr(_cm, cm_attr)
 
     raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
 
@@ -158,6 +163,31 @@ def is_config_loaded() -> bool:
     return _cm.config_loaded
 
 
+def are_paths_initialized() -> bool:
+    """
+    Проверяет, были ли инициализированы пути к проекту и файлам конфигурации.
+
+    Returns:
+        True, если пути определены.
+    """
+    return _cm.paths_initialized
+
+
+def get_config_paths(cfg_file: Optional[str] = None) -> Tuple[Optional[str], Optional[str]]:
+    """
+    Возвращает пути к основному и локальному файлам конфигурации.
+
+    Args:
+        cfg_file: Опциональный путь к основному файлу.
+
+    Returns:
+        Кортеж (путь_к_основному, путь_к_локальному).
+    """
+    if not _cm.paths_initialized:
+        _cm.initialize_paths(find_project_root)
+    return _cm.get_config_paths(cfg_file)
+
+
 def _check_pydantic():
     """Проверяет наличие установленного пакета pydantic."""
     try:
@@ -597,6 +627,21 @@ def get_config_path(
 
     # Если путь относительный, _BASE_DIR определен и resolve_from_root включен, объединяем их
     if resolve_from_root and not path_obj.is_absolute() and base_dir:
-        return str(Path(base_dir) / path_obj)
+        # Безопасное разрешение пути с проверкой на выход за пределы корня проекта (Path Traversal)
+        try:
+            base_dir_obj = Path(base_dir).resolve()
+            resolved_path = (base_dir_obj / path_obj).resolve()
+
+            # Проверяем, что итоговый путь находится внутри базовой директории
+            if not str(resolved_path).startswith(str(base_dir_obj)):
+                _get_logger().warning(
+                    "Обнаружена попытка выхода за пределы корня проекта (Path Traversal). "
+                    "Путь '%s' отклонен. Возвращено значение по умолчанию.", path_str
+                )
+                return fallback
+            return str(resolved_path)
+        except Exception as e:
+            _get_logger().error("Ошибка при разрешении пути '%s': %s", path_str, e)
+            return fallback
 
     return path_str