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

exonware/xwsystem/io/serialization/flyweight.py

@@ -1,9 +1,9 @@
-#exonware\xsystem\serialization\flyweight.py
+#exonware\xwsystem\serialization\flyweight.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: September 05, 2025
 
 Flyweight Pattern Implementation for Serializers
@@ -14,7 +14,7 @@ configuration, which is especially important for high-throughput applications.
 """
 
 import threading
-from typing import Any, Hashable, Optional, Type, Union
+from typing import Any, Hashable, Optional, Union
 # Root cause: Migrating to Python 3.12 built-in generic syntax for consistency
 # Priority #3: Maintainability - Modern type annotations improve code clarity
 from weakref import WeakValueDictionary
@@ -22,7 +22,7 @@ from weakref import WeakValueDictionary
 from ...config.logging_setup import get_logger
 from .contracts import ISerialization
 
-logger = get_logger("xsystem.serialization.flyweight")
+logger = get_logger("xwsystem.serialization.flyweight")
 
 
 class SerializerFlyweight:
@@ -46,7 +46,7 @@ class SerializerFlyweight:
     
     def get_serializer[T: ISerialization](
         self, 
-        serializer_class: Type[T],
+        serializer_class: type[T],
         **config: Any
     ) -> T:
         """
@@ -85,7 +85,7 @@ class SerializerFlyweight:
                 logger.error(f"Failed to create {serializer_class.__name__} instance: {e}")
                 raise
     
-    def _create_cache_key[T: ISerialization](self, serializer_class: Type[T], config: dict[str, Any]) -> str:
+    def _create_cache_key[T: ISerialization](self, serializer_class: type[T], config: dict[str, Any]) -> str:
         """
         Create a hashable cache key from class and configuration.
         
@@ -172,7 +172,7 @@ class SerializerFlyweight:
 _serializer_flyweight = SerializerFlyweight()
 
 
-def get_serializer[T: ISerialization](serializer_class: Type[T], **config: Any) -> T:
+def get_serializer[T: ISerialization](serializer_class: type[T], **config: Any) -> T:
     """
     Get a serializer instance using the flyweight pattern.
     
@@ -187,7 +187,7 @@ def get_serializer[T: ISerialization](serializer_class: Type[T], **config: Any)
         Shared serializer instance
         
     Example:
-        >>> from xsystem.serialization import JsonSerializer
+        >>> from xwsystem.serialization import JsonSerializer
         >>> # These will return the same instance
         >>> json1 = get_serializer(JsonSerializer, validate_input=True)
         >>> json2 = get_serializer(JsonSerializer, validate_input=True)
@@ -248,7 +248,7 @@ class SerializerPool:
         self._counter = 0
         self._lock = threading.RLock()
     
-    def get_serializer[T: ISerialization](self, serializer_class: Type[T], **config: Any) -> T:
+    def get_serializer[T: ISerialization](self, serializer_class: type[T], **config: Any) -> T:
         """Get serializer from pool with size-limited caching."""
         cache_key = self._create_cache_key(serializer_class, config)
         
@@ -302,7 +302,7 @@ class SerializerPool:
         
         logger.debug(f"Evicted serializer instance: {lru_key[:32]}...")
     
-    def _create_cache_key[T: ISerialization](self, serializer_class: Type[T], config: dict[str, Any]) -> str:
+    def _create_cache_key[T: ISerialization](self, serializer_class: type[T], config: dict[str, Any]) -> str:
         """Create cache key (same as flyweight implementation)."""
         return _serializer_flyweight._create_cache_key(serializer_class, config)
     

exonware/xwsystem/io/serialization/format_detector.py

@@ -1,9 +1,9 @@
-#exonware\xsystem\serialization\format_detector.py
+#exonware\xwsystem\serialization\format_detector.py
 """
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: September 04, 2025
 
 Intelligent format detection for automatic serialization format selection.
@@ -15,7 +15,7 @@ from typing import Any, Optional, Union
 
 from ...config.logging_setup import get_logger
 
-logger = get_logger("xsystem.serialization.format_detector")
+logger = get_logger("xwsystem.serialization.format_detector")
 
 
 class FormatDetector:
@@ -26,12 +26,15 @@ class FormatDetector:
     
     __slots__ = ('_extension_map', '_magic_bytes', '_content_patterns', '_confidence_threshold')
     
-    def __init__(self, confidence_threshold: float = 0.7):
+    def __init__(self, confidence_threshold: float = 0.3):
         """
         Initialize format detector.
         
         Args:
