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

provide/foundation/eventsets/sets/http.py

@@ -20,7 +20,7 @@ EVENT_SET = EventSet(
                 "options": "⚙️❔",
                 "default": "🌐",
             },
-            default_key="default"
+            default_key="default",
         ),
         EventMapping(
             name="http_status_class",
@@ -37,7 +37,7 @@ EVENT_SET = EventSet(
                 "4xx": {"http.client_error": True},
                 "5xx": {"http.server_error": True},
             },
-            default_key="default"
+            default_key="default",
         ),
         EventMapping(
             name="http_target_type",
@@ -47,7 +47,7 @@ EVENT_SET = EventSet(
                 "fragment": "#️⃣",
                 "default": "🎯",
             },
-            default_key="default"
+            default_key="default",
         ),
     ],
     field_mappings=[
@@ -55,99 +55,99 @@ EVENT_SET = EventSet(
             log_key="http.method",
             event_set_name="http",
             description="HTTP request method",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="http.status_class",
             event_set_name="http",
             description="HTTP status code class",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="http.target",
             event_set_name="http",
             description="Request target path and query",
             value_type="string",
-            default_override_key="path"
+            default_override_key="path",
         ),
         FieldMapping(
             log_key="http.url",
             event_set_name="http",
             description="Full HTTP URL",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="http.scheme",
             event_set_name="http",
             description="URL scheme",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="http.host",
             event_set_name="http",
             description="Request hostname",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="http.status_code",
             event_set_name="http",
             description="HTTP response status code",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="http.request.body.size",
             event_set_name="http",
             description="Request body size in bytes",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="http.response.body.size",
             event_set_name="http",
             description="Response body size in bytes",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="client.address",
             event_set_name="http",
             description="Client IP address",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="server.address",
             event_set_name="http",
             description="Server address or hostname",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="duration_ms",
             event_set_name="http",
             description="Request duration in milliseconds",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="trace_id",
             event_set_name="http",
             description="Distributed trace ID",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="span_id",
             event_set_name="http",
             description="Span ID",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="error.message",
             event_set_name="http",
             description="Error message if request failed",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="error.type",
             event_set_name="http",
             description="Error type if request failed",
-            value_type="string"
+            value_type="string",
         ),
     ],
-    priority=80
-)
+    priority=80,
+)

provide/foundation/eventsets/sets/llm.py

@@ -2,7 +2,7 @@
 Large Language Model (LLM) interaction event set for Foundation.
 """
 
-from provide.foundation.eventsets.types import EventSet, EventMapping, FieldMapping
+from provide.foundation.eventsets.types import EventMapping, EventSet, FieldMapping
 
 EVENT_SET = EventSet(
     name="llm",
@@ -27,7 +27,7 @@ EVENT_SET = EventSet(
                 "meta": {"llm.vendor": "meta", "llm.api": "llama"},
                 "mistral": {"llm.vendor": "mistral", "llm.api": "mistral"},
             },
-            default_key="default"
+            default_key="default",
         ),
         EventMapping(
             name="llm_task",
@@ -49,7 +49,7 @@ EVENT_SET = EventSet(
                 "chat": {"llm.type": "conversational"},
                 "tool_use": {"llm.type": "function_calling"},
             },
-            default_key="default"
+            default_key="default",
         ),
         EventMapping(
             name="llm_outcome",
@@ -70,7 +70,7 @@ EVENT_SET = EventSet(
                 "filtered_input": {"llm.filtered": True, "llm.filter_type": "input"},
                 "filtered_output": {"llm.filtered": True, "llm.filter_type": "output"},
             },
-            default_key="default"
+            default_key="default",
         ),
     ],
     field_mappings=[
@@ -78,62 +78,62 @@ EVENT_SET = EventSet(
             log_key="llm.provider",
             event_set_name="llm",
             description="LLM provider name",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="llm.task",
             event_set_name="llm",
             description="LLM task type",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="llm.model",
             event_set_name="llm",
             description="Model identifier",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="llm.outcome",
             event_set_name="llm",
             description="Operation outcome",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="llm.input.tokens",
             event_set_name="llm",
             description="Input token count",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="llm.output.tokens",
             event_set_name="llm",
             description="Output token count",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="llm.tool.name",
             event_set_name="llm",
             description="Tool/function name",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="llm.tool.call_id",
             event_set_name="llm",
             description="Tool call identifier",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="duration_ms",
             event_set_name="llm",
             description="LLM operation duration",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="trace_id",
             event_set_name="llm",
             description="Distributed trace ID",
-            value_type="string"
+            value_type="string",
         ),
     ],
-    priority=100  # High priority for LLM operations
-)
+    priority=100,  # High priority for LLM operations
+)

provide/foundation/eventsets/sets/task_queue.py

@@ -2,7 +2,7 @@
 Task queue and async job processing event set for Foundation.
 """
 
