provide-foundation 0.0.0.dev2__py3-none-any.whl → 0.0.0.dev3__py3-none-any.whl

provide/foundation/hub/handlers.py

@@ -15,14 +15,19 @@ log = get_logger(__name__)
 
 def _get_registry_and_lock():
     """Get registry and lock from components module."""
-    from provide.foundation.hub.components import get_component_registry, _registry_lock, ComponentCategory
+    from provide.foundation.hub.components import (
+        ComponentCategory,
+        _registry_lock,
+        get_component_registry,
+    )
+
     return get_component_registry(), _registry_lock, ComponentCategory
 
 
 def get_handlers_for_exception(exception: Exception) -> list[RegistryEntry]:
     """Get error handlers that can handle the given exception type."""
     registry, registry_lock, ComponentCategory = _get_registry_and_lock()
-    
+
     with registry_lock:
         # Get all error handlers
         all_entries = list(registry)
@@ -53,7 +58,10 @@ def get_handlers_for_exception(exception: Exception) -> list[RegistryEntry]:
 
 @with_error_handling(
     fallback=None,
-    context_provider=lambda: {"function": "execute_error_handlers", "module": "hub.handlers"}
+    context_provider=lambda: {
+        "function": "execute_error_handlers",
+        "module": "hub.handlers",
+    },
 )
 def execute_error_handlers(
     exception: Exception, context: dict[str, Any]
@@ -76,6 +84,6 @@ def execute_error_handlers(
 
 
 __all__ = [
-    "get_handlers_for_exception",
     "execute_error_handlers",
-]
+    "get_handlers_for_exception",
+]

provide/foundation/hub/lifecycle.py

@@ -17,17 +17,18 @@ log = get_logger(__name__)
 def _get_registry_and_globals():
     """Get registry, lock, and initialized components from components module."""
     from provide.foundation.hub.components import (
-        get_component_registry, 
-        _registry_lock, 
-        _initialized_components
+        _initialized_components,
+        _registry_lock,
+        get_component_registry,
     )
+
     return get_component_registry(), _registry_lock, _initialized_components
 
 
 def get_or_initialize_component(name: str, dimension: str) -> Any:
     """Get component, initializing lazily if needed."""
     registry, registry_lock, initialized_components = _get_registry_and_globals()
-    
+
     with registry_lock:
         key = (name, dimension)
 
@@ -75,7 +76,7 @@ def get_or_initialize_component(name: str, dimension: str) -> Any:
 async def initialize_async_component(name: str, dimension: str) -> Any:
     """Initialize component asynchronously."""
     registry, registry_lock, initialized_components = _get_registry_and_globals()
-    
+
     with registry_lock:
         key = (name, dimension)
 
@@ -122,7 +123,7 @@ async def initialize_async_component(name: str, dimension: str) -> Any:
 def cleanup_all_components(dimension: str | None = None) -> None:
     """Clean up all components in dimension."""
     registry, registry_lock, _ = _get_registry_and_globals()
-    
+
     with registry_lock:
         if dimension:
             entries = [entry for entry in registry if entry.dimension == dimension]
@@ -187,8 +188,8 @@ async def initialize_all_async_components() -> None:
 
 
 __all__ = [
-    "get_or_initialize_component",
-    "initialize_async_component", 
     "cleanup_all_components",
+    "get_or_initialize_component",
     "initialize_all_async_components",
-]
+    "initialize_async_component",
+]

provide/foundation/hub/manager.py

@@ -433,6 +433,9 @@ def get_hub() -> Hub:
         # Double-check after acquiring lock
         if _global_hub is None:
             _global_hub = Hub()
+            # Bootstrap foundation components now that hub is ready
+            from provide.foundation.hub.components import bootstrap_foundation
+            bootstrap_foundation()
 
     return _global_hub
 

provide/foundation/hub/processors.py

@@ -10,14 +10,19 @@ from provide.foundation.hub.registry import RegistryEntry
 
 def _get_registry_and_lock():
     """Get registry and lock from components module."""
-    from provide.foundation.hub.components import get_component_registry, _registry_lock, ComponentCategory
+    from provide.foundation.hub.components import (
+        ComponentCategory,
+        _registry_lock,
+        get_component_registry,
+    )
+
     return get_component_registry(), _registry_lock, ComponentCategory
 
 
 def get_processor_pipeline() -> list[RegistryEntry]:
     """Get log processors ordered by priority."""
     registry, registry_lock, ComponentCategory = _get_registry_and_lock()
-    
+
     with registry_lock:
         # Get all processors
         all_entries = list(registry)
