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

exonware/xwsystem/io/stream/async_operations.py

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/io/stream/async_operations.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
 
 Asynchronous I/O operations for non-blocking file handling.
@@ -10,12 +11,13 @@ Asynchronous I/O operations for non-blocking file handling.
 
 import asyncio
 import os
+import platform
 import shutil
 import tempfile
 import time
 from contextlib import asynccontextmanager
 from pathlib import Path
-from typing import Any, AsyncContextManager, BinaryIO, Optional, TextIO, Union
+from typing import Any, AsyncContextManager, BinaryIO, Optional, TextIO
 
 # Import aiofiles - lazy installation system will handle it if missing
 import aiofiles
@@ -38,11 +40,11 @@ class AsyncAtomicFileWriter:
 
     def __init__(
         self,
-        target_path: Union[str, Path],
+        target_path: str | Path,
         mode: str = "w",
         encoding: Optional[str] = "utf-8",
         backup: bool = False,
-        temp_dir: Optional[Union[str, Path]] = None,
+        temp_dir: Optional[str | Path] = None,
     ):
         """
         Initialize async atomic file writer.
@@ -130,6 +132,51 @@ class AsyncAtomicFileWriter:
             await self._cleanup()
             raise FileOperationError(f"Failed to start async atomic write: {e}") from e
 
+    async def write(self, data: bytes | str) -> int:
+        """
+        Write data to the temporary file.
+        
+        Automatically handles conversion between bytes and str based on file mode:
+        - Text mode ("w", "w+", etc.): Accepts str or bytes (bytes are decoded with encoding)
+        - Binary mode ("wb", "wb+", etc.): Accepts bytes only
+        
+        Args:
+            data: Data to write (bytes or str)
+            
+        Returns:
+            Number of bytes/characters written
+            
+        Raises:
+            FileOperationError: If write operation not started or write fails
+        """
+        if not self._started:
+            raise FileOperationError("Async atomic write operation not started. Call start() first.")
+        
+        if not self.file_handle:
+            raise FileOperationError("File handle not available")
+        
+        try:
+            is_binary_mode = "b" in self.mode
+            
+            if is_binary_mode:
+                # Binary mode: must write bytes
+                if isinstance(data, str):
+                    # Convert string to bytes using the encoding if available
+                    encoding = self.encoding or "utf-8"
+                    data = data.encode(encoding)
+                await self.file_handle.write(data)
+                return len(data)
+            else:
+                # Text mode: write string
+                if isinstance(data, bytes):
+                    # Decode bytes to string using the encoding
+                    encoding = self.encoding or "utf-8"
+                    data = data.decode(encoding)
+                await self.file_handle.write(data)
+                return len(data)
+        except Exception as e:
+            raise FileOperationError(f"Failed to write data: {e}") from e
+
     async def commit(self) -> None:
         """
         Commit the async atomic write operation.
@@ -161,8 +208,8 @@ class AsyncAtomicFileWriter:
                 logger.warning(f"Temporary file is empty: {self.temp_path}")
 
             # Atomic move to target location
-            # On Windows, need to remove target first if it exists
-            if os.name == "nt" and await aiofiles.os.path.exists(self.target_path):
+            # On Windows, need to remove target first if it exists (Windows filesystem limitation)
+            if platform.system() == 'Windows' and await aiofiles.os.path.exists(self.target_path):
                 await aiofiles.os.remove(self.target_path)
 
             # Perform the atomic move (using sync operation as aiofiles doesn't have move)
@@ -268,11 +315,11 @@ class AsyncAtomicFileWriter:
 
 @asynccontextmanager
 async def async_atomic_write(
-    target_path: Union[str, Path],
+    target_path: str | Path,
     mode: str = "w",
     encoding: Optional[str] = "utf-8",
     backup: bool = True,
-    temp_dir: Optional[Union[str, Path]] = None,
+    temp_dir: Optional[str | Path] = None,
 ) -> AsyncContextManager[Any]:
     """
     Async context manager for atomic file writing.
@@ -304,7 +351,7 @@ async def async_atomic_write(
 
 
 async def async_safe_write_text(
-    target_path: Union[str, Path],
+    target_path: str | Path,
     content: str,
     encoding: str = "utf-8",
     backup: bool = True,
@@ -323,7 +370,7 @@ async def async_safe_write_text(
 
 
 async def async_safe_write_bytes(
-    target_path: Union[str, Path], content: bytes, backup: bool = True
+    target_path: str | Path, content: bytes, backup: bool = True
 ) -> None:
     """
     Safely write binary content to a file atomically (async).
