exonware-xwsystem 0.1.0.1__py3-none-any.whl → 0.1.0.3__py3-none-any.whl

exonware/xwsystem/structures/defs.py

@@ -1,10 +1,11 @@
 #!/usr/bin/env python3
+#exonware/xwsystem/src/exonware/xwsystem/structures/defs.py
 #exonware/xwsystem/structures/types.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: 07-Sep-2025
 
 Structures types and enums for XWSystem.

exonware/xwsystem/structures/errors.py

@@ -1,9 +1,10 @@
+#exonware/xwsystem/src/exonware/xwsystem/structures/errors.py
 #exonware/xwsystem/structures/errors.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 Structures module errors - exception classes for data structure functionality.

exonware/xwsystem/structures/tree_walker.py

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/structures/tree_walker.py
 """
 Generic tree walking utilities for processing nested data structures.
 
@@ -7,7 +8,7 @@ previously embedded in xData but is generally useful across xLib components.
 
 import logging
 from collections.abc import Mapping, Sequence
-from typing import Any, Callable, Optional, Union
+from typing import Any, Callable, Optional
 
 logger = logging.getLogger(__name__)
 

exonware/xwsystem/threading/__init__.py

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/threading/__init__.py
 """
 Threading utilities for safe concurrent operations.
 """
@@ -5,22 +6,38 @@ Threading utilities for safe concurrent operations.
 from .locks import EnhancedRLock
 from .safe_factory import MethodGenerator, ThreadSafeFactory
 
+# Unified Facade
+from .facade import XWConcurrency
+
 
 def create_thread_safe_cache(max_size=128, maxsize=None):
     """
     Create a thread-safe cache with LRU eviction policy.
     
+    Uses flexible create_cache() to allow configuration via environment/settings.
+    Defaults to FunctoolsLRUCache (fastest Python cache).
+    
     Args:
         max_size: Maximum number of items in cache (primary parameter)
         maxsize: Alternative parameter name for compatibility
         
     Returns:
-        LRUCache instance
+        Cache instance (defaults to FunctoolsLRUCache)
     """
-    from ..caching import LRUCache
+    from ..caching import create_cache
     # Support both parameter names for compatibility
     size = maxsize if maxsize is not None else max_size
-    return LRUCache(capacity=size)
+    # Use flexible create_cache() to allow configuration via environment/settings
+    # Defaults to FunctoolsLRUCache (fastest Python cache)
+    return create_cache(capacity=size, namespace='xwsystem.threading')
 
 
-__all__ = ["ThreadSafeFactory", "MethodGenerator", "EnhancedRLock", "create_thread_safe_cache"]
+__all__ = [
+    # Unified Facade
+    "XWConcurrency",
+    # Core Classes
+    "ThreadSafeFactory",
+    "MethodGenerator",
+    "EnhancedRLock",
+    "create_thread_safe_cache",
+]

exonware/xwsystem/threading/async_primitives.py

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/threading/async_primitives.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 Async-aware concurrency primitives and synchronization utilities.
@@ -13,7 +14,7 @@ import logging
 import time
 import weakref
 from contextlib import asynccontextmanager
-from typing import Any, AsyncContextManager, Optional, Union
+from typing import Any, AsyncContextManager, Optional
 from collections import defaultdict
 
 from ..config.logging_setup import get_logger
@@ -288,7 +289,7 @@ class AsyncQueue:
             logger.warning(f"Queue {self.name} put timeout after {timeout}s")
             return False
 
-    async def get(self, timeout: Optional[float] = None) -> Union[Any, None]:
+    async def get(self, timeout: Optional[float] = None) -> Any | None:
         """
         Get item from queue with optional timeout.
         
@@ -332,7 +333,7 @@ class AsyncQueue:
             logger.warning(f"Queue {self.name} is full, put_nowait failed")
             return False
 
-    def get_nowait(self) -> Union[Any, None]:
+    def get_nowait(self) -> Any | None:
         """
         Get item from queue without waiting.
         
@@ -475,7 +476,7 @@ class AsyncResourcePool:
         
         logger.debug(f"Resource pool {self.name} initialized with {self._total_resources} resources")
 
-    async def acquire(self, timeout: Optional[float] = None) -> Union[Any, None]:
+    async def acquire(self, timeout: Optional[float] = None) -> Any | None:
         """
         Acquire a resource from the pool.
         

exonware/xwsystem/threading/base.py

@@ -1,16 +1,17 @@
+#exonware/xwsystem/src/exonware/xwsystem/threading/base.py
 #exonware/xwsystem/threading/base.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 Threading module base classes - abstract classes for threading functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Optional, Union, Callable, Coroutine
+from typing import Any, Optional, Callable, Coroutine
 from .contracts import ThreadState, LockType, AsyncPrimitiveType, ConcurrencyMode