oe-python-template 0.10.1__py3-none-any.whl → 0.10.3__py3-none-any.whl

oe_python_template/hello/_service.py

@@ -23,7 +23,7 @@ class Service(BaseService):
 
     def __init__(self) -> None:
         """Initialize service."""
-        super().__init__(Settings)
+        super().__init__(Settings)  # automatically loads and validates the settings
 
     def info(self) -> dict[str, Any]:  # noqa: PLR6301
         """Determine info of this service.

oe_python_template/system/__init__.py

@@ -3,9 +3,11 @@
 from ._api import api_routers
 from ._cli import cli
 from ._service import Service
+from ._settings import Settings
 
 __all__ = [
     "Service",
+    "Settings",
     "api_routers",
     "cli",
 ]

oe_python_template/system/_api.py

@@ -7,7 +7,7 @@ The endpoints use Pydantic models for request and response validation.
 """
 
 from collections.abc import Callable, Generator
-from typing import Annotated
+from typing import Annotated, Any
 
 from fastapi import APIRouter, Depends, Response, status
 
@@ -41,11 +41,11 @@ def register_health_endpoint(router: APIRouter) -> Callable[..., Health]:
     """
 
     @router.get("/healthz")
-    @router.get("/health")
+    @router.get("/system/health")
     def health_endpoint(service: Annotated[Service, Depends(get_service)], response: Response) -> Health:
         """Determine aggregate health of the system.
 
-        The health is aggregated from all modules that make
+        The health is aggregated from all modules making
             up this system including external dependencies.
 
         The response is to be interpreted as follows:
@@ -71,8 +71,46 @@ def register_health_endpoint(router: APIRouter) -> Callable[..., Health]:
     return health_endpoint
 
 
+def register_info_endpoint(router: APIRouter) -> Callable[..., dict[str, Any]]:
+    """Register info endpoint to the given router.
+
+    Args:
+        router: The router to register the info endpoint to.
+
+    Returns:
+        Callable[..., Health]: The health endpoint function.
+    """
+
+    @router.get("/system/info")
+    def info_endpoint(
+        service: Annotated[Service, Depends(get_service)], response: Response, token: str
+    ) -> dict[str, Any]:
+        """Determine aggregate info of the system.
+
+        The info is aggregated from all modules making up this system.
+
+        If the token does not match the setting, a 403 Forbidden status code is returned.
+
+        Args:
+            service (Service): The service instance.
+            response (Response): The FastAPI response object.
+            token (str): Token to present.
+
+        Returns:
+            dict[str, Any]: The aggregate info of the system.
+        """
+        if service.is_token_valid(token):
+            return service.info(include_environ=True, filter_secrets=False)
+
+        response.status_code = status.HTTP_403_FORBIDDEN
+        return {"error": "Forbidden"}
+
+    return info_endpoint
+
+
 api_routers = {}
 for version in API_VERSIONS:
     router = VersionedAPIRouter(version, tags=["system"])
     api_routers[version] = router
     health = register_health_endpoint(api_routers[version])
+    info = register_info_endpoint(api_routers[version])

oe_python_template/system/_service.py

