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

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

exonware/xwsystem/runtime/env.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
 
 Environment management utilities for runtime configuration and detection.
@@ -12,11 +12,11 @@ import os
 import platform
 import sys
 from pathlib import Path
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Optional, Union
 
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.runtime.env")
+logger = get_logger("xwsystem.runtime.env")
 
 
 class EnvironmentManager:
@@ -27,11 +27,11 @@ class EnvironmentManager:
 
     def __init__(self) -> None:
         """Initialize environment manager."""
-        self._cache: Dict[str, Any] = {}
-        self._env_vars: Dict[str, str] = dict(os.environ)
+        self._cache: dict[str, Any] = {}
+        self._env_vars: dict[str, str] = dict(os.environ)
 
     @property
-    def platform_info(self) -> Dict[str, str]:
+    def platform_info(self) -> dict[str, str]:
         """Get comprehensive platform information."""
         if 'platform_info' not in self._cache:
             self._cache['platform_info'] = {
@@ -68,7 +68,7 @@ class EnvironmentManager:
         return platform.architecture()[0] == '64bit'
 
     @property
-    def python_info(self) -> Dict[str, Any]:
+    def python_info(self) -> dict[str, Any]:
         """Get Python runtime information."""
         if 'python_info' not in self._cache:
             self._cache['python_info'] = {
@@ -159,7 +159,7 @@ class EnvironmentManager:
             logger.warning(f"Invalid float value for {key}: {value}, using default: {default}")
             return default
 
-    def get_env_list(self, key: str, separator: str = ',', default: Optional[List[str]] = None) -> List[str]:
+    def get_env_list(self, key: str, separator: str = ',', default: Optional[list[str]] = None) -> list[str]:
         """
         Get environment variable as list.
 
@@ -357,7 +357,7 @@ class EnvironmentManager:
         """Get number of CPU cores."""
         return os.cpu_count() or 1
 
-    def get_environment_summary(self) -> Dict[str, Any]:
+    def get_environment_summary(self) -> dict[str, Any]:
         """Get comprehensive environment summary."""
         return {
             'platform': self.platform_info,

exonware/xwsystem/runtime/errors.py

@@ -3,7 +3,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
 
 Runtime module errors - exception classes for runtime functionality.

exonware/xwsystem/runtime/reflection.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
 
 Reflection utilities for dynamic code inspection and manipulation.
@@ -12,11 +12,11 @@ import importlib
 import inspect
 import sys
 from pathlib import Path
-from typing import Any, Callable, Dict, List, Optional, Type, Union
+from typing import Any, Callable, Optional, Union
 
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.runtime.reflection")
+logger = get_logger("xwsystem.runtime.reflection")
 
 
 class ReflectionUtils:
@@ -26,7 +26,7 @@ class ReflectionUtils:
     """
 
     @staticmethod
-    def get_class_info(cls: Type) -> Dict[str, Any]:
+    def get_class_info(cls: type) -> dict[str, Any]:
         """
         Get comprehensive information about a class.
 
@@ -53,7 +53,7 @@ class ReflectionUtils:
         }
 
     @staticmethod
-    def get_function_info(func: Callable) -> Dict[str, Any]:
+    def get_function_info(func: Callable) -> dict[str, Any]:
         """
         Get comprehensive information about a function.
 
@@ -87,7 +87,7 @@ class ReflectionUtils:
         }
 
     @staticmethod
-    def get_module_info(module: Any) -> Dict[str, Any]:
+    def get_module_info(module: Any) -> dict[str, Any]:
         """
         Get comprehensive information about a module.
 
@@ -113,7 +113,7 @@ class ReflectionUtils:
         }
 
     @staticmethod
-    def _get_source_lines(obj: Any) -> Optional[Dict[str, Any]]:
+    def _get_source_lines(obj: Any) -> Optional[dict[str, Any]]:
         """Get source lines for an object."""
         try:
             source_lines, start_line = inspect.getsourcelines(obj)
@@ -164,7 +164,7 @@ class ReflectionUtils:
             raise
 
     @staticmethod
-    def get_class_from_string(class_path: str) -> Type:
+    def get_class_from_string(class_path: str) -> type:
         """
         Get class from string path.
 
@@ -240,7 +240,7 @@ class ReflectionUtils:
         return func(*args, **kwargs)
 
     @staticmethod
-    def find_classes_in_module(module: Any, base_class: Optional[Type] = None) -> List[Type]:
+    def find_classes_in_module(module: Any, base_class: Optional[type] = None) -> list[type]:
         """
         Find all classes in a module, optionally filtered by base class.
 
@@ -259,7 +259,7 @@ class ReflectionUtils:
         return classes
 
     @staticmethod
-    def find_functions_in_module(module: Any, decorator: Optional[Any] = None) -> List[Callable]:
+    def find_functions_in_module(module: Any, decorator: Optional[Any] = None) -> list[Callable]:
         """
         Find all functions in a module, optionally filtered by decorator.
 
@@ -278,7 +278,7 @@ class ReflectionUtils:
         return functions
 
     @staticmethod
-    def get_all_subclasses(cls: Type) -> List[Type]:
+    def get_all_subclasses(cls: type) -> list[type]:
         """
         Get all subclasses of a class recursively.
 
@@ -313,7 +313,7 @@ class ReflectionUtils:
             return False
 
     @staticmethod
-    def get_method_resolution_order(cls: Type) -> List[str]:
+    def get_method_resolution_order(cls: type) -> list[str]:
         """
         Get method resolution order for a class.
 
@@ -339,7 +339,7 @@ class ReflectionUtils:
         return sys.getsizeof(obj)
 
     @staticmethod
-    def get_module_dependencies(module_name: str) -> List[str]:
+    def get_module_dependencies(module_name: str) -> list[str]:
         """
         Get list of modules that a module depends on.
 
@@ -377,7 +377,7 @@ class ReflectionUtils:
         return dependencies
 
     @staticmethod
-    def get_runtime_info() -> Dict[str, Any]:
+    def get_runtime_info() -> dict[str, Any]:
         """
         Get comprehensive runtime reflection information.
 
@@ -393,7 +393,7 @@ class ReflectionUtils:
         }
 
     @staticmethod
