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

exonware/xwsystem/io/file/paged_source.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Paged file source with MODULAR paging system.
@@ -19,7 +19,7 @@ Priority 5 (Extensibility): Add new strategies without changing this class!
 """
 
 from pathlib import Path
-from typing import Union, Optional, Iterator
+from typing import Optional, Iterator
 
 from ..contracts import IPagedDataSource
 from .source import FileDataSource
@@ -29,7 +29,7 @@ from ..contracts import IPagingStrategy
 from .paging import auto_detect_paging_strategy
 
 
-class PagedFileSource(FileDataSource, IPagedDataSource[Union[bytes, str]]):
+class PagedFileSource(FileDataSource, IPagedDataSource[bytes | str]):
     """
     Paged file source with PLUGGABLE paging strategies!
     
@@ -50,7 +50,7 @@ class PagedFileSource(FileDataSource, IPagedDataSource[Union[bytes, str]]):
     
     def __init__(
         self,
-        path: Union[str, Path],
+        path: str | Path,
         mode: str = 'rb',
         encoding: Optional[str] = None,
         validate_path: bool = True,
@@ -84,7 +84,7 @@ class PagedFileSource(FileDataSource, IPagedDataSource[Union[bytes, str]]):
             return -1
         return self._path.stat().st_size
     
-    def read_page(self, page: int, page_size: int, **options) -> Union[bytes, str]:
+    def read_page(self, page: int, page_size: int, **options) -> bytes | str:
         """
         Read specific page using the paging strategy.
         
@@ -99,7 +99,7 @@ class PagedFileSource(FileDataSource, IPagedDataSource[Union[bytes, str]]):
             **options
         )
     
-    def iter_pages(self, page_size: int, **options) -> Iterator[Union[bytes, str]]:
+    def iter_pages(self, page_size: int, **options) -> Iterator[bytes | str]:
         """
         Iterate over pages using the paging strategy.
         """
@@ -111,7 +111,7 @@ class PagedFileSource(FileDataSource, IPagedDataSource[Union[bytes, str]]):
             **options
         )
     
-    def read_chunk(self, offset: int, size: int, **options) -> Union[bytes, str]:
+    def read_chunk(self, offset: int, size: int, **options) -> bytes | str:
         """
         Read chunk by byte offset (always byte-based).
         
@@ -136,7 +136,7 @@ class PagedFileSource(FileDataSource, IPagedDataSource[Union[bytes, str]]):
         except Exception as e:
             raise IOError(f"Failed to read chunk from {self._path}: {e}")
     
-    def iter_chunks(self, chunk_size: int, **options) -> Iterator[Union[bytes, str]]:
+    def iter_chunks(self, chunk_size: int, **options) -> Iterator[bytes | str]:
         """
         Iterate over chunks by byte size.
         

exonware/xwsystem/io/file/paging/__init__.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Modular paging system with strategy pattern.
@@ -42,4 +42,3 @@ __all__ = [
     "get_paging_strategy",
     "auto_detect_paging_strategy",
 ]
-

exonware/xwsystem/io/file/paging/byte_paging.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Byte-based paging strategy.
@@ -17,7 +17,7 @@ Priority 5 (Extensibility): Pluggable via registry
 """
 
 from pathlib import Path
-from typing import Union, Optional, Iterator
+from typing import Optional, Iterator
 
 from ...contracts import IPagingStrategy
 
@@ -47,7 +47,7 @@ class BytePagingStrategy:
         mode: str = 'rb',
         encoding: Optional[str] = None,
         **options
-    ) -> Union[bytes, str]:
+    ) -> bytes | str:
         """Read page by byte offset."""
         offset = page * page_size
         
@@ -62,7 +62,7 @@ class BytePagingStrategy:
         mode: str = 'rb',
         encoding: Optional[str] = None,
         **options
-    ) -> Iterator[Union[bytes, str]]:
+    ) -> Iterator[bytes | str]:
         """Iterate over pages by byte chunks."""
         page = 0
         while True:
@@ -71,4 +71,3 @@ class BytePagingStrategy:
                 break
             yield content
             page += 1
-

