oe-python-template 0.10.5__tar.gz → 0.10.7__tar.gz

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oe-python-template
-Version: 0.10.5
+Version: 0.10.7
 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/
@@ -101,7 +101,7 @@ Description-Content-Type: text/markdown
 [![Copier](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template)
 [![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2ZmZiIgZD0iTTE3IDE2VjdsLTYgNU0yIDlWOGwxLTFoMWw0IDMgOC04aDFsNCAyIDEgMXYxNGwtMSAxLTQgMmgtMWwtOC04LTQgM0gzbC0xLTF2LTFsMy0zIi8+PC9zdmc+)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template)
 [![Open in GitHub Codespaces](https://img.shields.io/static/v1?label=GitHub%20Codespaces&message=Open&color=blue&logo=github)](https://github.com/codespaces/new/helmut-hoffer-von-ankershoffen/oe-python-template)
-[![Vercel Deploy](https://deploy-badge.vercel.app/vercel/oe-python-template?root=docs)](https://oe-python-template.vercel.app/docs)
+[![Vercel Deploy](https://deploy-badge.vercel.app/vercel/oe-python-template?root=docs)](https://oe-python-template.vercel.app/api/v1/hello/world)
 [![Better Stack Uptime](https://uptime.betterstack.com/status-badges/v1/monitor/1vze5.svg)](https://helmut-hoffer-von-ankershoffen.betteruptime.com/)
 
 <!---
@@ -160,7 +160,7 @@ Projects generated with this template come with a comprehensive development tool
 
 Beyond development tooling, projects generated with this template include the code, documentation, and configuration of a fully functioning application and service. This reference implementation serves as a starting point for your own business logic with modern patterns and enterprise practices already in place:
 
-1. Usable as library with "Hello" module exposing a simple service
+1. Usable as library with "Hello" module exposing a simple service that can say "Hello, world!" and echo utterances.
 2. Command-line interface (CLI) with [Typer](https://typer.tiangolo.com/)
 3. Versioned webservice API with [FastAPI](https://fastapi.tiangolo.com/)
 4. [Interactive Jupyter notebook](https://jupyter.org/) and [reactive Marimo notebook](https://marimo.io/)
@@ -170,8 +170,9 @@ Beyond development tooling, projects generated with this template include the co
 8. Info command enabling to inspect the runtime, compiled settings, and further info provided dynamically by modules
 9. Health endpoint exposing system health dynamically aggregated from all modules and dependencies
 10. Flexible logging and instrumentation, including support for [Sentry](https://sentry.io/) and [Logfire](https://logfire.dev/) 
-11. Modular architecture including auto-registration of services, CLI commands and API routes exposed by modules
-12. Documentation including dynamic badges, setup instructions, contribution guide and security policy
+11. Hello service demonstrates use of custom real time metrics collected via Logfire
+12. Modular architecture including auto-registration of services, CLI commands and API routes exposed by modules
+13. Documentation including dynamic badges, setup instructions, contribution guide and security policy
 
 Explore [here](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example) for what's generated out of the box.
 

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/README.md

@@ -28,7 +28,7 @@
 [![Copier](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json)](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template)
 [![Open in Dev Containers](https://img.shields.io/static/v1?label=Dev%20Containers&message=Open&color=blue&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI2ZmZiIgZD0iTTE3IDE2VjdsLTYgNU0yIDlWOGwxLTFoMWw0IDMgOC04aDFsNCAyIDEgMXYxNGwtMSAxLTQgMmgtMWwtOC04LTQgM0gzbC0xLTF2LTFsMy0zIi8+PC9zdmc+)](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template)
 [![Open in GitHub Codespaces](https://img.shields.io/static/v1?label=GitHub%20Codespaces&message=Open&color=blue&logo=github)](https://github.com/codespaces/new/helmut-hoffer-von-ankershoffen/oe-python-template)
-[![Vercel Deploy](https://deploy-badge.vercel.app/vercel/oe-python-template?root=docs)](https://oe-python-template.vercel.app/docs)
+[![Vercel Deploy](https://deploy-badge.vercel.app/vercel/oe-python-template?root=docs)](https://oe-python-template.vercel.app/api/v1/hello/world)
 [![Better Stack Uptime](https://uptime.betterstack.com/status-badges/v1/monitor/1vze5.svg)](https://helmut-hoffer-von-ankershoffen.betteruptime.com/)
 
 <!---
@@ -87,7 +87,7 @@ Projects generated with this template come with a comprehensive development tool
 
 Beyond development tooling, projects generated with this template include the code, documentation, and configuration of a fully functioning application and service. This reference implementation serves as a starting point for your own business logic with modern patterns and enterprise practices already in place:
 
-1. Usable as library with "Hello" module exposing a simple service
+1. Usable as library with "Hello" module exposing a simple service that can say "Hello, world!" and echo utterances.
 2. Command-line interface (CLI) with [Typer](https://typer.tiangolo.com/)
 3. Versioned webservice API with [FastAPI](https://fastapi.tiangolo.com/)
 4. [Interactive Jupyter notebook](https://jupyter.org/) and [reactive Marimo notebook](https://marimo.io/)
@@ -97,8 +97,9 @@ Beyond development tooling, projects generated with this template include the co
 8. Info command enabling to inspect the runtime, compiled settings, and further info provided dynamically by modules
 9. Health endpoint exposing system health dynamically aggregated from all modules and dependencies
 10. Flexible logging and instrumentation, including support for [Sentry](https://sentry.io/) and [Logfire](https://logfire.dev/) 
-11. Modular architecture including auto-registration of services, CLI commands and API routes exposed by modules
-12. Documentation including dynamic badges, setup instructions, contribution guide and security policy
+11. Hello service demonstrates use of custom real time metrics collected via Logfire
+12. Modular architecture including auto-registration of services, CLI commands and API routes exposed by modules
+13. Documentation including dynamic badges, setup instructions, contribution guide and security policy
 
 Explore [here](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template-example) for what's generated out of the box.
 

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oe-python-template"
-version = "0.10.5"
+version = "0.10.7"
 description = "🧠 Copier template to scaffold Python projects compliant with best practices and modern tooling."
 readme = "README.md"
 authors = [{ name = "Helmut Hoffer von Ankershoffen", email = "helmuthva@gmail.com" }]
@@ -276,7 +276,7 @@ source = ["src/"]
 
 
 [tool.bumpversion]
-current_version = "0.10.5"
+current_version = "0.10.7"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 search = "{current_version}"

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/src/oe_python_template/hello/_service.py

@@ -5,6 +5,7 @@ import string
 from http import HTTPStatus
 from typing import Any
 
+import logfire
 import requests
 
 from oe_python_template.utils import BaseService, Health
@@ -74,6 +75,9 @@ class Service(BaseService):
         Returns:
             str: Hello world message.
         """
+        messages_sent = logfire.metric_counter("hello_world_messages_sent")
+        messages_sent.add(1)
+
         match self._settings.language:
             case Language.GERMAN:
                 return HELLO_WORLD_DE_DE

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/src/oe_python_template/hello/_settings.py

@@ -3,10 +3,10 @@
 from enum import StrEnum
 from typing import Annotated
 
-from pydantic import Field
-from pydantic_settings import BaseSettings, SettingsConfigDict
+from pydantic import BeforeValidator, Field, PlainSerializer, SecretStr
+from pydantic_settings import SettingsConfigDict
 
-from oe_python_template.utils import __env_file__, __project_name__
+from oe_python_template.utils import OpaqueSettings, __env_file__, __project_name__, strip_to_none_before_validator
 
 
 class Language(StrEnum):
@@ -18,7 +18,7 @@ class Language(StrEnum):
 
 # Settings derived from BaseSettings and exported by modules via their __init__.py are automatically registered
 # by the system module e.g. for showing all settings via the system info command.
-class Settings(BaseSettings):
+class Settings(OpaqueSettings):
     """Settings."""
 
     model_config = SettingsConfigDict(
@@ -35,3 +35,15 @@ class Settings(BaseSettings):
             description="Language to use for output - defaults to US english.",
         ),
     ]
+
+    token: Annotated[
+        SecretStr | None,
+        BeforeValidator(strip_to_none_before_validator),  # strip and if empty set to None
+        PlainSerializer(
+            func=OpaqueSettings.serialize_sensitive_info, return_type=str, when_used="always"
+        ),  # allow to unhide sensitive info from CLI or if user presents valid token via API
+        Field(
+            description="Secret token of Hello module.",
+            default=None,
+        ),
+    ]

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/src/oe_python_template/utils/__init__.py

@@ -23,7 +23,7 @@ from ._logfire import LogfireSettings
 from ._process import ProcessInfo, get_process_info
 from ._sentry import SentrySettings
 from ._service import BaseService
-from ._settings import UNHIDE_SENSITIVE_INFO, OpaqueSettings, load_settings
+from ._settings import UNHIDE_SENSITIVE_INFO, OpaqueSettings, load_settings, strip_to_none_before_validator
 from .boot import boot
 
 __all__ = [
@@ -56,4 +56,5 @@ __all__ = [
     "locate_implementations",
     "locate_subclasses",
     "prepare_cli",
+    "strip_to_none_before_validator",
 ]

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/src/oe_python_template/utils/_logfire.py

@@ -3,11 +3,11 @@
 from typing import Annotated
 
 import logfire
-from pydantic import Field, PlainSerializer, SecretStr
+from pydantic import BeforeValidator, Field, PlainSerializer, SecretStr
 from pydantic_settings import SettingsConfigDict
 
 from ._constants import __env__, __env_file__, __project_name__, __repository_url__, __version__
-from ._settings import OpaqueSettings, load_settings
+from ._settings import OpaqueSettings, load_settings, strip_to_none_before_validator
 
 
 class LogfireSettings(OpaqueSettings):
@@ -22,6 +22,7 @@ class LogfireSettings(OpaqueSettings):
 
     token: Annotated[
         SecretStr | None,
+        BeforeValidator(strip_to_none_before_validator),
         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),
     ]

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/src/oe_python_template/utils/_sentry.py

@@ -3,12 +3,12 @@
 from typing import Annotated
 
 import sentry_sdk
-from pydantic import Field, PlainSerializer, SecretStr
+from pydantic import BeforeValidator, 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 OpaqueSettings, load_settings
+from ._settings import OpaqueSettings, load_settings, strip_to_none_before_validator
 
 
 class SentrySettings(OpaqueSettings):
@@ -23,6 +23,7 @@ class SentrySettings(OpaqueSettings):
 
     dsn: Annotated[
         SecretStr | None,
+        BeforeValidator(strip_to_none_before_validator),
         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),
     ]
@@ -44,12 +45,14 @@ class SentrySettings(OpaqueSettings):
         int,
         Field(
             description="Max breadcrumbs (https://docs.sentry.io/platforms/python/configuration/options/#max_breadcrumbs)",
-            default=5.0,
+            ge=0,
+            default=50,
         ),
     ]
     sample_rate: Annotated[
         float,
         Field(
+            ge=0.0,
             description="Sample Rate (https://docs.sentry.io/platforms/python/configuration/sampling/#sampling-error-events)",
             default=1.0,
         ),
@@ -57,6 +60,7 @@ class SentrySettings(OpaqueSettings):
     traces_sample_rate: Annotated[
         float,
         Field(
+            ge=0.0,
             description="Traces Sample Rate (https://docs.sentry.io/platforms/python/configuration/sampling/#configuring-the-transaction-sample-rate)",
             default=1.0,
         ),
@@ -64,6 +68,7 @@ class SentrySettings(OpaqueSettings):
     profiles_sample_rate: Annotated[
         float,
         Field(
+            ge=0.0,
             description="Traces Sample Rate (https://docs.sentry.io/platforms/python/tracing/#configure)",
             default=1.0,
         ),
@@ -84,7 +89,7 @@ def sentry_initialize() -> bool:
     sentry_sdk.init(
         release=f"{__project_name__}@{__version__}",  # https://docs.sentry.io/platforms/python/configuration/releases/,
         environment=__env__,
-        dsn=settings.dsn.get_secret_value(),
+        dsn=settings.dsn.get_secret_value().strip(),
         max_breadcrumbs=settings.max_breadcrumbs,
         debug=settings.debug,
         send_default_pii=settings.send_default_pii,

{oe_python_template-0.10.5 → oe_python_template-0.10.7}/src/oe_python_template/utils/_settings.py

@@ -20,6 +20,15 @@ logger = logging.getLogger(__name__)
 UNHIDE_SENSITIVE_INFO = "unhide_sensitive_info"
 
 
+def strip_to_none_before_validator(v: str | None) -> str | None:
+    if v is None:
+        return None
+    v = v.strip()
+    if not v:
+        return None
+    return v
+
+
 class OpaqueSettings(BaseSettings):
     @staticmethod
     def serialize_sensitive_info(input_value: SecretStr, info: FieldSerializationInfo) -> str | None: