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

exonware/xwsystem/plugins/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
 
 Plugin protocol interfaces for XWSystem.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union, Iterator, Callable, Type, Tuple
+from typing import Any, Optional, Union, Iterator, Callable
 import importlib
 
 # Import enums from types module
@@ -49,7 +49,7 @@ class IPlugin(ABC):
         pass
     
     @abstractmethod
-    def get_info(self) -> Dict[str, Any]:
+    def get_info(self) -> dict[str, Any]:
         """
         Get plugin information.
         
@@ -113,7 +113,7 @@ class IPlugin(ABC):
         pass
     
     @abstractmethod
-    def get_dependencies(self) -> List[str]:
+    def get_dependencies(self) -> list[str]:
         """
         Get plugin dependencies.
         
@@ -191,7 +191,7 @@ class IExtensible(ABC):
         pass
     
     @abstractmethod
-    def get_extensions(self) -> List[Any]:
+    def get_extensions(self) -> list[Any]:
         """
         Get all extensions.
         
@@ -227,7 +227,7 @@ class IExtensible(ABC):
         pass
     
     @abstractmethod
-    def list_extension_names(self) -> List[str]:
+    def list_extension_names(self) -> list[str]:
         """
         List extension names.
         
@@ -309,7 +309,7 @@ class IHookable(ABC):
         pass
     
     @abstractmethod
-    def list_hooks(self, event: Optional[str] = None) -> List[Dict[str, Any]]:
+    def list_hooks(self, event: Optional[str] = None) -> list[dict[str, Any]]:
         """
         List hooks.
         
@@ -422,7 +422,7 @@ class IPluginManager(ABC):
         pass
     
     @abstractmethod
-    def list_plugins(self) -> List[str]:
+    def list_plugins(self) -> list[str]:
         """
         List all plugin names.
         
@@ -432,7 +432,7 @@ class IPluginManager(ABC):
         pass
     
     @abstractmethod
-    def list_loaded_plugins(self) -> List[str]:
+    def list_loaded_plugins(self) -> list[str]:
         """
         List loaded plugin names.
         
@@ -455,7 +455,7 @@ class IPluginManager(ABC):
         pass
     
     @abstractmethod
-    def get_plugin_info(self, plugin_name: str) -> Optional[Dict[str, Any]]:
+    def get_plugin_info(self, plugin_name: str) -> Optional[dict[str, Any]]:
         """
         Get plugin information.
         
@@ -480,7 +480,7 @@ class IPluginRegistry(ABC):
     """
     
     @abstractmethod
-    def register_plugin(self, plugin_class: Type[IPlugin], name: str, priority: PluginPriority = PluginPriority.NORMAL) -> bool:
+    def register_plugin(self, plugin_class: type[IPlugin], name: str, priority: PluginPriority = PluginPriority.NORMAL) -> bool:
         """
         Register plugin class.
         
@@ -508,7 +508,7 @@ class IPluginRegistry(ABC):
         pass
     
     @abstractmethod
-    def get_registered_plugins(self) -> Dict[str, Type[IPlugin]]:
+    def get_registered_plugins(self) -> dict[str, type[IPlugin]]:
         """
         Get all registered plugins.
         
@@ -531,7 +531,7 @@ class IPluginRegistry(ABC):
         pass
     
     @abstractmethod
-    def get_plugin_class(self, name: str) -> Optional[Type[IPlugin]]:
+    def get_plugin_class(self, name: str) -> Optional[type[IPlugin]]:
         """
         Get plugin class by name.
         
@@ -551,7 +551,7 @@ class IPluginRegistry(ABC):
         pass
     
     @abstractmethod
-    def get_registry_stats(self) -> Dict[str, Any]:
+    def get_registry_stats(self) -> dict[str, Any]:
         """
         Get registry statistics.
         
@@ -573,7 +573,7 @@ class IPluginDiscovery(ABC):
     """
     
     @abstractmethod
-    def discover_plugins(self, search_paths: List[str]) -> List[str]:
+    def discover_plugins(self, search_paths: list[str]) -> list[str]:
         """
         Discover plugins in search paths.
         
@@ -586,7 +586,7 @@ class IPluginDiscovery(ABC):
         pass
     
     @abstractmethod
-    def scan_directory(self, directory: str) -> List[str]:
+    def scan_directory(self, directory: str) -> list[str]:
         """
         Scan directory for plugins.
         
@@ -599,7 +599,7 @@ class IPluginDiscovery(ABC):
         pass
     
     @abstractmethod
-    def validate_plugin(self, plugin_path: str) -> Tuple[bool, List[str]]:
+    def validate_plugin(self, plugin_path: str) -> tuple[bool, list[str]]:
         """
         Validate plugin.
         
@@ -612,7 +612,7 @@ class IPluginDiscovery(ABC):
         pass
     
     @abstractmethod
-    def get_plugin_metadata(self, plugin_path: str) -> Optional[Dict[str, Any]]:
+    def get_plugin_metadata(self, plugin_path: str) -> Optional[dict[str, Any]]:
         """
         Get plugin metadata.
         
@@ -638,7 +638,7 @@ class IPluginDiscovery(ABC):
         pass
     
     @abstractmethod
-    def get_supported_extensions(self) -> List[str]:
+    def get_supported_extensions(self) -> list[str]:
         """
         Get supported plugin file extensions.
         
@@ -660,7 +660,7 @@ class IPluginConfig(ABC):
     """
     
     @abstractmethod
-    def get_plugin_config(self, plugin_name: str) -> Dict[str, Any]:
+    def get_plugin_config(self, plugin_name: str) -> dict[str, Any]:
         """
         Get plugin configuration.
         
@@ -673,7 +673,7 @@ class IPluginConfig(ABC):
         pass
     
     @abstractmethod
-    def set_plugin_config(self, plugin_name: str, config: Dict[str, Any]) -> None:
+    def set_plugin_config(self, plugin_name: str, config: dict[str, Any]) -> None:
         """
         Set plugin configuration.
         
@@ -828,7 +828,7 @@ class IPluginEvents(ABC):
         pass
     
     @abstractmethod
-    def get_event_subscribers(self, event: PluginEvent) -> List[Callable]:
+    def get_event_subscribers(self, event: PluginEvent) -> list[Callable]:
         """
         Get event subscribers.
         
@@ -851,7 +851,7 @@ class IPluginEvents(ABC):
         pass
     
     @abstractmethod
-    def get_event_history(self, event: Optional[PluginEvent] = None, limit: int = 100) -> List[Dict[str, Any]]:
+    def get_event_history(self, event: Optional[PluginEvent] = None, limit: int = 100) -> list[dict[str, Any]]:
         """
         Get event history.
         
@@ -910,7 +910,7 @@ class IPluginDependency(ABC):
         pass
     
     @abstractmethod
-    def get_dependencies(self, plugin_name: str) -> List[Dict[str, Any]]:
+    def get_dependencies(self, plugin_name: str) -> list[dict[str, Any]]:
         """
         Get plugin dependencies.
         
@@ -923,7 +923,7 @@ class IPluginDependency(ABC):
         pass
     
     @abstractmethod
-    def check_dependencies(self, plugin_name: str) -> Tuple[bool, List[str]]:
+    def check_dependencies(self, plugin_name: str) -> tuple[bool, list[str]]:
         """
         Check if plugin dependencies are satisfied.
         
@@ -936,7 +936,7 @@ class IPluginDependency(ABC):
         pass
     
     @abstractmethod
-    def resolve_dependencies(self, plugin_name: str) -> List[str]:
+    def resolve_dependencies(self, plugin_name: str) -> list[str]:
         """
         Resolve plugin dependency order.
         
@@ -949,7 +949,7 @@ class IPluginDependency(ABC):
         pass
     
     @abstractmethod
-    def get_dependents(self, plugin_name: str) -> List[str]:
+    def get_dependents(self, plugin_name: str) -> list[str]:
         """
         Get plugins that depend on this plugin.
         
