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

exonware/xwsystem/io/serialization/parsers/registry.py

@@ -0,0 +1,90 @@
+"""Parser registry for JSON parser selection and auto-detection."""
+
+from typing import Optional, Dict, Type
+
+from .base import IJsonParser
+from .standard import StandardJsonParser
+
+# Import hybrid parser (direct, no try/catch - assumes msgspec and orjson available)
+from .hybrid_parser import HybridParser
+
+# Registry of available parsers
+_PARSERS: Dict[str, Type[IJsonParser]] = {
+    "hybrid": HybridParser,  # Default: msgspec for reading, orjson for writing
+    "standard": StandardJsonParser,  # Fallback only
+}
+
+# Cache of parser instances
+_PARSER_INSTANCES: Dict[str, IJsonParser] = {}
+
+
+def get_best_available_parser() -> IJsonParser:
+    """
+    Auto-detect and return the best available parser.
+    
+    Default: hybrid (msgspec for reading, orjson for writing)
+    - Fastest combination: msgspec reads 1.36x faster, orjson writes 2.27x faster
+    - Direct imports (no try/catch) - assumes both are available
+    
+    Fallback: standard (stdlib json)
+    
+    Returns:
+        Best available parser instance
+    """
+    # Try hybrid first (default)
+    parser_class = _PARSERS.get("hybrid")
+    if parser_class:
+        parser = parser_class()
+        if parser.is_available:
+            return parser
+    
+    # Fallback to standard (always available)
+    return StandardJsonParser()
+
+
+def get_parser(name: Optional[str] = None) -> IJsonParser:
+    """
+    Get parser by name or auto-detect best available.
+    
+    Args:
+        name: Parser name ("standard", "orjson", or None for auto-detect)
+    
+    Returns:
+        Parser instance (falls back to best available if requested parser unavailable)
+    """
+    if name is None:
+        return get_best_available_parser()
+    
+    # Check cache first
+    if name in _PARSER_INSTANCES:
+        parser = _PARSER_INSTANCES[name]
+        if parser.is_available:
+            return parser
+    
+    # Create new instance
+    parser_class = _PARSERS.get(name, StandardJsonParser)
+    parser = parser_class()
+    
+    # Cache if available
+    if parser.is_available:
+        _PARSER_INSTANCES[name] = parser
+    else:
+        # Fallback to best available if requested parser unavailable
+        if name != "standard":
+            return get_best_available_parser()
+    
+    return parser
+
+
+def register_parser(name: str, parser_class: Type[IJsonParser]):
+    """
+    Register a new parser implementation.
+    
+    Args:
+        name: Parser identifier
+        parser_class: Parser class implementing IJsonParser
+    """
+    _PARSERS[name] = parser_class
+    # Clear cache to allow new parser to be used
+    if name in _PARSER_INSTANCES:
+        del _PARSER_INSTANCES[name]

exonware/xwsystem/io/serialization/parsers/standard.py

@@ -0,0 +1,43 @@
+"""Standard library JSON parser (baseline implementation)."""
+
+import json
+from typing import Any, Union
+
+from .base import IJsonParser
+
+
+class StandardJsonParser(IJsonParser):
+    """Standard library JSON parser - Tier 0 (baseline)."""
+    
+    @property
+    def parser_name(self) -> str:
+        return "standard"
+    
+    @property
+    def tier(self) -> int:
+        return 0
+    
+    @property
+    def is_available(self) -> bool:
+        return True  # Always available (stdlib)
+    
+    def loads(self, s: Union[str, bytes]) -> Any:
+        """Parse JSON using stdlib json.loads()."""
+        if isinstance(s, bytes):
+            s = s.decode("utf-8")
+        return json.loads(s)
+    
+    def dumps(self, obj: Any, **kwargs) -> Union[str, bytes]:
+        """Serialize JSON using stdlib json.dumps()."""
+        ensure_ascii = kwargs.get("ensure_ascii", False)
+        indent = kwargs.get("indent", None)
+        sort_keys = kwargs.get("sort_keys", False)
+        
+        return json.dumps(
+            obj,
+            ensure_ascii=ensure_ascii,
+            indent=indent,
+            sort_keys=sort_keys,
+            default=kwargs.get("default", None),
+            cls=kwargs.get("cls", None),
+        )

exonware/xwsystem/io/serialization/parsers/ujson_parser.py

@@ -0,0 +1,50 @@
+"""ujson parser - Tier 1 (C-based, fast)."""
+
+from typing import Any, Union
+
+try:
+    import ujson
+    UJSON_AVAILABLE = True
+except ImportError:
+    UJSON_AVAILABLE = False
+    ujson = None
+
+from .base import IJsonParser
+
+
+class UjsonParser(IJsonParser):
+    """ujson parser - Tier 1 (C-based, fast)."""
+    
+    @property
+    def parser_name(self) -> str:
+        return "ujson"
+    
+    @property
+    def tier(self) -> int:
+        return 1
+    
+    @property
+    def is_available(self) -> bool:
+        return UJSON_AVAILABLE
+    
+    def loads(self, s: Union[str, bytes]) -> Any:
+        """Parse JSON using ujson.loads()."""
+        if isinstance(s, bytes):
+            s = s.decode("utf-8")
+        return ujson.loads(s)
+    
+    def dumps(self, obj: Any, **kwargs) -> Union[str, bytes]:
+        """Serialize JSON using ujson.dumps()."""
+        # ujson supports most stdlib kwargs
+        result = ujson.dumps(
+            obj,
+            ensure_ascii=kwargs.get("ensure_ascii", True),
+            indent=kwargs.get("indent", None),
+            sort_keys=kwargs.get("sort_keys", False),
+        )
+        
+        # ujson returns str, encode if bytes needed
+        if isinstance(result, str) and kwargs.get("return_bytes", False):
+            return result.encode("utf-8")
+        
+        return result

