exonware-xwsystem 0.0.1.409__py3-none-any.whl → 0.0.1.411__py3-none-any.whl

exonware/xwsystem/ipc/process_manager.py

@@ -16,7 +16,7 @@ import time
 import signal
 import subprocess
 import multiprocessing as mp
-from typing import Dict, List, Optional, Callable, Any, Union
+from typing import Optional, Callable, Any, Union
 from dataclasses import dataclass
 from threading import Lock, Event
 import logging
@@ -29,7 +29,7 @@ class ProcessInfo:
     """Information about a managed process."""
     pid: int
     name: str
-    command: List[str]
+    command: list[str]
     started_at: float
     status: str  # 'running', 'stopped', 'failed', 'terminated'
     exit_code: Optional[int] = None
@@ -60,8 +60,8 @@ class ProcessManager:
         """
         self.max_processes = max_processes or mp.cpu_count() * 2
         self.monitor_interval = monitor_interval
-        self.processes: Dict[str, subprocess.Popen] = {}
-        self.process_info: Dict[str, ProcessInfo] = {}
+        self.processes: dict[str, subprocess.Popen] = {}
+        self.process_info: dict[str, ProcessInfo] = {}
         self._lock = Lock()
         self._shutdown_event = Event()
         self._monitor_thread = None
@@ -74,9 +74,9 @@ class ProcessManager:
     
     def start_process(self, 
                      name: str, 
-                     command: Union[str, List[str]], 
+                     command: Union[str, list[str]], 
                      cwd: Optional[str] = None,
-                     env: Optional[Dict[str, str]] = None,
+                     env: Optional[dict[str, str]] = None,
                      shell: bool = False) -> bool:
         """
         Start a new managed process.
@@ -227,7 +227,7 @@ class ProcessManager:
         with self._lock:
             return self.process_info.get(name)
     
-    def list_processes(self) -> List[ProcessInfo]:
+    def list_processes(self) -> list[ProcessInfo]:
         """List all managed processes."""
         with self._lock:
             return list(self.process_info.values())

exonware/xwsystem/ipc/process_pool.py

@@ -17,7 +17,7 @@ import logging
 import multiprocessing as mp
 import time
 from dataclasses import dataclass
-from typing import Any, Callable, Dict, List, Optional, Union
+from typing import Any, Callable, Optional, Union
 
 logger = logging.getLogger(__name__)
 
@@ -79,8 +79,8 @@ class ProcessPool:
         )
         
         # Task tracking
-        self._active_tasks: Dict[str, concurrent.futures.Future] = {}
-        self._completed_tasks: List[TaskResult] = []
+        self._active_tasks: dict[str, concurrent.futures.Future] = {}
+        self._completed_tasks: list[TaskResult] = []
         self._task_counter = 0
         
         # Statistics
@@ -202,7 +202,7 @@ class ProcessPool:
         
         return None
     
-    def wait_for_all(self, timeout: Optional[float] = None) -> List[TaskResult]:
+    def wait_for_all(self, timeout: Optional[float] = None) -> list[TaskResult]:
         """
         Wait for all active tasks to complete.
         
@@ -247,7 +247,7 @@ class ProcessPool:
         
         return cancelled
     
-    def get_active_tasks(self) -> List[str]:
+    def get_active_tasks(self) -> list[str]:
         """Get list of active task IDs."""
         return list(self._active_tasks.keys())
     
@@ -321,7 +321,7 @@ class AsyncProcessPool:
         self._loop: Optional[asyncio.AbstractEventLoop] = None
         
         # Task tracking
-        self._active_tasks: Dict[str, asyncio.Task] = {}
+        self._active_tasks: dict[str, asyncio.Task] = {}
         self._task_counter = 0
     
     def _ensure_executor(self):
@@ -397,7 +397,7 @@ class AsyncProcessPool:
         else:
             return await task
     
-    async def wait_for_all(self, timeout: Optional[float] = None) -> List[Any]:
+    async def wait_for_all(self, timeout: Optional[float] = None) -> list[Any]:
         """
         Wait for all active tasks to complete.
         
@@ -454,7 +454,7 @@ class AsyncProcessPool:
         
         return cancelled
     
-    def get_active_tasks(self) -> List[str]:
+    def get_active_tasks(self) -> list[str]:
         """Get list of active task IDs."""
         return list(self._active_tasks.keys())
     

