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

exonware/__init__.py

@@ -4,14 +4,14 @@ exonware package - Enterprise-grade Python framework ecosystem
 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
 
 This is a namespace package allowing multiple exonware subpackages
 to coexist (xwsystem, xwnode, xwdata, etc.)
 """
 
-# Make this a namespace package
+# Make this a namespace package FIRST
 __path__ = __import__('pkgutil').extend_path(__path__, __name__)
 
 import importlib.metadata

exonware/conf.py

@@ -9,7 +9,7 @@ works across all exonware packages (xwsystem, xwnode, xwdata, etc.).
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: 11-Nov-2025
 """
 
@@ -95,25 +95,15 @@ if sys.platform == "win32":
         except Exception:
             pass  # Silently fail if wrapping is not possible
 
-try:
-    # Try new path first (exonware.xwlazy.host.conf)
-    from exonware.xwlazy.host.conf import get_conf_module
-except ImportError:
-    try:
-        # Fall back to old path (xwlazy.lazy.host_conf) for installed packages
-        from xwlazy.lazy.host_conf import get_conf_module
-    except ImportError:  # xwlazy not installed yet
-        class _UnavailableConf(types.ModuleType):
-            def __getattr__(self, name: str):
-                raise RuntimeError(
-                    "Lazy configuration requires 'exonware-xwlazy'. "
-                    "Install it via 'pip install exonware-xwlazy' to enable lazy mode."
-                )
-        _module_instance = _UnavailableConf(__name__, __doc__)
-    else:
-        _module_instance = get_conf_module(__name__, __doc__)
-else:
-    _module_instance = get_conf_module(__name__, __doc__)
+# Configuration module - self-contained without xwlazy dependency
+class _ConfModule(types.ModuleType):
+    """Self-contained configuration module without xwlazy dependency."""
+    def __getattr__(self, name: str):
+        # Return a simple configuration object
+        # This can be extended later if needed
+        raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
+
+_module_instance = _ConfModule(__name__, __doc__)
 
 sys.modules[__name__] = _module_instance
 

exonware/xwsystem/__init__.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: October 10, 2025
 
 XWSystem - Enterprise-grade Python framework with AI-powered performance optimization.
@@ -50,7 +50,6 @@ This module provides common utilities that can be used across different
 components including threading, security, I/O, data structures, and design patterns.
 """
 
-import importlib
 import logging
 from typing import TYPE_CHECKING
 
@@ -58,17 +57,6 @@ from typing import TYPE_CHECKING
 if TYPE_CHECKING:
     from typing import Any
 
-# =============================================================================
-# LAZY MODE INTEGRATION
-# =============================================================================
-# Minimal-intrusion lazy mode bootstrap (one line)
-# Enables optimized lazy mode for xwsystem if xwlazy is installed
-# Uses fastest mode from benchmarks: cached + full (1.482 ms)
-try:
-    from .lazy_bootstrap import _bootstrap_lazy_mode  # noqa: F401
-except ImportError:
-    pass  # xwlazy not installed - silently continue
-
 # Logging utilities
 from .config.logging_setup import get_logger, setup_logging
 
@@ -111,8 +99,8 @@ from .io.serialization import (
 )
 
 # HTTP utilities
-from .http import HttpClient, AsyncHttpClient, HttpError, RetryConfig
-from .http.advanced_client import (
+from .http_client import HttpClient, AsyncHttpClient, HttpError, RetryConfig
+from .http_client.advanced_client import (
     AdvancedHttpClient, AdvancedHttpConfig, Http2Config, 
     StreamingConfig, MockTransport, MockResponse
 )
@@ -124,6 +112,7 @@ from .runtime import EnvironmentManager, ReflectionUtils
 from .plugins import PluginManager, PluginBase, PluginRegistry
 
 # I/O utilities
+from .io.facade import XWIO
 from .io.common.atomic import (
     AtomicFileWriter,
     FileOperationError,
@@ -502,7 +491,7 @@ def list_available_formats():
     List all available serialization formats.
     
     Returns:
-        Dict with format categories and their available formats
+        dict with format categories and their available formats
         
     Example:
         >>> formats = list_available_formats()
@@ -628,6 +617,7 @@ __all__ = [
     "hash_password", "hash_password_async",
     "verify_password", "verify_password_async",
     # I/O
+    "XWIO",
     "AtomicFileWriter",
     "FileOperationError",
     "safe_write_text",

exonware/xwsystem/caching/__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: 01-Nov-2025
 
 XSystem Caching Package

exonware/xwsystem/caching/base.py

@@ -1,16 +1,16 @@
-#exonware/xsystem/caching/base.py
+#exonware/xwsystem/caching/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
 
 Caching module base classes - abstract classes for caching functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union, Tuple, Hashable
+from typing import Any, Optional, Union, Hashable
 from .defs import CachePolicy
 
 
@@ -27,9 +27,9 @@ class ACache(ABC):
         """
         self.capacity = capacity
         self.ttl = ttl