exonware/xwsystem/io/serialization/registry.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: November 2, 2025
 
 Serialization Registry - Delegates to UniversalCodecRegistry.

exonware/xwsystem/io/serialization/serializer.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 XWSerializer - Unified intelligent serializer with I/O integration and auto-serialization.

exonware/xwsystem/io/serialization/utils/__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.1
 Generation Date: November 9, 2025
 
 Serialization utilities module.

exonware/xwsystem/io/serialization/utils/path_ops.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.1
 Generation Date: November 9, 2025
 
 Path operations utilities for serialization formats.

exonware/xwsystem/io/stream/__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.1
 Generation Date: 30-Oct-2025
 
 Stream operations and codec-integrated I/O.

exonware/xwsystem/io/stream/async_operations.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Asynchronous I/O operations for non-blocking file handling.

exonware/xwsystem/io/stream/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.1
 Generation Date: 30-Oct-2025
 
 Base classes for stream operations.

exonware/xwsystem/io/stream/codec_io.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.1
 Generation Date: 30-Oct-2025
 
 Codec-integrated I/O - THE KILLER FEATURE!

exonware/xwsystem/ipc/async_fabric.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: 09-Nov-2025
 
 Async Process Fabric

exonware/xwsystem/ipc/base.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 IPC module base classes - abstract classes for inter-process communication functionality.

exonware/xwsystem/ipc/contracts.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 IPC module contracts - interfaces and enums for inter-process communication.

exonware/xwsystem/ipc/defs.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.1
 Generation Date: 07-Sep-2025
 
 IPC types and enums for XWSystem.

exonware/xwsystem/ipc/errors.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 IPC module errors - exception classes for inter-process communication functionality.

exonware/xwsystem/monitoring/base.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Monitoring module base classes - abstract classes for monitoring functionality.

exonware/xwsystem/monitoring/contracts.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Monitoring protocol interfaces for XWSystem.

exonware/xwsystem/monitoring/defs.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.1
 Generation Date: 07-Sep-2025
 
 Monitoring types and enums for XWSystem.

exonware/xwsystem/monitoring/errors.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Monitoring module errors - exception classes for monitoring functionality.

exonware/xwsystem/monitoring/performance_manager_generic.py

@@ -10,7 +10,7 @@ health monitoring, and recommendations without being tied to specific implementa
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: November 04, 2025
 """
 

exonware/xwsystem/monitoring/system_monitor.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 System-wide monitoring and hardware introspection utilities.

exonware/xwsystem/monitoring/tracing.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 05, 2025
 
 Distributed Tracing Integration for Enterprise Observability

exonware/xwsystem/monitoring/tracker.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: October 26, 2025
 
 Operation tracker for monitoring operations with context management.

exonware/xwsystem/operations/__init__.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: October 26, 2025
 
 Universal operations library for data manipulation.

exonware/xwsystem/operations/base.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: October 26, 2025
 
 Base classes and contracts for operations.

exonware/xwsystem/operations/defs.py

@@ -5,7 +5,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: October 27, 2025
 
 Operations definitions and data structures.

exonware/xwsystem/operations/diff.py

@@ -5,7 +5,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: October 27, 2025
 
 Diff operations implementation.

exonware/xwsystem/operations/merge.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: October 26, 2025
 
 Merge operations implementation.

exonware/xwsystem/operations/patch.py

@@ -5,7 +5,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: October 27, 2025
 
 Patch operations implementation (RFC 6902 JSON Patch).

exonware/xwsystem/patterns/base.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Abstract base classes for XSystem patterns.

exonware/xwsystem/patterns/contracts.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Pattern contracts and interfaces for XWSystem design patterns.

exonware/xwsystem/patterns/defs.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.1
 Generation Date: 07-Sep-2025
 
 Pattern types and enums for XWSystem design patterns.

exonware/xwsystem/patterns/errors.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Pattern-specific error classes for XSystem design patterns.

exonware/xwsystem/patterns/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.1
 Generation Date: October 26, 2025
 
 Generic registry pattern for dynamic registration and discovery.

exonware/xwsystem/plugins/__init__.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 XSystem Plugins Package

exonware/xwsystem/plugins/base.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Plugin system base classes and management.

exonware/xwsystem/plugins/contracts.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Plugin protocol interfaces for XWSystem.

exonware/xwsystem/plugins/defs.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.1
 Generation Date: 07-Sep-2025
 
 Plugins types and enums for XWSystem.

exonware/xwsystem/plugins/errors.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Plugin-specific error classes for XSystem plugin system.

exonware/xwsystem/runtime/__init__.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 XSystem Runtime Package

exonware/xwsystem/runtime/base.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Runtime module base classes - abstract classes for runtime functionality.

exonware/xwsystem/runtime/contracts.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Runtime module contracts - interfaces and enums for runtime environment functionality.

exonware/xwsystem/runtime/defs.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.1
 Generation Date: 07-Sep-2025
 
 Runtime types and enums for XWSystem.

exonware/xwsystem/runtime/env.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Environment management utilities for runtime configuration and detection.

exonware/xwsystem/runtime/errors.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Runtime module errors - exception classes for runtime functionality.

exonware/xwsystem/runtime/reflection.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Reflection utilities for dynamic code inspection and manipulation.

exonware/xwsystem/security/auth.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Advanced Authentication Providers for Enterprise Integration

exonware/xwsystem/security/base.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Security module base classes - abstract classes for security functionality.

exonware/xwsystem/security/contracts.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.411
+Version: 0.1.0.1
 Generation Date: September 04, 2025
 
 Security protocol interfaces for XWSystem.