exonware-xwsystem 0.0.1.407__py3-none-any.whl → 0.0.1.408__py3-none-any.whl

exonware/__init__.py

@@ -4,7 +4,7 @@ exonware package - Enterprise-grade Python framework ecosystem
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: September 04, 2025
 
 This is a namespace package allowing multiple exonware subpackages
@@ -14,17 +14,26 @@ to coexist (xwsystem, xwnode, xwdata, etc.)
 # Make this a namespace package
 __path__ = __import__('pkgutil').extend_path(__path__, __name__)
 
-# Only import version if xwsystem is available (lazy import)
-# Root cause: Previous implementation used a hardcoded fallback placeholder,
-# which violates version centralization (GUIDE_DEV / GUIDE_TEST). Fix by
-# requiring the centralized version module to load successfully.
-try:
-    from .xwsystem.version import __version__
-except ImportError as exc:  # pragma: no cover - ensure failure is explicit
-    raise ImportError(
-        "exonware.xwsystem version metadata unavailable. Ensure the package is "
-        "installed with its source tree intact so that 'xwsystem.version' can be imported."
-    ) from exc
+import importlib.metadata
+from pathlib import Path
+
+
+def _load_version() -> str:
+    try:
+        return importlib.metadata.version("exonware-xwsystem")
+    except importlib.metadata.PackageNotFoundError:
+        version_path = Path(__file__).parent / "xwsystem" / "version.py"
+        ns: dict = {}
+        try:
+            exec(version_path.read_text(encoding="utf-8"), ns)  # noqa: S102
+        except FileNotFoundError as exc:  # pragma: no cover
+            raise ImportError(
+                f"Version metadata unavailable at {version_path}."
+            ) from exc
+        return ns["__version__"]
+
+
+__version__ = _load_version()
 
 __author__ = 'Eng. Muhammad AlShehri'
 __email__ = 'connect@exonware.com'

exonware/conf.py