-        self._cache: Dict[str, Any] = {}
-        self._access_times: Dict[str, float] = {}
-        self._creation_times: Dict[str, float] = {}
+        self._cache: dict[str, Any] = {}
+        self._access_times: dict[str, float] = {}
+        self._creation_times: dict[str, float] = {}
     
     @abstractmethod
     def get(self, key: Any, default: Any = None) -> Optional[Any]:
@@ -90,7 +90,7 @@ class ACache(ABC):
         pass
     
     @abstractmethod
-    def keys(self) -> List[Hashable]:
+    def keys(self) -> list[Hashable]:
         """
         Get list of all cache keys.
         
@@ -100,7 +100,7 @@ class ACache(ABC):
         pass
     
     @abstractmethod
-    def values(self) -> List[Any]:
+    def values(self) -> list[Any]:
         """
         Get list of all cache values.
         
@@ -110,7 +110,7 @@ class ACache(ABC):
         pass
     
     @abstractmethod
-    def items(self) -> List[Tuple[Hashable, Any]]:
+    def items(self) -> list[tuple[Hashable, Any]]:
         """
         Get list of all key-value pairs.
         
@@ -120,7 +120,7 @@ class ACache(ABC):
         pass
     
     @abstractmethod
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """
         Get cache statistics.
         
@@ -151,7 +151,7 @@ class ACache(ABC):
         """
         return self.size()
     
-    def get_many(self, keys: List[Hashable]) -> Dict[Hashable, Any]:
+    def get_many(self, keys: list[Hashable]) -> dict[Hashable, Any]:
         """
         Get multiple values in a single operation.
         
@@ -171,7 +171,7 @@ class ACache(ABC):
                 results[key] = value
         return results
     
-    def put_many(self, items: Dict[Hashable, Any]) -> int:
+    def put_many(self, items: dict[Hashable, Any]) -> int:
         """
         Put multiple key-value pairs in a single operation.
         
@@ -194,7 +194,7 @@ class ACache(ABC):
                 pass
         return count
     
-    def delete_many(self, keys: List[Hashable]) -> int:
+    def delete_many(self, keys: list[Hashable]) -> int:
         """
         Delete multiple keys in a single operation.
         
@@ -233,7 +233,7 @@ class ACacheManager(ABC):
         pass
     
     @abstractmethod
-    def list_caches(self) -> List[str]:
+    def list_caches(self) -> list[str]:
         """List all cache names."""
         pass
     
@@ -247,7 +247,7 @@ class ADistributedCache(ABC):
     """Abstract base class for distributed cache implementations."""
     
     @abstractmethod
-    def connect(self, nodes: List[str]) -> None:
+    def connect(self, nodes: list[str]) -> None:
         """Connect to distributed cache nodes."""
         pass
     
@@ -262,7 +262,7 @@ class ADistributedCache(ABC):
         pass
     
     @abstractmethod
-    def get_node_info(self) -> Dict[str, Any]:
+    def get_node_info(self) -> dict[str, Any]:
         """Get distributed cache node information."""
         pass
     