exonware/xwsystem/ipc/shared_memory.py

@@ -16,16 +16,16 @@ import mmap
 import struct
 import pickle
 import threading
-from typing import Any, Dict, Optional, Union, TypeVar, Generic
+from typing import Any, Optional, Union
+# Root cause: Migrating to Python 3.12 built-in generic syntax for consistency
+# Priority #3: Maintainability - Modern type annotations improve code clarity
 from contextlib import contextmanager
 import logging
 
 logger = logging.getLogger(__name__)
 
-T = TypeVar('T')
 
-
-class SharedData(Generic[T]):
+class SharedData[T]:
     """
     Thread-safe shared data container with automatic serialization.
     
@@ -68,7 +68,7 @@ class SharedData(Generic[T]):
                 # Unix: Use /dev/shm or temporary files
                 import tempfile
                 self._file_handle = tempfile.NamedTemporaryFile(
-                    prefix=f"xsystem_shared_{self.name}_",
+                    prefix=f"xwsystem_shared_{self.name}_",
                     delete=False
                 )
                 self._file_handle.write(b'\x00' * self.size)
@@ -242,7 +242,7 @@ class SharedMemoryManager:
     """
     
     def __init__(self):
-        self._segments: Dict[str, SharedData] = {}
+        self._segments: dict[str, SharedData] = {}
         self._lock = threading.RLock()
     
     def create_segment(self, name: str, size: int = 1024 * 1024) -> SharedData:
@@ -364,7 +364,7 @@ class SharedMemory:
             name: Name for the shared memory segment
             size: Size of the memory segment
         """
-        self.name = name or f"xsystem_shared_{os.getpid()}"
+        self.name = name or f"xwsystem_shared_{os.getpid()}"
         self.size = size
         self._manager = SharedMemoryManager()
         self._segment = None

exonware/xwsystem/monitoring/base.py

@@ -1,16 +1,16 @@
-#exonware/xsystem/monitoring/base.py
+#exonware/xwsystem/monitoring/base.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: September 04, 2025
 
 Monitoring module base classes - abstract classes for monitoring functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union, Callable, TYPE_CHECKING
+from typing import Any, Optional, Union, Callable, TYPE_CHECKING
 from .defs import MetricType, AlertLevel, HealthStatus, SpanKind
 
 if TYPE_CHECKING:
@@ -28,9 +28,9 @@ class APerformanceMonitorBase(ABC):
             monitor_name: Name of the performance monitor
         """
         self.monitor_name = monitor_name
-        self._metrics: Dict[str, Any] = {}
-        self._thresholds: Dict[str, float] = {}
-        self._alerts: List[Dict[str, Any]] = []
+        self._metrics: dict[str, Any] = {}
+        self._thresholds: dict[str, float] = {}
+        self._alerts: list[dict[str, Any]] = []
     
     @abstractmethod
     def start_monitoring(self) -> None:
@@ -58,7 +58,7 @@ class APerformanceMonitorBase(ABC):
         pass
     
     @abstractmethod
-    def get_all_metrics(self) -> Dict[str, float]:
+    def get_all_metrics(self) -> dict[str, float]:
         """Get all metrics."""
         pass
     
@@ -68,12 +68,12 @@ class APerformanceMonitorBase(ABC):
         pass
     
     @abstractmethod
-    def check_thresholds(self) -> List[Dict[str, Any]]:
+    def check_thresholds(self) -> list[dict[str, Any]]:
         """Check if any metrics exceed thresholds."""
         pass
     
     @abstractmethod
-    def get_performance_summary(self) -> Dict[str, Any]:
+    def get_performance_summary(self) -> dict[str, Any]:
         """Get performance summary."""
         pass
 
@@ -83,7 +83,7 @@ class AMemoryMonitorBase(ABC):
     
     def __init__(self):
         """Initialize memory monitor."""
-        self._memory_snapshots: List[Dict[str, Any]] = []
+        self._memory_snapshots: list[dict[str, Any]] = []
         self._leak_detection_enabled = False
     
     @abstractmethod
@@ -97,22 +97,22 @@ class AMemoryMonitorBase(ABC):
         pass
     
     @abstractmethod
-    def take_snapshot(self) -> Dict[str, Any]:
+    def take_snapshot(self) -> dict[str, Any]:
         """Take memory snapshot."""
         pass
     
     @abstractmethod
