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

exonware/xwsystem/utils/lazy_package/__init__.py

@@ -1,268 +0,0 @@
-"""
-#exonware/xwsystem/src/exonware/xwsystem/utils/lazy_package/__init__.py
-
-Company: eXonware.com
-Author: Eng. Muhammad AlShehri
-Email: connect@exonware.com
-Version: 0.0.1.407
-Generation Date: 10-Oct-2025
-
-Lazy Package - Unified Lazy Loading System
-
-This package provides per-package lazy loading with automatic installation
-of missing dependencies. It consolidates all lazy loading functionality into
-a clean, well-structured module following DEV_GUIDELINES.md.
-
-Design Patterns:
-- Facade: Unified API (LazySystemFacade, LazyModeFacade)
-- Strategy: Pluggable discovery/installation/caching strategies
-- Template Method: Base classes define common workflows
-- Singleton: Global instances for system-wide state
-- Registry: Per-package isolation (LazyInstallerRegistry)
-- Observer: Performance monitoring
-- Proxy: Deferred loading (LazyLoader, DeferredImportError)
-- Factory: Handler creation
-
-Core Goal: Per-Package Lazy Loading
-Each package (xwsystem, xwnode, xwdata) can independently enable lazy mode.
-Only packages installed with [lazy] extra get auto-installation.
-
-Quick Start:
-    # In your package's __init__.py
-    from exonware.xwsystem.utils.lazy_package import config_package_lazy_install_enabled
-    config_package_lazy_install_enabled("yourpackage")  # Auto-detect from pip install
-
-Usage:
-    # Then just use normal Python imports!
-    import fastavro  # Missing? Auto-installed! ✨
-    import pandas    # Missing? Auto-installed! ✨
-"""
-
-# Import all from submodules
-from .lazy_contracts import (
-    # Enums
-    LazyInstallMode,
-    PathType,
-    # Dataclasses
-    DependencyInfo,
-    # Interfaces
-    IPackageDiscovery,
-    IPackageInstaller,
-    IImportHook,
-    IPackageCache,
-    ILazyLoader,
-)
-
-from .lazy_errors import (
-    # Exceptions
-    LazySystemError,
-    LazyInstallError,
-    LazyDiscoveryError,
-    LazyHookError,
-    LazySecurityError,
-    ExternallyManagedError,
-    DeferredImportError,
-)
-
-from .lazy_base import (
-    # Abstract base classes
-    APackageDiscovery,
-    APackageInstaller,
-    AImportHook,
-    APackageCache,
-    ALazyLoader,
-)
-
-from .lazy_core import (
-    # Core classes
-    DependencyMapper,
-    LazyDiscovery,
-    LazyInstaller,
-    LazyInstallPolicy,
-    LazyInstallerRegistry,
-    LazyImportHook,
-    LazyMetaPathFinder,
-    LazyLoader,
-    LazyImporter,
-    LazyModuleRegistry,
-    LazyPerformanceMonitor,
-    LazyInstallConfig,
-    LazyModeFacade,
-    
-    # Discovery functions
-    get_lazy_discovery,
-    discover_dependencies,
-    export_dependency_mappings,
-    
-    # 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,
-    
-    # Hook functions
-    install_import_hook,
-    uninstall_import_hook,
-    is_import_hook_installed,
-    
-    # Lazy loading functions
-    enable_lazy_imports,
-    disable_lazy_imports,
-    is_lazy_import_enabled,
-    lazy_import,
-    register_lazy_module,
-    preload_module,
-    get_lazy_module,
-    get_loading_stats,
-    preload_frequently_used,
-    get_lazy_import_stats,
-    
-    # Lazy mode facade functions
-    enable_lazy_mode,
-    disable_lazy_mode,
-    is_lazy_mode_enabled,
-    get_lazy_mode_stats,
-    configure_lazy_mode,
-    preload_modules,
-    optimize_lazy_mode,
-    
-    # Configuration
-    config_package_lazy_install_enabled,
-    
-    # Security & Policy
-    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,
-)
-
-from .config import LazyConfig, DEFAULT_LAZY_CONFIG
-
-# Version info
-__version__ = "0.0.1.382"
-__author__ = "Eng. Muhammad AlShehri"
-__email__ = "connect@exonware.com"
-__company__ = "eXonware.com"
-
-# Export all
-__all__ = [
-    # Enums
-    'LazyInstallMode',
-    'PathType',
-    
-    # Dataclasses
-    'DependencyInfo',
-    
-    # Interfaces
-    'IPackageDiscovery',
-    'IPackageInstaller',
-    'IImportHook',
-    'IPackageCache',
-    'ILazyLoader',
-    
-    # Exceptions
-    'LazySystemError',
-    'LazyInstallError',
-    'LazyDiscoveryError',
-    'LazyHookError',
-    'LazySecurityError',
-    'ExternallyManagedError',
-    'DeferredImportError',
-    
-    # Abstract base classes
-    'APackageDiscovery',
-    'APackageInstaller',
-    'AImportHook',
-    'APackageCache',
-    'ALazyLoader',
-    
-    # Core classes
-    'DependencyMapper',
-    'LazyDiscovery',
-    'LazyInstaller',
-    'LazyInstallPolicy',
-    'LazyInstallerRegistry',
-    'LazyImportHook',
-    'LazyMetaPathFinder',
-    'LazyLoader',
-    'LazyImporter',
-    'LazyModuleRegistry',
-    'LazyPerformanceMonitor',
-    'LazyInstallConfig',
-    'LazyModeFacade',
-    
-    # Discovery functions
-    'get_lazy_discovery',
-    'discover_dependencies',
-    'export_dependency_mappings',
-    
-    # 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',
-    
-    # Hook functions
-    'install_import_hook',
-    'uninstall_import_hook',
-    'is_import_hook_installed',
-    
-    # Lazy loading functions
-    'enable_lazy_imports',
-    'disable_lazy_imports',
-    'is_lazy_import_enabled',
-    'lazy_import',
-    'register_lazy_module',
-    'preload_module',
-    'get_lazy_module',
-    'get_loading_stats',
-    'preload_frequently_used',
-    'get_lazy_import_stats',
-    
-    # Lazy mode facade functions
-    'enable_lazy_mode',
-    'disable_lazy_mode',
-    'is_lazy_mode_enabled',
-    'get_lazy_mode_stats',
-    'configure_lazy_mode',
-    'preload_modules',
-    'optimize_lazy_mode',
-    
-    # Configuration
-    'config_package_lazy_install_enabled',
-    'LazyConfig',
-    'DEFAULT_LAZY_CONFIG',
-    
-    # Security & Policy
-    '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',
-]
-