-            confidence_threshold: Minimum confidence level for format detection
+            confidence_threshold: Minimum confidence level for format detection.
+                Default is 0.3 so that simple, high-signal heuristics like
+                extension-only detection (e.g. ``test.json``) are accepted
+                without requiring magic-bytes or content analysis.
         """
         self._confidence_threshold = confidence_threshold
         self._extension_map = self._build_extension_map()

exonware/xwsystem/io/serialization/formats/__init__.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 Serialization formats - All format implementations.

exonware/xwsystem/io/serialization/formats/binary/bson.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 BSON serialization - Binary JSON format (MongoDB).

exonware/xwsystem/io/serialization/formats/binary/cbor.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 CBOR serialization - Concise Binary Object Representation.

exonware/xwsystem/io/serialization/formats/binary/marshal.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 Marshal serialization - Python internal serialization.

exonware/xwsystem/io/serialization/formats/binary/msgpack.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 MessagePack serialization - Efficient binary serialization.

exonware/xwsystem/io/serialization/formats/binary/pickle.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 Pickle serialization - Python object serialization.

exonware/xwsystem/io/serialization/formats/binary/plistlib.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 Plist serialization - Apple property list format.

exonware/xwsystem/io/serialization/formats/database/dbm.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 DBM serialization - Unix database manager.
@@ -13,6 +13,7 @@ Following I→A pattern:
 - Concrete: DbmSerializer
 """
 
+import json
 import dbm
 from typing import Any, Optional, Union
 from pathlib import Path
@@ -70,3 +71,54 @@ class DbmSerializer(ASerialization):
         """DBM decode requires file path - use load_file() instead."""
         raise NotImplementedError("DBM requires file-based operations - use load_file()")
 
+    # ---------------------------------------------------------------------
+    # FILE-BASED OPERATIONS
+    # ---------------------------------------------------------------------
+
+    def save_file(self, data: Any, file_path: Union[str, Path], **options: Any) -> None:
+        """
+        Save Python data into a DBM database file.
+
+        Root cause: Generic ``save_file`` tried to call ``encode`` which is
+        intentionally unimplemented for DBM. Fix by performing file-based
+        operations directly and storing a single JSON payload under a fixed
+        key.
+        """
+        path = Path(file_path)
+        path.parent.mkdir(parents=True, exist_ok=True)
+
+        try:
+            with dbm.open(str(path), "c") as db:
+                payload = json.dumps(data).encode("utf-8")
+                db[b"root"] = payload
+        except Exception as e:
+            raise SerializationError(
+                f"Failed to save DBM file '{path}': {e}",
+                format_name=self.format_name,
+                original_error=e,
+            ) from e
+
+    def load_file(self, file_path: Union[str, Path], **options: Any) -> Any:
+        """
+        Load Python data from a DBM database file.
+
+        Returns the JSON-decoded payload stored under the ``root`` key.
+        """
+        path = Path(file_path)
+
+        try:
+            with dbm.open(str(path), "r") as db:
+                raw = db.get(b"root")
+                if raw is None:
+                    return None
+                return json.loads(raw.decode("utf-8"))
+        except FileNotFoundError:
+            # Mirror other serializers' behaviour when file is missing
+            raise
+        except Exception as e:
+            raise SerializationError(
+                f"Failed to load DBM file '{path}': {e}",
+                format_name=self.format_name,
+                original_error=e,
+            ) from e
+

exonware/xwsystem/io/serialization/formats/database/shelve.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 Shelve serialization - Persistent dictionary storage.
@@ -70,3 +70,50 @@ class ShelveSerializer(ASerialization):
         """Shelve decode requires file path - use load_file() instead."""
         raise NotImplementedError("Shelve requires file-based operations - use load_file()")
 
+    # ---------------------------------------------------------------------
+    # FILE-BASED OPERATIONS
+    # ---------------------------------------------------------------------
+
+    def save_file(self, data: Any, file_path: Union[str, Path], **options: Any) -> None:
+        """
+        Save Python data into a shelve database file.
+
+        Uses a single key ``'root'`` to store the provided object, which is
+        sufficient for the dict-style usage expected by the tests and APIs.
+        """
+        path = Path(file_path)
+        path.parent.mkdir(parents=True, exist_ok=True)
+
+        try:
+            with shelve.open(str(path)) as db:
+                db["root"] = data
+        except Exception as e:
+            raise SerializationError(
+                f"Failed to save Shelve file '{path}': {e}",
+                format_name=self.format_name,
+                original_error=e,
+            ) from e
+
+    def load_file(self, file_path: Union[str, Path], **options: Any) -> Any:
+        """
+        Load Python data from a shelve database file.
+
+        Returns the object stored under the ``'root'`` key (or ``None`` if
+        not present), mirroring the behaviour of other serializers that
+        operate on a single top-level payload.
+        """
+        path = Path(file_path)
+
+        try:
+            with shelve.open(str(path)) as db:
+                return db.get("root")
+        except FileNotFoundError:
+            # Mirror other serializers' behaviour when file is missing
+            raise
+        except Exception as e:
+            raise SerializationError(
+                f"Failed to load Shelve file '{path}': {e}",
+                format_name=self.format_name,
+                original_error=e,
+            ) from e
+