-    def get_memory_usage(self) -> Dict[str, float]:
+    def get_memory_usage(self) -> dict[str, float]:
         """Get current memory usage."""
         pass
     
     @abstractmethod
-    def detect_memory_leaks(self) -> List[Dict[str, Any]]:
+    def detect_memory_leaks(self) -> list[dict[str, Any]]:
         """Detect potential memory leaks."""
         pass
     
     @abstractmethod
-    def get_memory_stats(self) -> Dict[str, Any]:
+    def get_memory_stats(self) -> dict[str, Any]:
         """Get memory statistics."""
         pass
     
@@ -122,7 +122,7 @@ class AMemoryMonitorBase(ABC):
         pass
     
     @abstractmethod
-    def get_garbage_collection_stats(self) -> Dict[str, Any]:
+    def get_garbage_collection_stats(self) -> dict[str, Any]:
         """Get garbage collection statistics."""
         pass
     
@@ -143,10 +143,10 @@ class AMetricsBase(ABC):
             metrics_name: Name of the metrics collector
         """
         self.metrics_name = metrics_name
-        self._counters: Dict[str, int] = {}
-        self._gauges: Dict[str, float] = {}
-        self._histograms: Dict[str, List[float]] = {}
-        self._timers: Dict[str, List[float]] = {}
+        self._counters: dict[str, int] = {}
+        self._gauges: dict[str, float] = {}
+        self._histograms: dict[str, list[float]] = {}
+        self._timers: dict[str, list[float]] = {}
     
     @abstractmethod
     def increment_counter(self, name: str, value: int = 1) -> None:
@@ -179,17 +179,17 @@ class AMetricsBase(ABC):
         pass
     
     @abstractmethod
-    def get_histogram_stats(self, name: str) -> Dict[str, float]:
+    def get_histogram_stats(self, name: str) -> dict[str, float]:
         """Get histogram statistics."""
         pass
     
     @abstractmethod
-    def get_timer_stats(self, name: str) -> Dict[str, float]:
+    def get_timer_stats(self, name: str) -> dict[str, float]:
         """Get timer statistics."""
         pass
     
     @abstractmethod
-    def export_metrics(self) -> Dict[str, Any]:
+    def export_metrics(self) -> dict[str, Any]:
         """Export all metrics."""
         pass
     
@@ -204,8 +204,8 @@ class AErrorRecoveryBase(ABC):
     
     def __init__(self):
         """Initialize error recovery."""
-        self._recovery_strategies: Dict[str, Callable] = {}
-        self._circuit_breakers: Dict[str, Dict[str, Any]] = {}
+        self._recovery_strategies: dict[str, Callable] = {}
+        self._circuit_breakers: dict[str, dict[str, Any]] = {}
     
     @abstractmethod
     def register_recovery_strategy(self, error_type: str, strategy: Callable) -> None:
@@ -213,7 +213,7 @@ class AErrorRecoveryBase(ABC):
         pass
     
     @abstractmethod
-    def handle_error(self, error: Exception, context: Dict[str, Any]) -> bool:
+    def handle_error(self, error: Exception, context: dict[str, Any]) -> bool:
         """Handle error with recovery strategy."""
         pass
     
@@ -239,7 +239,7 @@ class AErrorRecoveryBase(ABC):
         pass
     
     @abstractmethod
-    def get_circuit_state(self, name: str) -> Dict[str, Any]:
+    def get_circuit_state(self, name: str) -> dict[str, Any]:
         """Get circuit breaker state."""
         pass
 
@@ -250,7 +250,7 @@ class ASystemMonitorBase(ABC):
     def __init__(self):
         """Initialize system monitor."""
         self._monitoring_enabled = False
-        self._system_metrics: Dict[str, Any] = {}
+        self._system_metrics: dict[str, Any] = {}
     
     @abstractmethod
     def start_system_monitoring(self) -> None:
@@ -268,17 +268,17 @@ class ASystemMonitorBase(ABC):
         pass
     
     @abstractmethod
-    def get_memory_usage(self) -> Dict[str, float]:
+    def get_memory_usage(self) -> dict[str, float]:
         """Get memory usage statistics."""
         pass
     
     @abstractmethod
-    def get_disk_usage(self) -> Dict[str, float]:
+    def get_disk_usage(self) -> dict[str, float]:
         """Get disk usage statistics."""
         pass
     
     @abstractmethod
-    def get_network_usage(self) -> Dict[str, float]:
+    def get_network_usage(self) -> dict[str, float]:
         """Get network usage statistics."""
         pass
     
@@ -303,7 +303,7 @@ class ASystemMonitorBase(ABC):
         pass
     
     @abstractmethod
-    def get_system_info(self) -> Dict[str, Any]:
+    def get_system_info(self) -> dict[str, Any]:
         """Get comprehensive system information."""
         pass
 
@@ -322,7 +322,7 @@ class ATracingProvider(ABC):
         name: str, 
         kind: 'SpanKind' = None,
         parent: Optional['SpanContext'] = None,
-        attributes: Optional[Dict[str, Any]] = None
+        attributes: Optional[dict[str, Any]] = None
     ) -> 'SpanContext':
         """Start a new span."""
         pass
@@ -338,6 +338,6 @@ class ATracingProvider(ABC):
         pass
     
     @abstractmethod
-    def add_span_event(self, span: 'SpanContext', name: str, attributes: Optional[Dict[str, Any]] = None) -> None:
+    def add_span_event(self, span: 'SpanContext', name: str, attributes: Optional[dict[str, Any]] = None) -> None:
         """Add event to span."""
         pass

exonware/xwsystem/monitoring/contracts.py

@@ -3,14 +3,14 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: September 04, 2025
 
 Monitoring protocol interfaces for XWSystem.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union, Iterator, Callable, Tuple, Protocol
+from typing import Any, Optional, Union, Iterator, Callable, Protocol
 from typing_extensions import runtime_checkable
 import time
 
@@ -63,7 +63,7 @@ class IPerformance(ABC):
         pass
     
     @abstractmethod
-    def get_metrics(self) -> Dict[str, Any]:
+    def get_metrics(self) -> dict[str, Any]:
         """
         Get performance metrics.
         
