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

exonware/xwsystem/io/defs.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 IO module definitions - ALL enums and types in ONE place.

exonware/xwsystem/io/errors.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri  
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 IO module errors - ALL exceptions in ONE place.

exonware/xwsystem/io/facade.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 XWIO - Main facade for all I/O operations (MANDATORY facade pattern).
@@ -92,7 +92,7 @@ class XWIO(AUnifiedIO):
         
         with performance_monitor("file_open"):
             # Ensure parent directory exists
-            if self.auto_create_dirs and mode in [FileMode.WRITE, FileMode.APPEND, FileMode.WRITE_PLUS]:
+            if self.auto_create_dirs and mode in [FileMode.WRITE, FileMode.APPEND, FileMode.WRITE_READ]:
                 target_path.parent.mkdir(parents=True, exist_ok=True)
             
             # Open file

exonware/xwsystem/io/file/__init__.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 File-specific implementations and utilities.

exonware/xwsystem/io/file/base.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Base classes for file operations.

exonware/xwsystem/io/file/conversion.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: November 1, 2025
 
 File Format Conversion - Convert between compatible formats.

exonware/xwsystem/io/file/file.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 XWFile - Concrete implementation of file operations.
@@ -72,11 +72,12 @@ class XWFile(AFile):
     def open(self, mode: FileMode = FileMode.READ) -> None:
         """Open file with validation and monitoring."""
         if self.validate_paths:
-            self._path_validator.validate_path(self.file_path)
+            for_writing = mode in [FileMode.WRITE, FileMode.APPEND, FileMode.WRITE_READ, FileMode.BINARY_WRITE, FileMode.BINARY_APPEND, FileMode.BINARY_WRITE_READ]
+            self._path_validator.validate_path(self.file_path, for_writing=for_writing, create_dirs=self.auto_create_dirs)
         
         with performance_monitor("file_open"):
             # Ensure parent directory exists
-            if self.auto_create_dirs and mode in [FileMode.WRITE, FileMode.APPEND, FileMode.WRITE_PLUS]:
+            if self.auto_create_dirs and mode in [FileMode.WRITE, FileMode.APPEND, FileMode.WRITE_READ]:
                 self.file_path.parent.mkdir(parents=True, exist_ok=True)
             
             # Open file
@@ -110,7 +111,7 @@ class XWFile(AFile):
     def save(self, data: Any, **kwargs) -> bool:
         """Save data to file with atomic operations."""
         if self.validate_paths:
-            self._path_validator.validate_path(self.file_path)
+            self._path_validator.validate_path(self.file_path, for_writing=True, create_dirs=True)
         
         if self.validate_data:
             self._data_validator.validate_data(data)
@@ -119,9 +120,10 @@ class XWFile(AFile):
             try:
                 if self.use_atomic_operations:
                     # Use atomic file writer
-                    with AtomicFileWriter(self.file_path, backup=self.auto_backup) as writer:
+                    mode = 'wb' if isinstance(data, bytes) else 'w'
+                    with AtomicFileWriter(self.file_path, mode=mode, backup=self.auto_backup) as writer:
                         if isinstance(data, str):
-                            writer.write(data.encode('utf-8'))
+                            writer.write(data)
                         else:
                             writer.write(data)
                 else:

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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Paged file source with MODULAR paging system.
@@ -154,3 +154,10 @@ class PagedFileSource(FileDataSource, IPagedDataSource[Union[bytes, str]]):
                 break
             yield chunk
             offset += len(chunk) if isinstance(chunk, (bytes, str)) else chunk_size
