exonware-xwlazy 0.1.0.19__py3-none-any.whl → 0.1.0.20__py3-none-any.whl

exonware/xwlazy/module/importer_engine.py

@@ -6,7 +6,7 @@ Import Engine - Unified engine for all import-related operations.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 This module provides unified import engine for all import-related functionality.
@@ -86,14 +86,12 @@ from ..common.cache import MultiTierCache, BytecodeCache
 from ..runtime.adaptive_learner import AdaptiveLearner
 from ..runtime.intelligent_selector import IntelligentModeSelector, LoadLevel
 
-
 # =============================================================================
 # LOGGER (from common.logger)
 # =============================================================================
 
 logger = get_logger("xwlazy.importer_engine")
 
-
 # =============================================================================
 # IMPORT TRACKING (from import_tracking.py)
 # =============================================================================
@@ -105,39 +103,32 @@ _installing = threading.local()
 _installation_depth = 0
 _installation_depth_lock = threading.Lock()
 
-
 def _get_thread_imports() -> Set[str]:
     """Get thread-local import set (creates if needed)."""
     if not hasattr(_thread_local, 'imports'):
         _thread_local.imports = set()
     return _thread_local.imports
 
-
 def _is_import_in_progress(module_name: str) -> bool:
     """Check if a module import is currently in progress for this thread."""
     return module_name in _get_thread_imports()
 
-
 def _mark_import_started(module_name: str) -> None:
     """Mark a module import as started for this thread."""
     _get_thread_imports().add(module_name)
 
-
 def _mark_import_finished(module_name: str) -> None:
     """Mark a module import as finished for this thread."""
     _get_thread_imports().discard(module_name)
 
-
 def get_importing_state() -> threading.local:
     """Get thread-local importing state."""
     return _importing
 
-
 def get_installing_state() -> threading.local:
     """Get thread-local installing state."""
     return _installing
 
-
 # Thread-local storage for installation state
 _installing_state = get_installing_state()
 _importing_state = get_importing_state()
@@ -146,7 +137,6 @@ _importing_state = get_importing_state()
 _installation_depth = 0
 _installation_depth_lock = threading.Lock()
 
-
 # =============================================================================
 # PREFIX TRIE (from prefix_trie.py)
 # =============================================================================
@@ -183,7 +173,6 @@ class _PrefixTrie:
                 matches.append(end_value)
         return tuple(matches)
 
-
 # =============================================================================
 # WATCHED REGISTRY (from watched_registry.py)
 # =============================================================================
@@ -315,7 +304,6 @@ class WatchedPrefixRegistry:
                 self._root_snapshot_dirty = False
             return root_name in self._root_snapshot
 