@@ -172,7 +172,7 @@ class IMonitorable(ABC):
         pass
     
     @abstractmethod
-    def get_health(self) -> Dict[str, Any]:
+    def get_health(self) -> dict[str, Any]:
         """
         Get health information.
         
@@ -192,7 +192,7 @@ class IMonitorable(ABC):
         pass
     
     @abstractmethod
-    def get_monitoring_info(self) -> Dict[str, Any]:
+    def get_monitoring_info(self) -> dict[str, Any]:
         """
         Get monitoring information.
         
@@ -234,7 +234,7 @@ class IMetrics(ABC):
     """
     
     @abstractmethod
-    def collect_metrics(self) -> Dict[str, Any]:
+    def collect_metrics(self) -> dict[str, Any]:
         """
         Collect all metrics.
         
@@ -244,7 +244,7 @@ class IMetrics(ABC):
         pass
     
     @abstractmethod
-    def add_metric(self, name: str, value: Any, labels: Optional[Dict[str, str]] = None) -> None:
+    def add_metric(self, name: str, value: Any, labels: Optional[dict[str, str]] = None) -> None:
         """
         Add metric.
         
@@ -282,7 +282,7 @@ class IMetrics(ABC):
         pass
     
     @abstractmethod
-    def list_metrics(self) -> List[str]:
+    def list_metrics(self) -> list[str]:
         """
         List all metric names.
         
@@ -312,7 +312,7 @@ class IMetrics(ABC):
         pass
     
     @abstractmethod
-    def get_metrics_summary(self) -> Dict[str, Any]:
+    def get_metrics_summary(self) -> dict[str, Any]:
         """
         Get metrics summary.
         
@@ -344,7 +344,7 @@ class IHealthCheck(ABC):
         pass
     
     @abstractmethod
-    def get_health_details(self) -> Dict[str, Any]:
+    def get_health_details(self) -> dict[str, Any]:
         """
         Get detailed health information.
         
@@ -378,7 +378,7 @@ class IHealthCheck(ABC):
         pass
     
     @abstractmethod
-    def list_health_checks(self) -> List[str]:
+    def list_health_checks(self) -> list[str]:
         """
         List all health check names.
         
@@ -388,7 +388,7 @@ class IHealthCheck(ABC):
         pass
     
     @abstractmethod
-    def run_health_checks(self) -> Dict[str, HealthStatus]:
+    def run_health_checks(self) -> dict[str, HealthStatus]:
         """
         Run all health checks.
         
@@ -446,7 +446,7 @@ class IAlerting(ABC):
         pass
     
     @abstractmethod