+    
+    def get_page_count(self, page_size: int = 1024) -> int:
+        """Get total number of pages."""
+        total_size = self.total_size
+        if total_size < 0:
+            return 0
+        return (total_size + page_size - 1) // page_size  # Ceiling division

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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Modular paging system with strategy pattern.

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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Byte-based paging strategy.

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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Line-based paging strategy.

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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Record-based paging strategy for structured formats.

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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Paging strategy registry - LIKE CodecRegistry!
@@ -18,7 +18,7 @@ Priority 4 (Performance): Fast strategy lookup
 Priority 5 (Extensibility): Easy to add new strategies
 """
 
-from typing import Optional, Type
+from typing import Optional
 from ...contracts import IPagingStrategy
 from ...defs import PagingMode
 
@@ -46,10 +46,10 @@ class PagingStrategyRegistry:
     
     def __init__(self):
         """Initialize registry."""
-        self._strategies: dict[str, Type[IPagingStrategy]] = {}
+        self._strategies: dict[str, type[IPagingStrategy]] = {}
         self._instances: dict[str, IPagingStrategy] = {}
     
-    def register(self, strategy_class: Type[IPagingStrategy]) -> None:
+    def register(self, strategy_class: type[IPagingStrategy]) -> None:
         """
         Register a paging strategy.
         

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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 File-based data source implementation.
@@ -66,12 +66,14 @@ class FileDataSource(IDataSource[Union[bytes, str]]):
         self._validate_path = validate_path
         
         if validate_path:
-            # Use PathManager for validation if available
+            # Use PathValidator for validation if available
             try:
-                from ..common.path_manager import PathManager
-                pm = PathManager()
-                if not pm.is_safe_path(self._path):
-                    raise ValueError(f"Unsafe path: {self._path}")
+                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
     
@@ -131,10 +133,19 @@ class FileDataSource(IDataSource[Union[bytes, str]]):
             if atomic:
                 # Use AtomicFileWriter from common
                 from ..common.atomic import AtomicFileWriter
-                with AtomicFileWriter(self._path, backup=backup) as writer:
+                # Determine mode based on data type and stored mode
+                if isinstance(data, bytes):
+                    # Binary mode
+                    atomic_mode = 'wb'
+                    encoding = None
+                else:
+                    # Text mode
+                    atomic_mode = 'w'
+                    encoding = options.get('encoding', self._encoding or 'utf-8')
+                
+                with AtomicFileWriter(self._path, mode=atomic_mode, encoding=encoding, backup=backup) as writer:
                     if isinstance(data, str):
-                        encoding = options.get('encoding', self._encoding or 'utf-8')
-                        writer.write(data.encode(encoding))
+                        writer.write(data)
                     else:
                         writer.write(data)
             else:

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.410
+Version: 0.1.0.1
 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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Base classes for virtual filesystem.

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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Local filesystem implementation.
@@ -144,4 +144,12 @@ class LocalFileSystem(IFileSystem):
         p = self._resolve_path(path)
         p.parent.mkdir(parents=True, exist_ok=True)
         p.write_bytes(content)
+    
+    def read(self, path: str) -> bytes:
+        """Read file contents."""
+        return self.read_bytes(path)
+    
+    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.410
+Version: 0.1.0.1
 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.410
+Version: 0.1.0.1
 Generation Date: 30-Oct-2025
 
 Base classes for folder operations.

exonware/xwsystem/io/folder/folder.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 XWFolder - Concrete implementation of folder operations.
@@ -65,7 +65,7 @@ class XWFolder(AFolder):
     def create(self, parents: bool = True, exist_ok: bool = True) -> bool:
         """Create directory with validation."""
         if self.validate_paths:
-            self._path_validator.validate_path(self.dir_path)
+            self._path_validator.validate_path(self.dir_path, for_writing=True, create_dirs=parents)
         
         with performance_monitor("directory_create"):
             try:

exonware/xwsystem/io/serialization/__init__.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: November 2, 2025
 
 Serialization module - 29+ serialization formats with I→A→XW pattern.

exonware/xwsystem/io/serialization/auto_serializer.py