-    def _get_current_frame_info() -> Dict[str, Any]:
+    def _get_current_frame_info() -> dict[str, Any]:
         """Get information about the current execution frame."""
         frame = inspect.currentframe()
         if frame and frame.f_back:

exonware/xwsystem/security/auth.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
 
 Advanced Authentication Providers for Enterprise Integration
@@ -20,17 +20,38 @@ import time
 import base64
 import hashlib
 import hmac
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Optional, Union
 from urllib.parse import urlencode, parse_qs
 from .base import AAuthProvider, ATokenInfo, AUserInfo
 from .errors import AuthenticationError, AuthorizationError, TokenExpiredError
 from .defs import OAuth2GrantType
 
-import jwt
-import requests
-
 from ..config.logging_setup import get_logger
 
+# Lazy imports to avoid import errors during test collection
+# These are only imported when actually needed
+def _get_jwt():
+    """Lazy import jwt module."""
+    try:
+        import jwt
+        return jwt
+    except ImportError:
+        raise ImportError(
+            "PyJWT is required for JWT authentication. "
+            "Install it with: pip install PyJWT"
+        )
+
+def _get_requests():
+    """Lazy import requests module."""
+    try:
+        import requests
+        return requests
+    except ImportError:
+        raise ImportError(
+            "requests is required for OAuth2 authentication. "
+            "Install it with: pip install requests"
+        )
+
 logger = get_logger("xwsystem.security.auth")
 
 
@@ -44,7 +65,7 @@ class OAuth2Provider(AAuthProvider):
         authorization_url: str,
         token_url: str,
         userinfo_url: Optional[str] = None,
