provide-foundation 0.0.0.dev1__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,11 +1,13 @@
 """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
 from provide.foundation.logger import get_logger
 
 log = get_logger(__name__)
@@ -80,17 +82,12 @@ def temp_dir(
         yield temp_path
     finally:
         if cleanup and temp_path and temp_path.exists():
-            try:
+            with error_boundary(Exception, reraise=False):
                 shutil.rmtree(temp_path)
                 log.debug("Cleaned up temp directory", path=str(temp_path))
-            except Exception as e:
-                log.warning(
-                    "Failed to cleanup temp directory",
-                    path=str(temp_path),
-                    error=str(e),
-                )
 
 
+@with_error_handling(fallback=False, suppress=(FileNotFoundError,) if False else ())
 def safe_rmtree(
     path: Path | str,
     missing_ok: bool = True,
@@ -109,21 +106,15 @@ def safe_rmtree(
     """
     path = Path(path)
 
-    try:
-        if path.exists():
-            shutil.rmtree(path)
-            log.debug("Removed directory tree", path=str(path))
-            return True
-        elif missing_ok:
-            log.debug("Directory already absent", path=str(path))
-            return False
-        else:
-            raise FileNotFoundError(f"Directory does not exist: {path}")
-    except Exception as e:
-        if not path.exists() and missing_ok:
-            return False
-        log.error("Failed to remove directory tree", path=str(path), error=str(e))
-        raise
+    if path.exists():
+        shutil.rmtree(path)
+        log.debug("Removed directory tree", path=str(path))
+        return True
+    elif missing_ok:
+        log.debug("Directory already absent", path=str(path))
+        return False
+    else:
+        raise FileNotFoundError(f"Directory does not exist: {path}")
 
 
 __all__ = [

provide/foundation/file/lock.py

@@ -4,6 +4,7 @@ import os
 from pathlib import Path
 import time
 
+from provide.foundation.config.defaults import DEFAULT_FILE_LOCK_TIMEOUT
 from provide.foundation.errors.resources import LockError
 from provide.foundation.logger import get_logger
 
@@ -25,7 +26,7 @@ class FileLock:
     def __init__(
         self,
         path: Path | str,
-        timeout: float = 10.0,
+        timeout: float = DEFAULT_FILE_LOCK_TIMEOUT,
         check_interval: float = 0.1,
     ) -> None:
         """Initialize file lock.
@@ -158,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