@@ -9,7 +9,7 @@ works across all exonware packages (xwsystem, xwnode, xwdata, etc.).
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 11-Nov-2025
 """
 
@@ -17,163 +17,103 @@ from __future__ import annotations
 
 import sys
 import types
-from typing import Dict, Optional, Any
 
-from exonware.xwsystem.utils.lazy_package.lazy_state import LazyStateManager
+# CRITICAL: Set up warning filter BEFORE any other imports to catch early warnings
+# This suppresses the decimal module mpd_setminalloc warning that appears on stderr
+_original_stderr = sys.stderr
 
-
-class _PackageConfig:
-    """Per-package configuration wrapper."""
-    
-    def __init__(self, package_name: str, parent_conf):
-        self._package_name = package_name
-        self._parent_conf = parent_conf
-        self._lazy_config = None
-    
-    @property
-    def lazy_install(self) -> bool:
-        """Get lazy install status for this package."""
-        return self._get_lazy_config().lazy_import
-    
-    @lazy_install.setter
-    def lazy_install(self, value: bool) -> None:
-        """Set lazy install for this package."""
-        self._get_lazy_config().lazy_import = value
+class _FilteredStderr:
+    """Stderr wrapper that filters out decimal module warnings."""
+    def __init__(self, original_stderr):
+        self._original = original_stderr
+        # Match various forms of the decimal warning
+        self._filter_patterns = [
+            "mpd_setminalloc",
+            "MPD_MINALLOC", 
+            "ignoring request to set",
+            "libmpdec",
+            "context.c:57"
+        ]
     
-    def lazy_install_status(self) -> dict:
-        """Get detailed lazy install status for this package."""
-        return self._get_lazy_config().get_lazy_status()
+    def write(self, text: str) -> int:
+        """Write to stderr, filtering out unwanted warnings."""
+        # Check if this line contains any of our filter patterns
+        if any(pattern.lower() in text.lower() for pattern in self._filter_patterns):
+            return len(text)  # Pretend we wrote it, but don't actually write
+        return self._original.write(text)
     
-    def is_lazy_active(self) -> bool:
-        """Check if lazy mode is active for this package."""
-        return self._get_lazy_config().is_lazy_active()
+    def flush(self) -> None:
+        """Flush the original stderr."""
+        self._original.flush()
     
-    def _get_lazy_config(self):
-        """Lazy import LazyConfig from xwsystem when needed."""
-        if self._lazy_config is None:
-            try:
-                # Try to import - if xwsystem is already loaded, use it
-                import importlib
-                config_module = importlib.import_module('exonware.xwsystem.utils.lazy_package.config')
-                LazyConfig = config_module.LazyConfig
-                self._lazy_config = LazyConfig(packages=(self._package_name,))
-            except (ImportError, AttributeError):
-                # Fallback config that uses environment variables for early hook installation
-                class _StandaloneConfig:
-                    def __init__(self, pkg, parent):
-                        self._pkg = pkg
-                        self._parent = parent
-                        import os
-                        # Check environment variable for initial state
-                        env_var = f"{pkg.upper()}_LAZY_INSTALL"
-                        self._enabled = os.environ.get(env_var, '').lower() in ('true', '1', 'yes', 'on')
-                    
-                    @property
-                    def lazy_import(self):
-                        return self._enabled
-                    
-                    @lazy_import.setter
-                    def lazy_import(self, value):
-                        import os
-                        self._enabled = value
-                        state_manager = LazyStateManager(self._pkg)
-                        state_manager.set_manual_state(value)
-                        if not value:
-                            state_manager.set_auto_state(False)
-                        # Set environment variable so bootstrap can read it
-                        env_var = f"{self._pkg.upper()}_LAZY_INSTALL"
-                        if value:
-                            os.environ[env_var] = '1'
-                            # Try to install hook if xwsystem is available
-                            self._parent._try_install_hook(self._pkg)
-                        else:
-                            os.environ.pop(env_var, None)
-                    
-                    def get_lazy_status(self):
-                        # Try to get real status if xwsystem is now available
-                        try:
-                            import importlib
-                            config_module = importlib.import_module('exonware.xwsystem.utils.lazy_package.config')
-                            LazyConfig = config_module.LazyConfig
-                            real_config = LazyConfig(packages=(self._pkg,))
-                            return real_config.get_lazy_status()
-                        except (ImportError, AttributeError):
-                            return {
-                                'enabled': self._enabled,
-                                'hook_installed': False,
-                                'lazy_install_enabled': False,
-                                'active': False,
-                                'error': 'xwsystem not available'
-                            }
-                    
-                    def is_lazy_active(self):
-                        try:
-                            import importlib
-                            config_module = importlib.import_module('exonware.xwsystem.utils.lazy_package.config')
-                            LazyConfig = config_module.LazyConfig
-                            real_config = LazyConfig(packages=(self._pkg,))
-                            return real_config.is_lazy_active()
-                        except (ImportError, AttributeError):
-                            return False
-                
-                self._lazy_config = _StandaloneConfig(self._package_name, self._parent_conf)
-        return self._lazy_config
+    def reconfigure(self, *args, **kwargs):
+        """Handle reconfigure calls - update original reference and reapply filter."""
+        # Update the original reference after reconfigure
+        result = self._original.reconfigure(*args, **kwargs)
+        # Ensure filter stays active
+        if sys.stderr is not self:
+            sys.stderr = self  # type: ignore[assignment]
+        return result
     
-    def _try_install_hook(self, package_name: str):
-        """Try to install hook if xwsystem is available."""
-        try:
-            import importlib
-            lazy_core = importlib.import_module('exonware.xwsystem.utils.lazy_package.lazy_core')
-            if hasattr(lazy_core, 'install_import_hook'):
-                lazy_core.install_import_hook(package_name)
-        except (ImportError, AttributeError):
-            # xwsystem not available yet - bootstrap will install hook when it loads
-            pass
+    def __getattr__(self, name: str):
+        """Delegate all other attributes to original stderr."""
+        return getattr(self._original, name)
 
+# Set up filter immediately (default: suppress warnings)
+_filtered_stderr = _FilteredStderr(_original_stderr)
+sys.stderr = _filtered_stderr  # type: ignore[assignment]
 
-class _ExonwareConfModule(types.ModuleType):
-    """
-    Configuration module for all exonware packages.
-    
-    Provides per-package lazy mode configuration without requiring
-    any library to be initialized first.
-    """
-    
-    def __init__(self, name, doc=None):
-        super().__init__(name, doc)
-        self._package_configs: Dict[str, _PackageConfig] = {}
-    
-    def __getattr__(self, name: str):
-        # Per-package config access: conf.xwsystem.lazy_install
-        if name in ('xwsystem', 'xwnode', 'xwdata', 'xwschema', 'xwaction', 'xwentity'):
-            if name not in self._package_configs:
-                self._package_configs[name] = _PackageConfig(name, self)
-            return self._package_configs[name]
-        
-        # Global lazy_install (defaults to xwsystem for backward compatibility)
-        if name == "lazy_install":
-            return self.xwsystem.lazy_install
-        elif name == "lazy_install_status":
-            return self.xwsystem.lazy_install_status
-        elif name == "is_lazy_active":
-            return self.xwsystem.is_lazy_active
-        
-        raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
-    
-    def __setattr__(self, name: str, value) -> None:
-        # Internal attributes
-        if name.startswith('_'):
-            super().__setattr__(name, value)
-            return
-        
-        # Global lazy_install (defaults to xwsystem)
-        if name == "lazy_install":
-            self.xwsystem.lazy_install = value
-        else:
-            super().__setattr__(name, value)
+# CRITICAL: Configure UTF-8 encoding on Windows for emoji support
+# This ensures emojis work automatically when exonware.conf is imported
+# Root cause: Windows console defaults to cp1252 encoding, which can't encode emojis
+# Trigger: This code runs at import time, before any prints, ensuring UTF-8 is active
+if sys.platform == "win32":
+    try:
+        # Try to reconfigure stdout/stderr to UTF-8 (Python 3.7+)
+        if hasattr(sys.stdout, "reconfigure"):
+            try:
+                sys.stdout.reconfigure(encoding="utf-8")
+            except (ValueError, OSError):
+                pass  # May fail if already reconfigured or not supported
+        if hasattr(sys.stderr, "reconfigure"):
+            try:
+                sys.stderr.reconfigure(encoding="utf-8")
+            except (ValueError, OSError):
+                pass  # May fail if already reconfigured or not supported
+    except Exception:
+        # Fallback: wrap stdout/stderr with UTF-8 TextIOWrapper
+        import io
+        try:
+            if hasattr(sys.stdout, "buffer"):
+                sys.stdout = io.TextIOWrapper(
+                    sys.stdout.buffer, encoding="utf-8", errors="replace", line_buffering=True
+                )
+            if hasattr(_filtered_stderr._original, "buffer"):
+                _filtered_stderr._original = io.TextIOWrapper(
+                    _filtered_stderr._original.buffer, encoding="utf-8", errors="replace", line_buffering=True
+                )
+        except Exception:
+            pass  # Silently fail if wrapping is not possible
 
+try:
+    # Try new path first (exonware.xwlazy.host.conf)
+    from exonware.xwlazy.host.conf import get_conf_module
+except ImportError:
+    try:
+        # Fall back to old path (xwlazy.lazy.host_conf) for installed packages
+        from xwlazy.lazy.host_conf import get_conf_module
+    except ImportError:  # xwlazy not installed yet
+        class _UnavailableConf(types.ModuleType):
+            def __getattr__(self, name: str):
+                raise RuntimeError(
+                    "Lazy configuration requires 'exonware-xwlazy'. "
+                    "Install it via 'pip install exonware-xwlazy' to enable lazy mode."
+                )
+        _module_instance = _UnavailableConf(__name__, __doc__)
+    else:
+        _module_instance = get_conf_module(__name__, __doc__)
+else:
+    _module_instance = get_conf_module(__name__, __doc__)
 
-# Replace module with custom class instance
-_module_instance = _ExonwareConfModule(__name__, __doc__)
 sys.modules[__name__] = _module_instance
 

exonware/xwsystem/__init__.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: October 10, 2025
 
 XWSystem - Enterprise-grade Python framework with AI-powered performance optimization.
@@ -50,6 +50,7 @@ This module provides common utilities that can be used across different
 components including threading, security, I/O, data structures, and design patterns.
 """
 