@@ -41,4 +46,4 @@ def get_processors_for_stage(stage: str) -> list[RegistryEntry]:
 __all__ = [
     "get_processor_pipeline",
     "get_processors_for_stage",
-]
+]

provide/foundation/integrations/__init__.py

@@ -8,4 +8,4 @@ that are not part of the core foundation library.
 __all__ = [
     # Available integrations (import on demand)
     # "openobserve",
-]
+]

provide/foundation/integrations/openobserve/client.py

@@ -11,7 +11,6 @@ import requests
 from requests.adapters import HTTPAdapter
 from urllib3.util.retry import Retry
 
-from provide.foundation.logger import get_logger
 from provide.foundation.integrations.openobserve.auth import (
     get_auth_headers,
     validate_credentials,
@@ -27,6 +26,7 @@ from provide.foundation.integrations.openobserve.models import (
     StreamInfo,
     parse_relative_time,
 )
+from provide.foundation.logger import get_logger
 
 log = get_logger(__name__)
 
@@ -42,7 +42,7 @@ class OpenObserveClient:
         organization: str = "default",
         timeout: int = 30,
         max_retries: int = 3,
-    ):
+    ) -> None:
         """Initialize OpenObserve client.
 
         Args:

provide/foundation/integrations/openobserve/commands.py

@@ -27,7 +27,7 @@ if _HAS_CLICK:
 
     @click.group("openobserve", help="Query and manage OpenObserve logs")
     @click.pass_context
-    def openobserve_group(ctx):
+    def openobserve_group(ctx: click.Context) -> None:
         """OpenObserve log querying and streaming commands."""
         # Initialize client and store in context
         try:
@@ -75,7 +75,7 @@ if _HAS_CLICK:
         help="Pretty print JSON output",
     )
     @click.pass_obj
-    def query_command(client, sql, start, end, size, format, pretty):
+    def query_command(client: "OpenObserveClient | None", sql: str, start: str, end: str, size: int, format: str, pretty: bool) -> int | None:
         """Execute SQL query against OpenObserve logs."""
         if client is None:
             click.echo(
@@ -134,7 +134,7 @@ if _HAS_CLICK:
         help="Output format",
     )
     @click.pass_obj
-    def tail_command(client, stream, filter_sql, lines, follow, format):
+    def tail_command(client: "OpenObserveClient | None", stream: str, filter_sql: str | None, lines: int, follow: bool, format: str) -> int | None:
         """Tail logs from OpenObserve (like 'tail -f')."""
         if client is None:
             click.echo(
@@ -191,7 +191,7 @@ if _HAS_CLICK:
         help="Output format",
     )
     @click.pass_obj
-    def errors_command(client, stream, start, size, format):
+    def errors_command(client: "OpenObserveClient | None", stream: str, start: str, size: int, format: str) -> int | None:
         """Search for error logs."""
         if client is None:
             click.echo("OpenObserve not configured.", err=True)
@@ -233,7 +233,7 @@ if _HAS_CLICK:
         help="Output format",
     )
     @click.pass_obj
-    def trace_command(client, trace_id, stream, format):
+    def trace_command(client: "OpenObserveClient | None", trace_id: str, stream: str, format: str) -> int | None:
         """Search for logs by trace ID."""
         if client is None:
             click.echo("OpenObserve not configured.", err=True)
@@ -260,7 +260,7 @@ if _HAS_CLICK:
 
     @openobserve_group.command("streams")
     @click.pass_obj
-    def streams_command(client):
+    def streams_command(client: "OpenObserveClient | None") -> int | None:
         """List available streams."""
         if client is None:
             click.echo("OpenObserve not configured.", err=True)
@@ -297,7 +297,7 @@ if _HAS_CLICK:
         help="Filter by stream name",
     )
     @click.pass_obj
-    def history_command(client, size, stream):
+    def history_command(client: "OpenObserveClient | None", size: int, stream: str | None) -> int | None:
         """View search history."""
         if client is None:
             click.echo("OpenObserve not configured.", err=True)
@@ -326,7 +326,7 @@ if _HAS_CLICK:
 
     @openobserve_group.command("test")
     @click.pass_obj
-    def test_command(client):
+    def test_command(client: "OpenObserveClient | None") -> int | None:
         """Test connection to OpenObserve."""
         if client is None:
             click.echo("OpenObserve not configured.", err=True)
@@ -347,7 +347,7 @@ if _HAS_CLICK:
 
 else:
     # Stub when click is not available
-    def openobserve_group(*args, **kwargs):
+    def openobserve_group(*args: object, **kwargs: object) -> None:
         """OpenObserve command stub when click is not available."""
         raise ImportError(
             "CLI commands require optional dependencies. "

provide/foundation/integrations/openobserve/config.py

@@ -2,8 +2,8 @@
 
 from attrs import define
 
-from provide.foundation.config.env import RuntimeConfig
 from provide.foundation.config.base import field
+from provide.foundation.config.env import RuntimeConfig
 
 
 @define(slots=True, repr=False)
@@ -34,4 +34,4 @@ class OpenObserveConfig(RuntimeConfig):
         default=None,
         env_var="OPENOBSERVE_STREAM",
         description="OpenObserve stream name",
-    )
+    )

provide/foundation/integrations/openobserve/otlp.py

@@ -6,8 +6,8 @@ from datetime import datetime
 import json
 from typing import Any
 
-from provide.foundation.logger import get_logger
 from provide.foundation.integrations.openobserve.client import OpenObserveClient
+from provide.foundation.logger import get_logger
 
 log = get_logger(__name__)
 
@@ -15,7 +15,7 @@ log = get_logger(__name__)
 try:
     from opentelemetry import trace
     from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter
-    from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler
+    from opentelemetry.sdk._logs import LoggerProvider
     from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
     from opentelemetry.sdk.resources import Resource
     from opentelemetry.semconv.resource import ResourceAttributes

provide/foundation/integrations/openobserve/search.py

@@ -2,10 +2,9 @@
 Search operations for OpenObserve.
 """
 