-from provide.foundation.eventsets.types import EventSet, EventMapping, FieldMapping
+from provide.foundation.eventsets.types import EventMapping, EventSet, FieldMapping
 
 EVENT_SET = EventSet(
     name="task_queue",
@@ -25,7 +25,7 @@ EVENT_SET = EventSet(
                 "kafka": {"task.broker": "kafka", "task.streaming": True},
                 "rabbitmq": {"task.broker": "amqp"},
             },
-            default_key="default"
+            default_key="default",
         ),
         EventMapping(
             name="task_status",
@@ -50,7 +50,7 @@ EVENT_SET = EventSet(
                 "failure": {"task.state": "failed", "task.success": False},
                 "revoked": {"task.state": "cancelled"},
             },
-            default_key="default"
+            default_key="default",
         ),
     ],
     field_mappings=[
@@ -58,50 +58,50 @@ EVENT_SET = EventSet(
             log_key="task.system",
             event_set_name="task_queue",
             description="Task queue system",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="task.status",
             event_set_name="task_queue",
             description="Task execution status",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="task.id",
             event_set_name="task_queue",
             description="Unique task identifier",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="task.name",
             event_set_name="task_queue",
             description="Task or job name",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="task.queue_name",
             event_set_name="task_queue",
             description="Queue name",
-            value_type="string"
+            value_type="string",
         ),
         FieldMapping(
             log_key="task.retries",
             event_set_name="task_queue",
             description="Retry attempt count",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="duration_ms",
             event_set_name="task_queue",
             description="Task execution duration",
-            value_type="integer"
+            value_type="integer",
         ),
         FieldMapping(
             log_key="trace_id",
             event_set_name="task_queue",
             description="Distributed trace ID",
-            value_type="string"
+            value_type="string",
         ),
     ],
-    priority=70
-)
+    priority=70,
+)

provide/foundation/eventsets/types.py

@@ -12,7 +12,7 @@ from attrs import define, field
 class EventMapping:
     """
     Individual event enrichment mapping for a specific domain.
-    
+
     Attributes:
         name: Unique identifier for this mapping
         visual_markers: Mapping of values to visual indicators (e.g., emojis)
@@ -20,7 +20,7 @@ class EventMapping:
         transformations: Value transformation functions
         default_key: Key to use when no specific match is found
     """
-    
+
     name: str
     visual_markers: dict[str, str] = field(factory=lambda: {})
     metadata_fields: dict[str, dict[str, Any]] = field(factory=lambda: {})
@@ -32,7 +32,7 @@ class EventMapping:
 class FieldMapping:
     """
     Maps a log field to an event set for enrichment.
-    
+
     Attributes:
         log_key: The field key in log events (e.g., "http.method", "llm.provider")
         description: Human-readable description of this field
@@ -41,7 +41,7 @@ class FieldMapping:
         default_override_key: Override the default key for this specific field
         default_value: Default value to use if field is not present
     """
-    
+
     log_key: str
     description: str | None = field(default=None)
     value_type: str | None = field(default=None)
@@ -54,7 +54,7 @@ class FieldMapping:
 class EventSet:
     """
     Complete event enrichment domain definition.
-    
+
     Attributes:
         name: Unique identifier for this event set
         description: Human-readable description
@@ -62,9 +62,9 @@ class EventSet:
         field_mappings: List of field-to-mapping associations
         priority: Higher priority sets override lower ones
     """