@@ -338,7 +385,7 @@ async def async_safe_write_bytes(
 
 
 async def async_safe_read_text(
-    file_path: Union[str, Path], encoding: str = "utf-8", max_size_mb: float = 100.0
+    file_path: str | Path, encoding: str = "utf-8", max_size_mb: float = 100.0
 ) -> str:
     """
     Safely read text content from a file with size validation (async).
@@ -391,7 +438,7 @@ async def async_safe_read_text(
         raise FileOperationError(f"IOError reading file '{file_path}': {e}") from e
 
 
-async def async_safe_read_bytes(file_path: Union[str, Path], max_size_mb: float = 100.0) -> bytes:
+async def async_safe_read_bytes(file_path: str | Path, max_size_mb: float = 100.0) -> bytes:
     """
     Safely read binary content from a file with size validation (async).
 
@@ -439,7 +486,7 @@ async def async_safe_read_bytes(file_path: Union[str, Path], max_size_mb: float
 
 
 async def async_safe_read_with_fallback(
-    file_path: Union[str, Path],
+    file_path: str | Path,
     preferred_encoding: str = "utf-8",
     fallback_encodings: Optional[list[str]] = None,
     max_size_mb: float = 100.0,
@@ -462,7 +509,7 @@ async def async_safe_read_with_fallback(
     if fallback_encodings is None:
         fallback_encodings = ["latin1", "cp1252", "iso-8859-1"]
 
-    # Try preferred encoding first
+    # Try encoding first
     try:
         return await async_safe_read_text(file_path, preferred_encoding, max_size_mb)
     except FileOperationError as e:

exonware/xwsystem/io/stream/base.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: 30-Oct-2025
 
 Base classes for stream operations.
@@ -39,4 +39,3 @@ class ACodecIO[T, R](ICodecIO[T, R], ABC):
 class APagedCodecIO[T, R](ACodecIO[T, R], IPagedCodecIO[T, R], ABC):
     """Abstract base for paged codec I/O."""
     pass
-

exonware/xwsystem/io/stream/codec_io.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: 30-Oct-2025
 
 Codec-integrated I/O - THE KILLER FEATURE!
@@ -19,7 +19,7 @@ Priority 5 (Extensibility): Works with ANY codec + ANY data source
 """
 
 from pathlib import Path
-from typing import Union, Optional, Iterator, Any
+from typing import Optional, Iterator, Any
 
 from ..contracts import ICodecIO, IPagedCodecIO, IDataSource, IPagedDataSource
 
@@ -165,7 +165,7 @@ class CodecIO[T, R](ICodecIO[T, R]):
         # Fallback: load full file, update in memory, save
         data = self.load(**opts)
         
-        # Simple path update (subclasses should override for format-specific logic)
+        # Simple path update (subclasses override for format-specific logic)
         if isinstance(data, dict) and path.startswith('/'):
             from ..serialization.utils.path_ops import set_value_by_path
             set_value_by_path(data, path, value, create=opts.get('create', False))
@@ -213,7 +213,7 @@ class CodecIO[T, R](ICodecIO[T, R]):
         # Fallback: load full file, extract path
         data = self.load(**opts)
         
-        # Simple path extraction (subclasses should override for format-specific logic)
+        # Simple path extraction (subclasses override for format-specific logic)
         if isinstance(data, dict) and path.startswith('/'):
             from ..serialization.utils.path_ops import get_value_by_path
             return get_value_by_path(data, path)
@@ -224,7 +224,7 @@ class CodecIO[T, R](ICodecIO[T, R]):
             )
     
     @staticmethod
-    def from_file(path: Union[str, Path], mode: str = 'rb', encoding: Optional[str] = None):
+    def from_file(path: str | Path, mode: str = 'rb', encoding: Optional[str] = None):
         """
         Create CodecIO with auto-detected codec from file extension.
         
@@ -399,7 +399,7 @@ class PagedCodecIO[T, R](CodecIO[T, R], IPagedCodecIO[T, R]):
             self._source.write(combined, **opts)
     
     @staticmethod
-    def from_file(path: Union[str, Path], mode: str = 'rb', encoding: Optional[str] = None):
+    def from_file(path: str | Path, mode: str = 'rb', encoding: Optional[str] = None):
         """
         Create PagedCodecIO with auto-detected codec from file extension.
         
@@ -431,4 +431,3 @@ class PagedCodecIO[T, R](CodecIO[T, R], IPagedCodecIO[T, R]):
         source = PagedFileSource(path, mode=mode, encoding=encoding)
         
         return PagedCodecIO(codec, source)
-

exonware/xwsystem/ipc/__init__.py

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/ipc/__init__.py
 """
 Inter-Process Communication (IPC) Module
 ========================================

exonware/xwsystem/ipc/async_fabric.py

@@ -1,9 +1,10 @@
+#exonware/xwsystem/src/exonware/xwsystem/ipc/async_fabric.py
 #exonware/xwsystem/ipc/async_fabric.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.1
+Version: 0.1.0.4
 Generation Date: 09-Nov-2025
 
 Async Process Fabric
@@ -39,7 +40,7 @@ from .shared_memory import SharedData, SharedMemoryManager
 
 logger = logging.getLogger("xwsystem.ipc.async_fabric")
 
-CallableRef = Union[str, Callable[..., Any]]
+CallableRef = str | Callable[..., Any]
 TaskId = str
 
 
@@ -230,7 +231,7 @@ class AsyncProcessFabricSession:
 
     async def iter_results(
         self,
-        task_ids: Union[TaskId, Sequence[TaskId]],
+        task_ids: TaskId | Sequence[TaskId],
         *,
         timeout: Optional[float] = None,
     ) -> AsyncIterator[Any]:
@@ -355,4 +356,3 @@ class AsyncProcessFabricSession:
     def active_tasks(self) -> Sequence[TaskId]:
         """Return snapshot of currently tracked task IDs."""
         return tuple(self._active_task_ids)
-

exonware/xwsystem/ipc/base.py

@@ -1,16 +1,17 @@
+#exonware/xwsystem/src/exonware/xwsystem/ipc/base.py
 #exonware/xwsystem/ipc/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
 
 IPC module base classes - abstract classes for inter-process communication functionality.
 """
 
 from abc import ABC, abstractmethod
-from typing import Any, Optional, Union
+from typing import Any, Optional
 from .contracts import MessageType, QueueType, ProcessState, SharedMemoryType
 
 
@@ -116,12 +117,12 @@ class APipeBase(ABC):
         pass
     
     @abstractmethod
-    def write(self, data: Union[str, bytes]) -> int:
+    def write(self, data: str | bytes) -> int:
         """Write data to pipe."""
         pass
     
     @abstractmethod
-    def read(self, size: Optional[int] = None) -> Union[str, bytes]:
+    def read(self, size: Optional[int] = None) -> str | bytes:
         """Read data from pipe."""
         pass
     
@@ -331,7 +332,7 @@ class AProcessPoolBase(ABC):
 
 class BaseIPC:
     """
-    Base IPC class for backward compatibility.
+    Base IPC class.
     
     Provides a simple interface for IPC operations.
     """

exonware/xwsystem/ipc/contracts.py

@@ -1,15 +1,15 @@
+#exonware/xwsystem/src/exonware/xwsystem/ipc/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
 
 IPC module contracts - interfaces and enums for inter-process communication.
 """
 
-from abc import ABC, abstractmethod
-from typing import Any, Optional, Union, AsyncGenerator, Callable
+from typing import Any, Optional, AsyncGenerator, Callable, Protocol, runtime_checkable
 from multiprocessing import Process
 
 # Import enums from types module
@@ -23,165 +23,140 @@ from .defs import (
 )
 
 
-class IMessageQueue(ABC):
+@runtime_checkable
+class IMessageQueue(Protocol):
     """Interface for message queue operations."""
     
-    @abstractmethod
     async def put(self, message: Any, message_type: MessageType = MessageType.DATA) -> None:
         """Put message in queue."""
-        pass
+        ...
     
-    @abstractmethod
     async def get(self, timeout: Optional[float] = None) -> Any:
         """Get message from queue."""
-        pass
+        ...
     
-    @abstractmethod
     async def get_nowait(self) -> Any:
         """Get message without waiting."""
-        pass
+        ...
     
-    @abstractmethod
     def empty(self) -> bool:
         """Check if queue is empty."""
-        pass
+        ...
     
-    @abstractmethod
     def full(self) -> bool:
         """Check if queue is full."""
-        pass
+        ...
     
-    @abstractmethod
     def size(self) -> int:
         """Get queue size."""
-        pass
+        ...
 
 
-class IPipe(ABC):
+@runtime_checkable
+class IPipe(Protocol):
     """Interface for pipe operations."""
     
-    @abstractmethod
     async def send(self, data: Any) -> None:
         """Send data through pipe."""
-        pass
+        ...
     
-    @abstractmethod
     async def recv(self, timeout: Optional[float] = None) -> Any:
         """Receive data from pipe."""
-        pass
+        ...
     
-    @abstractmethod
     async def recv_nowait(self) -> Any:
         """Receive data without waiting."""
-        pass
+        ...
     
-    @abstractmethod
     def close(self) -> None:
         """Close pipe."""
-        pass
+        ...
     
-    @abstractmethod
     def closed(self) -> bool:
         """Check if pipe is closed."""
-        pass
+        ...
 
 
-class ISharedMemory(ABC):
+@runtime_checkable
+class ISharedMemory(Protocol):
     """Interface for shared memory operations."""
     
-    @abstractmethod
     def create(self, name: str, size: int) -> None:
         """Create shared memory segment."""
-        pass
+        ...
     
-    @abstractmethod
     def attach(self, name: str) -> None:
         """Attach to shared memory segment."""
-        pass
+        ...
     
-    @abstractmethod
     def detach(self) -> None:
         """Detach from shared memory segment."""
-        pass
+        ...
     
-    @abstractmethod
     def unlink(self) -> None:
         """Unlink shared memory segment."""
-        pass
+        ...
     
-    @abstractmethod
     def read(self, offset: int = 0, size: Optional[int] = None) -> bytes:
         """Read from shared memory."""
-        pass
+        ...
     
-    @abstractmethod
     def write(self, data: bytes, offset: int = 0) -> None:
         """Write to shared memory."""
-        pass
+        ...
 
 
-class IProcessManager(ABC):
+@runtime_checkable
+class IProcessManager(Protocol):
     """Interface for process management."""
     
-    @abstractmethod
     def create_process(self, target: Callable, args: tuple = (), kwargs: Optional[dict] = None) -> Process:
         """Create new process."""
-        pass
+        ...
     
-    @abstractmethod
     def start_process(self, process: Process) -> None:
         """Start process."""
-        pass
+        ...
     
-    @abstractmethod
     def stop_process(self, process: Process, timeout: Optional[float] = None) -> None:
         """Stop process."""
-        pass
+        ...
     
-    @abstractmethod
     def get_process_state(self, process: Process) -> ProcessState:
         """Get process state."""
-        pass
+        ...
     
-    @abstractmethod
     def is_process_alive(self, process: Process) -> bool:
         """Check if process is alive."""
-        pass
+        ...
 
 
-class IProcessPool(ABC):
+@runtime_checkable
+class IProcessPool(Protocol):
     """Interface for process pool operations."""
     
-    @abstractmethod
     def submit(self, func: Callable, *args, **kwargs) -> Any:
         """Submit task to pool."""
-        pass
+        ...
     
-    @abstractmethod
     async def submit_async(self, func: Callable, *args, **kwargs) -> Any:
         """Submit async task to pool."""
-        pass
+        ...
     
-    @abstractmethod
     def map(self, func: Callable, iterable: list[Any]) -> list[Any]:
         """Map function over iterable."""
-        pass
+        ...
     
-    @abstractmethod
     async def map_async(self, func: Callable, iterable: list[Any]) -> list[Any]:
         """Map function over iterable asynchronously."""
-        pass
+        ...
     
-    @abstractmethod
     def close(self) -> None:
         """Close process pool."""
-        pass
+        ...
     
-    @abstractmethod
     def join(self) -> None:
         """Join all processes."""
-        pass
+        ...
 
 
-# Aliases for backward compatibility
-IPipeManager = IPipe

exonware/xwsystem/ipc/defs.py

@@ -1,10 +1,11 @@
 #!/usr/bin/env python3
+#exonware/xwsystem/src/exonware/xwsystem/ipc/defs.py
 #exonware/xwsystem/ipc/types.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
 
 IPC types and enums for XWSystem.

exonware/xwsystem/ipc/errors.py

@@ -1,9 +1,10 @@
+#exonware/xwsystem/src/exonware/xwsystem/ipc/errors.py
 #exonware/xwsystem/ipc/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
 
 IPC module errors - exception classes for inter-process communication functionality.

exonware/xwsystem/ipc/message_queue.py

@@ -1,3 +1,4 @@
+#exonware/xwsystem/src/exonware/xwsystem/ipc/message_queue.py
 """
 Message Queue Utilities
 =======================
@@ -208,7 +209,8 @@ class MessageQueue[T]:
         while not self.empty():
             try:
                 self.get_nowait()
-            except:
+            except queue.Empty:
+                # Queue is empty, stop clearing
                 break
     
     def get_stats(self) -> dict:
@@ -398,7 +400,8 @@ class AsyncMessageQueue[T]:
         while not self.empty():
             try:
                 self.get_nowait()
-            except:
+            except queue.Empty:
+                # Queue is empty, stop clearing
                 break
     
     async def get_stats(self) -> dict: