add

2026-10-15 20:36:59 +08:00
commit 6bf949949c
7923 changed files with 1369582 additions and 0 deletions
@@ -0,0 +1,46 @@
+import logging
+import os
+import types
+from pathlib import Path
+from typing import Any, _Final, _GenericAlias  # type: ignore [attr-defined]
+
+logger = logging.getLogger('pydantic_settings')
+
+_DEBUG_ENV_VAR = 'PYDANTIC_SETTINGS_DEBUG'
+
+
+def _settings_debug_enabled() -> bool:
+    """Whether settings source debugging is enabled via the `PYDANTIC_SETTINGS_DEBUG` env var."""
+    return os.environ.get(_DEBUG_ENV_VAR, '').strip().lower() in ('1', 'true', 'yes', 'on')
+
+
+_PATH_TYPE_LABELS: tuple[tuple[str, str], ...] = (
+    ('is_dir', 'directory'),
+    ('is_file', 'file'),
+    ('is_mount', 'mount point'),
+    ('is_symlink', 'symlink'),
+    ('is_block_device', 'block device'),
+    ('is_char_device', 'char device'),
+    ('is_fifo', 'FIFO'),
+    ('is_socket', 'socket'),
+)
+
+
+def path_type_label(p: Path) -> str:
+    """
+    Find out what sort of thing a path is.
+    """
+    assert p.exists(), 'path does not exist'
+    for method_name, name in _PATH_TYPE_LABELS:
+        if getattr(p, method_name)():
+            return name
+
+    return 'unknown'  # pragma: no cover
+
+
+def _lenient_issubclass(cls: Any, class_or_tuple: Any) -> bool:
+    return isinstance(cls, type) and issubclass(cls, class_or_tuple)
+
+
+_WithArgsTypes = (_GenericAlias, types.GenericAlias, types.UnionType)
+_typing_base: Any = _Final  # pyright: ignore[reportAttributeAccessIssue]