-    
+
     name: str
     description: str | None = field(default=None)
     mappings: list[EventMapping] = field(factory=lambda: [])
     field_mappings: list[FieldMapping] = field(factory=lambda: [])
-    priority: int = field(default=0, converter=int)
+    priority: int = field(default=0, converter=int)

provide/foundation/file/directory.py

@@ -1,10 +1,10 @@
 """Directory operations and utilities."""
 
 from contextlib import contextmanager
-from typing import Generator
 from pathlib import Path
 import shutil
 import tempfile
+from typing import Generator
 
 from provide.foundation.errors.decorators import with_error_handling
 from provide.foundation.errors.handlers import error_boundary

provide/foundation/file/lock.py

@@ -5,7 +5,6 @@ from pathlib import Path
 import time
 
 from provide.foundation.config.defaults import DEFAULT_FILE_LOCK_TIMEOUT
-from provide.foundation.errors.decorators import with_error_handling
 from provide.foundation.errors.resources import LockError
 from provide.foundation.logger import get_logger
 
@@ -160,12 +159,12 @@ class FileLock:
 
         return False
 
-    def __enter__(self):
+    def __enter__(self) -> "FileLock":
         """Context manager entry."""
         self.acquire()
         return self
 
-    def __exit__(self, exc_type, exc_val, exc_tb):
+    def __exit__(self, exc_type: object, exc_val: object, exc_tb: object) -> bool:
         """Context manager exit."""
         self.release()
         return False  # Don't suppress exceptions

provide/foundation/hub/components.py

@@ -6,8 +6,8 @@ components are managed through the Hub registry system. Provides centralized
 component discovery, lifecycle management, and dependency resolution.
 """
 
-import threading
 from enum import Enum
+import threading
 from typing import Any, Protocol
 
 from attrs import define, field
@@ -73,7 +73,10 @@ def get_component_registry() -> Registry:
 
 @with_error_handling(
     fallback={"status": "error"},
-    context_provider=lambda: {"function": "check_component_health", "module": "hub.components"}
+    context_provider=lambda: {
+        "function": "check_component_health",
+        "module": "hub.components",
+    },
 )
 def check_component_health(name: str, dimension: str) -> dict[str, Any]:
     """Check component health status."""
@@ -112,7 +115,7 @@ def bootstrap_foundation() -> None:
     registry = get_component_registry()
 
     # Register core processors
-    def timestamp_processor(logger, method_name, event_dict):
+    def timestamp_processor(logger: object, method_name: str, event_dict: dict[str, Any]) -> dict[str, Any]:
         import time
 
         event_dict["timestamp"] = time.time()
@@ -138,43 +141,38 @@ def reset_registry_for_tests() -> None:
 
 # Import and re-export functions from specialized modules
 from provide.foundation.hub.config import (
-    resolve_config_value,
     get_config_chain,
     load_all_configs,
     load_config_from_registry,
+    resolve_config_value,
+)
+from provide.foundation.hub.discovery import (
+    discover_components,
+    resolve_component_dependencies,
 )
-
 from provide.foundation.hub.handlers import (
-    get_handlers_for_exception,
     execute_error_handlers,
+    get_handlers_for_exception,
 )
-
 from provide.foundation.hub.lifecycle import (
-    get_or_initialize_component,
-    initialize_async_component,
     cleanup_all_components,
+    get_or_initialize_component,
     initialize_all_async_components,
+    initialize_async_component,
 )
-
 from provide.foundation.hub.processors import (
     get_processor_pipeline,
     get_processors_for_stage,
 )
 
-from provide.foundation.hub.discovery import (
-    resolve_component_dependencies,
-    discover_components,
-)
-
-
-# Bootstrap on module import
-bootstrap_foundation()
+# Bootstrap will happen lazily on first hub access to avoid circular imports
+# bootstrap_foundation()
 
 
 __all__ = [
     # Core classes
     "ComponentInfo",
-    "ComponentCategory", 
+    "ComponentCategory",
     "ComponentLifecycle",
     # Registry access
     "get_component_registry",
@@ -189,7 +187,7 @@ __all__ = [
     "get_config_chain",
     "load_all_configs",
     "load_config_from_registry",
-    "get_handlers_for_exception", 
+    "get_handlers_for_exception",
     "execute_error_handlers",
     "get_or_initialize_component",
     "initialize_async_component",
@@ -199,4 +197,4 @@ __all__ = [
     "get_processors_for_stage",
     "resolve_component_dependencies",
     "discover_components",
-]
+]

provide/foundation/hub/config.py

@@ -5,7 +5,6 @@ Provides functions for resolving configuration values from registered sources,
 loading configurations, and managing the configuration chain.
 """
 