exonware/xwsystem/io/file/paging/line_paging.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Line-based paging strategy.
@@ -17,7 +17,7 @@ Priority 5 (Extensibility): Pluggable via registry
 """
 
 from pathlib import Path
-from typing import Union, Optional, Iterator
+from typing import Optional, Iterator
 
 from ...contracts import IPagingStrategy
 
@@ -84,4 +84,3 @@ class LinePagingStrategy:
                 break
             yield content
             page += 1
-

exonware/xwsystem/io/file/paging/record_paging.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Record-based paging strategy for structured formats.
@@ -17,7 +17,7 @@ Priority 5 (Extensibility): Pluggable via registry
 """
 
 from pathlib import Path
-from typing import Union, Optional, Iterator
+from typing import Optional, Iterator
 
 from ...contracts import IPagingStrategy
 
@@ -98,4 +98,3 @@ class RecordPagingStrategy:
                 break
             yield content
             page += 1
-

exonware/xwsystem/io/file/paging/registry.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Paging strategy registry - LIKE CodecRegistry!
@@ -177,4 +177,3 @@ def auto_detect_paging_strategy(mode: str = 'rb', **hints) -> IPagingStrategy:
         >>> strategy = auto_detect_paging_strategy(mode='r')
     """
     return get_global_paging_registry().auto_detect(mode, **hints)
-

exonware/xwsystem/io/file/source.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 File-based data source implementation.
@@ -17,12 +17,12 @@ Priority 5 (Extensibility): Foundation for other data sources (HTTP, S3, etc.)
 """
 
 from pathlib import Path
-from typing import Union, Optional, Any
+from typing import Optional, Any
 
 from ..contracts import IDataSource
 
 
-class FileDataSource(IDataSource[Union[bytes, str]]):
+class FileDataSource(IDataSource[bytes | str]):
     """
     File-based data source implementation.
     
@@ -46,7 +46,7 @@ class FileDataSource(IDataSource[Union[bytes, str]]):
     
     def __init__(
         self,
-        path: Union[str, Path],
+        path: str | Path,
         mode: str = 'rb',
         encoding: Optional[str] = None,
         validate_path: bool = True
@@ -66,16 +66,13 @@ class FileDataSource(IDataSource[Union[bytes, str]]):
         self._validate_path = validate_path
         
         if validate_path:
-            # Use PathValidator for validation if available
-            try:
-                from ...security.path_validator import PathValidator
-                # Don't check existence during initialization - file may be created later
-                pv = PathValidator(check_existence=False)
-                # For write modes, allow creating the file (path doesn't exist yet)
-                for_writing = mode and ('w' in mode or 'a' in mode or '+' in mode)
-                pv.validate_path(str(self._path), for_writing=for_writing, create_dirs=True)
-            except ImportError:
-                pass
+            # Use PathValidator for validation (always available in xwsystem)
+            from ...security.path_validator import PathValidator
+            # Don't check existence during initialization - file may be created later
+            pv = PathValidator(check_existence=False)
+            # For write modes, allow creating the file (path doesn't exist yet)
+            for_writing = mode and ('w' in mode or 'a' in mode or '+' in mode)
+            pv.validate_path(str(self._path), for_writing=for_writing, create_dirs=True)
     
     @property
     def uri(self) -> str:
@@ -87,7 +84,7 @@ class FileDataSource(IDataSource[Union[bytes, str]]):
         """Return scheme identifier."""
         return "file"
     
-    def read(self, **options) -> Union[bytes, str]:
+    def read(self, **options) -> bytes | str:
         """
         Read entire file content.
         
@@ -109,7 +106,7 @@ class FileDataSource(IDataSource[Union[bytes, str]]):
         except Exception as e:
             raise IOError(f"Failed to read {self._path}: {e}")
     
-    def write(self, data: Union[bytes, str], **options) -> None:
+    def write(self, data: bytes | str, **options) -> None:
         """
         Write entire content to file.
         
@@ -211,4 +208,3 @@ class FileDataSource(IDataSource[Union[bytes, str]]):
                 'uri': self.uri,
                 'error': str(e)
             }
-

exonware/xwsystem/io/filesystem/__init__.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Virtual filesystem abstractions.

exonware/xwsystem/io/filesystem/base.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Base classes for virtual filesystem.
@@ -24,4 +24,3 @@ class AFileSystem(IVirtualFS, ABC):
     def scheme(self) -> str:
         """URI scheme."""
         pass
-

exonware/xwsystem/io/filesystem/local.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Local filesystem implementation.
@@ -17,7 +17,7 @@ Priority 5 (Extensibility): Foundation for other FS (S3, FTP, etc.)
 """
 
 from pathlib import Path