@@ -975,7 +975,7 @@ class IPluginDependency(ABC):
         pass
     
     @abstractmethod
-    def get_dependency_graph(self) -> Dict[str, List[str]]:
+    def get_dependency_graph(self) -> dict[str, list[str]]:
         """
         Get plugin dependency graph.
         

exonware/xwsystem/plugins/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
 
 Plugins types and enums for XWSystem.

exonware/xwsystem/plugins/errors.py

@@ -1,22 +1,22 @@
-#exonware/xsystem/plugins/errors.py
+#exonware/xwsystem/plugins/errors.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
 
 Plugin-specific error classes for XSystem plugin system.
 """
 
-from typing import Any, Dict, List, Optional, Type
+from typing import Any, Optional
 
 
 class PluginError(Exception):
     """Base exception for all plugin-related errors."""
     
     def __init__(self, message: str, plugin_name: Optional[str] = None, 
-                 plugin_version: Optional[str] = None, context: Optional[Dict[str, Any]] = None, 
+                 plugin_version: Optional[str] = None, context: Optional[dict[str, Any]] = None, 
                  original_error: Optional[Exception] = None):
         super().__init__(message)
         self.plugin_name = plugin_name
@@ -39,7 +39,7 @@ class PluginError(Exception):
 class PluginNotFoundError(PluginError):
     """Error when a requested plugin is not found."""
     
-    def __init__(self, plugin_name: str, available_plugins: Optional[List[str]] = None, **kwargs):
+    def __init__(self, plugin_name: str, available_plugins: Optional[list[str]] = None, **kwargs):
         message = f"Plugin '{plugin_name}' not found"
         if available_plugins:
             message += f". Available plugins: {', '.join(available_plugins)}"
@@ -66,7 +66,7 @@ class PluginImportError(PluginLoadError):
 class PluginDependencyError(PluginLoadError):
     """Error when plugin dependencies are not met."""
     
-    def __init__(self, message: str, plugin_name: str, missing_dependencies: Optional[List[str]] = None, **kwargs):
+    def __init__(self, message: str, plugin_name: str, missing_dependencies: Optional[list[str]] = None, **kwargs):
         super().__init__(message, plugin_name=plugin_name, **kwargs)
         self.missing_dependencies = missing_dependencies or []
 
@@ -84,7 +84,7 @@ class PluginVersionError(PluginLoadError):
 class PluginRegistrationError(PluginError):
     """Error when plugin registration fails."""
     
-    def __init__(self, message: str, plugin_name: str, plugin_class: Optional[Type] = None, **kwargs):
+    def __init__(self, message: str, plugin_name: str, plugin_class: Optional[type] = None, **kwargs):
         super().__init__(message, plugin_name=plugin_name, **kwargs)
         self.plugin_class = plugin_class
 
@@ -100,7 +100,7 @@ class PluginDuplicateError(PluginRegistrationError):
 class PluginValidationError(PluginRegistrationError):
     """Error when plugin validation fails."""
     
-    def __init__(self, message: str, plugin_name: str, validation_errors: Optional[List[str]] = None, **kwargs):
+    def __init__(self, message: str, plugin_name: str, validation_errors: Optional[list[str]] = None, **kwargs):
         super().__init__(message, plugin_name=plugin_name, **kwargs)
         self.validation_errors = validation_errors or []
 
@@ -350,7 +350,7 @@ class PluginPriorityError(PluginError):
 class PluginDependencyCycleError(PluginError):
     """Error when plugin dependency cycle is detected."""
     
-    def __init__(self, message: str, plugin_name: str, dependency_cycle: Optional[List[str]] = None, **kwargs):
+    def __init__(self, message: str, plugin_name: str, dependency_cycle: Optional[list[str]] = None, **kwargs):
         super().__init__(message, plugin_name=plugin_name, **kwargs)
         self.dependency_cycle = dependency_cycle or []
 

exonware/xwsystem/runtime/__init__.py