-import asyncio
 import inspect
 from typing import Any, TypeVar
 
@@ -20,7 +19,12 @@ 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
 
 
@@ -28,7 +32,7 @@ def _get_registry_and_lock():
 def resolve_config_value(key: str) -> Any:
     """Resolve configuration value using priority-ordered sources."""
     registry, registry_lock, ComponentCategory = _get_registry_and_lock()
-    
+
     with registry_lock:
         # Get all config sources
         all_entries = list(registry)
@@ -59,7 +63,7 @@ def resolve_config_value(key: str) -> Any:
 def get_config_chain() -> list[RegistryEntry]:
     """Get configuration sources ordered by priority."""
     registry, registry_lock, ComponentCategory = _get_registry_and_lock()
-    
+
     with registry_lock:
         # Get all config sources
         all_entries = list(registry)
@@ -75,8 +79,7 @@ def get_config_chain() -> list[RegistryEntry]:
 
 
 @with_error_handling(
-    fallback={},
-    context_provider=lambda: {"function": "load_all_configs"}
+    fallback={}, context_provider=lambda: {"function": "load_all_configs"}
 )
 async def load_all_configs() -> dict[str, Any]:
     """Load configurations from all registered sources."""
@@ -105,19 +108,19 @@ async def load_all_configs() -> dict[str, Any]:
 def load_config_from_registry(config_class: type[T]) -> T:
     """
     Load configuration from registry sources.
-    
+
     Args:
         config_class: Configuration class to instantiate
-        
+
     Returns:
         Configuration instance loaded from registry sources
     """
     registry, registry_lock, ComponentCategory = _get_registry_and_lock()
-    
+
     with registry_lock:
         # Get configuration data from registry
         config_data = {}
-        
+
         # Load from all config sources
         chain = get_config_chain()
         for entry in chain:
@@ -126,26 +129,29 @@ def load_config_from_registry(config_class: type[T]) -> T:
                 try:
                     # Skip async sources in sync context
                     if inspect.iscoroutinefunction(source.load_config):
-                        log.debug("Skipping async config source in sync context", source=entry.name)
+                        log.debug(
+                            "Skipping async config source in sync context",
+                            source=entry.name,
+                        )
                         continue
-                    
+
                     source_data = source.load_config()
                     if source_data:
                         config_data.update(source_data)
                 except Exception as e:
                     log.warning(
-                        "Failed to load config from source", 
-                        source=entry.name, 
-                        error=str(e)
+                        "Failed to load config from source",
+                        source=entry.name,
+                        error=str(e),
                     )
-        
+
         # Create config instance
         return config_class.from_dict(config_data)
 
 
 __all__ = [
-    "resolve_config_value",
-    "get_config_chain", 
+    "get_config_chain",
     "load_all_configs",
     "load_config_from_registry",
-]
+    "resolve_config_value",
+]

provide/foundation/hub/discovery.py

@@ -12,14 +12,15 @@ from provide.foundation.hub.registry import Registry
 
 def _get_registry_and_lock():
     """Get registry and lock from components module."""
-    from provide.foundation.hub.components import get_component_registry, _registry_lock
+    from provide.foundation.hub.components import _registry_lock, get_component_registry
+
     return get_component_registry(), _registry_lock
 
 
 def resolve_component_dependencies(name: str, dimension: str) -> dict[str, Any]:
     """Resolve component dependencies recursively."""
     registry, registry_lock = _get_registry_and_lock()
-    
+
     with registry_lock:
         entry = registry.get_entry(name, dimension)
 
@@ -57,6 +58,6 @@ def discover_components(
 
 
 __all__ = [
-    "resolve_component_dependencies",
     "discover_components",
-]
+    "resolve_component_dependencies",
+]