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

exonware/xwsystem/caching/tagging.py

@@ -3,19 +3,19 @@
 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
 
 Tag-based cache invalidation.
 Extensibility Priority #5 - Flexible invalidation patterns.
 """
 
-from typing import Any, Dict, List, Optional, Hashable, Set
+from typing import Any, Optional, Hashable
 from collections import defaultdict
 from .lru_cache import LRUCache
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.caching.tagging")
+logger = get_logger("xwsystem.caching.tagging")
 
 
 class TaggedCache(LRUCache):
@@ -51,11 +51,11 @@ class TaggedCache(LRUCache):
         super().__init__(capacity, ttl, name)
         
         # Tag tracking
-        self._key_to_tags: Dict[Hashable, Set[str]] = {}
-        self._tag_to_keys: Dict[str, Set[Hashable]] = defaultdict(set)
+        self._key_to_tags: dict[Hashable, set[str]] = {}
+        self._tag_to_keys: dict[str, set[Hashable]] = defaultdict(set)
         self._invalidations = 0
     
-    def put(self, key: Hashable, value: Any, tags: Optional[List[str]] = None) -> None:
+    def put(self, key: Hashable, value: Any, tags: Optional[list[str]] = None) -> None:
         """
         Put value with optional tags.
         
@@ -123,7 +123,7 @@ class TaggedCache(LRUCache):
         logger.info(f"Invalidated {count} entries with tag '{tag}'")
         return count
     
-    def invalidate_by_tags(self, tags: List[str]) -> int:
+    def invalidate_by_tags(self, tags: list[str]) -> int:
         """
         Invalidate all entries with any of the specified tags.
         
@@ -148,7 +148,7 @@ class TaggedCache(LRUCache):
         logger.info(f"Invalidated {count} entries with tags: {tags}")
         return count
     
-    def get_keys_by_tag(self, tag: str) -> Set[Hashable]:
+    def get_keys_by_tag(self, tag: str) -> set[Hashable]:
         """
         Get all keys associated with a tag.
         
@@ -160,7 +160,7 @@ class TaggedCache(LRUCache):
         """
         return self._tag_to_keys.get(tag, set()).copy()
     
-    def get_tags(self, key: Hashable) -> Set[str]:
+    def get_tags(self, key: Hashable) -> set[str]:
         """
         Get all tags associated with a key.
         
@@ -172,7 +172,7 @@ class TaggedCache(LRUCache):
         """
         return self._key_to_tags.get(key, set()).copy()
     
-    def get_all_tags(self) -> Set[str]:
+    def get_all_tags(self) -> set[str]:
         """
         Get all tags in cache.
         
@@ -187,7 +187,7 @@ class TaggedCache(LRUCache):
         self._key_to_tags.clear()
         self._tag_to_keys.clear()
     
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """Get statistics including tag information."""
         stats = super().get_stats()
         stats['total_tags'] = len(self._tag_to_keys)

exonware/xwsystem/caching/ttl_cache.py

@@ -7,14 +7,14 @@ Production-grade TTL caching for XSystem.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generated: 2025-01-27
 """
 
 import asyncio
 import time
 import threading
-from typing import Any, Dict, Optional, Tuple, Union
+from typing import Any, Optional, Union
 from dataclasses import dataclass
 import logging
 from .base import ACache
@@ -83,7 +83,7 @@ class TTLCache(ACache):
         self.name = name
         
         # Storage
-        self._cache: Dict[str, TTLEntry] = {}
+        self._cache: dict[str, TTLEntry] = {}
         self._access_order = []  # For LRU tracking
         
         # Thread safety
@@ -298,7 +298,22 @@ class TTLCache(ACache):
             
             return True
     
-    def get_stats(self) -> Dict[str, Any]:
+    def keys(self) -> list[str]:
+        """Get list of all cache keys."""
+        with self._lock:
+            return list(self._cache.keys())
+    
+    def values(self) -> list[Any]:
+        """Get list of all cache values."""
+        with self._lock:
+            return [entry.value for entry in self._cache.values() if not entry.is_expired()]
+    
+    def items(self) -> list[tuple[str, Any]]:
+        """Get list of all key-value pairs."""
+        with self._lock:
+            return [(key, entry.value) for key, entry in self._cache.items() if not entry.is_expired()]
+    
+    def get_stats(self) -> dict[str, Any]:
         """Get cache statistics."""
         with self._lock:
             total_requests = self._stats['hits'] + self._stats['misses']
@@ -369,7 +384,7 @@ class AsyncTTLCache:
         self.name = name
         
         # Storage
-        self._cache: Dict[str, TTLEntry] = {}
+        self._cache: dict[str, TTLEntry] = {}
         self._access_order = []
         
         # Async synchronization
@@ -497,7 +512,7 @@ class AsyncTTLCache:
         async with self._lock:
             return len(self._cache)
     
-    async def get_stats(self) -> Dict[str, Any]:
+    async def get_stats(self) -> dict[str, Any]:
         """Get async cache statistics."""
         async with self._lock:
             total_requests = self._stats['hits'] + self._stats['misses']

exonware/xwsystem/caching/two_tier_cache.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: October 26, 2025
 
 Two-tier cache implementation combining memory and disk caching.
 """
 
 import threading
-from typing import Any, Optional, Dict
+from typing import Any, Optional
 from .lru_cache import LRUCache
 from .disk_cache import DiskCache
 from .contracts import ICache
@@ -169,7 +169,7 @@ class TwoTierCache(ICache):
         with self._lock:
             return self.memory_cache.size() + self.disk_cache.size()
     
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """Get comprehensive statistics for both tiers."""
         with self._lock:
             memory_stats = self.memory_cache.get_stats()
@@ -197,11 +197,11 @@ class TwoTierCache(ICache):
                 'disk_stats': disk_stats,
             }
     
-    def get_memory_stats(self) -> Dict[str, Any]:
+    def get_memory_stats(self) -> dict[str, Any]:
         """Get memory tier statistics."""
         return self.memory_cache.get_stats()
     
-    def get_disk_stats(self) -> Dict[str, Any]:
+    def get_disk_stats(self) -> dict[str, Any]:
         """Get disk tier statistics."""
         return self.disk_cache.get_stats()
     

exonware/xwsystem/caching/utils.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
 
 Common utility functions for caching module.
@@ -13,7 +13,7 @@ Common utility functions for caching module.
 import sys
 import hashlib
 import pickle
-from typing import Any, Callable, Tuple
+from typing import Any, Callable
 
 
 def estimate_object_size(obj: Any) -> int:
@@ -110,7 +110,7 @@ def format_bytes(size: int) -> str:
     return f"{size_float:.2f} {units[unit_index]}"
 
 
-def default_key_builder(func: Callable, args: Tuple, kwargs: dict) -> str:
+def default_key_builder(func: Callable, args: tuple, kwargs: dict) -> str:
     """
     Build cache key from function and arguments.
     

exonware/xwsystem/caching/validation.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
 
 Input validation for caching module - Security Priority #1.

exonware/xwsystem/caching/warming.py

@@ -4,26 +4,26 @@
 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
 
 Cache warming utilities for preloading data.
 Performance Priority #4 - Reduce cold start penalties.
 """
 
-from typing import Any, Callable, List, Optional, Hashable, Dict
+from typing import Any, Callable, Optional, Hashable
 from abc import ABC, abstractmethod
 import time
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.caching.warming")
+logger = get_logger("xwsystem.caching.warming")
 
 
 class AWarmingStrategy(ABC):
     """Abstract base class for cache warming strategies."""
     
     @abstractmethod
-    def warm(self, cache: Any, keys: List[Hashable], loader: Callable[[Hashable], Any]) -> int:
+    def warm(self, cache: Any, keys: list[Hashable], loader: Callable[[Hashable], Any]) -> int:
         """
         Warm cache with data.
         
@@ -45,7 +45,7 @@ class PreloadWarmingStrategy(AWarmingStrategy):
     Suitable for small datasets that fit entirely in cache.
     """
     
-    def warm(self, cache: Any, keys: List[Hashable], loader: Callable[[Hashable], Any]) -> int:
+    def warm(self, cache: Any, keys: list[Hashable], loader: Callable[[Hashable], Any]) -> int:
         """Preload all keys into cache."""
         success_count = 0
         failures = []
@@ -91,7 +91,7 @@ class LazyWarmingStrategy(AWarmingStrategy):
         """
         self.preload_limit = preload_limit
     
-    def warm(self, cache: Any, keys: List[Hashable], loader: Callable[[Hashable], Any]) -> int:
+    def warm(self, cache: Any, keys: list[Hashable], loader: Callable[[Hashable], Any]) -> int:
         """Preload limited number of keys, rest loaded lazily."""
         # Preload up to limit
         preload_keys = keys[:self.preload_limit]
@@ -129,7 +129,7 @@ class PriorityWarmingStrategy(AWarmingStrategy):
         """
         self.priority_func = priority_func
     
-    def warm(self, cache: Any, keys: List[Hashable], loader: Callable[[Hashable], Any]) -> int:
+    def warm(self, cache: Any, keys: list[Hashable], loader: Callable[[Hashable], Any]) -> int:
         """Load keys in priority order."""
         # Sort keys by priority (descending)
         sorted_keys = sorted(keys, key=self.priority_func, reverse=True)
@@ -151,7 +151,7 @@ class PriorityWarmingStrategy(AWarmingStrategy):
 def warm_cache(
     cache: Any,
     loader: Callable[[Hashable], Any],
-    keys: List[Hashable],
+    keys: list[Hashable],
     strategy: Optional[AWarmingStrategy] = None,
     on_progress: Optional[Callable[[int, int], None]] = None
 ) -> int:
@@ -198,7 +198,7 @@ def warm_cache(
 def warm_cache_async(
     cache: Any,
     loader: Callable,
-    keys: List[Hashable]
+    keys: list[Hashable]
 ) -> int:
     """
     Warm async cache with data.

exonware/xwsystem/caching/write_behind.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
 
 Write-behind (lazy write) cache implementation.
@@ -12,11 +12,11 @@ Performance Priority #4 - Delayed persistence for better write performance.
 
 import threading
 import time
-from typing import Any, Callable, Dict, Optional, Set, Hashable
+from typing import Any, Callable, Optional, Hashable
 from .lru_cache import LRUCache
 from ..config.logging_setup import get_logger
 
-logger = get_logger("xsystem.caching.write_behind")
+logger = get_logger("xwsystem.caching.write_behind")
 
 
 class WriteBehindCache(LRUCache):
@@ -77,7 +77,7 @@ class WriteBehindCache(LRUCache):
         self.flush_interval = flush_interval
         
         # Dirty entry tracking
-        self._dirty_keys: Set[Hashable] = set()
+        self._dirty_keys: set[Hashable] = set()
         self._flush_lock = threading.Lock()
         
         # Statistics
@@ -195,7 +195,7 @@ class WriteBehindCache(LRUCache):
         
         logger.debug("Background flusher stopped")
     
-    def get_stats(self) -> Dict[str, Any]:
+    def get_stats(self) -> dict[str, Any]:
         """Get statistics including write-behind metrics."""
         stats = super().get_stats()
         stats['dirty_entries'] = len(self._dirty_keys)

exonware/xwsystem/cli/__init__.py

@@ -7,7 +7,7 @@ Production-grade CLI utilities for XSystem.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generated: 2025-01-27
 """
 

exonware/xwsystem/cli/args.py

@@ -7,13 +7,13 @@ Production-grade CLI argument parsing for XWSystem.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generated: 2025-01-27
 """
 
 import argparse
 import sys
-from typing import Any, Dict, List, Optional, Callable, Union
+from typing import Any, Optional, Callable, Union
 from dataclasses import dataclass
 import logging
 from .defs import ArgumentType
@@ -40,7 +40,7 @@ class Argument:
     default: Any = None
     help_text: str = ""
     short_name: Optional[str] = None
-    choices: Optional[List[str]] = None
+    choices: Optional[list[str]] = None
     validator: Optional[Callable[[Any], bool]] = None
     action: str = "store"  # store, store_true, store_false, append, count
     nargs: Optional[Union[int, str]] = None  # Number of arguments
@@ -72,9 +72,9 @@ class Command:
     name: str
     handler: Callable
     description: str = ""
-    arguments: List[Argument] = None
-    subcommands: List['Command'] = None
-    examples: List[str] = None
+    arguments: list[Argument] = None
+    subcommands: list['Command'] = None
+    examples: list[str] = None
     
     def __post_init__(self):
         """Initialize command defaults."""
@@ -134,9 +134,9 @@ class ArgumentParser:
             )
         
         # Command registry
-        self._commands: Dict[str, Command] = {}
+        self._commands: dict[str, Command] = {}
         self._subparsers = None
-        self._global_arguments: List[Argument] = []
+        self._global_arguments: list[Argument] = []
     
     def add_argument(self, argument: Argument) -> 'ArgumentParser':
         """
@@ -256,7 +256,7 @@ class ArgumentParser:
         
         parser.add_argument(*names, **kwargs)
     
-    def parse_args(self, args: List[str] = None) -> argparse.Namespace:
+    def parse_args(self, args: list[str] = None) -> argparse.Namespace:
         """
         Parse command-line arguments.
         
@@ -282,7 +282,7 @@ class ArgumentParser:
             self._parser.print_help()
             sys.exit(1)
     
-    def execute(self, args: List[str] = None) -> Any:
+    def execute(self, args: list[str] = None) -> Any:
         """
         Parse arguments and execute the appropriate command.
         

exonware/xwsystem/cli/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
 
 CLI module base classes - abstract classes for command-line interface functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Optional, Union
 from .contracts import ColorType, ProgressStyle, TableStyle, PromptType, ICLI
 from ..version import __version__
 
@@ -85,7 +85,7 @@ class AProgressBarBase(ABC):
 class ATableBase(ABC):
     """Abstract base class for table operations."""
     
-    def __init__(self, headers: List[str], style: TableStyle = TableStyle.SIMPLE):
+    def __init__(self, headers: list[str], style: TableStyle = TableStyle.SIMPLE):
         """
         Initialize table.
         
@@ -95,7 +95,7 @@ class ATableBase(ABC):
         """
         self.headers = headers
         self.style = style
-        self.rows: List[List[str]] = []
+        self.rows: list[list[str]] = []
     
     @abstractmethod
     def add_row(self, *values: Any) -> None:
@@ -132,12 +132,12 @@ class APromptBase(ABC):
         pass
     
     @abstractmethod
-    def select(self, message: str, choices: List[str], default: Optional[str] = None) -> str:
+    def select(self, message: str, choices: list[str], default: Optional[str] = None) -> str:
         """Ask user to select from choices."""
         pass
     
     @abstractmethod
-    def multiselect(self, message: str, choices: List[str], default: Optional[List[str]] = None) -> List[str]:
+    def multiselect(self, message: str, choices: list[str], default: Optional[list[str]] = None) -> list[str]:
         """Ask user to select multiple choices."""
         pass
 
@@ -153,7 +153,7 @@ class AArgumentParserBase(ABC):
             description: Parser description
         """
         self.description = description
-        self.arguments: List[Dict[str, Any]] = []
+        self.arguments: list[dict[str, Any]] = []
     
     @abstractmethod
     def add_argument(self, *args, **kwargs) -> None:
@@ -161,7 +161,7 @@ class AArgumentParserBase(ABC):
         pass
     
     @abstractmethod
-    def parse_args(self, args: Optional[List[str]] = None) -> Any:
+    def parse_args(self, args: Optional[list[str]] = None) -> Any:
         """Parse command line arguments."""
         pass
     
@@ -190,7 +190,7 @@ class AColorBase(ABC):
         pass
     
     @abstractmethod
-    def get_color_codes(self) -> Dict[ColorType, str]:
+    def get_color_codes(self) -> dict[ColorType, str]:
         """Get color codes mapping."""
         pass
 
@@ -207,8 +207,8 @@ class BaseCLI(ICLI):
         """
         self._name = name
         self._version = version or __version__
-        self._commands: Dict[str, Any] = {}
-        self._options: Dict[str, Any] = {}
+        self._commands: dict[str, Any] = {}
+        self._options: dict[str, Any] = {}
     
     @property
     def name(self) -> str:
@@ -238,7 +238,7 @@ class BaseCLI(ICLI):
         """
         self._options[name] = option
     
-    def run(self, args: Optional[List[str]] = None) -> int:
+    def run(self, args: Optional[list[str]] = None) -> int:
         """Run the CLI.
         
         Args:
@@ -262,8 +262,8 @@ class BaseCLI(ICLI):
         """Initialize base CLI."""
         self._name = name
         self._version = version or __version__
-        self._commands: Dict[str, Any] = {}
-        self._options: Dict[str, Any] = {}
+        self._commands: dict[str, Any] = {}
+        self._options: dict[str, Any] = {}
     
     @property
     def name(self) -> str:
@@ -283,7 +283,7 @@ class BaseCLI(ICLI):
         """Add an option to the CLI."""
         self._options[name] = option
     
-    def run(self, args: Optional[List[str]] = None) -> int:
+    def run(self, args: Optional[list[str]] = None) -> int:
         """Run the CLI."""
         if not args:
             args = []

exonware/xwsystem/cli/colors.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 05, 2025
 
 Colored terminal output utilities with cross-platform support.

exonware/xwsystem/cli/console.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
 
 Console utilities for CLI operations.

exonware/xwsystem/cli/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
 
 CLI module contracts - interfaces and enums for command-line interface functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Optional, Union
 
 # Import enums from types module
 from .defs import (
@@ -95,7 +95,7 @@ class IArgumentParser(ABC):
         pass
     
     @abstractmethod
-    def parse_args(self, args: Optional[List[str]] = None) -> Any:
+    def parse_args(self, args: Optional[list[str]] = None) -> Any:
         """Parse command line arguments."""
         pass
 
@@ -126,7 +126,7 @@ class ICLI(ABC):
         pass
     
     @abstractmethod
-    def run(self, args: Optional[List[str]] = None) -> int:
+    def run(self, args: Optional[list[str]] = None) -> int:
         """Run the CLI."""
         pass
     
@@ -169,7 +169,7 @@ class IPrompts(ABC):
         pass
     
     @abstractmethod
-    def select(self, message: str, choices: List[str], default: Optional[str] = None) -> str:
+    def select(self, message: str, choices: list[str], default: Optional[str] = None) -> str:
         """Ask user to select from choices."""
         pass
 

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

exonware/xwsystem/cli/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
 
 CLI module errors - exception classes for command-line interface functionality.

exonware/xwsystem/cli/progress.py

@@ -7,7 +7,7 @@ Production-grade progress indicators for XSystem.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.409
+Version: 0.0.1.411
 Generation Date: September 05, 2025
 """
 

exonware/xwsystem/cli/prompts.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
 
 Interactive prompts - Placeholder.