exonware/xwsystem/io/serialization/formats/database/sqlite3.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 SQLite3 serialization - Embedded database storage.
@@ -13,6 +13,7 @@ Following I→A pattern:
 - Concrete: Sqlite3Serializer
 """
 
+import json
 import sqlite3
 from typing import Any, Optional, Union
 from pathlib import Path
@@ -70,3 +71,86 @@ class Sqlite3Serializer(ASerialization):
         """SQLite3 decode requires file path - use load_file() instead."""
         raise NotImplementedError("SQLite3 requires file-based operations - use load_file()")
 
+    # ---------------------------------------------------------------------
+    # FILE-BASED OPERATIONS (override ASerialization defaults)
+    # ---------------------------------------------------------------------
+
+    def save_file(self, data: Any, file_path: Union[str, Path], **options: Any) -> None:
+        """
+        Save Python data into a SQLite3 database file.
+
+        Root cause: The generic ``ASerialization.save_file`` implementation
+        expects an in-memory ``encode`` operation, but SQLite3 is inherently
+        file-backed and our ``encode``/``decode`` are intentionally
+        unimplemented. Calling the base implementation raised a
+        ``NotImplementedError`` wrapped in ``SerializationError``.
+
+        Solution: Override ``save_file`` / ``load_file`` to perform
+        file-based operations directly using ``sqlite3`` while still
+        presenting a simple dict-like API to callers and tests.
+        """
+        path = Path(file_path)
+        path.parent.mkdir(parents=True, exist_ok=True)
+
+        # For now we implement a minimal schema:
+        # - Single table ``data``
+        # - Single row with id=1 storing JSON representation of ``data``
+        try:
+            conn = sqlite3.connect(path)
+            try:
+                cur = conn.cursor()
+                cur.execute(
+                    "CREATE TABLE IF NOT EXISTS data ("
+                    "id INTEGER PRIMARY KEY, "
+                    "json TEXT NOT NULL"
+                    ")"
+                )
+                json_str = json.dumps(data)
+                # Ensure id=1 holds the latest payload
+                cur.execute("DELETE FROM data WHERE id = 1")
+                cur.execute("INSERT INTO data (id, json) VALUES (1, ?)", (json_str,))
+                conn.commit()
+            finally:
+                conn.close()
+        except sqlite3.Error as e:
+            raise SerializationError(
+                f"Failed to save SQLite3 file '{path}': {e}",
+                format_name=self.format_name,
+                original_error=e,
+            ) from e
+
+    def load_file(self, file_path: Union[str, Path], **options: Any) -> Any:
+        """
+        Load Python data from a SQLite3 database file.
+
+        Reads row with ``id = 1`` from the ``data`` table and returns the
+        JSON-decoded payload. This mirrors the simple dict-based contract
+        used by the tests and higher-level APIs.
+        """
+        path = Path(file_path)
+        if not path.exists():
+            raise FileNotFoundError(f"SQLite3 file not found: {path}")
+
+        try:
+            conn = sqlite3.connect(path)
+            try:
+                cur = conn.cursor()
+                cur.execute(
+                    "SELECT json FROM data WHERE id = 1"
+                )
+                row = cur.fetchone()
+                if row is None or row[0] is None:
+                    # No payload stored yet – mirror behaviour of other
+                    # serializers by returning None.
+                    return None
+
+                return json.loads(row[0])
+            finally:
+                conn.close()
+        except sqlite3.Error as e:
+            raise SerializationError(
+                f"Failed to load SQLite3 file '{path}': {e}",
+                format_name=self.format_name,
+                original_error=e,
+            ) from e
+

exonware/xwsystem/io/serialization/formats/text/configparser.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 ConfigParser serialization - INI file format.

exonware/xwsystem/io/serialization/formats/text/csv.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 CSV serialization - Comma-separated values format.

exonware/xwsystem/io/serialization/formats/text/formdata.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 FormData serialization - URL-encoded form data.

exonware/xwsystem/io/serialization/formats/text/json.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: November 2, 2025
 
 JSON serialization - Universal, human-readable data interchange format.

exonware/xwsystem/io/serialization/formats/text/json5.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.410
+Version: 0.0.1.411
 Generation Date: 02-Nov-2025
 
 JSON5 Serialization - Extended JSON with Comments and Trailing Commas
@@ -29,12 +29,11 @@ from pathlib import Path
 # Lazy import for json5 - the lazy hook will automatically handle ImportError
 import json5
 
-from ...base import ASerialization
-from ...contracts import ISerialization
+from .json import JsonSerializer
 from ....errors import SerializationError
 
 
-class Json5Serializer(ASerialization):
+class Json5Serializer(JsonSerializer):
     """
     JSON5 serializer with comment support.
     
@@ -58,7 +57,10 @@ class Json5Serializer(ASerialization):
         Priority #1: Security - Prevent DoS via excessive nesting
         Priority #4: Performance - Prevent hangs on large data
         """
-        # JSON5 parser has known performance issues, use stricter limits
+        # JSON5 parser has known performance issues, use stricter limits.
+        # We still rely on the JsonSerializer base for all generic JSON
+        # behaviour (path operations, queries, etc.), only overriding the
+        # concrete encode/decode layer.
         super().__init__(max_depth=max_depth, max_size_mb=max_size_mb)
         if json5 is None:
             raise ImportError("json5 library required. Install with: pip install json5")