exonware-xwlazy 0.1.0.23__py3-none-any.whl → 1.0.1.2__py3-none-any.whl

{exonware_xwlazy-0.1.0.23.dist-info → exonware_xwlazy-1.0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exonware-xwlazy
-Version: 0.1.0.23
+Version: 1.0.1.2
 Summary: Marker package that enables lazy install features across the eXonware suite.
 Project-URL: Homepage, https://exonware.com
 Project-URL: Repository, https://github.com/exonware/xwlazy
@@ -174,6 +174,10 @@ After `pip install -e .`, xwlazy automatically enables lazy loading for your pac
 ## 📖 Documentation
 
 - **[Architecture Reference](docs/REF_ARCH.md)** - System design, patterns, and structure
+- **[Integration Guide](docs/INTEGRATION_GUIDE.md)** - Integration with xw libraries
+- **[Best Practices](docs/BEST_PRACTICES.md)** - Usage guidelines and recommendations
+- **[Troubleshooting Guide](docs/TROUBLESHOOTING.md)** - Common issues and solutions
+- **[Production Deployment](docs/PRODUCTION_DEPLOYMENT.md)** - Production deployment guide
 - **[Keyword Detection Guide](docs/KEYWORD_DETECTION.md)** - Zero-code integration
 - **[Competition Benchmarks](benchmarks/competition_tests/)** - Performance comparisons
 - **[Performance Analysis](benchmarks/competition_tests/PERFORMANCE_ANALYSIS.md)** - Optimization recommendations

exonware_xwlazy-1.0.1.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+exonware/__init__.py,sha256=pJ73geou9GfYyPqjK4AzPGIrVT3zU_Gvr2vt2ndkUhM,3774
+exonware/xwlazy.py,sha256=5iAWriwqzmCqv68DLmw2fwm4whz6FLSNDn8hHk6TPBU,113036
+exonware/xwlazy_external_libs.toml,sha256=-btpWbrLeXC-0ojFD8lJl_kNT5V_ZYbk5ZqSAUrsdjs,17965
+exonware/xwlazy/version.py,sha256=1FTi6sQR_qQoHLHVMX6Mz8xbwdwpQbZwaSuYUFNvV3w,2349
+exonware_xwlazy-1.0.1.2.dist-info/METADATA,sha256=GPeqvBdqeban3zpr3MiOjw_Rg0kgQmClicx9vdikopo,17004
+exonware_xwlazy-1.0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+exonware_xwlazy-1.0.1.2.dist-info/licenses/LICENSE,sha256=w42ohoEUfhyT0NgiivAL4fWg2AMRLGnfXPMAR4EO-MU,1094
+exonware_xwlazy-1.0.1.2.dist-info/RECORD,,

exonware/xwlazy/__init__.py

@@ -1,379 +0,0 @@
-"""
-#exonware/xwlazy/src/exonware/xwlazy/__init__.py
-
-xwlazy: Lazy loading and on-demand package installation for Python.
-
-The xwlazy library provides automatic dependency installation and lazy loading
-capabilities, allowing packages to declare optional dependencies that are
-installed only when needed.
-
-Company: eXonware.com
-Author: Eng. Muhammad AlShehri
-Email: connect@exonware.com
-Generation Date: 10-Oct-2025
-
-Main Features:
-    - Automatic dependency discovery from pyproject.toml and requirements.txt
-    - On-demand package installation via import hooks
-    - Two-stage lazy loading for optimal performance
-    - Per-package lazy mode configuration
-    - Security policies and allow/deny lists
-    - SBOM generation and lockfile management
-
-Example:
-    >>> from exonware.xwlazy import enable_lazy_mode, xwimport
-    >>> 
-    >>> # Enable lazy mode for your package
-    >>> enable_lazy_mode(package_name="my_package", lazy_install_mode="smart")
-    >>> 
-    >>> # Import with automatic installation
-    >>> pandas = xwimport("pandas")  # Installs pandas if not available
-"""
-
-# =============================================================================
-# VERSION
-# =============================================================================
-
-from .version import (
-    __version__,
-    VERSION_MAJOR,
-    VERSION_MINOR,
-    VERSION_PATCH,
-    VERSION_BUILD,
-    VERSION_SUFFIX,
-    VERSION_STRING,
-    get_version,
-    get_version_info,
-    get_version_dict,
-    is_dev_version,
-    is_release_version,
-)
-
-# =============================================================================
-# IMPORTS - Standard Python Imports (No Defensive Code!)
-# =============================================================================
-
-# Import from facade - provides unified public API
-from .facade import (
-    # Facade functions
-    enable_lazy_mode,
-    disable_lazy_mode,
-    is_lazy_mode_enabled,
-    get_lazy_mode_stats,
-    configure_lazy_mode,
-    preload_modules,
-    optimize_lazy_mode,
-    # One-line activation API
-    auto_enable_lazy,
-    # Lazy-loader compatible API
-    attach,
-    # Public API 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,
-    # Configuration
-    config_package_lazy_install_enabled,
-    config_module_lazy_load_enabled,
-    sync_manifest_configuration,
-    refresh_lazy_manifests,
-    # 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,
-    register_lazy_module_prefix,
-    register_lazy_module_methods,
-    # Keyword-based detection
-    enable_keyword_detection,
-    is_keyword_detection_enabled,
-    get_keyword_detection_keyword,
-    check_package_keywords,
-    # Discovery functions
-    get_lazy_discovery,
-    discover_dependencies,
-    export_dependency_mappings,
-)
-
-# Import contracts and base for advanced usage
-from .defs import PRESET_MODES, get_preset_mode
-from .defs import (
-    LazyLoadMode,
-    LazyInstallMode,
-    PathType,
-    DependencyInfo,
-    LazyModeConfig,
-)
-from .contracts import (
-    IPackageHelper,
-    IModuleHelper,
-    IRuntime,
-)
-
-# Import errors
-from .errors import (
-    LazySystemError,
-    LazyInstallError,
-    LazyDiscoveryError,
-    LazyHookError,
-    LazySecurityError,
-    ExternallyManagedError,
-    DeferredImportError,
-)
-
-# Import config
-from .config import LazyConfig, DEFAULT_LAZY_CONFIG
-
-# Import abstract base classes directly from submodules
-from .package.base import APackageHelper
-from .module.base import AModuleHelper
-from .runtime.base import ARuntimeHelper
-
-# Import concrete implementations (lazy to prevent circular imports)
-from typing import Any
-
-def __getattr__(name: str) -> Any:
-    """Lazy import for concrete facades to prevent circular dependencies."""
-    if name == "XWPackageHelper":
-        from .package import XWPackageHelper
-        return XWPackageHelper
-    elif name == "XWModuleHelper":
-        from .module import XWModuleHelper
-        return XWModuleHelper
-    elif name == "XWRuntimeHelper":
-        from .runtime import XWRuntimeHelper
-        return XWRuntimeHelper
-    elif name == "manifest":
-        # Import manifest module for lazy access
-        from .package.services import manifest
-        return manifest
-    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
-
-# Import core classes for advanced usage
-from .package.services.config_manager import LazyInstallConfig
-from .package.services import LazyInstallerRegistry, AsyncInstallHandle, LazyInstaller
-from .common.services.dependency_mapper import DependencyMapper
-from .module.importer_engine import (
-    LazyMetaPathFinder,
-    WatchedPrefixRegistry,
-    LazyLoader,
-)
-from .package.services.manifest import LazyManifestLoader, PackageManifest
-from .facade import _lazy_importer
-
-# Import internal utilities (for advanced usage)
-from .common.services import (
-    check_package_keywords,
-    _detect_lazy_installation,
-    _detect_meta_info_mode,
-)
-from .module.importer_engine import (
-    _set_package_class_hints,
-    _get_package_class_hints,
-    _clear_all_package_class_hints,
-    _spec_for_existing_module,
-)
-from .common.services.spec_cache import (
-    _cached_stdlib_check,
-    _spec_cache_get,
-    _spec_cache_put,
-    _spec_cache_clear,
-    _cache_spec_if_missing,
-    _spec_cache_prune_locked,
-)
-from .package.services import (
-    is_externally_managed as _is_externally_managed,
-    check_pip_audit_available as _check_pip_audit_available,
-)
-from .module.importer_engine import (
-    _is_import_in_progress,
-    _mark_import_started,
-    _mark_import_finished,
-    _lazy_aware_import_module,
-    # _patch_import_module removed - deprecated, use sys.meta_path hooks instead
-    _unpatch_import_module,
-)
-
-# Version info
-__author__ = 'Eng. Muhammad AlShehri'
-__email__ = 'connect@exonware.com'
-__company__ = 'eXonware.com'
-
-# =============================================================================
-# PUBLIC API
-# =============================================================================
-
-__all__ = [
-    # Version
-    "__version__",
-    "VERSION_MAJOR",
-    "VERSION_MINOR",
-    "VERSION_PATCH",
-    "VERSION_BUILD",
-    "VERSION_SUFFIX",
-    "VERSION_STRING",
-    "get_version",
-    "get_version_info",
-    "get_version_dict",
-    "is_dev_version",
-    "is_release_version",
-    # Facade functions
-    "enable_lazy_mode",
-    "disable_lazy_mode",
-    "is_lazy_mode_enabled",
-    "get_lazy_mode_stats",
-    "configure_lazy_mode",
-    "preload_modules",
-    "optimize_lazy_mode",
-    # One-line activation API
-    "auto_enable_lazy",
-    # Lazy-loader compatible API
-    "attach",
-    # Public API 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",
-    # Configuration
-    "config_package_lazy_install_enabled",
-    "sync_manifest_configuration",
-    "refresh_lazy_manifests",
-    # 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",
-    "register_lazy_module_prefix",
-    "register_lazy_module_methods",
-    # Keyword-based detection
-    "enable_keyword_detection",
-    "is_keyword_detection_enabled",
-    "get_keyword_detection_keyword",
-    "check_package_keywords",
-    # Discovery functions
-    "get_lazy_discovery",
-    "discover_dependencies",
-    "export_dependency_mappings",
-    # Contracts
-    "LazyLoadMode",
-    "LazyInstallMode",
-    "PathType",
-    "DependencyInfo",
-    "LazyModeConfig",
-    "PRESET_MODES",
-    "get_preset_mode",
-    "IPackageHelper",
-    "IModuleHelper",
-    "IRuntime",
-    # Abstract base classes
-    "APackageHelper",
-    "AModuleHelper",
-    "ARuntimeHelper",
-    # Concrete implementations
-    "XWPackageHelper",
-    "XWModuleHelper",
-    "XWRuntimeHelper",
-    # Errors
-    "LazySystemError",
-    "LazyInstallError",
-    "LazyDiscoveryError",
-    "LazyHookError",
-    "LazySecurityError",
-    "ExternallyManagedError",
-    "DeferredImportError",
-    # Config
-    "LazyConfig",
-    "DEFAULT_LAZY_CONFIG",
-    # Core classes (for advanced usage)
-    "LazyInstallConfig",
-    "LazyInstallerRegistry",
-    "AsyncInstallHandle",
-    "LazyInstaller",
-    "DependencyMapper",
-    "LazyMetaPathFinder",
-    "WatchedPrefixRegistry",
-    "LazyLoader",
-    "LazyManifestLoader",
-    "PackageManifest",
-    "manifest",
-    "_lazy_importer",
-    # Internal utilities (for advanced usage)
-    "check_package_keywords",
-    "_detect_lazy_installation",
-    "_detect_meta_info_mode",
-    "_set_package_class_hints",
-    "_get_package_class_hints",
-    "_clear_all_package_class_hints",
-    "_spec_for_existing_module",
-    "_cached_stdlib_check",
-    "_spec_cache_get",
-    "_spec_cache_put",
-    "_spec_cache_clear",
-    "_cache_spec_if_missing",
-    "_spec_cache_prune_locked",
-    "_is_externally_managed",
-    "_check_pip_audit_available",
-    "_is_import_in_progress",
-    "_mark_import_started",
-    "_mark_import_finished",
-    "_lazy_aware_import_module",
-    # "_patch_import_module",  # Removed - deprecated, use sys.meta_path hooks instead
-    "_unpatch_import_module",
-]
-

exonware/xwlazy/common/__init__.py

@@ -1,55 +0,0 @@
-"""
-#exonware/xwlazy/src/exonware/xwlazy/common/__init__.py
-
-Common utilities shared across package, module, and runtime.
-
-Company: eXonware.com
-Author: Eng. Muhammad AlShehri
-Email: connect@exonware.com
-
-Generation Date: 15-Nov-2025
-"""
-
-from .logger import (
-    get_logger,
-    log_event,
-    print_formatted,
-    format_message,
-    is_log_category_enabled,
-    set_log_category,
-    set_log_categories,
-    get_log_categories,
-    XWLazyFormatter,
-)
-
-from .cache import (
-    MultiTierCache,
-    BytecodeCache,
-    InstallationCache,
-)
-
-from .utils import (
-    find_project_root,
-    find_config_file,
-)
-
-__all__ = [
-    # Logger
-    'get_logger',
-    'log_event',
-    'print_formatted',
-    'format_message',
-    'is_log_category_enabled',
-    'set_log_category',
-    'set_log_categories',
-    'get_log_categories',
-    'XWLazyFormatter',
-    # Cache
-    'MultiTierCache',
-    'BytecodeCache',
-    'InstallationCache',
-    # Utils
-    'find_project_root',
-    'find_config_file',
-]
-

exonware/xwlazy/common/base.py

@@ -1,65 +0,0 @@
-"""
-Common Abstract Base Classes
-
-Company: eXonware.com
-Author: Eng. Muhammad AlShehri
-Email: connect@exonware.com
-
-Generation Date: 15-Nov-2025
-
-Abstract base classes for shared/common strategies.
-"""
-
-from abc import ABC, abstractmethod
-from typing import Optional, Any
-from ..contracts import ICachingStrategy, ICacheStrategy
-
-# =============================================================================
-# ABSTRACT CACHING STRATEGY
-# =============================================================================
-
-class ACachingStrategy(ICachingStrategy, ABC):
-    """
-    Abstract base class for caching strategies (legacy name).
-    
-    Note: Use ACacheStrategy for new code (ICacheStrategy interface).
-    """
-    pass
-
-class ACacheStrategy(ICacheStrategy, ABC):
-    """
-    Abstract base class for caching strategies.
-    
-    Works with ANY data type (modules, packages, etc.).
-    All caching strategies must extend this class.
-    """
-    
-    @abstractmethod
-    def get(self, key: str) -> Optional[Any]:
-        """Get value from cache."""
-        ...
-    
-    @abstractmethod
-    def set(self, key: str, value: Any) -> None:
-        """Set value in cache."""
-        ...
-    
-    @abstractmethod
-    def invalidate(self, key: str) -> None:
-        """Invalidate cached value."""
-        ...
-    
-    @abstractmethod
-    def clear(self) -> None:
-        """Clear all cached values."""
-        ...
-
-# =============================================================================
-# EXPORT ALL
-# =============================================================================
-
-__all__ = [
-    'ACachingStrategy',  # Legacy name
-    'ACacheStrategy',    # New name for ICacheStrategy interface
-]
-