@@ -3,14 +3,14 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Automatic serializer that detects format and delegates to appropriate serializer.
 """
 
 from pathlib import Path
-from typing import Any, Optional, Type, Union
+from typing import Any, Optional, Union
 
 from .format_detector import FormatDetector, detect_format
 from .contracts import ISerialization
@@ -39,7 +39,7 @@ class AutoSerializer:
         self._serializer_cache: dict[str, ISerialization] = {}
         self._default_format = default_format
     
-    def _get_serializer_class(self, format_name: str) -> Type[ISerialization]:
+    def _get_serializer_class(self, format_name: str) -> type[ISerialization]:
         """
         Get serializer class for format name.
         
@@ -52,36 +52,45 @@ class AutoSerializer:
         Raises:
             ImportError: If format not available
         """
-        # Dynamic import to avoid circular dependencies
+        # Dynamic import to avoid circular dependencies.
+        # Root cause fix: import concrete serializers from the canonical
+        # xwsystem.io.serialization.formats packages instead of a parallel
+        # exonware.xwsystem.serialization namespace (which should not exist).
         module_map = {
-            'JSON': ('json', 'JsonSerializer'),
-            'YAML': ('yaml', 'YamlSerializer'),
-            'TOML': ('toml', 'TomlSerializer'),
-            'XML': ('xml', 'XmlSerializer'),
-            'CSV': ('csv', 'CsvSerializer'),
-            'ConfigParser': ('configparser', 'ConfigParserSerializer'),
-            'FormData': ('formdata', 'FormDataSerializer'),
-            'Multipart': ('multipart', 'MultipartSerializer'),
-            
-            # Binary formats
-            'BSON': ('bson', 'BsonSerializer'),
-            'MessagePack': ('msgpack', 'MsgPackSerializer'),
-            'CBOR': ('cbor', 'CborSerializer'),
-            'Pickle': ('pickle', 'PickleSerializer'),
-            'Marshal': ('marshal', 'MarshalSerializer'),
-            'SQLite3': ('sqlite3', 'Sqlite3Serializer'),
-            'DBM': ('dbm', 'DbmSerializer'),
-            'Shelve': ('shelve', 'ShelveSerializer'),
-            'Plistlib': ('plistlib', 'PlistSerializer'),
-            
-            # Schema-based formats
-            'Avro': ('avro', 'AvroSerializer'),
-            'Protobuf': ('protobuf', 'ProtobufSerializer'),
-            'Thrift': ('thrift', 'ThriftSerializer'),
-            'Parquet': ('parquet', 'ParquetSerializer'),
-            'ORC': ('orc', 'OrcSerializer'),
-            'CapnProto': ('capnproto', 'CapnProtoSerializer'),
-            'FlatBuffers': ('flatbuffers', 'FlatBuffersSerializer'),
+            # Text formats
+            'JSON': ('io.serialization.formats.text.json', 'JsonSerializer'),
+            'JSONL': ('io.serialization.formats.text.jsonlines', 'JsonLinesSerializer'),
+            'NDJSON': ('io.serialization.formats.text.jsonlines', 'JsonLinesSerializer'),
+            'YAML': ('io.serialization.formats.text.yaml', 'YamlSerializer'),
+            'TOML': ('io.serialization.formats.text.toml', 'TomlSerializer'),
+            'XML': ('io.serialization.formats.text.xml', 'XmlSerializer'),
+            'CSV': ('io.serialization.formats.text.csv', 'CsvSerializer'),
+            'ConfigParser': ('io.serialization.formats.text.configparser', 'ConfigParserSerializer'),
+            'FormData': ('io.serialization.formats.text.formdata', 'FormDataSerializer'),
+            'Multipart': ('io.serialization.formats.text.multipart', 'MultipartSerializer'),
+
+            # Binary / database formats
+            'BSON': ('io.serialization.formats.binary.bson', 'BsonSerializer'),
+            'MessagePack': ('io.serialization.formats.binary.msgpack', 'MsgPackSerializer'),
+            'CBOR': ('io.serialization.formats.binary.cbor', 'CborSerializer'),
+            'Pickle': ('io.serialization.formats.binary.pickle', 'PickleSerializer'),
+            'Marshal': ('io.serialization.formats.binary.marshal', 'MarshalSerializer'),
+            'SQLite3': ('io.serialization.formats.database.sqlite3', 'Sqlite3Serializer'),
+            'DBM': ('io.serialization.formats.database.dbm', 'DbmSerializer'),
+            'Shelve': ('io.serialization.formats.database.shelve', 'ShelveSerializer'),
+            'Plistlib': ('io.serialization.formats.binary.plistlib', 'PlistSerializer'),
+
+            # Schema-based / advanced formats (placeholders for future modules)
+            # These entries intentionally point to non-existent modules today.
+            # The lazy installation system will handle installing/adding them
+            # when the corresponding format implementations are introduced.
+            'Avro': ('io.serialization.formats.schema.avro', 'AvroSerializer'),
+            'Protobuf': ('io.serialization.formats.schema.protobuf', 'ProtobufSerializer'),
+            'Thrift': ('io.serialization.formats.schema.thrift', 'ThriftSerializer'),
+            'Parquet': ('io.serialization.formats.scientific.parquet', 'ParquetSerializer'),
+            'ORC': ('io.serialization.formats.scientific.orc', 'OrcSerializer'),
+            'CapnProto': ('io.serialization.formats.schema.capnproto', 'CapnProtoSerializer'),
+            'FlatBuffers': ('io.serialization.formats.schema.flatbuffers', 'FlatBuffersSerializer'),
         }
         
         if format_name not in module_map:
@@ -90,9 +99,9 @@ class AutoSerializer:
         module_name, class_name = module_map[format_name]
         
         try:
-            # Import from current package
-            module = __import__(f'exonware.xwsystem.serialization.{module_name}', 
-                              fromlist=[class_name])
+            # Import from canonical xwsystem.io serialization path
+            module = __import__(f'exonware.xwsystem.{module_name}',
+                                fromlist=[class_name])
             return getattr(module, class_name)
         except (ImportError, AttributeError) as e:
             # Lazy installation system will handle missing dependencies
@@ -119,7 +128,8 @@ class AutoSerializer:
         self, 
         data: Any, 
         file_path: Optional[Union[str, Path]] = None,
-        format_hint: Optional[str] = None
+        format_hint: Optional[str] = None,
+        **opts
     ) -> Union[str, bytes]:
         """
         Auto-detect format and serialize data.