exonware/xwsystem/caching/bloom_cache.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: 01-Nov-2025
 
 Bloom filter-enhanced cache for faster negative lookups.
@@ -11,11 +11,11 @@ Performance Priority #4 - Probabilistic data structure for efficiency.
 """
 
 import hashlib
-from typing import Any, Dict, List, Optional, Hashable
+from typing import Any, Optional, Hashable
 from .lru_cache import LRUCache
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.caching.bloom_cache")
+logger = get_logger("xwsystem.caching.bloom_cache")
 
 
 class SimpleBloomFilter:
@@ -38,7 +38,7 @@ class SimpleBloomFilter:
         self.bit_array = [False] * size
         self.items_added = 0
     
-    def _hashes(self, item: Any) -> List[int]:
+    def _hashes(self, item: Any) -> list[int]:
         """Generate multiple hash values for item."""
         hashes = []
         item_bytes = str(item).encode('utf-8')
@@ -191,7 +191,7 @@ class BloomFilterCache(LRUCache):
             self._bloom.add(key)
         logger.info("Bloom filter rebuilt")
     
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """Get statistics including Bloom filter metrics."""
         stats = super().get_stats()
         stats['bloom_size'] = self._bloom.size

exonware/xwsystem/caching/cache_manager.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
 
 Cache Manager implementation - Placeholder.
 """
 
 from dataclasses import dataclass
-from typing import Dict, Any
+from typing import Any
 
 @dataclass
 class CacheConfig:

exonware/xwsystem/caching/conditional.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: 01-Nov-2025
 
 Conditional eviction policies for caching.
@@ -11,11 +11,11 @@ Extensibility Priority #5 - Customizable eviction behavior.
 """
 
 import time
-from typing import Any, Callable, Dict, Optional, Hashable
+from typing import Any, Callable, Optional, Hashable
 from .lru_cache import LRUCache, CacheNode
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.caching.conditional")
+logger = get_logger("xwsystem.caching.conditional")
 
 
 class ConditionalEvictionCache(LRUCache):
@@ -136,7 +136,7 @@ class ConditionalEvictionCache(LRUCache):
         self.eviction_policy = policy
         logger.info("Eviction policy updated")
     
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """Get statistics including eviction rejections."""
         stats = super().get_stats()
         stats['eviction_rejections'] = self._eviction_rejections

exonware/xwsystem/caching/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
 
 Caching 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
 
@@ -107,7 +107,7 @@ class ICacheable(ABC):
         pass
     
     @abstractmethod
-    def get_cache_info(self) -> Dict[str, Any]:
+    def get_cache_info(self) -> dict[str, Any]:
         """
         Get cache information.
         
@@ -170,7 +170,7 @@ class ICacheManager(ABC):
         pass
     
     @abstractmethod
-    def list_caches(self) -> List[str]:
+    def list_caches(self) -> list[str]:
         """
         List all cache names.
         
@@ -187,7 +187,7 @@ class ICacheManager(ABC):
         pass
     
     @abstractmethod
-    def get_cache_stats(self) -> Dict[str, Dict[str, Any]]:
+    def get_cache_stats(self) -> dict[str, dict[str, Any]]:
         """
         Get statistics for all caches.
         
@@ -320,7 +320,7 @@ class ICacheStorage(ABC):
         pass
     
     @abstractmethod
-    def items(self) -> Iterator[Tuple[str, Any]]:
+    def items(self) -> Iterator[tuple[str, Any]]:
         """
         Get iterator over cache items.
         
@@ -356,7 +356,7 @@ class ICacheEviction(ABC):
         pass
     
     @abstractmethod
-    def select_eviction_candidate(self, items: List[Tuple[str, Any, float]]) -> str:
+    def select_eviction_candidate(self, items: list[tuple[str, Any, float]]) -> str:
         """
         Select item to evict.
         
@@ -400,7 +400,7 @@ class ICacheEviction(ABC):
         pass
     
     @abstractmethod