@@ -2,7 +2,7 @@
 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
 
 XSystem Runtime Package

exonware/xwsystem/runtime/base.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
 
 Runtime module base classes - abstract classes for runtime functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union, Type, Callable
+from typing import Any, Optional, Union, Callable
 from .contracts import RuntimeMode, PlatformType, PythonVersion, EnvironmentType
 
 
@@ -26,7 +26,7 @@ class ARuntimeBase(ABC):
         """
         self.mode = mode
         self._initialized = False
-        self._runtime_info: Dict[str, Any] = {}
+        self._runtime_info: dict[str, Any] = {}
     
     @abstractmethod
     def initialize(self) -> None:
@@ -44,27 +44,27 @@ class ARuntimeBase(ABC):
         pass
     
     @abstractmethod
-    def get_runtime_info(self) -> Dict[str, Any]:
+    def get_runtime_info(self) -> dict[str, Any]:
         """Get runtime information."""
         pass
     
-    def get_platform_info(self) -> Dict[str, Any]:
+    def get_platform_info(self) -> dict[str, Any]:
         """Get platform information."""
         return {}
     
-    def get_python_info(self) -> Dict[str, Any]:
+    def get_python_info(self) -> dict[str, Any]:
         """Get Python information."""
         return {}
     
-    def get_system_info(self) -> Dict[str, Any]:
+    def get_system_info(self) -> dict[str, Any]:
         """Get system information."""
         return {}
     
-    def get_memory_info(self) -> Dict[str, Any]:
+    def get_memory_info(self) -> dict[str, Any]:
         """Get memory information."""
         return {}
     
-    def get_cpu_info(self) -> Dict[str, Any]:
+    def get_cpu_info(self) -> dict[str, Any]:
         """Get CPU information."""
         return {}
 
@@ -74,7 +74,7 @@ class AEnvironmentBase(ABC):
     
     def __init__(self):
         """Initialize environment base."""
-        self._environment_vars: Dict[str, str] = {}
+        self._environment_vars: dict[str, str] = {}
         self._environment_type: EnvironmentType = EnvironmentType.UNKNOWN
     
     @abstractmethod
@@ -103,7 +103,7 @@ class AEnvironmentBase(ABC):
         pass
     
     @abstractmethod
-    def get_all_environment_variables(self) -> Dict[str, str]:
+    def get_all_environment_variables(self) -> dict[str, str]:
         """Get all environment variables."""
         pass
     
@@ -123,7 +123,7 @@ class AEnvironmentBase(ABC):
         pass
     
     @abstractmethod
-    def get_environment_config(self) -> Dict[str, Any]:
+    def get_environment_config(self) -> dict[str, Any]:
         """Get environment configuration."""
         pass
 
@@ -134,7 +134,7 @@ class APlatformBase(ABC):
     def __init__(self):
         """Initialize platform base."""
         self._platform_type: PlatformType = PlatformType.UNKNOWN
-        self._platform_info: Dict[str, Any] = {}
+        self._platform_info: dict[str, Any] = {}
     
     @abstractmethod
     def detect_platform(self) -> PlatformType:
@@ -182,7 +182,7 @@ class APlatformBase(ABC):
         pass
     
     @abstractmethod
-    def get_platform_specific_info(self) -> Dict[str, Any]:
+    def get_platform_specific_info(self) -> dict[str, Any]:
         """Get platform-specific information."""
         pass
 
@@ -193,7 +193,7 @@ class APythonBase(ABC):
     def __init__(self):
         """Initialize Python base."""
         self._python_version: PythonVersion = PythonVersion.UNKNOWN
-        self._python_info: Dict[str, Any] = {}
+        self._python_info: dict[str, Any] = {}
     
     @abstractmethod
     def get_python_version(self) -> PythonVersion:
@@ -216,7 +216,7 @@ class APythonBase(ABC):
         pass
     
     @abstractmethod
-    def get_python_paths(self) -> List[str]:
+    def get_python_paths(self) -> list[str]:
         """Get Python module search paths."""
         pass
     
@@ -236,12 +236,12 @@ class APythonBase(ABC):
         pass
     
     @abstractmethod
-    def get_installed_packages(self) -> List[str]:
+    def get_installed_packages(self) -> list[str]:
         """Get list of installed packages."""
         pass
     
     @abstractmethod
-    def get_package_info(self, package_name: str) -> Dict[str, Any]:
+    def get_package_info(self, package_name: str) -> dict[str, Any]:
         """Get package information."""
         pass
 
@@ -251,11 +251,11 @@ class AReflectionBase(ABC):
     
     def __init__(self):
         """Initialize reflection base."""
-        self._module_cache: Dict[str, Any] = {}
-        self._class_cache: Dict[str, Type] = {}
+        self._module_cache: dict[str, Any] = {}
+        self._class_cache: dict[str, type] = {}
     
     @abstractmethod
-    def get_class(self, class_name: str, module_name: Optional[str] = None) -> Optional[Type]:
+    def get_class(self, class_name: str, module_name: Optional[str] = None) -> Optional[type]:
         """Get class by name."""
         pass
     
@@ -285,27 +285,27 @@ class AReflectionBase(ABC):
         pass
     
     @abstractmethod
-    def get_methods(self, obj: Any) -> List[str]:
+    def get_methods(self, obj: Any) -> list[str]:
         """Get object methods."""
         pass
     
     @abstractmethod
-    def get_attributes(self, obj: Any) -> List[str]:
+    def get_attributes(self, obj: Any) -> list[str]:
         """Get object attributes."""
         pass
     
     @abstractmethod
-    def get_class_hierarchy(self, cls: Type) -> List[Type]:
+    def get_class_hierarchy(self, cls: type) -> list[type]:
         """Get class hierarchy."""
         pass
     
     @abstractmethod
-    def is_subclass(self, cls: Type, parent_cls: Type) -> bool:
+    def is_subclass(self, cls: type, parent_cls: type) -> bool:
         """Check if class is subclass of parent."""
         pass
     
     @abstractmethod
-    def get_type_info(self, obj: Any) -> Dict[str, Any]:
+    def get_type_info(self, obj: Any) -> dict[str, Any]:
         """Get type information."""
         pass
 
@@ -315,8 +315,8 @@ class ARuntimeManagerBase(ABC):
     
     def __init__(self):
         """Initialize runtime manager."""
-        self._runtime_components: Dict[str, Any] = {}
-        self._component_states: Dict[str, bool] = {}
+        self._runtime_components: dict[str, Any] = {}
+        self._component_states: dict[str, bool] = {}
     
     @abstractmethod
     def register_component(self, name: str, component: Any) -> None:
@@ -334,7 +334,7 @@ class ARuntimeManagerBase(ABC):
         pass
     
     @abstractmethod
-    def list_components(self) -> List[str]:
+    def list_components(self) -> list[str]:
         """List all registered components."""
         pass
     
@@ -354,17 +354,17 @@ class ARuntimeManagerBase(ABC):
         pass
     
     @abstractmethod
-    def get_component_status(self) -> Dict[str, bool]:
+    def get_component_status(self) -> dict[str, bool]:
         """Get status of all components."""
         pass
     
     @abstractmethod
-    def initialize_all_components(self) -> Dict[str, bool]:
+    def initialize_all_components(self) -> dict[str, bool]:
         """Initialize all components."""
         pass
     
     @abstractmethod
-    def shutdown_all_components(self) -> Dict[str, bool]:
+    def shutdown_all_components(self) -> dict[str, bool]:
         """Shutdown all components."""
         pass
 
@@ -396,27 +396,27 @@ class BaseRuntime(ARuntimeBase):
         """Check if runtime is initialized."""
         return self._initialized
     
-    def get_runtime_info(self) -> Dict[str, Any]:
+    def get_runtime_info(self) -> dict[str, Any]:
         """Get runtime information."""
         return self._runtime_info.copy()
     
-    def get_platform_info(self) -> Dict[str, Any]:
+    def get_platform_info(self) -> dict[str, Any]:
         """Get platform information."""
         return {}
     
-    def get_python_info(self) -> Dict[str, Any]:
+    def get_python_info(self) -> dict[str, Any]:
         """Get Python information."""
         return {}
     
-    def get_system_info(self) -> Dict[str, Any]:
+    def get_system_info(self) -> dict[str, Any]:
         """Get system information."""
         return {}
     
-    def get_memory_info(self) -> Dict[str, Any]:
+    def get_memory_info(self) -> dict[str, Any]:
         """Get memory information."""
         return {}
     
-    def get_cpu_info(self) -> Dict[str, Any]:
+    def get_cpu_info(self) -> dict[str, Any]:
         """Get CPU information."""
         return {}
     
@@ -444,7 +444,7 @@ class BaseRuntime(ARuntimeBase):
         """Get component."""
         return self._components.get(name)
     
-    def list_components(self) -> List[str]:
+    def list_components(self) -> list[str]:
         """List all components."""
         return list(self._components.keys())
     
@@ -471,14 +471,14 @@ class BaseRuntime(ARuntimeBase):
             return component.is_initialized()
         return False
     
-    def get_component_status(self) -> Dict[str, bool]:
+    def get_component_status(self) -> dict[str, bool]:
         """Get status of all components."""
         return {name: self.is_component_initialized(name) for name in self._components.keys()}
     
-    def initialize_all_components(self) -> Dict[str, bool]:
+    def initialize_all_components(self) -> dict[str, bool]:
         """Initialize all components."""
         return {name: self.initialize_component(name) for name in self._components.keys()}
     
-    def shutdown_all_components(self) -> Dict[str, bool]:
+    def shutdown_all_components(self) -> dict[str, bool]:
         """Shutdown all components."""
         return {name: self.shutdown_component(name) for name in self._components.keys()}

exonware/xwsystem/runtime/contracts.py

@@ -2,14 +2,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
 
 Runtime module contracts - interfaces and enums for runtime environment functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union, Type, Callable
+from typing import Any, Optional, Union, Callable
 import sys
 
 # Import enums from types module
@@ -45,7 +45,7 @@ class IEnvironmentManager(ABC):
         pass
     
     @abstractmethod
-    def get_all_environment_variables(self) -> Dict[str, str]:
+    def get_all_environment_variables(self) -> dict[str, str]:
         """Get all environment variables."""
         pass
 
@@ -93,12 +93,12 @@ class IPythonInfo(ABC):
         pass
     
     @abstractmethod
-    def get_python_path(self) -> List[str]:
+    def get_python_path(self) -> list[str]:
         """Get Python path."""
         pass
     
     @abstractmethod
-    def get_installed_packages(self) -> Dict[str, str]:
+    def get_installed_packages(self) -> dict[str, str]:
         """Get installed packages."""
         pass
     
@@ -112,7 +112,7 @@ class IReflectionUtils(ABC):
     """Interface for reflection utilities."""
     
     @abstractmethod
-    def get_class_from_string(self, class_path: str) -> Type:
+    def get_class_from_string(self, class_path: str) -> type:
         """Get class from string path."""
         pass
     
@@ -122,17 +122,17 @@ class IReflectionUtils(ABC):
         pass
     
     @abstractmethod
-    def find_classes_in_module(self, module: Any, base_class: Type) -> List[Type]:
+    def find_classes_in_module(self, module: Any, base_class: type) -> list[type]:
         """Find classes in module."""
         pass
     
     @abstractmethod
-    def get_class_hierarchy(self, cls: Type) -> List[Type]:
+    def get_class_hierarchy(self, cls: type) -> list[type]:
         """Get class hierarchy."""
         pass
     
     @abstractmethod
-    def get_class_attributes(self, cls: Type) -> Dict[str, Any]:
+    def get_class_attributes(self, cls: type) -> dict[str, Any]:
         """Get class attributes."""
         pass