-    def get_alert(self, alert_id: str) -> Optional[Dict[str, Any]]:
+    def get_alert(self, alert_id: str) -> Optional[dict[str, Any]]:
         """
         Get alert by ID.
         
@@ -459,7 +459,7 @@ class IAlerting(ABC):
         pass
     
     @abstractmethod
-    def list_alerts(self, level: Optional[AlertLevel] = None) -> List[Dict[str, Any]]:
+    def list_alerts(self, level: Optional[AlertLevel] = None) -> list[dict[str, Any]]:
         """
         List alerts.
         
@@ -513,7 +513,7 @@ class IAlerting(ABC):
         pass
     
     @abstractmethod
-    def get_alert_stats(self) -> Dict[str, int]:
+    def get_alert_stats(self) -> dict[str, int]:
         """
         Get alert statistics.
         
@@ -557,7 +557,7 @@ class ISystemMonitor(ABC):
         pass
     
     @abstractmethod
-    def get_memory_usage(self) -> Dict[str, Any]:
+    def get_memory_usage(self) -> dict[str, Any]:
         """
         Get memory usage information.
         
@@ -567,7 +567,7 @@ class ISystemMonitor(ABC):
         pass
     
     @abstractmethod
-    def get_disk_usage(self) -> Dict[str, Any]:
+    def get_disk_usage(self) -> dict[str, Any]:
         """
         Get disk usage information.
         
@@ -577,7 +577,7 @@ class ISystemMonitor(ABC):
         pass
     
     @abstractmethod
-    def get_network_usage(self) -> Dict[str, Any]:
+    def get_network_usage(self) -> dict[str, Any]:
         """
         Get network usage information.
         
@@ -587,7 +587,7 @@ class ISystemMonitor(ABC):
         pass
     
     @abstractmethod
-    def get_process_info(self) -> List[Dict[str, Any]]:
+    def get_process_info(self) -> list[dict[str, Any]]:
         """
         Get process information.
         
@@ -617,7 +617,7 @@ class ISystemMonitor(ABC):
         pass
     
     @abstractmethod
-    def get_system_info(self) -> Dict[str, Any]:
+    def get_system_info(self) -> dict[str, Any]:
         """
         Get system information.
         
@@ -652,7 +652,7 @@ class IProfiler(ABC):
         pass
     
     @abstractmethod
-    def stop_profiling(self, session_id: str) -> Dict[str, Any]:
+    def stop_profiling(self, session_id: str) -> dict[str, Any]:
         """
         Stop profiling session.
         
@@ -665,7 +665,7 @@ class IProfiler(ABC):
         pass
     
     @abstractmethod
-    def profile_function(self, func: Callable, *args, **kwargs) -> Tuple[Any, Dict[str, Any]]:
+    def profile_function(self, func: Callable, *args, **kwargs) -> tuple[Any, dict[str, Any]]:
         """
         Profile function execution.
         
@@ -680,7 +680,7 @@ class IProfiler(ABC):
         pass
     
     @abstractmethod
-    def get_profiling_results(self, session_id: str) -> Optional[Dict[str, Any]]:
+    def get_profiling_results(self, session_id: str) -> Optional[dict[str, Any]]:
         """
         Get profiling results.
         
@@ -693,7 +693,7 @@ class IProfiler(ABC):
         pass
     
     @abstractmethod
-    def list_profiling_sessions(self) -> List[str]:
+    def list_profiling_sessions(self) -> list[str]:
         """
         List profiling sessions.
         
@@ -813,7 +813,7 @@ class IMonitoringConfig(ABC):
         pass
     
     @abstractmethod
-    def get_monitoring_config(self) -> Dict[str, Any]:
+    def get_monitoring_config(self) -> dict[str, Any]:
         """
         Get monitoring configuration.
         
@@ -823,7 +823,7 @@ class IMonitoringConfig(ABC):
         pass
     
     @abstractmethod
-    def set_monitoring_config(self, config: Dict[str, Any]) -> None:
+    def set_monitoring_config(self, config: dict[str, Any]) -> None:
         """
         Set monitoring configuration.
         
@@ -849,6 +849,6 @@ class Monitorable(Protocol):
         """Stop performance monitoring."""
         ...
     
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """Get performance statistics."""
         ...

exonware/xwsystem/monitoring/defs.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: 07-Sep-2025
 
 Monitoring types and enums for XWSystem.