-    def get_eviction_stats(self) -> Dict[str, Any]:
+    def get_eviction_stats(self) -> dict[str, Any]:
         """
         Get eviction statistics.
         
@@ -494,7 +494,7 @@ class ICacheMonitor(ABC):
         pass
     
     @abstractmethod
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """
         Get cache statistics.
         
@@ -533,7 +533,7 @@ class IDistributedCache(ABC):
         pass
     
     @abstractmethod
-    def get_cluster_nodes(self) -> List[str]:
+    def get_cluster_nodes(self) -> list[str]:
         """
         Get list of cluster nodes.
         
@@ -543,7 +543,7 @@ class IDistributedCache(ABC):
         pass
     
     @abstractmethod
-    def replicate(self, key: str, value: Any, nodes: List[str]) -> bool:
+    def replicate(self, key: str, value: Any, nodes: list[str]) -> bool:
         """
         Replicate cache entry to nodes.
         
@@ -558,7 +558,7 @@ class IDistributedCache(ABC):
         pass
     
     @abstractmethod
-    def invalidate(self, key: str, nodes: List[str]) -> bool:
+    def invalidate(self, key: str, nodes: list[str]) -> bool:
         """
         Invalidate cache entry on nodes.
         

exonware/xwsystem/caching/decorators.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: 01-Nov-2025
 
 Advanced cache decorators with hooks and customization.
@@ -18,7 +18,7 @@ from .lru_cache import LRUCache, AsyncLRUCache
 from .utils import default_key_builder
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.caching.decorators")
+logger = get_logger("xwsystem.caching.decorators")
 
 
 def xwcached(

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

exonware/xwsystem/caching/disk_cache.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: October 26, 2025
 
 Disk cache implementation with pickle-based persistence.
@@ -15,7 +15,7 @@ import hashlib
 import threading
 import time
 from pathlib import Path
-from typing import Any, Optional, Dict, Set
+from typing import Any, Optional
 from .contracts import ICache
 from .errors import CacheError
 from ..config.logging_setup import get_logger
@@ -72,7 +72,7 @@ class DiskCache(ICache):
         
         # Metadata file for tracking cache entries
         self.metadata_file = self.cache_dir / "metadata.pkl"
-        self._metadata: Dict[str, Dict[str, Any]] = {}
+        self._metadata: dict[str, dict[str, Any]] = {}
         self._load_metadata()
         
         # Statistics
@@ -308,7 +308,7 @@ class DiskCache(ICache):
         with self._lock:
             return len(self._metadata)
     
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """Get cache statistics."""
         with self._lock:
             total_requests = self._stats['hits'] + self._stats['misses']

exonware/xwsystem/caching/distributed.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: 01-Nov-2025
 
 Distributed cache implementations - Coming in v1.0.

exonware/xwsystem/caching/errors.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
 
 Caching module errors - exception classes for caching functionality.

exonware/xwsystem/caching/events.py

@@ -4,18 +4,18 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: 01-Nov-2025
 
 Event system for caching module.
 Extensibility Priority #5 - Event-driven architecture for custom behaviors.
 """
 
-from typing import Callable, Dict, List, Any, Optional
+from typing import Callable, Any, Optional
 from enum import Enum
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.caching.events")
+logger = get_logger("xwsystem.caching.events")
 
 
 class CacheEvent(Enum):
@@ -49,10 +49,10 @@ class CacheEventEmitter:
     
     def __init__(self):
         """Initialize event emitter."""