-from typing import Union, Optional, Any
+from typing import Optional, Any
 
 from ..contracts import IFileSystem
 
@@ -39,7 +39,7 @@ class LocalFileSystem(IFileSystem):
         >>> fs.write_text("file.txt", "content")  # Saves to S3!
     """
     
-    def __init__(self, base_path: Optional[Union[str, Path]] = None):
+    def __init__(self, base_path: Optional[str | Path] = None):
         """
         Initialize local filesystem.
         
@@ -152,4 +152,3 @@ class LocalFileSystem(IFileSystem):
     def write(self, path: str, content: bytes) -> None:
         """Write file contents."""
         self.write_bytes(path, content)
-

exonware/xwsystem/io/folder/__init__.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Folder-specific implementations.

exonware/xwsystem/io/folder/base.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: 30-Oct-2025
 
 Base classes for folder operations.
@@ -35,4 +35,3 @@ class AFolderSource(IFolderSource, ABC):
     def delete(self, recursive: bool = False) -> bool:
         """Delete directory."""
         pass
-

exonware/xwsystem/io/folder/folder.py

@@ -1,8 +1,9 @@
+#exonware/xwsystem/src/exonware/xwsystem/io/folder/folder.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.3
 Generation Date: September 04, 2025
 
 XWFolder - Concrete implementation of folder operations.
@@ -11,7 +12,7 @@ XWFolder - Concrete implementation of folder operations.
 import os
 import shutil
 from pathlib import Path
-from typing import Any, Optional, Union
+from typing import Any, Optional
 
 from ..base import AFolder
 from ..contracts import OperationResult, IFolder
@@ -37,7 +38,7 @@ class XWFolder(AFolder):
     - xwsystem integration (security, validation, monitoring)
     """
     
-    def __init__(self, dir_path: Union[str, Path], **config):
+    def __init__(self, dir_path: str | Path, **config):
         """
         Initialize XWFolder with xwsystem integration.
         
@@ -93,13 +94,17 @@ class XWFolder(AFolder):
                 logger.error(f"Failed to delete directory {self.dir_path}: {e}")
                 return False
     
-    def copy_to(self, destination: Union[str, Path]) -> bool:
+    def copy_to(self, destination: str | Path) -> bool:
         """Copy directory to destination."""
         dest_path = Path(destination)
         
         if self.validate_paths:
             self._path_validator.validate_path(self.dir_path)
-            self._path_validator.validate_path(dest_path)
+            # Destination doesn't need to exist yet - it will be created by copytree
+            # Use check_existence=False to allow destination to not exist
+            dest_parent = dest_path.parent
+            if dest_parent:
+                self._path_validator.validate_path(dest_parent, create_dirs=True)
         
         with performance_monitor("directory_copy"):
             try:
@@ -110,13 +115,17 @@ class XWFolder(AFolder):
                 logger.error(f"Failed to copy directory from {self.dir_path} to {dest_path}: {e}")
                 return False
     
-    def move_to(self, destination: Union[str, Path]) -> bool:
+    def move_to(self, destination: str | Path) -> bool:
         """Move directory to destination."""
         dest_path = Path(destination)
         
         if self.validate_paths:
             self._path_validator.validate_path(self.dir_path)
-            self._path_validator.validate_path(dest_path)
+            # Destination doesn't need to exist yet - it will be created by move
+            # Use check_existence=False to allow destination to not exist
+            dest_parent = dest_path.parent
+            if dest_parent:
+                self._path_validator.validate_path(dest_parent, create_dirs=True)
         
         with performance_monitor("directory_move"):
             try:

exonware/xwsystem/io/indexing/__init__.py

@@ -0,0 +1,14 @@
+#exonware/xwsystem/src/exonware/xwsystem/io/indexing/__init__.py
+"""
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.3
+Generation Date: January 2026
+
+Indexing module - Unified indexing facade for line-oriented files.
+"""
+
+from .facade import XWIndex
+
+__all__ = ["XWIndex"]