+import importlib
 import logging
 from typing import TYPE_CHECKING
 
@@ -58,103 +59,15 @@ if TYPE_CHECKING:
     from typing import Any
 
 # =============================================================================
-# EARLY LAZY BOOTSTRAP - Install hook before any imports
+# LAZY MODE INTEGRATION
 # =============================================================================
-# Import bootstrap FIRST to install hook if [lazy] extra detected
-# This ensures hook is active before serialization modules are imported
-from . import _lazy_bootstrap  # This installs hook if [lazy] extra detected
-
-# =============================================================================
-# LAZY LOADING SYSTEM - Unified Package
-# =============================================================================
-# All lazy loading functionality consolidated into lazy_package following DEV_GUIDELINES.md
-# Implements per-package lazy loading with automatic installation of missing dependencies.
-
-from .utils.lazy_package import (
-    # Core classes
-    LazyLoader,
-    LazyModuleRegistry,
-    LazyModeFacade,
-    LazyPerformanceMonitor,
-    LazyInstaller,
-    LazyInstallerRegistry,
-    LazyInstallMode,
-    LazyInstallPolicy,
-    DependencyMapper,
-    LazyDiscovery,
-    LazyInstallConfig,
-    DeferredImportError,
-    LazyMetaPathFinder,
-    
-    # Dataclasses
-    DependencyInfo,
-    
-    # Lazy mode functions
-    register_lazy_module,
-    get_lazy_module,
-    get_loading_stats,
-    preload_frequently_used,
-    enable_lazy_mode,
-    disable_lazy_mode,
-    is_lazy_mode_enabled,
-    get_lazy_mode_stats,
-    configure_lazy_mode,
-    preload_modules,
-    optimize_lazy_mode,
-    
-    # Install functions
-    enable_lazy_install,
-    disable_lazy_install,
-    is_lazy_install_enabled,
-    set_lazy_install_mode,
-    get_lazy_install_mode,
-    install_missing_package,
-    install_and_import,
-    get_lazy_install_stats,
-    get_all_lazy_install_stats,
-    lazy_import_with_install,
-    xwimport,
-    
-    # Discovery functions
-    discover_dependencies,
-    get_lazy_discovery,
-    export_dependency_mappings,
-    config_package_lazy_install_enabled,
-    
-    # Hook functions
-    install_import_hook,
-    uninstall_import_hook,
-    is_import_hook_installed,
-    
-    # Security & Policy APIs
-    set_package_allow_list,
-    set_package_deny_list,
-    add_to_package_allow_list,
-    add_to_package_deny_list,
-    set_package_index_url,
-    set_package_extra_index_urls,
-    add_package_trusted_host,
-    set_package_lockfile,
-    generate_package_sbom,
-    check_externally_managed_environment,
-)
-
-# Auto-detect [lazy] installation mode and install import hook only when enabled
-config_package_lazy_install_enabled("xwsystem")
-
-# =============================================================================
-# LAZY INSTALLATION - Simple One-Line Configuration
-# =============================================================================
-# DISABLED BY DEFAULT - Users can enable manually if needed
-# Auto-detects if user installed with [lazy] extra: pip install xwsystem[lazy]
-# config_package_lazy_install_enabled("xwsystem", install_hook=False)  # Configure lazy mode
-
-# =============================================================================
-# TWO-STAGE LAZY LOADING - Install import hook BEFORE importing serialization
-# =============================================================================
-# DISABLED BY DEFAULT - Prevents import hook interference
-# Install the hook NOW, before serialization imports, so it can intercept them
-# install_import_hook("xwsystem")  # Install hook to intercept serialization module imports
+# Minimal-intrusion lazy mode bootstrap (one line)
+# Enables optimized lazy mode for xwsystem if xwlazy is installed
+# Uses fastest mode from benchmarks: cached + full (1.482 ms)
+try:
+    from .lazy_bootstrap import _bootstrap_lazy_mode  # noqa: F401
+except ImportError:
+    pass  # xwlazy not installed - silently continue
 
 # Logging utilities
 from .config.logging_setup import get_logger, setup_logging
