exonware-xwsystem 0.0.1.408__py3-none-any.whl → 0.0.1.410__py3-none-any.whl

exonware/xwsystem/monitoring/metrics.py

@@ -10,7 +10,7 @@ import time
 from collections import defaultdict, deque
 from contextlib import contextmanager
 from dataclasses import dataclass, field
-from typing import Any, Callable, Dict, List, Optional
+from typing import Any, Callable, Optional
 
 from ..config.logging_setup import get_logger
 
@@ -55,7 +55,7 @@ class OperationMetrics:
         """Get error rate as percentage."""
         return (self.error_count / max(1, self.total_calls)) * 100
 
-    def to_dict(self) -> Dict[str, Any]:
+    def to_dict(self) -> dict[str, Any]:
         """Convert to dictionary representation."""
         return {
             "total_calls": self.total_calls,
@@ -75,9 +75,9 @@ class GenericMetrics:
     def __init__(self, component_name: str = "generic"):
         self.component_name = component_name
         self._logger = get_logger(f"{component_name}.metrics")
-        self._operations: Dict[str, OperationMetrics] = defaultdict(OperationMetrics)
-        self._counters: Dict[str, int] = defaultdict(int)
-        self._gauges: Dict[str, float] = {}
+        self._operations: dict[str, OperationMetrics] = defaultdict(OperationMetrics)
+        self._counters: dict[str, int] = defaultdict(int)
+        self._gauges: dict[str, float] = {}
         self._start_time = time.time()
         self._lock = threading.RLock()
 
@@ -179,14 +179,14 @@ class GenericMetrics:
         """Get uptime in seconds."""
         return time.time() - self._start_time
 
-    def get_operation_stats(self, operation_name: str) -> Dict[str, Any]:
+    def get_operation_stats(self, operation_name: str) -> dict[str, Any]:
         """Get statistics for a specific operation."""
         with self._lock:
             if operation_name in self._operations:
                 return self._operations[operation_name].to_dict()
             return {}
 
-    def get_summary(self) -> Dict[str, Any]:
+    def get_summary(self) -> dict[str, Any]:
         """Get comprehensive metrics summary."""
         with self._lock:
             operations_summary = {}
@@ -289,7 +289,7 @@ class GenericMetrics:
 
 
 # Global metrics registry
-_metrics_registry: Dict[str, GenericMetrics] = {}
+_metrics_registry: dict[str, GenericMetrics] = {}
 _registry_lock = threading.Lock()
 
 

exonware/xwsystem/monitoring/performance_manager_generic.py

@@ -10,7 +10,7 @@ health monitoring, and recommendations without being tied to specific implementa
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.408
+Version: 0.0.1.410
 Generation Date: November 04, 2025
 """
 
@@ -18,7 +18,7 @@ import threading
 import time
 from dataclasses import dataclass, field
 from enum import Enum
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Optional, Union
 
 from ..config.performance_modes import PerformanceMode
 from ..config.logging_setup import get_logger
@@ -34,7 +34,7 @@ class PerformanceRecommendation:
     priority: str  # 'low', 'medium', 'high', 'critical'
     message: str
     action: str
-    details: Dict[str, Any] = field(default_factory=dict)
+    details: dict[str, Any] = field(default_factory=dict)
 
 
 @dataclass
@@ -43,8 +43,8 @@ class HealthStatus:
 
     status: str  # 'excellent', 'good', 'fair', 'poor', 'critical'
     health_score: int  # 0-100
-    warnings: Dict[str, bool] = field(default_factory=dict)
-    details: Dict[str, Any] = field(default_factory=dict)
+    warnings: dict[str, bool] = field(default_factory=dict)
+    details: dict[str, Any] = field(default_factory=dict)
 
 
 class GenericPerformanceManager:
@@ -59,8 +59,8 @@ class GenericPerformanceManager:
         """Initialize generic performance manager."""
         self.component_name = component_name
         self._lock = threading.RLock()
-        self._mode_history: List[Dict[str, Any]] = []
-        self._performance_stats: Dict[str, Any] = {}
+        self._mode_history: list[dict[str, Any]] = []
+        self._performance_stats: dict[str, Any] = {}
         self._last_mode_change = time.time()
         self._local_mode = None
         self._local_config = None
@@ -121,7 +121,7 @@ class GenericPerformanceManager:
         # This should be overridden by subclasses
         return {"performance_mode": mode}
 
-    def get_mode_history(self) -> List[Dict[str, Any]]:
+    def get_mode_history(self) -> list[dict[str, Any]]:
         """Get the history of performance mode changes."""
         with self._lock:
             return self._mode_history.copy()
@@ -136,7 +136,7 @@ class GenericPerformanceManager:
     # GENERIC PERFORMANCE STATISTICS
     # ============================================================================
 
-    def get_performance_stats(self) -> Dict[str, Any]:
+    def get_performance_stats(self) -> dict[str, Any]:
         """Get comprehensive performance statistics."""
         with self._lock:
             current_mode = self.get_performance_mode()
@@ -282,7 +282,7 @@ class GenericPerformanceManager:
         logger.info(f"Performance monitoring stopped for {self.component_name}")
         return self
 
-    def get_performance_report(self) -> Dict[str, Any]:
+    def get_performance_report(self) -> dict[str, Any]:
         """Generate a comprehensive performance report."""
         stats = self.get_performance_stats()
         health = self.get_health_status()
@@ -296,8 +296,8 @@ class GenericPerformanceManager:
         }
 
     def benchmark_performance(
-        self, test_operations: List[callable] = None
-    ) -> Dict[str, Any]:
+        self, test_operations: list[callable] = None
+    ) -> dict[str, Any]:
         """Run performance benchmarks."""
         if test_operations is None:
             test_operations = []
@@ -337,11 +337,11 @@ class GenericPerformanceManager:
     # GENERIC HELPER METHODS (to be overridden by subclasses)
     # ============================================================================
 
-    def _get_cache_stats(self) -> Dict[str, Any]:
+    def _get_cache_stats(self) -> dict[str, Any]:
         """Get cache statistics. Override in subclasses."""
         return {"hit_rate": 0.0, "miss_rate": 0.0, "size": 0, "max_size": 0}
 
-    def _get_memory_stats(self) -> Dict[str, Any]:
+    def _get_memory_stats(self) -> dict[str, Any]:
         """Get memory usage statistics."""
         try:
             import os
@@ -361,7 +361,7 @@ class GenericPerformanceManager:
             logger.warning(f"Failed to get memory stats: {e}")
             return {"error": str(e)}
 
-    def _get_operation_stats(self) -> Dict[str, Any]:
+    def _get_operation_stats(self) -> dict[str, Any]:
         """Get operation statistics. Override in subclasses."""
         return {
             "total_operations": 0,
@@ -370,13 +370,13 @@ class GenericPerformanceManager:
             "fastest_operation": None,
         }
 
-    def _get_adaptive_stats(self) -> Dict[str, Any]:
+    def _get_adaptive_stats(self) -> dict[str, Any]:
         """Get adaptive learning statistics. Override in subclasses."""
         return {"learning_rate": 0.0, "adaptation_count": 0, "last_adaptation": None}
 
     def _generate_recommendations(
-        self, stats: Dict[str, Any], health: HealthStatus
-    ) -> List[PerformanceRecommendation]:
+        self, stats: dict[str, Any], health: HealthStatus
+    ) -> list[PerformanceRecommendation]:
         """Generate performance recommendations."""
         recommendations = []
 
@@ -463,7 +463,7 @@ class GenericPerformanceManager:
 
         return self
 
-    def _apply_manual_overrides(self, config_overrides: Dict[str, Any]) -> None:
+    def _apply_manual_overrides(self, config_overrides: dict[str, Any]) -> None:
         """Apply manual configuration overrides. Override in subclasses."""
         pass
 

exonware/xwsystem/monitoring/performance_monitor.py

@@ -9,7 +9,7 @@ framework-wide reusability.
 import logging
 import time
 from contextlib import contextmanager
-from typing import Any, ContextManager, Dict, List, Optional
+from typing import Any, ContextManager, Optional
 
 logger = logging.getLogger(__name__)
 
@@ -30,8 +30,8 @@ class PerformanceStats:
         """Initialize empty performance statistics."""
         self.operations_count = 0
         self.total_processing_time = 0.0
-        self.memory_usage_samples: List[Dict[str, Any]] = []
-        self.operation_history: List[Dict[str, Any]] = []
+        self.memory_usage_samples: list[dict[str, Any]] = []
+        self.operation_history: list[dict[str, Any]] = []
         self.error_count = 0
         self.cache_hits = 0
         self.cache_misses = 0
@@ -46,7 +46,7 @@ class PerformanceStats:
         self.cache_hits = 0
         self.cache_misses = 0
 
-    def to_native(self) -> Dict[str, Any]:
+    def to_native(self) -> dict[str, Any]:
         """Convert statistics to dictionary format."""
         return {
             "operations_count": self.operations_count,
@@ -58,7 +58,7 @@ class PerformanceStats:
             "cache_misses": self.cache_misses,
         }
 
-    def from_native(self, data: Dict[str, Any]) -> None:
+    def from_native(self, data: dict[str, Any]) -> None:
         """Load statistics from dictionary format."""
         self.operations_count = data.get("operations_count", 0)
         self.total_processing_time = data.get("total_processing_time", 0.0)
@@ -73,7 +73,7 @@ class PerformanceStats:
         operation_name: str,
         duration: float,
         success: bool = True,
-        memory_usage: Optional[Dict[str, Any]] = None,
+        memory_usage: Optional[dict[str, Any]] = None,
         **context_data: Any,
     ) -> None:
         """Add operation data to statistics."""
@@ -155,7 +155,7 @@ class PerformanceMonitor:
         """Get current performance statistics."""
         return self.stats
 
-    def get_stats_dict(self) -> Dict[str, Any]:
+    def get_stats_dict(self) -> dict[str, Any]:
         """Get performance statistics as dictionary."""
         return self.stats.to_native()
 
@@ -179,7 +179,7 @@ class PerformanceMonitor:
         operation_name: str,
         duration: float,
         success: bool = True,
-        memory_usage: Optional[Dict[str, Any]] = None,
+        memory_usage: Optional[dict[str, Any]] = None,
         **context_data: Any,
     ) -> None:
         """Record an operation manually."""
@@ -200,7 +200,7 @@ class PerformanceMonitor:
         if self._enabled:
             self.stats.cache_misses += 1
 
-    def get_summary(self) -> Dict[str, Any]:
+    def get_summary(self) -> dict[str, Any]:
         """Get performance summary."""
         return {
             "monitor_name": self.name,
@@ -303,7 +303,7 @@ def enhanced_error_context(operation: str, **context_data: Any) -> ContextManage
     return ErrorContext()
 
 
-def calculate_performance_summary(stats: Dict[str, Any]) -> Dict[str, Any]:
+def calculate_performance_summary(stats: dict[str, Any]) -> dict[str, Any]:
     """
     Calculate performance summary from statistics.
 
@@ -341,7 +341,7 @@ def calculate_performance_summary(stats: Dict[str, Any]) -> Dict[str, Any]:
 
 
 def format_performance_report(
-    stats: Dict[str, Any], include_history: bool = False
+    stats: dict[str, Any], include_history: bool = False
 ) -> str:
     """
     Format performance statistics as a readable report.

exonware/xwsystem/monitoring/performance_validator.py

@@ -10,7 +10,7 @@ import threading
 import time
 from collections import defaultdict, deque
 from dataclasses import dataclass, field
-from typing import Any, Callable, Dict, List, Optional
+from typing import Any, Callable, Optional
 
 from ..config.logging_setup import get_logger
 
@@ -25,8 +25,8 @@ class PerformanceMetric:
     duration: float  # seconds
     timestamp: float
     success: bool = True
-    error_info: Optional[Dict[str, Any]] = None
-    additional_data: Dict[str, Any] = field(default_factory=dict)
+    error_info: Optional[dict[str, Any]] = None
+    additional_data: dict[str, Any] = field(default_factory=dict)
 
 
 @dataclass
@@ -57,8 +57,8 @@ class PerformanceReport:
     percentile_99: float
     error_rate: float
     throughput: float  # operations per second
-    threshold_violations: List[str] = field(default_factory=list)
-    recommendations: List[str] = field(default_factory=list)
+    threshold_violations: list[str] = field(default_factory=list)
+    recommendations: list[str] = field(default_factory=list)
 
 
 class PerformanceValidator:
@@ -86,11 +86,11 @@ class PerformanceValidator:
         self.enable_regression_detection = enable_regression_detection
 
         # Performance data storage
-        self._metrics: Dict[str, deque] = defaultdict(
+        self._metrics: dict[str, deque] = defaultdict(
             lambda: deque(maxlen=max_metrics_per_operation)
         )
-        self._thresholds: Dict[str, PerformanceThreshold] = {}
-        self._baseline_performance: Dict[str, Dict[str, float]] = {}
+        self._thresholds: dict[str, PerformanceThreshold] = {}
+        self._baseline_performance: dict[str, dict[str, float]] = {}
 
         # Thread safety
         self._lock = threading.RLock()
@@ -103,8 +103,8 @@ class PerformanceValidator:
         self._regressions_detected = 0
 
         # Callbacks
-        self._threshold_violation_callbacks: List[Callable] = []
-        self._regression_detected_callbacks: List[Callable] = []
+        self._threshold_violation_callbacks: list[Callable] = []
+        self._regression_detected_callbacks: list[Callable] = []
 
         logger.info("📊 Performance validator initialized")
 
@@ -119,8 +119,8 @@ class PerformanceValidator:
         operation_name: str,
         duration: float,
         success: bool = True,
-        error_info: Optional[Dict[str, Any]] = None,
-        additional_data: Dict[str, Any] = None,
+        error_info: Optional[dict[str, Any]] = None,
+        additional_data: dict[str, Any] = None,
     ) -> None:
         """Record a performance metric."""
         if additional_data is None:
@@ -139,12 +139,12 @@ class PerformanceValidator:
             self._metrics[operation_name].append(metric)
             self._total_metrics_recorded += 1
 
-    def get_operation_metrics(self, operation_name: str) -> List[PerformanceMetric]:
+    def get_operation_metrics(self, operation_name: str) -> list[PerformanceMetric]:
         """Get all metrics for a specific operation."""
         with self._lock:
             return list(self._metrics.get(operation_name, []))
 
-    def calculate_percentiles(self, durations: List[float]) -> Dict[str, float]:
+    def calculate_percentiles(self, durations: list[float]) -> dict[str, float]:
         """Calculate percentiles for a list of durations."""
         if not durations:
             return {}
@@ -265,7 +265,7 @@ class PerformanceValidator:
 
         return report
 
-    def validate_all_operations(self) -> Dict[str, PerformanceReport]:
+    def validate_all_operations(self) -> dict[str, PerformanceReport]:
         """Validate performance for all operations."""
         with self._lock:
             operation_names = set(self._metrics.keys())
@@ -276,7 +276,7 @@ class PerformanceValidator:
 
         return reports
 
-    def detect_regression(self, operation_name: str) -> Optional[Dict[str, Any]]:
+    def detect_regression(self, operation_name: str) -> Optional[dict[str, Any]]:
         """Detect performance regression compared to baseline."""
         if not self.enable_regression_detection:
             return None
@@ -409,7 +409,7 @@ class PerformanceValidator:
                 logger.error(f"Error in validation loop: {e}")
                 time.sleep(1.0)  # Brief pause on error
 
-    def get_performance_statistics(self) -> Dict[str, Any]:
+    def get_performance_statistics(self) -> dict[str, Any]:
         """Get overall performance statistics."""
         with self._lock:
             total_operations = sum(len(metrics) for metrics in self._metrics.values())
@@ -482,8 +482,8 @@ def record_performance_metric(
     operation_name: str,
     duration: float,
     success: bool = True,
-    error_info: Optional[Dict[str, Any]] = None,
-    additional_data: Dict[str, Any] = None,
+    error_info: Optional[dict[str, Any]] = None,
+    additional_data: dict[str, Any] = None,
 ) -> None:
     """Record a global performance metric."""
     validator = get_performance_validator()
@@ -498,7 +498,7 @@ def validate_performance(operation_name: str) -> PerformanceReport:
     return validator.validate_performance(operation_name)
 
 
-def get_performance_statistics() -> Dict[str, Any]:
+def get_performance_statistics() -> dict[str, Any]:
     """Get global performance statistics."""
     validator = get_performance_validator()
     return validator.get_performance_statistics()

exonware/xwsystem/monitoring/system_monitor.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.408
+Version: 0.0.1.410
 Generation Date: September 04, 2025
 
 System-wide monitoring and hardware introspection utilities.
@@ -12,7 +12,7 @@ import os
 import platform
 import time
 from dataclasses import dataclass
-from typing import Dict, List, Optional, Any, Tuple, Union
+from typing import Optional, Any, Union
 from pathlib import Path
 
 # Import psutil - lazy installation system will handle it if missing
@@ -37,7 +37,7 @@ class ProcessInfo:
     create_time: float
     num_threads: int
     username: Optional[str] = None
-    cmdline: Optional[List[str]] = None
+    cmdline: Optional[list[str]] = None
     cwd: Optional[str] = None
     exe: Optional[str] = None
 
@@ -149,7 +149,7 @@ class SystemMonitor:
     # PROCESS MONITORING
     # =============================================================================
     
-    def list_processes(self, attrs: Optional[List[str]] = None) -> List[ProcessInfo]:
+    def list_processes(self, attrs: Optional[list[str]] = None) -> list[ProcessInfo]:
         """
         List all running processes.
         
@@ -251,7 +251,7 @@ class SystemMonitor:
         except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
             return None
     
-    def find_processes_by_name(self, name: str) -> List[ProcessInfo]:
+    def find_processes_by_name(self, name: str) -> list[ProcessInfo]:
         """
         Find processes by name.
         
@@ -357,7 +357,7 @@ class SystemMonitor:
         
         return SystemInfo(**system_info)
     
-    def get_cpu_usage(self, interval: float = 1.0, per_cpu: bool = False) -> Union[float, List[float]]:
+    def get_cpu_usage(self, interval: float = 1.0, per_cpu: bool = False) -> Union[float, list[float]]:
         """
         Get CPU usage percentage.
         
@@ -372,7 +372,7 @@ class SystemMonitor:
         
         return psutil.cpu_percent(interval=interval, percpu=per_cpu)
     
-    def get_memory_usage(self) -> Dict[str, Any]:
+    def get_memory_usage(self) -> dict[str, Any]:
         """
         Get memory usage information.
         
@@ -394,7 +394,7 @@ class SystemMonitor:
             'cached': getattr(memory, 'cached', 0),
         }
     
-    def get_disk_usage(self) -> List[DiskInfo]:
+    def get_disk_usage(self) -> list[DiskInfo]:
         """
         Get disk usage information for all mounted disks.
         
@@ -427,7 +427,7 @@ class SystemMonitor:
         
         return disks
     
-    def get_network_interfaces(self) -> List[NetworkInfo]:
+    def get_network_interfaces(self) -> list[NetworkInfo]:
         """
         Get network interface statistics.
         
@@ -468,7 +468,7 @@ class SystemMonitor:
         
         return interfaces
     
-    def get_network_connections(self, kind: str = 'inet') -> List[NetworkConnection]:
+    def get_network_connections(self, kind: str = 'inet') -> list[NetworkConnection]:
         """
         Get network connections.
         
@@ -518,7 +518,7 @@ class SystemMonitor:
     # HARDWARE INFORMATION
     # =============================================================================
     
-    def get_hardware_info(self) -> Dict[str, Any]:
+    def get_hardware_info(self) -> dict[str, Any]:
         """
         Get detailed hardware information.
         
@@ -648,11 +648,11 @@ class SystemMonitor:
             # Fallback to environment variables
             return os.getenv('USER') or os.getenv('USERNAME') or 'unknown'
     
-    def get_environment_variables(self) -> Dict[str, str]:
+    def get_environment_variables(self) -> dict[str, str]:
         """Get all environment variables."""
         return dict(os.environ)
     
-    def get_python_info(self) -> Dict[str, Any]:
+    def get_python_info(self) -> dict[str, Any]:
         """Get Python runtime information."""
         import sys
         
@@ -670,7 +670,7 @@ class SystemMonitor:
 _system_monitor = SystemMonitor()
 
 # Convenience functions
-def list_processes() -> List[ProcessInfo]:
+def list_processes() -> list[ProcessInfo]:
     """List all running processes."""
     return _system_monitor.list_processes()
 
@@ -686,11 +686,11 @@ def get_cpu_usage(interval: float = 1.0) -> float:
     """Get CPU usage percentage."""
     return _system_monitor.get_cpu_usage(interval)
 
-def get_memory_usage() -> Dict[str, Any]:
+def get_memory_usage() -> dict[str, Any]:
     """Get memory usage information."""
     return _system_monitor.get_memory_usage()
 
-def get_hardware_info() -> Dict[str, Any]:
+def get_hardware_info() -> dict[str, Any]:
     """Get hardware information."""
     return _system_monitor.get_hardware_info()