-
-from provide.foundation.logger import get_logger
 from provide.foundation.integrations.openobserve.client import OpenObserveClient
 from provide.foundation.integrations.openobserve.models import SearchResponse
+from provide.foundation.logger import get_logger
 
 log = get_logger(__name__)
 

provide/foundation/integrations/openobserve/streaming.py

@@ -9,13 +9,13 @@ from typing import Any
 
 import requests
 
-from provide.foundation.logger import get_logger
 from provide.foundation.integrations.openobserve.auth import get_auth_headers
 from provide.foundation.integrations.openobserve.client import OpenObserveClient
 from provide.foundation.integrations.openobserve.exceptions import (
     OpenObserveStreamingError,
 )
 from provide.foundation.integrations.openobserve.models import parse_relative_time
+from provide.foundation.logger import get_logger
 
 log = get_logger(__name__)
 

provide/foundation/logger/__init__.py

@@ -8,7 +8,6 @@ Re-exports key components related to logging functionality.
 
 # Import trace module early to ensure PrintLogger gets patched
 from provide.foundation.logger import trace  # noqa: F401
-
 from provide.foundation.logger.base import (
     FoundationLogger,  # Class definition
     get_logger,  # Factory function

provide/foundation/logger/config/base.py

@@ -9,7 +9,7 @@ import os
 import sys
 
 
-def get_config_logger():
+def get_config_logger() -> object:
     """Get logger for config warnings that respects FOUNDATION_LOG_OUTPUT."""
     import structlog
 

provide/foundation/logger/config/logging.py

@@ -9,22 +9,7 @@ from pathlib import Path
 
 from attrs import define
 
-from provide.foundation.config.env import RuntimeConfig
 from provide.foundation.config.base import field
-from provide.foundation.config.defaults import (
-    DEFAULT_LOG_LEVEL,
-    DEFAULT_CONSOLE_FORMATTER,
-    DEFAULT_LOGGER_NAME_EMOJI_ENABLED,
-    DEFAULT_DAS_EMOJI_ENABLED,
-    DEFAULT_OMIT_TIMESTAMP,
-    DEFAULT_FOUNDATION_SETUP_LOG_LEVEL,
-    DEFAULT_FOUNDATION_LOG_OUTPUT,
-    DEFAULT_RATE_LIMIT_ENABLED,
-    DEFAULT_RATE_LIMIT_EMIT_WARNINGS,
-    DEFAULT_RATE_LIMIT_GLOBAL,
-    DEFAULT_RATE_LIMIT_GLOBAL_CAPACITY,
-    DEFAULT_RATE_LIMIT_OVERFLOW_POLICY,
-)
 from provide.foundation.config.converters import (
     parse_bool_extended,
     parse_console_formatter,
@@ -34,10 +19,24 @@ from provide.foundation.config.converters import (
     parse_module_levels,
     parse_rate_limits,
     validate_log_level,
-    validate_non_negative,
     validate_overflow_policy,
     validate_positive,
 )
+from provide.foundation.config.defaults import (
+    DEFAULT_CONSOLE_FORMATTER,
+    DEFAULT_DAS_EMOJI_ENABLED,
+    DEFAULT_FOUNDATION_LOG_OUTPUT,
+    DEFAULT_FOUNDATION_SETUP_LOG_LEVEL,
+    DEFAULT_LOG_LEVEL,
+    DEFAULT_LOGGER_NAME_EMOJI_ENABLED,
+    DEFAULT_OMIT_TIMESTAMP,
+    DEFAULT_RATE_LIMIT_EMIT_WARNINGS,
+    DEFAULT_RATE_LIMIT_ENABLED,
+    DEFAULT_RATE_LIMIT_GLOBAL,
+    DEFAULT_RATE_LIMIT_GLOBAL_CAPACITY,
+    DEFAULT_RATE_LIMIT_OVERFLOW_POLICY,
+)
+from provide.foundation.config.env import RuntimeConfig
 from provide.foundation.types import (
     ConsoleFormatterStr,
     LogLevelStr,
@@ -90,7 +89,7 @@ class LoggingConfig(RuntimeConfig):
         default=None,
         env_var="PROVIDE_LOG_FILE",
         converter=lambda x: Path(x) if x else None,
-        description="Path to log file"
+        description="Path to log file",
     )
     foundation_setup_log_level: LogLevelStr = field(
         default=DEFAULT_FOUNDATION_SETUP_LOG_LEVEL,
@@ -138,7 +137,9 @@ class LoggingConfig(RuntimeConfig):
     rate_limit_summary_interval: float = field(
         default=DEFAULT_RATE_LIMIT_GLOBAL,
         env_var="PROVIDE_LOG_RATE_LIMIT_SUMMARY_INTERVAL",
-        converter=lambda x: parse_float_with_validation(x, min_val=0.0) if x else DEFAULT_RATE_LIMIT_GLOBAL,
+        converter=lambda x: parse_float_with_validation(x, min_val=0.0)
+        if x
+        else DEFAULT_RATE_LIMIT_GLOBAL,
         validator=validate_positive,
         description="Seconds between rate limit summary reports",
     )
@@ -161,4 +162,3 @@ class LoggingConfig(RuntimeConfig):
         validator=validate_overflow_policy,
         description="Policy when queue is full: drop_oldest, drop_newest, or block",
     )
-

provide/foundation/logger/config/telemetry.py

@@ -5,24 +5,25 @@
 TelemetryConfig class for Foundation telemetry configuration.
 """
 
+import os
+
 from attrs import define
 
-from provide.foundation.config.env import RuntimeConfig
 from provide.foundation.config.base import field
-from provide.foundation.config.defaults import (
-    DEFAULT_TELEMETRY_GLOBALLY_DISABLED,
-    DEFAULT_TRACING_ENABLED,
-    DEFAULT_METRICS_ENABLED,
-    DEFAULT_OTLP_PROTOCOL,
-    DEFAULT_TRACE_SAMPLE_RATE,
-)
-import os
 from provide.foundation.config.converters import (
     parse_bool_extended,
     parse_headers,
     parse_sample_rate,
     validate_sample_rate,
 )
+from provide.foundation.config.defaults import (
+    DEFAULT_METRICS_ENABLED,
+    DEFAULT_OTLP_PROTOCOL,
+    DEFAULT_TELEMETRY_GLOBALLY_DISABLED,
+    DEFAULT_TRACE_SAMPLE_RATE,
+    DEFAULT_TRACING_ENABLED,
+)
+from provide.foundation.config.env import RuntimeConfig
 from provide.foundation.logger.config.logging import LoggingConfig
 
 
@@ -45,8 +46,7 @@ class TelemetryConfig(RuntimeConfig):
         description="Service version for telemetry",
     )
     logging: LoggingConfig = field(
-        factory=lambda: LoggingConfig.from_env(),
-        description="Logging configuration"
+        factory=lambda: LoggingConfig.from_env(), description="Logging configuration"
     )
     globally_disabled: bool = field(
         default=DEFAULT_TELEMETRY_GLOBALLY_DISABLED,
@@ -97,8 +97,6 @@ class TelemetryConfig(RuntimeConfig):
         description="Sampling rate for traces (0.0 to 1.0)",
     )
 
-
-
     def get_otlp_headers_dict(self) -> dict[str, str]:
         """Get OTLP headers dictionary.
 

provide/foundation/logger/factories.py

@@ -13,7 +13,7 @@ from provide.foundation.logger.core import logger
 def get_logger(
     name: str | None = None,
     emoji: str | None = None,
-    emoji_hierarchy: dict[str, str] | None = None
+    emoji_hierarchy: dict[str, str] | None = None,
 ) -> Any:
     """
     Get a logger instance with the given name and optional emoji customization.
@@ -30,7 +30,7 @@ def get_logger(
     """
     # Emoji hierarchy removed - using event sets now
     # emoji and emoji_hierarchy parameters are deprecated
-    
+
     return logger.get_logger(name)
 
 

provide/foundation/logger/processors/main.py

@@ -7,7 +7,7 @@ Structlog processors for Foundation Telemetry.
 
 import json
 import logging as stdlib_logging
-from typing import TYPE_CHECKING, Any, TextIO, cast
+from typing import Any, TextIO, cast
 
 import structlog
 
@@ -26,7 +26,6 @@ from provide.foundation.types import (
     LogLevelStr,
 )
 
-
 _LEVEL_TO_NUMERIC: dict[LogLevelStr, int] = {
     "CRITICAL": stdlib_logging.CRITICAL,
     "ERROR": stdlib_logging.ERROR,
@@ -70,24 +69,29 @@ def _config_create_timestamp_processors(
 
 
 def _config_create_event_enrichment_processors(
-    logging_config: LoggingConfig
+    logging_config: LoggingConfig,
 ) -> list[StructlogProcessor]:
     processors: list[StructlogProcessor] = []
     if logging_config.logger_name_emoji_prefix_enabled:
         processors.append(cast(StructlogProcessor, add_logger_name_emoji_prefix))
     if logging_config.das_emoji_prefix_enabled:
+
         def add_event_enrichment_processor(
             _logger: Any, _method_name: str, event_dict: structlog.types.EventDict
         ) -> structlog.types.EventDict:
             # Lazy import to avoid circular dependency
-            from provide.foundation.eventsets.resolver import get_resolver
             from provide.foundation.eventsets.registry import discover_event_sets
-            
+            from provide.foundation.eventsets.resolver import get_resolver
+
             # Initialize on first use
-            if not hasattr(add_event_enrichment_processor, '_initialized'):
+            if not hasattr(add_event_enrichment_processor, "_initialized"):
+                from provide.foundation.logger.setup.coordinator import create_foundation_internal_logger
+                setup_logger = create_foundation_internal_logger()
+                setup_logger.trace("Initializing event enrichment processor")
                 discover_event_sets()
                 add_event_enrichment_processor._initialized = True
-            
+                setup_logger.trace("Event enrichment processor initialized")
+
             resolver = get_resolver()
             return resolver.enrich_event(event_dict)
 
@@ -95,9 +99,7 @@ def _config_create_event_enrichment_processors(
     return processors
 
 
-def _build_core_processors_list(
-    config: TelemetryConfig
-) -> list[StructlogProcessor]:
+def _build_core_processors_list(config: TelemetryConfig) -> list[StructlogProcessor]:
     log_cfg = config.logging
     processors: list[StructlogProcessor] = [
         structlog.contextvars.merge_contextvars,

provide/foundation/logger/ratelimit/limiters.py

@@ -17,7 +17,7 @@ class SyncRateLimiter:
     Thread-safe implementation suitable for synchronous logging operations.
     """
 
-    def __init__(self, capacity: float, refill_rate: float):
+    def __init__(self, capacity: float, refill_rate: float) -> None:
         """
         Initialize the rate limiter.
 
@@ -87,7 +87,7 @@ class AsyncRateLimiter:
     Uses asyncio.Lock for thread safety in async contexts.
     """
 
-    def __init__(self, capacity: float, refill_rate: float):
+    def __init__(self, capacity: float, refill_rate: float) -> None:
         """
         Initialize the async rate limiter.
 
@@ -160,7 +160,7 @@ class GlobalRateLimiter:
     _instance = None
     _lock = threading.Lock()
 
-    def __new__(cls):
+    def __new__(cls) -> "GlobalRateLimiter":
         if cls._instance is None:
             with cls._lock:
                 if cls._instance is None:
@@ -168,7 +168,7 @@ class GlobalRateLimiter:
                     cls._instance._initialized = False
         return cls._instance
 
-    def __init__(self):
+    def __init__(self) -> None:
         if self._initialized:
             return
 

provide/foundation/logger/ratelimit/processor.py

@@ -107,7 +107,7 @@ class RateLimiterProcessor:
         stats = self.rate_limiter.get_stats()
 
         # Check if there's been any rate limiting activity
-        global_stats = stats.get("global", {})
+        global_stats = stats.get("global") or {}
         total_denied = global_stats.get("total_denied", 0)
 
         if not self.suppressed_counts and total_denied == 0: