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

exonware/xwsystem/data_structures/union_find.py

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""
+#exonware/xwsystem/src/exonware/xwsystem/data_structures/union_find.py
+
+Union-Find (Disjoint Set) Data Structure for xwsystem.
+
+Generic Union-Find implementation that can be used by any library.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.4
+Generation Date: 26-Jan-2025
+"""
+
+from typing import Any, Dict
+
+
+class UnionFind:
+    """
+    Union-Find (Disjoint Set) data structure.
+    
+    Generic implementation that can be used by any library.
+    
+    Time Complexity:
+    - make_set: O(1)
+    - find: α(n) ≈ O(1) with path compression
+    - union: α(n) ≈ O(1) with union by rank
+    - connected: α(n) ≈ O(1)
+    """
+    
+    def __init__(self):
+        """Initialize Union-Find structure."""
+        self._parent: Dict[Any, Any] = {}
+        self._rank: Dict[Any, int] = {}
+        self._sets_count = 0
+    
+    def make_set(self, x: Any) -> None:
+        """
+        Create new set with element x.
+        
+        Time Complexity: O(1)
+        
+        Args:
+            x: Element to add
+        """
+        if x not in self._parent:
+            self._parent[x] = x
+            self._rank[x] = 0
+            self._sets_count += 1
+    
+    def find(self, x: Any) -> Any:
+        """
+        Find root of set containing x with path compression.
+        
+        Time Complexity: α(n) ≈ O(1) (inverse Ackermann function)
+        
+        Args:
+            x: Element to find
+            
+        Returns:
+            Root of set containing x
+            
+        Raises:
+            ValueError: If element not found
+        """
+        if x not in self._parent:
+            raise ValueError(f"Element {x} not found in union-find structure")
+        
+        # Path compression
+        if self._parent[x] != x:
+            self._parent[x] = self.find(self._parent[x])
+        
+        return self._parent[x]
+    
+    def union(self, x: Any, y: Any) -> None:
+        """
+        Union sets containing x and y by rank.
+        
+        Time Complexity: α(n) ≈ O(1)
+        
+        Args:
+            x: First element
+            y: Second element
+        """
+        # Ensure both elements exist
+        self.make_set(x)
+        self.make_set(y)
+        
+        root_x = self.find(x)
+        root_y = self.find(y)
+        
+        if root_x == root_y:
+            return  # Already in same set
+        
+        # Union by rank
+        if self._rank[root_x] < self._rank[root_y]:
+            root_x, root_y = root_y, root_x
+        
+        self._parent[root_y] = root_x
+        if self._rank[root_x] == self._rank[root_y]:
+            self._rank[root_x] += 1
+        
+        self._sets_count -= 1
+    
+    def connected(self, x: Any, y: Any) -> bool:
+        """
+        Check if x and y are in same set.
+        
+        Time Complexity: α(n) ≈ O(1)
+        
+        Args:
+            x: First element
+            y: Second element
+            
+        Returns:
+            True if x and y are in the same set
+        """
+        try:
+            return self.find(x) == self.find(y)
+        except ValueError:
+            return False
+    
+    def size(self) -> int:
+        """
+        Get number of elements.
+        
+        Time Complexity: O(1)
+        
+        Returns:
+            Number of elements
+        """
+        return len(self._parent)
+    
+    def sets_count(self) -> int:
+        """
+        Get number of disjoint sets.
+        
+        Time Complexity: O(1)
+        
+        Returns:
+            Number of disjoint sets
+        """
+        return self._sets_count

exonware/xwsystem/defs.py

@@ -0,0 +1,17 @@
+"""
+#exonware/xwsystem/src/exonware/xwsystem/defs.py
+
+Package-level definitions (constants, enums, TypedDicts) for xwsystem.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.4
+Last Updated: 29-Jan-2026
+"""
+
+from __future__ import annotations
+
+
+__all__: list[str] = []
+

exonware/xwsystem/errors.py

@@ -0,0 +1,23 @@
+"""
+#exonware/xwsystem/src/exonware/xwsystem/errors.py
+
+Package-level errors for xwsystem.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.4
+Last Updated: 29-Jan-2026
+"""
+
+from __future__ import annotations
+
+
+class XWSystemError(Exception):
+    """Base exception for xwsystem (package-level)."""
+
+
+__all__ = [
+    "XWSystemError",
+]
+

exonware/xwsystem/facade.py

@@ -0,0 +1,62 @@
+"""
+#exonware/xwsystem/src/exonware/xwsystem/facade.py
+
+Package-level facade(s) for xwsystem.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.4
+Last Updated: 29-Jan-2026
+
+This module provides a stable, high-level entry point for composing major
+subsystem facades (IO, caching, security, etc.).
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .base import AXWFacade
+from .caching.facade import XWCache
+from .http_client import AsyncHttpClient, HttpClient
+from .io.facade import XWIO
+from .monitoring.facade import XWMonitor
+from .security.facade import XWSecurity
+from .threading.facade import XWConcurrency
+from .validation.facade import XWValidator
+
+
+@dataclass(frozen=True, slots=True)
+class XWSystem(AXWFacade):
+    """Top-level facade that bundles major subsystem facades."""
+
+    io: XWIO
+    caching: XWCache
+    security: XWSecurity
+    monitoring: XWMonitor
+    threading: XWConcurrency
+    validation: XWValidator
+
+    http: HttpClient
+    http_async: AsyncHttpClient
+
+    @classmethod
+    def create(cls) -> "XWSystem":
+        """Create a default `XWSystem` facade with sane defaults."""
+        return cls(
+            io=XWIO(),
+            caching=XWCache(),
+            security=XWSecurity(),
+            monitoring=XWMonitor(),
+            threading=XWConcurrency(),
+            validation=XWValidator(),
+            http=HttpClient(),
+            http_async=AsyncHttpClient(),
+        )
+
+
+__all__ = [
+    "XWSystem",
+]
+

exonware/xwsystem/http_client/__init__.py

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/http_client/__init__.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: September 04, 2025
 
 XSystem HTTP Package
@@ -12,10 +13,30 @@ connection pooling, and comprehensive error handling.
 """
 
 from .client import HttpClient, AsyncHttpClient, HttpError, RetryConfig
+from .advanced_client import (
+    AdvancedHttpClient,
+    AdvancedHttpConfig,
+    Http2Config,
+    StreamingConfig,
+    MockTransport,
+    MockResponse,
+)
+
+# Unified Facade
+from .facade import XWHTTP
 
 __all__ = [
+    # Unified Facade
+    "XWHTTP",
+    # Core Classes
     "HttpClient",
     "AsyncHttpClient",
     "HttpError", 
     "RetryConfig",
+    "AdvancedHttpClient",
+    "AdvancedHttpConfig",
+    "Http2Config",
+    "StreamingConfig",
+    "MockTransport",
+    "MockResponse",
 ]

exonware/xwsystem/http_client/advanced_client.py

@@ -1,22 +1,25 @@
+#exonware/xwsystem/src/exonware/xwsystem/http_client/advanced_client.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: September 04, 2025
 
 Advanced HTTP client with HTTP/2, streaming, pluggable transports, and modern features.
 """
 
+from __future__ import annotations
+
 import asyncio
 import os
 import ssl
 from contextlib import asynccontextmanager
 from dataclasses import dataclass, field
-from typing import Any, AsyncIterator, Optional, Union
+from typing import Any, AsyncIterator, Optional
 from urllib.parse import urljoin
 
-from .contracts import Transport
+from .contracts import ITransport as Transport
 
 # Prevent httpx from importing rich (Python 3.8+ only, no legacy deps)
 os.environ.setdefault("HTTPX_NO_RICH", "1")
@@ -200,7 +203,7 @@ class AdvancedHttpClient:
             self._client = httpx.Client(**client_kwargs)
             self._async_client = httpx.AsyncClient(**client_kwargs)
 
-    async def __aenter__(self) -> 'AdvancedHttpClient':
+    async def __aenter__(self) -> AdvancedHttpClient:
         """Async context manager entry."""
         return self
 
@@ -208,7 +211,7 @@ class AdvancedHttpClient:
         """Async context manager exit."""
         await self.aclose()
 
-    def __enter__(self) -> 'AdvancedHttpClient':
+    def __enter__(self) -> AdvancedHttpClient:
         """Sync context manager entry."""
         return self
 

exonware/xwsystem/http_client/base.py

@@ -1,16 +1,17 @@
+#exonware/xwsystem/src/exonware/xwsystem/http_client/base.py
 #exonware/xwsystem/http/base.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: September 04, 2025
 
 HTTP module base classes - abstract classes for HTTP client functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Optional, Union, AsyncGenerator
+from typing import Any, Optional, AsyncGenerator
 from .contracts import HttpMethod, HttpStatus, ContentType, AuthType
 
 

exonware/xwsystem/http_client/client.py

@@ -1,18 +1,21 @@
+#exonware/xwsystem/src/exonware/xwsystem/http_client/client.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: September 04, 2025
 
 HTTP client with retry mechanisms, connection pooling, and error handling.
 """
 
+from __future__ import annotations
+
 import asyncio
 import os
 import time
 from dataclasses import dataclass, field
-from typing import Any, Optional, Union
+from typing import Any, Optional
 from urllib.parse import urljoin
 
 # Prevent httpx from importing rich (Python 3.8+ only, no legacy deps)
@@ -91,7 +94,7 @@ class HttpClient:
             headers=self.default_headers
         )
 
-    def __enter__(self) -> 'HttpClient':
+    def __enter__(self) -> HttpClient:
         """Context manager entry."""
         return self
 
@@ -345,7 +348,7 @@ class AsyncHttpClient:
             headers=self.default_headers
         )
 
-    async def __aenter__(self) -> 'AsyncHttpClient':
+    async def __aenter__(self) -> AsyncHttpClient:
         """Async context manager entry."""
         return self
 

exonware/xwsystem/http_client/contracts.py

@@ -1,15 +1,17 @@
+#exonware/xwsystem/src/exonware/xwsystem/http_client/contracts.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: September 04, 2025
 
 HTTP module contracts - interfaces and enums for HTTP client functionality.
 """
 
-from abc import ABC, abstractmethod
-from typing import Any, Optional, Union, AsyncGenerator
+from __future__ import annotations
+
+from typing import Any, Optional, AsyncGenerator, Protocol, runtime_checkable
 from urllib.parse import ParseResult
 
 # Import enums from types module
@@ -22,134 +24,118 @@ from .defs import (
 )
 
 
-class IHttpClient(ABC):
+@runtime_checkable
+class IHttpClient(Protocol):
     """Interface for HTTP client operations."""
     
-    @abstractmethod
-    async def get(self, url: str, **kwargs) -> 'IHttpResponse':
+    async def get(self, url: str, **kwargs) -> IHttpResponse:
         """Make GET request."""
-        pass
+        ...
     
-    @abstractmethod
-    async def post(self, url: str, data: Optional[Any] = None, **kwargs) -> 'IHttpResponse':
+    async def post(self, url: str, data: Optional[Any] = None, **kwargs) -> IHttpResponse:
         """Make POST request."""
-        pass
+        ...
     
-    @abstractmethod
-    async def put(self, url: str, data: Optional[Any] = None, **kwargs) -> 'IHttpResponse':
+    async def put(self, url: str, data: Optional[Any] = None, **kwargs) -> IHttpResponse:
         """Make PUT request."""
-        pass
+        ...
     
-    @abstractmethod
-    async def delete(self, url: str, **kwargs) -> 'IHttpResponse':
+    async def delete(self, url: str, **kwargs) -> IHttpResponse:
         """Make DELETE request."""
-        pass
+        ...
     
-    @abstractmethod
-    async def request(self, method: HttpMethod, url: str, **kwargs) -> 'IHttpResponse':
+    async def request(self, method: HttpMethod, url: str, **kwargs) -> IHttpResponse:
         """Make HTTP request."""
-        pass
+        ...
 
 
-class IHttpResponse(ABC):
+@runtime_checkable
+class IHttpResponse(Protocol):
     """Interface for HTTP response."""
     
     @property
-    @abstractmethod
     def status_code(self) -> int:
         """Response status code."""
-        pass
+        ...
     
     @property
-    @abstractmethod
     def headers(self) -> dict[str, str]:
         """Response headers."""
-        pass
+        ...
     
     @property
-    @abstractmethod
     def content(self) -> bytes:
         """Response content as bytes."""
-        pass
+        ...
     
     @property
-    @abstractmethod
     def text(self) -> str:
         """Response content as text."""
-        pass
+        ...
     
-    @abstractmethod
     def json(self) -> Any:
         """Response content as JSON."""
-        pass
+        ...
     
-    @abstractmethod
     async def stream(self) -> AsyncGenerator[bytes, None]:
         """Stream response content."""
-        pass
+        ...
 
 
-class IHttpSession(ABC):
+@runtime_checkable
+class IHttpSession(Protocol):
     """Interface for HTTP session management."""
     
-    @abstractmethod
-    async def __aenter__(self) -> 'IHttpSession':
+    async def __aenter__(self) -> IHttpSession:
         """Async context manager entry."""
-        pass
+        ...
     
-    @abstractmethod
     async def __aexit__(self, exc_type, exc_val, exc_tb) -> None:
         """Async context manager exit."""
-        pass
+        ...
     
-    @abstractmethod
     def set_auth(self, auth_type: AuthType, **kwargs) -> None:
         """Set authentication."""
-        pass
+        ...
     
-    @abstractmethod
     def set_headers(self, headers: dict[str, str]) -> None:
         """Set default headers."""
-        pass
+        ...
     
-    @abstractmethod
     def set_timeout(self, timeout: float) -> None:
         """Set request timeout."""
-        pass
+        ...
 
 
-class IRetryConfig(ABC):
+@runtime_checkable
+class IRetryConfig(Protocol):
     """Interface for retry configuration."""
     
     @property
-    @abstractmethod
     def max_retries(self) -> int:
         """Maximum number of retries."""
-        pass
+        ...
     
     @property
-    @abstractmethod
     def strategy(self) -> RetryStrategy:
         """Retry strategy."""
-        pass
+        ...
     
     @property
-    @abstractmethod
     def backoff_factor(self) -> float:
         """Backoff factor for retries."""
-        pass
+        ...
     
     @property
-    @abstractmethod
     def retry_on_status(self) -> list[int]:
         """Status codes to retry on."""
-        pass
+        ...
 
 
-class Transport(ABC):
+@runtime_checkable
+class ITransport(Protocol):
     """Abstract base class for HTTP transport implementations."""
     
-    @abstractmethod
     async def request(self, method: str, url: str, **kwargs) -> Any:
         """Make an HTTP request."""
-        pass
+        ...

exonware/xwsystem/http_client/defs.py

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

exonware/xwsystem/http_client/errors.py

@@ -1,9 +1,10 @@
+#exonware/xwsystem/src/exonware/xwsystem/http_client/errors.py
 #exonware/xwsystem/http/errors.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: September 04, 2025
 
 HTTP module errors - exception classes for HTTP client functionality.