@@ -11,6 +11,7 @@ from typing import Any
 from pydantic_settings import BaseSettings
 
 from ..utils import (  # noqa: TID252
+    UNHIDE_SENSITIVE_INFO,
     BaseService,
     Health,
     __env__,
@@ -18,18 +19,24 @@ from ..utils import (  # noqa: TID252
     __project_path__,
     __repository_url__,
     __version__,
+    get_logger,
     get_process_info,
     load_settings,
     locate_subclasses,
 )
+from ._settings import Settings
+
+logger = get_logger(__name__)
 
 
 class Service(BaseService):
     """System service."""
 
+    _settings: Settings
+
     def __init__(self) -> None:
         """Initialize service."""
-        super().__init__()
+        super().__init__(Settings)
 
     @staticmethod
     def _is_healthy() -> bool:
@@ -60,6 +67,18 @@ class Service(BaseService):
         reason = None if self._is_healthy() else "System marked as unhealthy"
         return Health(status=status, components=components, reason=reason)
 
+    def is_token_valid(self, token: str) -> bool:
+        """Check if the presented token is valid.
+
+        Returns:
+            bool: True if the token is valid, False otherwise.
+        """
+        logger.info(token)
+        if not self._settings.token:
+            logger.warning("Token is not set in settings.")
+            return False
+        return token == self._settings.token.get_secret_value()
+
     @staticmethod
     def info(include_environ: bool = False, filter_secrets: bool = True) -> dict[str, Any]:
         """
@@ -126,7 +145,7 @@ class Service(BaseService):
         for settings_class in locate_subclasses(BaseSettings):
             settings_instance = load_settings(settings_class)
             env_prefix = settings_instance.model_config.get("env_prefix", "")
-            settings_dict = json.loads(settings_instance.model_dump_json())
+            settings_dict = settings_instance.model_dump(context={UNHIDE_SENSITIVE_INFO: not filter_secrets})
             for key, value in settings_dict.items():
                 flat_key = f"{env_prefix}{key}".upper()
                 settings[flat_key] = value

oe_python_template/system/_settings.py

@@ -0,0 +1,31 @@
+"""Settings of the system module."""
+
+from typing import Annotated
+
+from pydantic import Field, PlainSerializer, SecretStr
+from pydantic_settings import SettingsConfigDict
+
+from ..utils import OpaqueSettings, __env_file__, __project_name__  # noqa: TID252
+
+
+class Settings(OpaqueSettings):
+    """Settings."""
+
+    model_config = SettingsConfigDict(
+        env_prefix=f"{__project_name__.upper()}_SYSTEM_",
+        extra="ignore",
+        env_file=__env_file__,
+        env_file_encoding="utf-8",
+    )
+
+    token: Annotated[
+        SecretStr | None,
+        PlainSerializer(func=OpaqueSettings.serialize_sensitive_info, return_type=str, when_used="always"),
+        Field(
+            description=(
+                "Secret token to present when performing sensitive operations such as "
+                "retrieving info via webservice API"
+            ),
+            default=None,
+        ),
+    ]

oe_python_template/utils/__init__.py

@@ -23,15 +23,17 @@ from ._logfire import LogfireSettings
 from ._process import ProcessInfo, get_process_info
 from ._sentry import SentrySettings
 from ._service import BaseService
-from ._settings import load_settings
+from ._settings import UNHIDE_SENSITIVE_INFO, OpaqueSettings, load_settings
 from .boot import boot
 
 __all__ = [
+    "UNHIDE_SENSITIVE_INFO",
     "BaseService",
     "Health",
     "LogSettings",
     "LogSettings",
     "LogfireSettings",
+    "OpaqueSettings",
     "ProcessInfo",
     "SentrySettings",
     "VersionedAPIRouter",

oe_python_template/utils/_constants.py

@@ -10,7 +10,7 @@ __project_path__ = str(Path(__file__).parent.parent.parent)
 __version__ = metadata.version(__project_name__)
 __is_development_mode__ = "uvx" not in sys.argv[0].lower()
 __is_running_in_container__ = os.getenv(f"{__project_name__.upper()}_RUNNING_IN_CONTAINER")
-__env__ = os.getenv("ENV", "local")
+__env__ = os.getenv("ENV", os.getenv("VERCEL_ENV", "local"))
 __env_file__ = [
     Path.home() / f".{__project_name__}" / ".env",
     Path.home() / f".{__project_name__}" / f".env.{__env__}",

oe_python_template/utils/_logfire.py

@@ -3,14 +3,14 @@
 from typing import Annotated
 
 import logfire
-from pydantic import Field, SecretStr
-from pydantic_settings import BaseSettings, SettingsConfigDict
+from pydantic import Field, PlainSerializer, SecretStr
+from pydantic_settings import SettingsConfigDict
 
 from ._constants import __env__, __env_file__, __project_name__, __repository_url__, __version__
-from ._settings import load_settings
+from ._settings import OpaqueSettings, load_settings
 
 
-class LogfireSettings(BaseSettings):
+class LogfireSettings(OpaqueSettings):
     """Configuration settings for Logfire integration."""
 
     model_config = SettingsConfigDict(
@@ -22,6 +22,7 @@ class LogfireSettings(BaseSettings):
 
     token: Annotated[
         SecretStr | None,
+        PlainSerializer(func=OpaqueSettings.serialize_sensitive_info, return_type=str, when_used="always"),
         Field(description="Logfire token. Leave empty to disable logfire.", examples=["YOUR_TOKEN"], default=None),
     ]
     instrument_system_metrics: Annotated[

oe_python_template/utils/_sentry.py

@@ -3,15 +3,15 @@
 from typing import Annotated
 
 import sentry_sdk
-from pydantic import Field, SecretStr
-from pydantic_settings import BaseSettings, SettingsConfigDict
+from pydantic import Field, PlainSerializer, SecretStr
+from pydantic_settings import SettingsConfigDict
 from sentry_sdk.integrations.typer import TyperIntegration
 
 from ._constants import __env__, __env_file__, __project_name__, __version__
-from ._settings import load_settings
+from ._settings import OpaqueSettings, load_settings
 
 
-class SentrySettings(BaseSettings):
+class SentrySettings(OpaqueSettings):
     """Configuration settings for Sentry integration."""
 
     model_config = SettingsConfigDict(
@@ -23,6 +23,7 @@ class SentrySettings(BaseSettings):
 
     dsn: Annotated[
         SecretStr | None,
+        PlainSerializer(func=OpaqueSettings.serialize_sensitive_info, return_type=str, when_used="always"),
         Field(description="Sentry DSN", examples=["https://SECRET@SECRET.ingest.de.sentry.io/SECRET"], default=None),
     ]
 

oe_python_template/utils/_settings.py

@@ -6,7 +6,7 @@ import sys
 from pathlib import Path
 from typing import TypeVar
 
-from pydantic import ValidationError
+from pydantic import FieldSerializationInfo, SecretStr, ValidationError
 from pydantic_settings import BaseSettings
 from rich.panel import Panel
 from rich.text import Text
@@ -17,6 +17,18 @@ T = TypeVar("T", bound=BaseSettings)
 
 logger = logging.getLogger(__name__)
 
+UNHIDE_SENSITIVE_INFO = "unhide_sensitive_info"
+
+
+class OpaqueSettings(BaseSettings):
+    @staticmethod
+    def serialize_sensitive_info(input_value: SecretStr, info: FieldSerializationInfo) -> str | None:
+        if not input_value:
+            return None
+        if info.context.get(UNHIDE_SENSITIVE_INFO, False):  # type: ignore
+            return input_value.get_secret_value()
+        return str(input_value)
+
 
 def load_settings(settings_class: type[T]) -> T:
     """

{oe_python_template-0.10.1.dist-info → oe_python_template-0.10.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oe-python-template
-Version: 0.10.1
+Version: 0.10.3
 Summary: 🧠 Copier template to scaffold Python projects compliant with best practices and modern tooling.
 Project-URL: Homepage, https://oe-python-template.readthedocs.io/en/latest/
 Project-URL: Documentation, https://oe-python-template.readthedocs.io/en/latest/

{oe_python_template-0.10.1.dist-info → oe_python_template-0.10.3.dist-info}/RECORD

@@ -7,28 +7,29 @@ oe_python_template/hello/_api.py,sha256=hWWlEDUfFY1se2ZzhqGMfPyD3FPwuA-YzxG9Q9z4
 oe_python_template/hello/_cli.py,sha256=mSNmRj_VRoRfCAR1I8tssZqZCTmT6jgzsNWrTtlFP7Y,1184
 oe_python_template/hello/_constants.py,sha256=6aRleAIcdgC13TeTzI07YwjoSwqGb2g131dw8aEoM4I,109
 oe_python_template/hello/_models.py,sha256=JtI7wGT72u23NOxFa-oeWzdyiMg7PnHL5eg22im2_yQ,574
-oe_python_template/hello/_service.py,sha256=-rUlt54EAafMhLSo-IBsWMe6mjLTIlYfhxCFKVl8C8s,3004
+oe_python_template/hello/_service.py,sha256=zI5lXKdI28D1uIqY0phecnlJPxCrwtQVO6d7w1HstS8,3054
 oe_python_template/hello/_settings.py,sha256=1z77_B4pWFx_ag9EasgUM01MjKeBwiAhnkhL9XjlR9I,984
-oe_python_template/system/__init__.py,sha256=u6UcW5_-5hT1Iqlv2NrDGW2QYVCryu2_bDkJKxl9z-c,379
-oe_python_template/system/_api.py,sha256=-uorLNHyDHKll9IUp_1fadMQ-BATXTK33gdmfflTaWo,2444
+oe_python_template/system/__init__.py,sha256=NNgODkr7AyJjTTJiv3pys7o2z6xi1G96g0vnsxVhlI4,427
+oe_python_template/system/_api.py,sha256=rE9Aau3IIHXdEkOBUXOwJ7SxN3cZpgtYEuojnSWfT_4,3687
 oe_python_template/system/_cli.py,sha256=J_4upBBdbSxbONPYmOZPbuhZcKjfnPIUeZpp0L7lY-Q,4846
-oe_python_template/system/_service.py,sha256=PSM22bV-0MYnh3KI41z0UiGhzWpvJBBMzFflwrRMw4U,5513
-oe_python_template/utils/__init__.py,sha256=XCu2HmU4JHzd4h5wU9lwNI7CSt1uf9sSh358RTtGAF0,1359
+oe_python_template/system/_service.py,sha256=G8Us2ez4MF7NWdWOUBbcxaVT3dpM-QZ_dP9b_1MkjIQ,6093
+oe_python_template/system/_settings.py,sha256=MwMAJYifJ6jGImeSh4e9shmIXmiUSuQGHXz_Ts0mSdk,901
+oe_python_template/utils/__init__.py,sha256=rHdmSS21CtvF3AXPMSCZO17FTzxPDo-NiKZ5AjVU9b0,1449
 oe_python_template/utils/_api.py,sha256=w3hPQK1pL2gBI4_1qNWNa2b4S_oH-8mY-ckRX0KrCWM,617
 oe_python_template/utils/_cli.py,sha256=J_mFtXZ1gGeovGrE5i3wlokTOBfiTTKEz5magiRP7GA,2091
 oe_python_template/utils/_console.py,sha256=u0-utcdRmVu4rabrYUyNOx8yPxLhxB3E92m22kSCwPQ,293
-oe_python_template/utils/_constants.py,sha256=72gJp53wLIyorzGXdA1h6alXmaUWpvEVOXZ8EJ1HOIA,1712
+oe_python_template/utils/_constants.py,sha256=1ocbciHjhmy66uHrTw6p-fbBq_wLl1HaUSu4oTgt8mo,1737
 oe_python_template/utils/_di.py,sha256=KdjiD4xZ_QSfbddkKWwsPJmG5YrIg6dzuBrlsd-FhxA,2189
 oe_python_template/utils/_health.py,sha256=35QOWe2r5InrEpGtuVMym9dI5aRHS0HWf4BHBRAUIj0,4102
 oe_python_template/utils/_log.py,sha256=ZW4gs540SdjVK-2KeheLfDY15d_3xpO5FyGn7wTXyaM,3592
-oe_python_template/utils/_logfire.py,sha256=zLkrgukvJpPZ8vQpawgDViPMMWza1APFlIIlKVny_ak,1893
+oe_python_template/utils/_logfire.py,sha256=g2tR60XgpdRs_UwDpqkwWm6ErUBcV7lPFBJdvgfTuu0,2022
 oe_python_template/utils/_process.py,sha256=40R0NZMqJUn0iUPERzohSUpJgU1HcJApIg1HipIxFCw,941
-oe_python_template/utils/_sentry.py,sha256=ChSvJu-B_oby5F6oqycJ6McYzy15jRj9yZgG5apOsY4,2999
+oe_python_template/utils/_sentry.py,sha256=Y4hZ-PeBOdR3iRhoXW9j0tbWsYf07460UG8OVTKH1mU,3128
 oe_python_template/utils/_service.py,sha256=atHAejvBucKXjzhsMSdOBBFa7rRD74zcV70Pp0pl0Tg,1038
-oe_python_template/utils/_settings.py,sha256=lA47dtwMHgO62j3R6i1W7sTidrQwVNloOGGxbS2rz6Q,1843
+oe_python_template/utils/_settings.py,sha256=5K1pnp-AxMQbktREb3bXDmqgrOx_L4EJIgjPQfqH4sE,2294
 oe_python_template/utils/boot.py,sha256=TBgmqbtIryQz0cAozYzxhYQRIldfbJ6v9R-rH6sO9mY,2696
-oe_python_template-0.10.1.dist-info/METADATA,sha256=2rP1g7b8hqv0W2yGu0GEXgn4zjSQE552F7GH7aV2-HI,31916
-oe_python_template-0.10.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-oe_python_template-0.10.1.dist-info/entry_points.txt,sha256=IroSSWhLGxus9rxcashkYQda39TTvf7LbUMYtOKXUBE,66
-oe_python_template-0.10.1.dist-info/licenses/LICENSE,sha256=5H409K6xzz9U5eUaoAHQExNkoWJRlU0LEj6wL2QJ34s,1113
-oe_python_template-0.10.1.dist-info/RECORD,,
+oe_python_template-0.10.3.dist-info/METADATA,sha256=lembvVaYyUa62VqmgNc_Zd1w6Twfo_9V0BWsX4t6OT8,31916
+oe_python_template-0.10.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+oe_python_template-0.10.3.dist-info/entry_points.txt,sha256=IroSSWhLGxus9rxcashkYQda39TTvf7LbUMYtOKXUBE,66
+oe_python_template-0.10.3.dist-info/licenses/LICENSE,sha256=5H409K6xzz9U5eUaoAHQExNkoWJRlU0LEj6wL2QJ34s,1113
+oe_python_template-0.10.3.dist-info/RECORD,,