@@ -128,6 +138,7 @@ class AutoSerializer:
             data: Data to serialize
             file_path: Optional file path for format detection
             format_hint: Optional format hint to use
+            **opts: Additional serializer-specific options (pretty, indent, etc.)
             
         Returns:
             Serialized data
@@ -145,7 +156,7 @@ class AutoSerializer:
                 logger.debug(f"Using default format: {format_name}")
         
         serializer = self._get_serializer(format_name)
-        return serializer.dumps(data)
+        return serializer.dumps(data, **opts)
     
     def detect_and_deserialize(
         self, 
@@ -362,7 +373,8 @@ _global_auto_serializer = AutoSerializer()
 def auto_serialize(
     data: Any, 
     file_path: Optional[Union[str, Path]] = None,
-    format_hint: Optional[str] = None
+    format_hint: Optional[str] = None,
+    **opts
 ) -> Union[str, bytes]:
     """
     Convenience function for auto-serialization.
@@ -371,11 +383,12 @@ def auto_serialize(
         data: Data to serialize
         file_path: Optional file path for format detection
         format_hint: Optional format hint
+        **opts: Additional serializer options
         
     Returns:
         Serialized data
     """
-    return _global_auto_serializer.detect_and_serialize(data, file_path, format_hint)
+    return _global_auto_serializer.detect_and_serialize(data, file_path, format_hint, **opts)
 
 def auto_deserialize(
     data: Union[str, bytes],