exonware/xwsystem/utils/lazy_package/config.py

@@ -1,163 +0,0 @@
-from __future__ import annotations
-
-"""Configuration helpers for the lazy-loading subsystem."""
-
-from dataclasses import dataclass, field
-from typing import Tuple
-
-from .lazy_core import (
-    config_package_lazy_install_enabled,
-    disable_lazy_mode,
-    enable_lazy_mode,
-    is_import_hook_installed,
-    is_lazy_install_enabled,
-    is_lazy_mode_enabled,
-    install_import_hook,
-)
-
-
-@dataclass
-class LazyConfig:
-    """Bridge configuration settings with the lazy package implementation."""
-
-    packages: Tuple[str, ...] = field(
-        default_factory=lambda: ("xwsystem", "default")
-    )
-
-    def __post_init__(self) -> None:
-        self.packages = tuple(package.lower() for package in self.packages)
-
-    # High-level API -----------------------------------------------------
-    @property
-    def lazy_import(self) -> bool:
-        """Return whether lazy mode is currently active."""
-        return is_lazy_mode_enabled()
-
-    @lazy_import.setter
-    def lazy_import(self, value: bool) -> None:
-        self.set_lazy_import(bool(value))
-
-    def set_lazy_import(
-        self,
-        enabled: bool,
-        *,
-        lazy_imports: bool = True,
-        lazy_install: bool = True,
-        install_hook: bool = True,
-        mode: str = "auto",
-    ) -> None:
-        """
-        Toggle lazy mode with optional fine-grained controls.
-        
-        Includes re-hooking support: If lazy is enabled and install_hook is True,
-        ensures the import hook is installed even if it wasn't installed initially.
-        """
-        if enabled:
-            self._configure_packages(True, mode=mode, install_hook=install_hook)
-            enable_lazy_mode(
-                package_name=self.packages[0],
-                enable_lazy_imports=lazy_imports,
-                enable_lazy_install=lazy_install,
-                install_hook=install_hook,
-                lazy_install_mode=mode,
-            )
-            # Re-hook: Install hook if lazy is enabled and hook not already installed
-            # Root cause: Hook not installed when lazy enabled after package load
-            # Priority impact: Usability (#2) - Users expect lazy to work when enabled
-            if install_hook:
-                self._ensure_hook_installed()
-        else:
-            disable_lazy_mode()
-            self._configure_packages(False, install_hook=False)
-
-    def enable(
-        self,
-        *,
-        lazy_imports: bool = True,
-        lazy_install: bool = True,
-        install_hook: bool = True,
-        mode: str = "auto",
-    ) -> None:
-        """Enable lazy mode using the provided options."""
-        self.set_lazy_import(
-            True,
-            lazy_imports=lazy_imports,
-            lazy_install=lazy_install,
-            install_hook=install_hook,
-            mode=mode,
-        )
-
-    def disable(self) -> None:
-        """Disable lazy mode entirely."""
-        self.set_lazy_import(False)
-
-    # DX: Status check methods -------------------------------------------
-    def get_lazy_status(self) -> dict:
-        """
-        Get detailed lazy installation status (DX enhancement).
-        
-        Returns:
-            Dictionary with lazy mode status information
-        """
-        try:
-            primary_package = self.packages[0] if self.packages else "xwsystem"
-            return {
-                'enabled': self.lazy_import,
-                'hook_installed': is_import_hook_installed(primary_package),
-                'lazy_install_enabled': is_lazy_install_enabled(primary_package),
-                'active': self.lazy_import and is_import_hook_installed(primary_package)
-            }
-        except Exception:
-            return {
-                'enabled': self.lazy_import,
-                'hook_installed': False,
-                'lazy_install_enabled': False,
-                'active': False,
-                'error': 'Could not check hook status'
-            }
-    
-    def is_lazy_active(self) -> bool:
-        """
-        Check if lazy mode is active (DX enhancement).
-        
-        Returns:
-            True if lazy mode is enabled and hook is installed
-        """
-        try:
-            primary_package = self.packages[0] if self.packages else "xwsystem"
-            return self.lazy_import and is_import_hook_installed(primary_package)
-        except Exception:
-            return False
-
-    # Internal helpers ---------------------------------------------------
-    def _configure_packages(
-        self,
-        enabled: bool,
-        *,
-        mode: str = "auto",
-        install_hook: bool = True,
-    ) -> None:
-        for package in self.packages:
-            config_package_lazy_install_enabled(
-                package,
-                enabled,
-                mode,
-                install_hook=install_hook,
-            )
-    
-    def _ensure_hook_installed(self) -> None:
-        """
-        Ensure import hook is installed for primary package.
-        
-        Re-hooking support: Install hook if not already installed.
-        """
-        try:
-            primary_package = self.packages[0] if self.packages else "xwsystem"
-            if not is_import_hook_installed(primary_package):
-                install_import_hook(primary_package)
-        except Exception:
-            # Fail silently - hook installation failure shouldn't break package
-            pass
-
-
-DEFAULT_LAZY_CONFIG = LazyConfig()