-
 # Global registry instance
 _DEFAULT_WATCHED_PREFIXES = tuple(
     filter(
@@ -328,12 +316,10 @@ _DEFAULT_WATCHED_PREFIXES = tuple(
 )
 _watched_registry = WatchedPrefixRegistry(list(_DEFAULT_WATCHED_PREFIXES))
 
-
 def get_watched_registry() -> WatchedPrefixRegistry:
     """Get the global watched prefix registry."""
     return _watched_registry
 
-
 # =============================================================================
 # DEFERRED LOADER (from deferred_loader.py)
 # =============================================================================
@@ -350,7 +336,6 @@ class _DeferredModuleLoader(importlib.abc.Loader):
     def exec_module(self, module):  # noqa: D401 - nothing to execute
         return None
 
-
 # =============================================================================
 # CACHE (from common.cache)
 # =============================================================================
@@ -419,7 +404,6 @@ class ParallelLoader:
                 self._executor.shutdown(wait=wait)
                 self._executor = None
 
-
 class DependencyGraph:
     """Manages module dependencies for optimal parallel loading."""
     
@@ -470,14 +454,12 @@ class DependencyGraph:
             
             return levels
 
-
 # =============================================================================
 # MODULE PATCHING (from module_patching.py)
 # =============================================================================
 
 _original_import_module = importlib.import_module
 
-
 def _lazy_aware_import_module(name: str, package: Optional[str] = None) -> ModuleType:
     """Lazy-aware version of importlib.import_module."""
     if _is_import_in_progress(name):
@@ -489,19 +471,16 @@ def _lazy_aware_import_module(name: str, package: Optional[str] = None) -> Modul
     finally:
         _mark_import_finished(name)
 
-
 def _patch_import_module() -> None:
     """Patch importlib.import_module to be lazy-aware."""
     importlib.import_module = _lazy_aware_import_module
     logger.debug("Patched importlib.import_module to be lazy-aware")
 
-
 def _unpatch_import_module() -> None:
     """Restore original importlib.import_module."""
     importlib.import_module = _original_import_module
     logger.debug("Restored original importlib.import_module")
 
-
 # =============================================================================
 # ARCHIVE IMPORTS (from archive_imports.py)
 # =============================================================================
@@ -509,7 +488,6 @@ def _unpatch_import_module() -> None:
 _archive_path = None
 _archive_added = False
 
-
 def get_archive_path() -> Path:
     """Get the path to the _archive folder."""
     global _archive_path
@@ -518,7 +496,6 @@ def get_archive_path() -> Path:
         _archive_path = current_file.parent.parent.parent.parent.parent.parent / "_archive"
     return _archive_path
 
-
 def ensure_archive_in_path() -> None:
     """Ensure the archive folder is in sys.path for imports."""
     global _archive_added
@@ -529,13 +506,11 @@ def ensure_archive_in_path() -> None:
             sys.path.insert(0, archive_str)
         _archive_added = True
 
-
 def import_from_archive(module_name: str):
     """Import a module from the archived lazy code."""
     ensure_archive_in_path()
     return __import__(module_name, fromlist=[''])
 
-
 # =============================================================================
 # BOOTSTRAP (from bootstrap.py)
 # =============================================================================
@@ -550,7 +525,6 @@ def _env_enabled(env_value: Optional[str]) -> Optional[bool]:
         return False
     return None
 
-
 def bootstrap_lazy_mode(package_name: str) -> None:
     """Detect whether lazy mode should be enabled for ``package_name`` and bootstrap hooks."""
     package_name = package_name.lower()
@@ -573,7 +547,6 @@ def bootstrap_lazy_mode(package_name: str) -> None:
         install_hook=True,
     )
 
-
 def bootstrap_lazy_mode_deferred(package_name: str) -> None:
     """Schedule lazy mode bootstrap to run AFTER the calling package finishes importing."""
     package_name_lower = package_name.lower()
@@ -605,7 +578,6 @@ def bootstrap_lazy_mode_deferred(package_name: str) -> None:
         import builtins
         builtins.__import__ = _import_hook
 
-
 # =============================================================================
 # LAZY LOADER (from loader.py)
 # =============================================================================
@@ -668,7 +640,6 @@ class LazyLoader(AModuleHelper):
         module = self.load_module()
         return dir(module)
 
-
 # =============================================================================
 # LAZY MODULE REGISTRY (from registry.py)
 # =============================================================================
@@ -739,7 +710,6 @@ class LazyModuleRegistry:
                 loader.unload_module(loader._module_path)
             log_event("config", logger.info, "Cleared all cached modules")
 
-
 # =============================================================================
 # LAZY IMPORTER (from importer.py)
 # =============================================================================
@@ -1306,7 +1276,6 @@ class LazyImporter:
                 'total_loaded': len(self._loaded_modules)
             }
 
-
 # =============================================================================
 # IMPORT HOOK (from import_hook.py)
 # =============================================================================
@@ -1347,7 +1316,6 @@ class LazyImportHook(AModuleHelper):
         """Check if hook is installed."""
         return is_import_hook_installed(self._package_name)
 
-
 # =============================================================================
 # META PATH FINDER (from meta_path_finder.py)
 # =============================================================================
@@ -1371,7 +1339,6 @@ _lazy_prefix_method_registry: Dict[str, Tuple[str, ...]] = {}
 _package_class_hints: Dict[str, Tuple[str, ...]] = {}
 _class_hint_lock = threading.RLock()
 
