pydantic-settings-helper 0.1.0__py3-none-any.whl

pydantic_settings_helper/__init__.py

@@ -0,0 +1,47 @@
+from pydantic import Field, ValidationError
+from pydantic_settings import BaseSettings
+
+
+class PydanticSettingsSetupError(RuntimeError):
+    """Custom exception for Pydantic settings setup errors."""
+
+    def __init__(self, message: str, original_exception: ValidationError | None = None):
+        super().__init__(message)
+        self.message = message
+        self.original_exception = original_exception
+
+
+def load_settings[SettingsClass: type[BaseSettings]](
+    settings_class: SettingsClass,
+) -> SettingsClass:
+    model_config = settings_class.model_config
+    env_prefix = model_config.get("env_prefix")
+    cli_prefix = model_config.get("cli_prefix")
+    try:
+        return settings_class()
+    except ValidationError as exc:
+        lines = ["\nConfiguration error — missing values:\n"]
+        for err in exc.errors():
+            error_location: tuple[int | str, ...] = err["loc"]
+            full_error_location = ".".join(
+                str(error_location_part) for error_location_part in error_location
+            )
+            env_var = f"{env_prefix}{full_error_location.replace('.', '_').upper()}"
+            cli_flag = f"--{cli_prefix}{full_error_location.replace('.', '-')}"
+            lines.append(
+                f" • `{full_error_location}` → set via ${env_var!r} or `{cli_flag}`"
+            )
+        raise PydanticSettingsSetupError("\n".join(lines), exc)
+
+
+def SettingsSubModel(
+    *args,
+    **kwargs,
+):
+    """A wrapper for Field to create a settings sub-model."""
+    return Field(
+        *args,
+        default_factory=dict,
+        validate_default=True,
+        **kwargs,
+    )

pydantic_settings_helper-0.1.0.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: pydantic-settings-helper
+Version: 0.1.0
+Summary: Add your description here
+Author-email: Sygmei <3835355+Sygmei@users.noreply.github.com>
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: pydantic-settings>=2.9.1
+Requires-Dist: pydantic>=2.11.3
+Description-Content-Type: text/markdown
+
+# pydantic-settings-helper
+Little helper for pydantic-settings to improve error message and nesting

pydantic_settings_helper-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+pydantic_settings_helper/__init__.py,sha256=GogD46WliYH73XshssfALNme2zxzPbeZx4ycKj8mDec,1629
+pydantic_settings_helper-0.1.0.dist-info/METADATA,sha256=uprhtOqNMeJDbJ_U78wef8BcU0NYbln--PMwSMPSCP4,425
+pydantic_settings_helper-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pydantic_settings_helper-0.1.0.dist-info/entry_points.txt,sha256=Ml0SXc-npTX_UMQoafN57CyOxgXof26kOe9kYwXDKKI,75
+pydantic_settings_helper-0.1.0.dist-info/licenses/LICENSE,sha256=rJuVDmpsbuFanqGEGWPHTuiLeH7vSw_UGZRuqju20HE,1084
+pydantic_settings_helper-0.1.0.dist-info/RECORD,,

pydantic_settings_helper-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

pydantic_settings_helper-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pydantic-settings-helper = pydantic_settings_helper:main

pydantic_settings_helper-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sygmei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.