-        scopes: Optional[List[str]] = None
+        scopes: Optional[list[str]] = None
     ):
         """
         Initialize OAuth2 provider.
@@ -80,7 +101,7 @@ class OAuth2Provider(AAuthProvider):
         
         return f"{self.authorization_url}?{urlencode(params)}"
     
-    async def authenticate(self, credentials: Dict[str, Any]) -> ATokenInfo:
+    async def authenticate(self, credentials: dict[str, Any]) -> ATokenInfo:
         """Authenticate using OAuth2 flow."""
         import asyncio
         
@@ -98,8 +119,9 @@ class OAuth2Provider(AAuthProvider):
         
         return await asyncio.to_thread(_authenticate)
     
-    def _authenticate_authorization_code(self, credentials: Dict[str, Any]) -> ATokenInfo:
+    def _authenticate_authorization_code(self, credentials: dict[str, Any]) -> ATokenInfo:
         """Authenticate using authorization code."""
+        requests = _get_requests()
         data = {
             'grant_type': OAuth2GrantType.AUTHORIZATION_CODE.value,
             'client_id': self.client_id,
@@ -124,6 +146,7 @@ class OAuth2Provider(AAuthProvider):
     
     def _authenticate_client_credentials(self) -> ATokenInfo:
         """Authenticate using client credentials."""
+        requests = _get_requests()
         data = {
             'grant_type': OAuth2GrantType.CLIENT_CREDENTIALS.value,
             'client_id': self.client_id,
@@ -144,8 +167,9 @@ class OAuth2Provider(AAuthProvider):
             scope=token_data.get('scope')
         )
     
-    def _authenticate_resource_owner(self, credentials: Dict[str, Any]) -> ATokenInfo:
+    def _authenticate_resource_owner(self, credentials: dict[str, Any]) -> ATokenInfo:
         """Authenticate using resource owner credentials."""
+        requests = _get_requests()
         data = {
             'grant_type': OAuth2GrantType.RESOURCE_OWNER.value,
             'client_id': self.client_id,
@@ -177,6 +201,7 @@ class OAuth2Provider(AAuthProvider):
         import asyncio
         
         def _validate():
+            requests = _get_requests()
             headers = {'Authorization': f'Bearer {token}'}
             response = requests.get(self.userinfo_url, headers=headers)
             
@@ -200,6 +225,7 @@ class OAuth2Provider(AAuthProvider):
         import asyncio
         
         def _refresh():
+            requests = _get_requests()
             data = {
                 'grant_type': OAuth2GrantType.REFRESH_TOKEN.value,
                 'client_id': self.client_id,
@@ -253,11 +279,12 @@ class JWTProvider(AAuthProvider):
         self.audience = audience
         self.expiration_time = expiration_time
     
-    async def authenticate(self, credentials: Dict[str, Any]) -> ATokenInfo:
+    async def authenticate(self, credentials: dict[str, Any]) -> ATokenInfo:
         """Create JWT token from user credentials."""
         import asyncio
         
         def _authenticate():
+            jwt = _get_jwt()
             # In a real implementation, you'd validate credentials against a database
             user_id = credentials.get('user_id')
             if not user_id:
@@ -291,6 +318,7 @@ class JWTProvider(AAuthProvider):
         import asyncio
         
         def _validate():
+            jwt = _get_jwt()
             try:
                 payload = jwt.decode(
                     token,
@@ -317,6 +345,7 @@ class JWTProvider(AAuthProvider):
     
     async def refresh_token(self, refresh_token: str) -> ATokenInfo:
         """Refresh JWT token (create new token from existing)."""
+        jwt = _get_jwt()
         try:
             # Validate existing token (ignore expiration for refresh)
             payload = jwt.decode(
@@ -341,8 +370,11 @@ class JWTProvider(AAuthProvider):
                 expires_in=self.expiration_time
             )
             
-        except jwt.InvalidTokenError as e:
-            raise AuthenticationError(f"Invalid refresh token: {e}")
+        except Exception as e:
+            jwt_module = _get_jwt()
+            if isinstance(e, jwt_module.InvalidTokenError):
+                raise AuthenticationError(f"Invalid refresh token: {e}")
+            raise
 
 
 class SAMLProvider(AAuthProvider):
@@ -368,7 +400,7 @@ class SAMLProvider(AAuthProvider):
         
         logger.warning("SAML provider is a simplified implementation. Use a full SAML library for production.")
     
-    async def authenticate(self, credentials: Dict[str, Any]) -> ATokenInfo:
+    async def authenticate(self, credentials: dict[str, Any]) -> ATokenInfo:
         """Authenticate using SAML (simplified)."""
         # This is a placeholder implementation
         # In practice, you'd use a library like python3-saml
@@ -424,7 +456,7 @@ class EnterpriseAuth:
         
         return self._providers[name]
     
-    async def authenticate(self, credentials: Dict[str, Any], provider: Optional[str] = None) -> ATokenInfo:
+    async def authenticate(self, credentials: dict[str, Any], provider: Optional[str] = None) -> ATokenInfo:
         """Authenticate using specified or active provider."""
         provider_instance = self.get_provider(provider)
         return await provider_instance.authenticate(credentials)
@@ -439,7 +471,7 @@ class EnterpriseAuth:
         provider_instance = self.get_provider(provider)
         return await provider_instance.refresh_token(refresh_token)
     
-    def list_providers(self) -> List[str]:
+    def list_providers(self) -> list[str]:
         """List available providers."""
         return list(self._providers.keys())
     

exonware/xwsystem/security/base.py

@@ -1,16 +1,16 @@
-#exonware/xsystem/security/base.py
+#exonware/xwsystem/security/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
 
 Security module base classes - abstract classes for security functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union, Tuple
+from typing import Any, Optional, Union
 from .defs import HashAlgorithm, EncryptionAlgorithm, SecurityLevel
 
 
@@ -118,7 +118,7 @@ class AHashBase(ABC):
         pass
     
     @abstractmethod
-    def hash_with_salt(self, data: Union[str, bytes]) -> Tuple[str, bytes]:
+    def hash_with_salt(self, data: Union[str, bytes]) -> tuple[str, bytes]:
         """Hash data with generated salt."""
         pass
 
@@ -189,8 +189,8 @@ class APathValidatorBase(ABC):
             security_level: Security level for validation
         """
         self.security_level = security_level