-
 def _set_package_class_hints(package_name: str, hints: Iterable[str]) -> None:
     """Set class hints for a package."""
     normalized: Tuple[str, ...] = tuple(
@@ -1383,19 +1350,16 @@ def _set_package_class_hints(package_name: str, hints: Iterable[str]) -> None:
         else:
             _package_class_hints.pop(package_name, None)
 
-
 def _get_package_class_hints(package_name: str) -> Tuple[str, ...]:
     """Get class hints for a package."""
     with _class_hint_lock:
         return _package_class_hints.get(package_name, ())
 
-
 def _clear_all_package_class_hints() -> None:
     """Clear all package class hints."""
     with _class_hint_lock:
         _package_class_hints.clear()
 
-
 def register_lazy_module_methods(prefix: str, methods: Tuple[str, ...]) -> None:
     """Register method names to enhance for all classes under a module prefix."""
     prefix = prefix.strip()
@@ -1408,7 +1372,6 @@ def register_lazy_module_methods(prefix: str, methods: Tuple[str, ...]) -> None:
     _lazy_prefix_method_registry[prefix] = methods
     log_event("config", logger.info, f"Registered lazy module methods for prefix {prefix}: {methods}")
 
-
 def _spec_for_existing_module(
     fullname: str,
     module: ModuleType,
@@ -1426,7 +1389,6 @@ def _spec_for_existing_module(
     module.__spec__ = spec
     return spec
 
-
 class LazyMetaPathFinder:
     """
     Custom meta path finder that intercepts failed imports.
@@ -2037,12 +1999,10 @@ class LazyMetaPathFinder:
         
         return LazyClassWrapper
 
-
 # Registry of installed hooks per package
 _installed_hooks: Dict[str, LazyMetaPathFinder] = {}
 _hook_lock = threading.RLock()
 
-
 def install_import_hook(package_name: str = 'default') -> None:
     """Install performant import hook for automatic lazy installation."""
     global _installed_hooks
@@ -2063,7 +2023,6 @@ def install_import_hook(package_name: str = 'default') -> None:
         
         log_event("hook", logger.info, f"✅ [HOOK INSTALL] Lazy import hook installed for {package_name} (now {len(sys.meta_path)} meta_path entries)")
 
-
 def uninstall_import_hook(package_name: str = 'default') -> None:
     """Uninstall import hook for a package."""
     global _installed_hooks
@@ -2078,12 +2037,10 @@ def uninstall_import_hook(package_name: str = 'default') -> None:
             del _installed_hooks[package_name]
             log_event("hook", logger.info, f"Lazy import hook uninstalled for {package_name}")
 
-
 def is_import_hook_installed(package_name: str = 'default') -> bool:
     """Check if import hook is installed for a package."""
     return package_name in _installed_hooks
 
-
 def register_lazy_module_prefix(prefix: str) -> None:
     """Register an import prefix for lazy wrapping."""
     _watched_registry = get_watched_registry()
@@ -2092,7 +2049,6 @@ def register_lazy_module_prefix(prefix: str) -> None:
     if normalized:
         log_event("config", logger.info, "Registered lazy module prefix: %s", normalized)
 
-
 # =============================================================================
 # EXPORTS
 # =============================================================================

exonware/xwlazy/module/strategies/__init__.py

@@ -4,7 +4,7 @@ Module Strategies - Helper and Manager implementations.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 """
 

exonware/xwlazy/module/strategies/module_helper_lazy.py

@@ -4,7 +4,7 @@ Lazy Module Helper Strategy - Deferred loading.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 Lazy loading - loads module on first access with caching.
@@ -18,7 +18,6 @@ from typing import Any, Optional, Dict
 from ...module.base import AModuleHelperStrategy
 from ..data import ModuleData
 
-
 class LazyHelper(AModuleHelperStrategy):
     """
     Lazy helper - deferred loading with caching.

exonware/xwlazy/module/strategies/module_helper_simple.py

@@ -4,7 +4,7 @@ Simple Module Helper Strategy - Basic synchronous loading.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 Simple synchronous module loading - no lazy loading.
@@ -15,7 +15,6 @@ from types import ModuleType
 from typing import Any
 from ...module.base import AModuleHelperStrategy
 
-
 class SimpleHelper(AModuleHelperStrategy):
     """
     Simple helper - standard synchronous import.

exonware/xwlazy/module/strategies/module_manager_advanced.py

@@ -4,7 +4,7 @@ Advanced Module Manager Strategy - Full features.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 Advanced manager - with hooks, error handling, and full features.
@@ -18,7 +18,6 @@ from ...contracts import ICachingStrategy, IModuleHelperStrategy
 from ...package.base import APackageHelper
 from ...module import importer_engine
 
-
 class AdvancedManager(AModuleManagerStrategy):
     """
     Advanced manager - full features with hooks and error handling.

exonware/xwlazy/module/strategies/module_manager_simple.py

@@ -4,7 +4,7 @@ Simple Module Manager Strategy - Basic operations.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 Simple manager - basic module loading/unloading only.
@@ -15,7 +15,6 @@ from typing import Optional
 from ...module.base import AModuleManagerStrategy
 from ...contracts import ICachingStrategy, IModuleHelperStrategy
 
-
 class SimpleManager(AModuleManagerStrategy):
     """
     Simple manager - basic module operations only.

exonware/xwlazy/package/base.py

@@ -4,7 +4,7 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 10-Oct-2025
 
 Abstract Base Class for Package Operations
@@ -33,7 +33,6 @@ from ..contracts import (
     IMappingStrategy,
 )
 
-
 # =============================================================================
 # ABSTRACT PACKAGE (Unified - Merges APackageDiscovery + APackageInstaller + APackageCache + APackageHelper)
 # =============================================================================
@@ -604,7 +603,6 @@ class APackageHelper(IPackageHelper, ABC):
         """Get watched prefixes from manifest (from IManifestLoader)."""
         raise NotImplementedError("Subclasses must implement get_watched_prefixes")
 
-
 # =============================================================================
 # DEPRECATED CLASSES (for backward compatibility)
 # =============================================================================
@@ -641,7 +639,6 @@ class APackageHelperStrategy(IPackageHelperStrategy, ABC):
         """Get installed version."""
         ...
 
-
 # =============================================================================
 # ABSTRACT PACKAGE MANAGER STRATEGY
 # =============================================================================
@@ -674,7 +671,6 @@ class APackageManagerStrategy(IPackageManagerStrategy, ABC):
         """Check security policy."""
         ...
 
-
 # =============================================================================
 # ABSTRACT INSTALLATION EXECUTION STRATEGY
 # =============================================================================
@@ -696,7 +692,6 @@ class AInstallExecutionStrategy(IInstallExecutionStrategy, ABC):
         """Execute uninstallation of a package."""
         ...
 
-
 # =============================================================================
 # ABSTRACT INSTALLATION TIMING STRATEGY
 # =============================================================================
@@ -723,7 +718,6 @@ class AInstallTimingStrategy(IInstallTimingStrategy, ABC):
         """Get priority order for installing packages."""
         ...
 
-
 # =============================================================================
 # ABSTRACT DISCOVERY STRATEGY
 # =============================================================================
@@ -745,7 +739,6 @@ class ADiscoveryStrategy(IDiscoveryStrategy, ABC):
         """Get the source of a discovered dependency."""
         ...
 
-
 # =============================================================================
 # ABSTRACT POLICY STRATEGY
 # =============================================================================
@@ -767,7 +760,6 @@ class APolicyStrategy(IPolicyStrategy, ABC):
         """Get pip arguments based on policy."""
         ...
 
-
 # =============================================================================
 # ABSTRACT MAPPING STRATEGY
 # =============================================================================
@@ -789,7 +781,6 @@ class AMappingStrategy(IMappingStrategy, ABC):
         """Map package name to possible import names."""
         ...
 
-
 # =============================================================================
 # EXPORT ALL
 # =============================================================================

exonware/xwlazy/package/conf.py

@@ -11,7 +11,7 @@ longer need to ship their own lazy bootstrap logic.  Consumers import
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 10-Oct-2025
 """
 
@@ -39,7 +39,6 @@ from .services.config_manager import LazyInstallConfig
 
 __all__ = ['get_conf_module', '_PackageConfig', '_FilteredStderr', '_LazyConfModule', '_setup_global_warning_filter']
 
-
 class _PackageConfig:
     """Per-package configuration wrapper."""
 
@@ -78,7 +77,6 @@ class _PackageConfig:
         """Return True if lazy install + hook are active."""
         return self.lazy_install_status()["active"]
 
-
 class _FilteredStderr:
     """Stderr wrapper that filters out specific warning messages."""
     
@@ -109,7 +107,6 @@ class _FilteredStderr:
         """Delegate all other attributes to original stderr."""
         return getattr(self._original, name)
 
-
 class _LazyConfModule(types.ModuleType):
     """Configuration module for all exonware packages."""
 
@@ -286,12 +283,10 @@ class _LazyConfModule(types.ModuleType):
             return
         super().__setattr__(name, value)
 
-
 _CONF_INSTANCE: Optional[_LazyConfModule] = None
 _ORIGINAL_STDERR: Optional[Any] = None
 _FILTERED_STDERR: Optional[_FilteredStderr] = None
 
-
 def _setup_global_warning_filter() -> None:
     """Set up global stderr filter for decimal module warnings (called at module import)."""
     global _ORIGINAL_STDERR, _FILTERED_STDERR
@@ -317,12 +312,10 @@ def _setup_global_warning_filter() -> None:
     if sys.stderr is not _FILTERED_STDERR:
         sys.stderr = _FILTERED_STDERR  # type: ignore[assignment]
 
-
 # Set up warning filter immediately when module is imported (default: suppress warnings)
 # Note: conf.py may have already set up a filter, which is fine
 _setup_global_warning_filter()
 
-
 def get_conf_module(name: str = "exonware.conf", doc: Optional[str] = None) -> types.ModuleType:
     """Return (and memoize) the shared conf module instance."""
     global _CONF_INSTANCE

exonware/xwlazy/package/data.py

@@ -4,7 +4,7 @@ Package Data - Immutable data structure for packages.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 Re-export PackageData from defs.py for backward compatibility.

exonware/xwlazy/package/facade.py

@@ -47,7 +47,6 @@ from .strategies import (
     ManifestFirstMapping,
 )
 
-
 class XWPackageHelper(APackageHelper):
     """
     Concrete implementation of APackageHelper.

exonware/xwlazy/package/services/async_install_handle.py

@@ -4,7 +4,7 @@ Async Install Handle
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 Lightweight handle for background installation jobs.
@@ -13,7 +13,6 @@ Lightweight handle for background installation jobs.
 import asyncio
 from typing import Optional, Any
 
-
 class AsyncInstallHandle:
     """Lightweight handle for background installation jobs."""
     
@@ -84,6 +83,5 @@ class AsyncInstallHandle:
             return self._task_or_future.done()
         return False
 
-
 __all__ = ['AsyncInstallHandle']
 

exonware/xwlazy/package/services/config_manager.py

@@ -45,7 +45,6 @@ _MODE_ENUM_MAP = {
     "lazy": LazyInstallMode.SMART,
 }
 
-
 class LazyInstallConfig:
     """Global configuration for lazy installation per package."""
     _configs: Dict[str, bool] = {}

exonware/xwlazy/package/services/discovery.py

@@ -6,7 +6,7 @@ Package discovery implementation.
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 10-Oct-2025
 
 This module provides LazyDiscovery class that discovers dependencies from
@@ -27,7 +27,6 @@ from ...common.logger import get_logger, log_event as _log
 
 logger = get_logger("xwlazy.discovery")
 
-
 class LazyDiscovery(APackageHelper):
     """
     Discovers dependencies from project configuration sources.
@@ -355,12 +354,10 @@ class LazyDiscovery(APackageHelper):
         with open(file_path, 'w', encoding='utf-8') as f:
             json.dump(data, f, indent=2, ensure_ascii=False)
 
-
 # Global discovery instance
 _discovery: Optional[LazyDiscovery] = None
 _discovery_lock = threading.RLock()
 
-
 def get_lazy_discovery(project_root: Optional[str] = None) -> LazyDiscovery:
     """Get or create global discovery instance."""
     global _discovery
@@ -369,6 +366,5 @@ def get_lazy_discovery(project_root: Optional[str] = None) -> LazyDiscovery:
             _discovery = LazyDiscovery(project_root)
         return _discovery
 
-
 __all__ = ['LazyDiscovery', 'get_lazy_discovery']
 

exonware/xwlazy/package/services/host_packages.py

@@ -46,7 +46,6 @@ class LazyMetaPathFinder:
 _TRUTHY = {"1", "true", "yes", "on"}
 _REGISTERED: dict[str, dict[str, Tuple[str, ...]]] = {}
 
-
 def _normalized(items: Iterable[str]) -> Tuple[str, ...]:
     seen = []
     for item in items:
@@ -54,7 +53,6 @@ def _normalized(items: Iterable[str]) -> Tuple[str, ...]:
             seen.append(item)
     return tuple(seen)
 
-
 def register_host_package(
     package_name: str,
     module_prefixes: Iterable[str] = (),
@@ -114,7 +112,6 @@ def register_host_package(
             # Best-effort: package import must continue even if hook installation fails
             pass
 
-
 def refresh_host_package(package_name: str) -> None:
     """Re-apply wrappers for a registered package."""
     data = _REGISTERED.get(package_name.lower())
@@ -126,7 +123,6 @@ def refresh_host_package(package_name: str) -> None:
         data["method_prefixes"],
     )
 
-
 def _apply_wrappers_for_loaded_modules(
     package_name: str,
     module_prefixes: Iterable[str],

exonware/xwlazy/package/services/install_async.py

@@ -4,7 +4,7 @@ Async Installation Mixin
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 Mixin for async installation operations.
@@ -48,7 +48,6 @@ def _ensure_logging_initialized():
     if _log is None:
         _log = _get_log_event()
 
-
 class AsyncInstallMixin:
     """Mixin for async installation operations."""
     

exonware/xwlazy/package/services/install_cache.py

@@ -4,7 +4,7 @@ Installation Cache Mixin
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
+
 Generation Date: 15-Nov-2025
 
 Mixin for cache management (wheels, install trees, known missing modules).
@@ -49,7 +49,6 @@ def _ensure_spec_cache_initialized():
     if _spec_cache_clear is None:
         _spec_cache_clear = _get_spec_cache_clear()
 
-
 class InstallCacheMixin:
     """Mixin for cache management (wheels, install trees, known missing modules)."""