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

exonware/xwlazy/contracts.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
 
 Contracts for Lazy Loading System
@@ -25,7 +25,6 @@ from .defs import (
     LazyModeConfig,
 )
 
-
 # =============================================================================
 # PROTOCOLS / INTERFACES (Following GUIDE_DEV.md - Use IClass naming)
 # =============================================================================
@@ -381,7 +380,6 @@ class IPackageHelper(Protocol):
         """
         ...
 
-
 class IModuleHelper(Protocol):
     """
     Unified interface for module operations.
@@ -875,7 +873,6 @@ class IModuleHelper(Protocol):
         """Clear bytecode cache (from IBytecodeCache)."""
         ...
 
-
 class IRuntime(Protocol):
     """
     Unified interface for runtime services.
@@ -1172,7 +1169,6 @@ class IRuntime(Protocol):
         """
         ...
 
-
 # =============================================================================
 # STRATEGY INTERFACES (New Strategy Pattern)
 # =============================================================================
@@ -1200,7 +1196,6 @@ class ICachingStrategy(Protocol):
         """Clear all cached values."""
         ...
 
-
 @runtime_checkable
 class IModuleHelperStrategy(Protocol):
     """
@@ -1220,7 +1215,6 @@ class IModuleHelperStrategy(Protocol):
         """Check if module is importable."""
         ...
 
-
 @runtime_checkable
 class IPackageHelperStrategy(Protocol):
     """
@@ -1244,7 +1238,6 @@ class IPackageHelperStrategy(Protocol):
         """Get installed version."""
         ...
 
-
 @runtime_checkable
 class IModuleManagerStrategy(Protocol):
     """
@@ -1272,7 +1265,6 @@ class IModuleManagerStrategy(Protocol):
         """Handle import error."""
         ...
 
-
 @runtime_checkable
 class IPackageManagerStrategy(Protocol):
     """
@@ -1296,7 +1288,6 @@ class IPackageManagerStrategy(Protocol):
         """Check security policy."""
         ...
 
-
 # =============================================================================
 # NEW PACKAGE STRATEGY TYPES (Redesigned Architecture)
 # =============================================================================
@@ -1316,7 +1307,6 @@ class IInstallExecutionStrategy(Protocol):
         """Execute uninstallation of a package."""
         ...
 
-
 @runtime_checkable
 class IInstallTimingStrategy(Protocol):
     """
@@ -1336,7 +1326,6 @@ class IInstallTimingStrategy(Protocol):
         """Get priority order for installing packages."""
         ...
 
-
 @runtime_checkable
 class IDiscoveryStrategy(Protocol):
     """
@@ -1352,7 +1341,6 @@ class IDiscoveryStrategy(Protocol):
         """Get the source of a discovered dependency."""
         ...
 
-
 @runtime_checkable
 class IPolicyStrategy(Protocol):
     """
@@ -1368,7 +1356,6 @@ class IPolicyStrategy(Protocol):
         """Get pip arguments based on policy."""
         ...
 
-
 @runtime_checkable
 class IMappingStrategy(Protocol):
     """
@@ -1384,7 +1371,6 @@ class IMappingStrategy(Protocol):
         """Map package name to possible import names."""
         ...
 
-
 # =============================================================================
 # EXPORT ALL
 # =============================================================================

exonware/xwlazy/defs.py

@@ -4,7 +4,6 @@
 Company: eXonware.com
 Author: Eng. Muhammad AlShehri
 Email: connect@exonware.com
-Version: 0.1.0.19
 Generation Date: 10-Oct-2025
 
 Type Definitions and Constants for Lazy Loading System
@@ -18,7 +17,6 @@ from typing import TypedDict, Dict, List, Optional, Any, Tuple
 from dataclasses import dataclass, field
 from types import ModuleType
 
-
 # =============================================================================
 # ENUMS
 # =============================================================================
@@ -38,7 +36,6 @@ class LazyLoadMode(Enum):
     ULTRA = "ultra"         # Aggressive optimizations (pre-compiled bytecode, mmap, etc.)
     INTELLIGENT = "intelligent"  # Automatically switches to fastest mode based on load level
 
-
 class LazyInstallMode(Enum):
     """Lazy installation modes."""
     # Core modes
@@ -55,14 +52,12 @@ class LazyInstallMode(Enum):
     DISABLED = "disabled"   # Don't install anything (alias for NONE, more explicit)
     DRY_RUN = "dry_run"    # Show what would be installed but don't install
 
-
 class PathType(Enum):
     """Path types for validation."""
     FILE = "file"
     DIRECTORY = "directory"
     UNKNOWN = "unknown"
 
-
 class InstallStatus(Enum):
     """Installation status."""
     PENDING = "pending"
@@ -71,7 +66,6 @@ class InstallStatus(Enum):
     FAILED = "failed"
     SKIPPED = "skipped"
 
-
 class LoadLevel(Enum):
     """Load level categories."""
     LIGHT = "light_load"
@@ -79,7 +73,6 @@ class LoadLevel(Enum):
     HEAVY = "heavy_load"
     ENTERPRISE = "enterprise_load"
 
-
 # =============================================================================
 # DATACLASSES
 # =============================================================================
@@ -93,7 +86,6 @@ class DependencyInfo:
     source: str = "unknown"
     category: str = "general"
 
-
 @dataclass
 class LazyModeConfig:
     """Two-dimensional lazy mode configuration combining load and install modes."""
@@ -113,7 +105,6 @@ class LazyModeConfig:
         if isinstance(self.install_mode, str):
             self.install_mode = LazyInstallMode(self.install_mode)
 
-
 @dataclass
 class InstallResult:
     """Result of an installation operation."""
@@ -124,7 +115,6 @@ class InstallResult:
     version: Optional[str] = None
     source: Optional[str] = None  # "cache", "pip", "wheel", etc.
 
-
 @dataclass
 class LazyConfig:
     """Bridge configuration settings with the lazy package implementation."""
@@ -135,7 +125,6 @@ class LazyConfig:
     def __post_init__(self) -> None:
         self.packages = tuple(package.lower() for package in self.packages)
 
-
 @dataclass(frozen=True)
 class PackageManifest:
     """Resolved manifest data for a single package."""
@@ -157,7 +146,6 @@ class PackageManifest:
         # Case-insensitive fallback for convenience
         return self.dependencies.get(import_name.lower())
 
-
 @dataclass(frozen=True)
 class PackageData:
     """
@@ -174,7 +162,6 @@ class PackageData:
     error: Optional[Exception] = None
     metadata: Dict[str, Any] = field(default_factory=dict)
 
-
 @dataclass(frozen=True)
 class ModuleData:
     """
@@ -190,7 +177,6 @@ class ModuleData:
     error: Optional[Exception] = None
     metadata: Dict[str, Any] = field(default_factory=dict)
 
-
 # =============================================================================
 # TYPE DEFINITIONS
 # =============================================================================
@@ -203,7 +189,6 @@ class DependencyMapping(TypedDict, total=False):
     source: str
     category: str
 
-
 class PackageStats(TypedDict, total=False):
     """Type definition for package statistics."""
     enabled: bool
@@ -214,7 +199,6 @@ class PackageStats(TypedDict, total=False):
     total_installed: int
     total_failed: int
 
-
 class LazyStatus(TypedDict, total=False):
     """Type definition for lazy mode status."""
     enabled: bool
@@ -223,7 +207,6 @@ class LazyStatus(TypedDict, total=False):
     active: bool
     error: Optional[str]
 
-
 # =============================================================================
 # CONSTANTS
 # =============================================================================
@@ -340,12 +323,10 @@ PRESET_MODES: Dict[str, LazyModeConfig] = {
     ),
 }
 
-
 def get_preset_mode(preset_name: str) -> Optional[LazyModeConfig]:
     """Get preset mode configuration by name."""
     return PRESET_MODES.get(preset_name.lower())
 
-
 # =============================================================================
 # EXPORT ALL
 # =============================================================================

exonware/xwlazy/errors.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
 
 Errors for Lazy Loading System
@@ -15,7 +15,6 @@ following GUIDE_ARCH.md structure.
 
 from typing import Optional, Any
 
-
 # =============================================================================
 # BASE EXCEPTION
 # =============================================================================
@@ -40,7 +39,6 @@ class LazySystemError(Exception):
             message = f"[{package_name}] {message}"
         super().__init__(message)
 
-
 # =============================================================================
 # SPECIFIC EXCEPTIONS
 # =============================================================================
@@ -56,7 +54,6 @@ class LazyInstallError(LazySystemError):
     """
     pass
 
-
 class LazyDiscoveryError(LazySystemError):
     """
     Raised when dependency discovery fails.
@@ -68,7 +65,6 @@ class LazyDiscoveryError(LazySystemError):
     """
     pass
 
-
 class LazyHookError(LazySystemError):
     """
     Raised when import hook operation fails.
@@ -80,7 +76,6 @@ class LazyHookError(LazySystemError):
     """
     pass
 
-
 class LazySecurityError(LazySystemError):
     """
     Raised when security policy is violated.
@@ -92,7 +87,6 @@ class LazySecurityError(LazySystemError):
     """
     pass
 
-
 class ExternallyManagedError(LazyInstallError):
     """
     Raised when environment is externally managed (PEP 668).
@@ -120,7 +114,6 @@ class ExternallyManagedError(LazyInstallError):
         )
         super().__init__(message, package_name=None)
 
-
 class DeferredImportError(Exception):
     """
     Placeholder for a failed import that will be retried when accessed.
@@ -264,7 +257,6 @@ class DeferredImportError(Exception):
             return f"<DeferredImport: {self._import_name} (loaded)>"
         return f"<DeferredImport: {self._import_name} (will install on first use)>"
 
-
 # =============================================================================
 # EXPORT ALL
 # =============================================================================