@@ -446,6 +359,14 @@ from .shared.contracts import IStringable
 # Import version from centralized location
 from .version import __version__
 
+try:
+    import sys as _sys
+    _parent_pkg = _sys.modules.get("exonware")
+    if _parent_pkg is not None:
+        _parent_pkg.__version__ = __version__
+except Exception:  # pragma: no cover
+    pass
+
 # =============================================================================
 # CONVENIENCE FUNCTIONS - Quick access to common operations
 # =============================================================================
@@ -932,68 +853,6 @@ __all__ = [
     "Pipe",
     "AsyncPipe",
     
-    # Lazy Mode - Performance optimization
-    "LazyLoader",
-    "LazyModuleRegistry", 
-    "LazyModeFacade",
-    "LazyPerformanceMonitor",
-    "register_lazy_module",
-    "get_lazy_module",
-    "get_loading_stats",
-    "preload_frequently_used",
-    "enable_lazy_mode",
-    "disable_lazy_mode",
-    "is_lazy_mode_enabled",
-    "get_lazy_mode_stats",
-    "configure_lazy_mode",
-    "preload_modules",
-    "optimize_lazy_mode",
-    
-    # Lazy Install - Auto-install missing packages (per-package isolation)
-    "LazyInstaller",
-    "LazyInstallerRegistry",
-    "LazyInstallMode",
-    "LazyInstallPolicy",
-    "DependencyMapper",
-    "enable_lazy_install",
-    "disable_lazy_install",
-    "is_lazy_install_enabled",
-    "set_lazy_install_mode",
-    "get_lazy_install_mode",
-    "install_missing_package",
-    "install_and_import",
-    "get_lazy_install_stats",
-    "get_all_lazy_install_stats",
-    "lazy_import_with_install",
-    "xwimport",
-    # Security & Policy APIs
-    "set_package_allow_list",
-    "set_package_deny_list",
-    "add_to_package_allow_list",
-    "add_to_package_deny_list",
-    "set_package_index_url",
-    "set_package_extra_index_urls",
-    "add_package_trusted_host",
-    "set_package_lockfile",
-    "generate_package_sbom",
-    "check_externally_managed_environment",
-    
-    # Lazy Discovery - Package-agnostic dependency discovery with auto-detection
-    "LazyDiscovery",
-    "LazyInstallConfig",
-    "DependencyInfo",
-    "discover_dependencies",
-    "get_lazy_discovery",
-    "export_dependency_mappings",
-    "config_package_lazy_install_enabled",
-    
-    # Lazy Import Hook - Performance optimized automatic import interception
-    "DeferredImportError",
-    "LazyMetaPathFinder",
-    "install_import_hook",
-    "uninstall_import_hook",
-    "is_import_hook_installed",
-    
     # Convenience Functions - Quick access patterns
     "quick_serialize",
     "quick_deserialize", 

exonware/xwsystem/caching/__init__.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 01-Nov-2025
 
 XSystem Caching Package

exonware/xwsystem/caching/base.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: September 04, 2025
 
 Caching module base classes - abstract classes for caching functionality.

exonware/xwsystem/caching/bloom_cache.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 01-Nov-2025
 
 Bloom filter-enhanced cache for faster negative lookups.

exonware/xwsystem/caching/cache_manager.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: September 04, 2025
 
 Cache Manager implementation - Placeholder.

exonware/xwsystem/caching/conditional.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 01-Nov-2025
 
 Conditional eviction policies for caching.

exonware/xwsystem/caching/contracts.py

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

exonware/xwsystem/caching/decorators.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 01-Nov-2025
 
 Advanced cache decorators with hooks and customization.

exonware/xwsystem/caching/defs.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 07-Sep-2025
 
 Caching types and enums for XWSystem.

exonware/xwsystem/caching/disk_cache.py

@@ -3,7 +3,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: October 26, 2025
 
 Disk cache implementation with pickle-based persistence.

exonware/xwsystem/caching/distributed.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 01-Nov-2025
 
 Distributed cache implementations - Coming in v1.0.

exonware/xwsystem/caching/errors.py

@@ -2,7 +2,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: September 04, 2025
 
 Caching module errors - exception classes for caching functionality.

exonware/xwsystem/caching/events.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 01-Nov-2025
 
 Event system for caching module.

exonware/xwsystem/caching/eviction_strategies.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 01-Nov-2025
 
 Pluggable eviction strategies for caching module.

exonware/xwsystem/caching/fluent.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.0.1.407
+Version: 0.0.1.408
 Generation Date: 01-Nov-2025
 
 Fluent API wrappers for caching module.