-        self._allowed_paths: List[str] = []
-        self._blocked_paths: List[str] = []
+        self._allowed_paths: list[str] = []
+        self._blocked_paths: list[str] = []
     
     @abstractmethod
     def validate_path(self, path: Union[str, bytes]) -> bool:
@@ -238,12 +238,12 @@ class APathValidatorBase(ABC):
         pass
     
     @abstractmethod
-    def get_allowed_paths(self) -> List[str]:
+    def get_allowed_paths(self) -> list[str]:
         """Get allowed paths."""
         pass
     
     @abstractmethod
-    def get_blocked_paths(self) -> List[str]:
+    def get_blocked_paths(self) -> list[str]:
         """Get blocked paths."""
         pass
 
@@ -253,8 +253,8 @@ class AResourceLimitsBase(ABC):
     
     def __init__(self):
         """Initialize resource limits."""
-        self._limits: Dict[str, int] = {}
-        self._current_usage: Dict[str, int] = {}
+        self._limits: dict[str, int] = {}
+        self._current_usage: dict[str, int] = {}
     
     @abstractmethod
     def set_limit(self, resource: str, limit: int) -> None:
@@ -297,12 +297,12 @@ class AResourceLimitsBase(ABC):
         pass
     
     @abstractmethod
-    def get_all_limits(self) -> Dict[str, int]:
+    def get_all_limits(self) -> dict[str, int]:
         """Get all resource limits."""
         pass
     
     @abstractmethod
-    def get_all_usage(self) -> Dict[str, int]:
+    def get_all_usage(self) -> dict[str, int]:
         """Get all resource usage."""
         pass
     
@@ -323,7 +323,7 @@ class ASecurityValidatorBase(ABC):
             security_level: Security level for validation
         """
         self.security_level = security_level
-        self._validation_rules: Dict[str, callable] = {}
+        self._validation_rules: dict[str, callable] = {}
     
     @abstractmethod
     def validate_input(self, data: Any, input_type: str) -> bool:
@@ -351,7 +351,7 @@ class ASecurityValidatorBase(ABC):
         pass
     
     @abstractmethod
-    def get_validation_errors(self) -> List[str]:
+    def get_validation_errors(self) -> list[str]:
         """Get validation errors."""
         pass
     
@@ -394,15 +394,15 @@ class AUserInfo:
     user_id: str
     username: Optional[str] = None
     email: Optional[str] = None
-    roles: List[str] = field(default_factory=list)
-    attributes: Dict[str, Any] = field(default_factory=dict)
+    roles: list[str] = field(default_factory=list)
+    attributes: dict[str, Any] = field(default_factory=dict)
 
 
 class AAuthProvider(ABC):
     """Abstract base class for authentication providers."""
     
     @abstractmethod
-    async def authenticate(self, credentials: Dict[str, Any]) -> ATokenInfo:
+    async def authenticate(self, credentials: dict[str, Any]) -> ATokenInfo:
         """Authenticate user with credentials."""
         pass