processcube-etw-library 2026.1.19.145934__tar.gz → 2026.1.21.174504b0__tar.gz

{processcube_etw_library-2026.1.19.145934/src/processcube_etw_library.egg-info → processcube_etw_library-2026.1.21.174504b0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: processcube-etw-library
-Version: 2026.1.19.145934
+Version: 2026.1.21.174504b0
 Summary: A library to create ETW apps with the ProcessCube platform.
 Author-email: Jeremy Hill <jeremy.hill@profection.de>
 License: MIT

{processcube_etw_library-2026.1.19.145934 → processcube_etw_library-2026.1.21.174504b0}/src/processcube_etw_library/create_external_task_client.py

@@ -1,32 +1,21 @@
-from os import getenv
-
 # Prevent nest_asyncio from patching asyncio.run() in processcube_client - it breaks uvicorn's loop_factory
 import nest_asyncio
 nest_asyncio.apply = lambda *args, **kwargs: None
 
 from processcube_client.external_task import ExternalTaskClient
-from processcube_client.app_info import AppInfoClient
 
 from .identity_provider import IdentityProvider
+from .settings import get_settings
 
 
-def _determine_authority_url(engine_url: str) -> str:
-    if authority := getenv("PROCESSCUBE_AUTHORITY_URL"):
-        return authority
-
-    app_info_client = AppInfoClient(engine_url)
-    authority_url = app_info_client.get_authority()
-    return authority_url # type: ignore
-
-
-def create_external_task_client(
-    engine_url: str,
-    client_name: str,
-    client_secret: str,
-    client_scopes: str,
-    max_get_oauth_access_token_retries: int,
-) -> ExternalTaskClient:
-    authority_url = _determine_authority_url(engine_url)
+def create_external_task_client() -> ExternalTaskClient:
+    settings = get_settings()
+    authority_url = settings.processcube_authority_url
+    engine_url = settings.processcube_engine_url
+    client_name = settings.processcube_etw_client_id
+    client_secret = settings.processcube_etw_client_secret
+    client_scopes = settings.processcube_etw_client_scopes
+    max_get_oauth_access_token_retries = settings.max_get_oauth_access_token_retries
 
     identity_provider = IdentityProvider(
         authority_url,

{processcube_etw_library-2026.1.19.145934 → processcube_etw_library-2026.1.21.174504b0}/src/processcube_etw_library/etw_app.py

@@ -1,7 +1,6 @@
 import asyncio
 from concurrent.futures import ThreadPoolExecutor
 from contextlib import asynccontextmanager
-import os
 from typing import Callable, Optional
 
 from fastapi import FastAPI
@@ -16,6 +15,7 @@ from .health import (
 from .create_external_task_client import create_external_task_client
 from .server_config import get_server_config
 from .typed_handler import create_typed_handler_wrapper
+from .settings import get_settings
 from processcube_client.external_task import ExternalTaskClient
 
 
@@ -92,23 +92,9 @@ class ExternalTaskWorkerApp:
 def new_external_task_worker_app(
     built_in_health_checks: bool = True,
 ) -> ExternalTaskWorkerApp:
-    engine_url = os.getenv("PROCESSCUBE_ENGINE_URL", "http://localhost:56000")
-    etw_client_name = os.getenv("PROCESSCUBE_ETW_CLIENT_ID", "test_etw")
-    etw_client_secret = os.getenv(
-        "PROCESSCUBE_ETW_CLIENT_SECRET", "3ef62eb3-fe49-4c2c-ba6f-73e4d234321b"
-    )
-    etw_client_scopes = os.getenv("PROCESSCUBE_ETW_CLIENT_SCOPES", "engine_etw")
-    max_get_oauth_access_token_retries = int(
-        os.getenv("MAX_GET_OAUTH_ACCESS_TOKEN_RETRIES", 10)
-    )
+    settings = get_settings()
 
-    external_task_client = create_external_task_client(
-        engine_url,
-        etw_client_name,
-        etw_client_secret,
-        etw_client_scopes,
-        max_get_oauth_access_token_retries,
-    )
+    external_task_client = create_external_task_client()
 
     return ExternalTaskWorkerApp(
         external_task_client, built_in_health_checks=built_in_health_checks

{processcube_etw_library-2026.1.19.145934 → processcube_etw_library-2026.1.21.174504b0}/src/processcube_etw_library/health/built_in.py

@@ -1,16 +1,18 @@
-import os
-
+from ..settings import get_settings
 from .check import HealthCheck, create_url_health_check
 from .registry import HealthCheckRegistry
 
 
 def add_built_in_health_checks(registry: HealthCheckRegistry) -> None:
+    settings = get_settings()
+
     engine_url = (
-        os.getenv("PROCESSCUBE_ENGINE_URL", "http://localhost:56000").strip("/")
+        settings.processcube_engine_url.strip("/")
         + "/atlas_engine/api/v1/info"
     )
+
     authority_url = (
-        os.getenv("PROCESSCUBE_AUTHORITY_URL", "http://localhost:56020").strip("/")
+        settings.processcube_authority_url.strip("/")
         + "/.well-known/openid-configuration"
     )
 

{processcube_etw_library-2026.1.19.145934 → processcube_etw_library-2026.1.21.174504b0}/src/processcube_etw_library/server_config.py

@@ -1,6 +1,7 @@
-from os import getenv
 from typing import TypedDict
 
+from .settings import get_settings
+
 
 class ServerConfig(TypedDict, total=False):
     host: str
@@ -11,7 +12,9 @@ class ServerConfig(TypedDict, total=False):
 
 
 def get_server_config() -> ServerConfig:
-    if getenv("ENVIRONMENT") == "production":
+    settings = get_settings()
+
+    if settings.environment == "production":
         return ServerConfig(
             host="0.0.0.0",
             port=8000,

processcube_etw_library-2026.1.21.174504b0/src/processcube_etw_library/settings.py

@@ -0,0 +1,117 @@
+import logging
+from os import getenv
+from typing import Optional, Type, TypeVar
+
+from pydantic import Field, model_validator
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+from processcube_client.app_info import AppInfoClient
+
+logger = logging.getLogger(__name__)
+
+T = TypeVar("T", bound="ETWSettings")
+
+DEFAULTS = {
+    "PROCESSCUBE_ENGINE_URL": "http://localhost:56000",
+    "PROCESSCUBE_ETW_CLIENT_ID": "test_etw",
+    "PROCESSCUBE_ETW_CLIENT_SECRET": "3ef62eb3-fe49-4c2c-ba6f-73e4d234321b",
+    "PROCESSCUBE_ETW_CLIENT_SCOPES": "engine_etw",
+    "MAX_GET_OAUTH_ACCESS_TOKEN_RETRIES": 10,
+    "ENVIRONMENT": "development",
+}
+
+
+def _determine_authority_url(engine_url: str) -> str:
+    if authority_url := getenv("PROCESSCUBE_AUTHORITY_URL"):
+        logger.info("Using authority URL from environment variable PROCESSCUBE_AUTHORITY_URL")
+        return authority_url
+
+    app_info_client = AppInfoClient(engine_url)
+    authority_url = app_info_client.get_authority()
+    logger.debug(f"Determined authority URL from AppInfoClient: {authority_url}")
+    if type(authority_url) is not str:
+        raise ValueError("Could not determine authority URL from AppInfoClient")
+
+    return authority_url
+
+
+class ETWSettings(BaseSettings):
+    """
+    Base settings for the External Task Worker library.
+
+    Users can extend this class to add their own settings:
+
+        class MySettings(ETWSettings):
+            my_custom_var: str = Field(default="default_value")
+
+        # Initialize with custom settings class
+        init_settings(MySettings)
+    """
+
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        extra="ignore",
+    )
+
+    processcube_engine_url: str = Field(default=DEFAULTS["PROCESSCUBE_ENGINE_URL"])
+    processcube_authority_url: str = Field(default="")
+    processcube_etw_client_id: str = Field(default=DEFAULTS["PROCESSCUBE_ETW_CLIENT_ID"])
+    processcube_etw_client_secret: str = Field(default=DEFAULTS["PROCESSCUBE_ETW_CLIENT_SECRET"])
+    processcube_etw_client_scopes: str = Field(default=DEFAULTS["PROCESSCUBE_ETW_CLIENT_SCOPES"])
+    max_get_oauth_access_token_retries: int = Field(default=DEFAULTS["MAX_GET_OAUTH_ACCESS_TOKEN_RETRIES"])
+    environment: str = Field(default=DEFAULTS["ENVIRONMENT"])
+
+    @model_validator(mode="before")
+    @classmethod
+    def warn_missing_values(cls, values: dict) -> dict:
+        for env_name, default_value in DEFAULTS.items():
+            field_name = env_name.lower()
+            if field_name not in values or values.get(field_name) is None:
+                if default_value is not None:
+                    logger.warning(
+                        f"Environment variable '{env_name}' not set, using default: {default_value}"
+                    )
+        return values
+
+    @model_validator(mode="after")
+    def resolve_authority_url(self) -> "ETWSettings":
+        if not self.processcube_authority_url.strip():
+            self.processcube_authority_url = _determine_authority_url(
+                self.processcube_engine_url
+            )
+            logger.info(
+                f"Authority URL resolved from AppInfoClient: {self.processcube_authority_url}"
+            )
+        return self
+
+
+_settings: Optional[ETWSettings] = None
+
+
+def init_settings(settings_class: Type[T] = ETWSettings) -> T:
+    """
+    Initialize the global settings instance.
+
+    Call this with a custom settings class to extend the base settings:
+
+        class MySettings(ETWSettings):
+            my_var: str = Field(default="value")
+
+        init_settings(MySettings)
+    """
+    global _settings
+    _settings = settings_class()
+    return _settings
+
+
+def get_settings() -> ETWSettings:
+    """
+    Get the global settings instance.
+
+    If settings haven't been initialized, creates a default ETWSettings instance.
+    """
+    global _settings
+    if _settings is None:
+        _settings = ETWSettings()
+    return _settings

{processcube_etw_library-2026.1.19.145934 → processcube_etw_library-2026.1.21.174504b0/src/processcube_etw_library.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: processcube-etw-library
-Version: 2026.1.19.145934
+Version: 2026.1.21.174504b0
 Summary: A library to create ETW apps with the ProcessCube platform.
 Author-email: Jeremy Hill <jeremy.hill@profection.de>
 License: MIT

{processcube_etw_library-2026.1.19.145934 → processcube_etw_library-2026.1.21.174504b0}/src/processcube_etw_library.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ src/processcube_etw_library/create_external_task_client.py
 src/processcube_etw_library/etw_app.py
 src/processcube_etw_library/identity_provider.py
 src/processcube_etw_library/server_config.py
+src/processcube_etw_library/settings.py
 src/processcube_etw_library/typed_handler.py
 src/processcube_etw_library.egg-info/PKG-INFO
 src/processcube_etw_library.egg-info/SOURCES.txt