-        self._hooks: Dict[CacheEvent, List[Callable]] = {
+        self._hooks: dict[CacheEvent, list[Callable]] = {
             event: [] for event in CacheEvent
         }
-        self._event_stats: Dict[CacheEvent, int] = {
+        self._event_stats: dict[CacheEvent, int] = {
             event: 0 for event in CacheEvent
         }
     
@@ -124,7 +124,7 @@ class CacheEventEmitter:
                 logger.error(f"Event callback failed for {event.value}: {e}")
                 self._emit(CacheEvent.ERROR, error=e, event=event, **kwargs)
     
-    def get_event_stats(self) -> Dict[str, int]:
+    def get_event_stats(self) -> dict[str, int]:
         """
         Get event emission statistics.
         
@@ -149,7 +149,7 @@ class EventLogger:
             log_level: Logging level for events
         """
         self.log_level = log_level
-        self.events_log: List[Dict[str, Any]] = []
+        self.events_log: list[dict[str, Any]] = []
     
     def __call__(self, event: CacheEvent, **kwargs):
         """Log event."""
@@ -180,7 +180,7 @@ class EventLogger:
         elif event == CacheEvent.ERROR:
             logger.error(f"[EVENT] Cache ERROR: {kwargs.get('error', 'Unknown')}")
     
-    def get_events(self, event_type: Optional[CacheEvent] = None) -> List[Dict]:
+    def get_events(self, event_type: Optional[CacheEvent] = None) -> list[dict[str, Any]]:
         """Get logged events, optionally filtered by type."""
         if event_type:
             return [e for e in self.events_log if e['event'] == event_type.value]

exonware/xwsystem/caching/eviction_strategies.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: 01-Nov-2025
 
 Pluggable eviction strategies for caching module.
@@ -12,7 +12,7 @@ Extensibility Priority #5 - Strategy pattern for custom eviction policies.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, List, Tuple, Optional, Hashable
+from typing import Any, Optional, Hashable
 import random
 import time
 
@@ -25,7 +25,7 @@ class AEvictionStrategy(ABC):
     """
     
     @abstractmethod
-    def select_victim(self, cache_items: List[Tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
+    def select_victim(self, cache_items: list[tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
         """
         Select item to evict from cache.
         
@@ -80,7 +80,7 @@ class AEvictionStrategy(ABC):
 class LRUEvictionStrategy(AEvictionStrategy):
     """Least Recently Used eviction strategy."""
     
-    def select_victim(self, cache_items: List[Tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
+    def select_victim(self, cache_items: list[tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
         """Select least recently used item."""
         if not cache_items:
             return None
@@ -113,7 +113,7 @@ class LFUEvictionStrategy(AEvictionStrategy):
         """Initialize LFU strategy."""
         self._access_counts: dict = {}
     
-    def select_victim(self, cache_items: List[Tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
+    def select_victim(self, cache_items: list[tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
         """Select least frequently used item."""
         if not cache_items:
             return None
@@ -144,7 +144,7 @@ class LFUEvictionStrategy(AEvictionStrategy):
 class FIFOEvictionStrategy(AEvictionStrategy):
     """First In, First Out eviction strategy."""
     
-    def select_victim(self, cache_items: List[Tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
+    def select_victim(self, cache_items: list[tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
         """Select oldest inserted item."""
         if not cache_items:
             return None
@@ -173,7 +173,7 @@ class FIFOEvictionStrategy(AEvictionStrategy):
 class RandomEvictionStrategy(AEvictionStrategy):
     """Random eviction strategy."""
     
-    def select_victim(self, cache_items: List[Tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
+    def select_victim(self, cache_items: list[tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
         """Select random item to evict."""
         if not cache_items:
             return None
@@ -201,7 +201,7 @@ class RandomEvictionStrategy(AEvictionStrategy):
 class SizeBasedEvictionStrategy(AEvictionStrategy):
     """Evict largest items first to free maximum memory."""
     
-    def select_victim(self, cache_items: List[Tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
+    def select_victim(self, cache_items: list[tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
         """Select largest item to evict."""
         if not cache_items:
             return None
@@ -231,7 +231,7 @@ class SizeBasedEvictionStrategy(AEvictionStrategy):
 class TTLEvictionStrategy(AEvictionStrategy):
     """Evict items closest to expiration first."""
     
-    def select_victim(self, cache_items: List[Tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
+    def select_victim(self, cache_items: list[tuple[Hashable, Any, dict]]) -> Optional[Hashable]:
         """Select item closest to expiration."""
         if not cache_items:
             return None