xwlazy 0.1.0.11__py3-none-any.whl → 0.1.0.19__py3-none-any.whl

README.md

@@ -49,14 +49,40 @@ Built-in tracking of module load times, access counts, memory usage, and cache h
 
 **Why it matters:** Visibility into lazy loading performance helps identify bottlenecks and optimize import strategies.
 
-### 🎨 **5 Installation Modes**
-- **AUTO:** Install automatically without asking
-- **INTERACTIVE:** Prompt user before each installation
-- **WARN:** Log warnings but don't install (monitoring mode)
-- **DISABLED:** Don't install anything
+### 🎨 **Two-Dimensional Mode System**
+
+xwlazy uses a powerful two-dimensional mode system that separates **loading behavior** from **installation behavior**, giving you precise control over how modules are loaded and when packages are installed.
+
+#### **Lazy Load Modes** (When modules load)
+- **NONE:** Standard imports (no lazy loading)
+- **AUTO:** Lazy loading enabled (deferred module loading)
+- **PRELOAD:** Preload all modules on start (parallel loading)
+- **BACKGROUND:** Load modules in background threads (non-blocking)
+- **CACHED:** Cache loaded modules but allow unloading
+
+#### **Lazy Install Modes** (When packages install)
+- **NONE:** No auto-installation
+- **SMART:** Install on first usage (on-demand)
+- **FULL:** Install all dependencies on start (parallel batch)
+- **CLEAN:** Install on usage + uninstall after completion
+- **TEMPORARY:** Always uninstall after use (aggressive cleanup)
+- **SIZE_AWARE:** Install small packages, skip large ones
+- **INTERACTIVE:** Ask user before installing
+- **WARN:** Log warning but don't install (monitoring mode)
+- **DISABLED:** Don't install anything (explicit)
 - **DRY_RUN:** Show what would be installed
 
-**Why it matters:** Different environments need different policies. Development might use AUTO, production might use WARN or DISABLED.
+#### **Preset Modes** (Quick combinations)
+- **none:** NONE load + NONE install (standard imports)
+- **lite:** AUTO load + NONE install (lazy loading only)
+- **smart:** AUTO load + SMART install (on-demand installation)
+- **full:** AUTO load + FULL install (install all on start)
+- **clean:** AUTO load + CLEAN install (install + cleanup)
+- **temporary:** AUTO load + TEMPORARY install (aggressive cleanup)
+- **size_aware:** AUTO load + SIZE_AWARE install (smart sizing)
+- **auto:** AUTO load + SMART install + auto-uninstall large packages
+
+**Why it matters:** Different environments need different policies. Development might use `smart`, production might use `lite` or `warn`, CI/CD might use `clean` or `temporary`.
 
 ## 🏆 Performance Benchmarks
 
@@ -188,26 +214,76 @@ import suspicious_package  # ❌ Blocked by security policy
 
 ## 🔧 Advanced Configuration
 
-### Installation Modes
+### Two-Dimensional Mode Configuration
+
+#### Using Preset Modes (Recommended)
+
+```python
+from xwlazy.lazy import config_package_lazy_install_enabled
+
+# Quick preset modes
+config_package_lazy_install_enabled("xwsystem", enabled=True, mode="smart")   # On-demand install
+config_package_lazy_install_enabled("xwsystem", enabled=True, mode="full")   # Install all on start
+config_package_lazy_install_enabled("xwsystem", enabled=True, mode="clean") # Install + cleanup
+config_package_lazy_install_enabled("xwsystem", enabled=True, mode="lite")   # Lazy load only
+```
+
+#### Using Explicit Mode Configuration
 
 ```python
 from xwlazy.lazy import (
     config_package_lazy_install_enabled,
+    LazyLoadMode,
     LazyInstallMode,
+    LazyModeConfig,
 )
 
+# Explicit two-dimensional configuration
+config_package_lazy_install_enabled(
+    "xwsystem",
+    enabled=True,
+    load_mode=LazyLoadMode.PRELOAD,      # Preload all modules
+    install_mode=LazyInstallMode.SMART   # Install on-demand
+)
+
+# Or use LazyModeConfig for full control
+config = LazyModeConfig(
+    load_mode=LazyLoadMode.BACKGROUND,
+    install_mode=LazyInstallMode.SIZE_AWARE,
+    large_package_threshold_mb=100.0,  # Skip packages > 100MB
+    background_workers=4              # 4 background workers
+)
+config_package_lazy_install_enabled(
+    "xwsystem",
+    enabled=True,
+    mode_config=config
+)
+```
+
+#### Using exonware.conf (Global Configuration)
+
+```python
+import exonware.conf as conf
+
+# Set global lazy mode for all packages
+conf.lazy = "smart"   # or "lite", "full", "clean", "auto", etc.
+```
+
+#### Special Purpose Modes
+
+```python
 # Interactive mode: Ask user before installing
 config_package_lazy_install_enabled(
     "xwsystem",
     enabled=True,
-    mode=LazyInstallMode.INTERACTIVE
+    mode="interactive"  # or LazyInstallMode.INTERACTIVE
 )
 
 # Warn mode: Log but don't install (monitoring)
 config_package_lazy_install_enabled(
     "xwsystem",
     enabled=True,
-    mode=LazyInstallMode.WARN
+    mode="warn"  # or LazyInstallMode.WARN
 )
 ```
 

src/xwlazy_wrapper.py

@@ -0,0 +1,21 @@
+"""
+xwlazy Wrapper Package
+
+This is a convenience wrapper that provides 'import xwlazy' functionality.
+The actual implementation is in the exonware-xwlazy package.
+
+Company: eXonware.com
+Author: Eng. Muhammad AlShehri
+Email: connect@exonware.com
+Version: 0.1.0.19
+Generation Date: 10-Oct-2025
+"""
+
+# This wrapper package depends on exonware-xwlazy
+# When you pip install xwlazy, it automatically installs exonware-xwlazy
+# Both import paths then work:
+#   - import xwlazy
+#   - import exonware.xwlazy
+
+__all__ = []
+

{xwlazy-0.1.0.11.dist-info → xwlazy-0.1.0.19.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xwlazy
-Version: 0.1.0.11
+Version: 0.1.0.19
 Summary: Convenience wrapper for exonware-xwlazy - provides 'import xwlazy' alias
 Project-URL: Homepage, https://exonware.com
 Project-URL: Repository, https://github.com/exonware/xwlazy
@@ -76,14 +76,40 @@ Built-in tracking of module load times, access counts, memory usage, and cache h
 
 **Why it matters:** Visibility into lazy loading performance helps identify bottlenecks and optimize import strategies.
 
-### 🎨 **5 Installation Modes**
-- **AUTO:** Install automatically without asking
-- **INTERACTIVE:** Prompt user before each installation
-- **WARN:** Log warnings but don't install (monitoring mode)
-- **DISABLED:** Don't install anything
+### 🎨 **Two-Dimensional Mode System**
+
+xwlazy uses a powerful two-dimensional mode system that separates **loading behavior** from **installation behavior**, giving you precise control over how modules are loaded and when packages are installed.
+
+#### **Lazy Load Modes** (When modules load)
+- **NONE:** Standard imports (no lazy loading)
+- **AUTO:** Lazy loading enabled (deferred module loading)
+- **PRELOAD:** Preload all modules on start (parallel loading)
+- **BACKGROUND:** Load modules in background threads (non-blocking)
+- **CACHED:** Cache loaded modules but allow unloading
+
+#### **Lazy Install Modes** (When packages install)
+- **NONE:** No auto-installation
+- **SMART:** Install on first usage (on-demand)
+- **FULL:** Install all dependencies on start (parallel batch)
+- **CLEAN:** Install on usage + uninstall after completion
+- **TEMPORARY:** Always uninstall after use (aggressive cleanup)
+- **SIZE_AWARE:** Install small packages, skip large ones
+- **INTERACTIVE:** Ask user before installing
+- **WARN:** Log warning but don't install (monitoring mode)
+- **DISABLED:** Don't install anything (explicit)
 - **DRY_RUN:** Show what would be installed
 
-**Why it matters:** Different environments need different policies. Development might use AUTO, production might use WARN or DISABLED.
+#### **Preset Modes** (Quick combinations)
+- **none:** NONE load + NONE install (standard imports)
+- **lite:** AUTO load + NONE install (lazy loading only)
+- **smart:** AUTO load + SMART install (on-demand installation)
+- **full:** AUTO load + FULL install (install all on start)
+- **clean:** AUTO load + CLEAN install (install + cleanup)
+- **temporary:** AUTO load + TEMPORARY install (aggressive cleanup)
+- **size_aware:** AUTO load + SIZE_AWARE install (smart sizing)
+- **auto:** AUTO load + SMART install + auto-uninstall large packages
+
+**Why it matters:** Different environments need different policies. Development might use `smart`, production might use `lite` or `warn`, CI/CD might use `clean` or `temporary`.
 
 ## 🏆 Performance Benchmarks
 
@@ -215,26 +241,76 @@ import suspicious_package  # ❌ Blocked by security policy
 
 ## 🔧 Advanced Configuration
 
-### Installation Modes
+### Two-Dimensional Mode Configuration
+
+#### Using Preset Modes (Recommended)
+
+```python
+from xwlazy.lazy import config_package_lazy_install_enabled
+
+# Quick preset modes
+config_package_lazy_install_enabled("xwsystem", enabled=True, mode="smart")   # On-demand install
+config_package_lazy_install_enabled("xwsystem", enabled=True, mode="full")   # Install all on start
+config_package_lazy_install_enabled("xwsystem", enabled=True, mode="clean") # Install + cleanup
+config_package_lazy_install_enabled("xwsystem", enabled=True, mode="lite")   # Lazy load only
+```
+
+#### Using Explicit Mode Configuration
 
 ```python
 from xwlazy.lazy import (
     config_package_lazy_install_enabled,
+    LazyLoadMode,
     LazyInstallMode,
+    LazyModeConfig,
 )
 
+# Explicit two-dimensional configuration
+config_package_lazy_install_enabled(
+    "xwsystem",
+    enabled=True,
+    load_mode=LazyLoadMode.PRELOAD,      # Preload all modules
+    install_mode=LazyInstallMode.SMART   # Install on-demand
+)
+
+# Or use LazyModeConfig for full control
+config = LazyModeConfig(
+    load_mode=LazyLoadMode.BACKGROUND,
+    install_mode=LazyInstallMode.SIZE_AWARE,
+    large_package_threshold_mb=100.0,  # Skip packages > 100MB
+    background_workers=4              # 4 background workers
+)
+config_package_lazy_install_enabled(
+    "xwsystem",
+    enabled=True,
+    mode_config=config
+)
+```
+
+#### Using exonware.conf (Global Configuration)
+
+```python
+import exonware.conf as conf
+
+# Set global lazy mode for all packages
+conf.lazy = "smart"   # or "lite", "full", "clean", "auto", etc.
+```
+
+#### Special Purpose Modes
+
+```python
 # Interactive mode: Ask user before installing
 config_package_lazy_install_enabled(
     "xwsystem",
     enabled=True,
-    mode=LazyInstallMode.INTERACTIVE
+    mode="interactive"  # or LazyInstallMode.INTERACTIVE
 )
 
 # Warn mode: Log but don't install (monitoring)
 config_package_lazy_install_enabled(
     "xwsystem",
     enabled=True,
-    mode=LazyInstallMode.WARN
+    mode="warn"  # or LazyInstallMode.WARN
 )
 ```
 

xwlazy-0.1.0.19.dist-info/RECORD

@@ -0,0 +1,6 @@
+README.md,sha256=d7uDJ3tvKKBtAhWQtHVp6OzrtELNqMwBZ_8BNYF8HHs,15544
+src/xwlazy_wrapper.py,sha256=dfGgZBTeWfJ93ASG2B9FT7fdRV7J-2Xy1xviDo3gQAE,516
+xwlazy-0.1.0.19.dist-info/METADATA,sha256=Lbd66PjJAZ-I1kV92ZNaYPtPkO1a_EVPvl_lvsNEB7c,16696
+xwlazy-0.1.0.19.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+xwlazy-0.1.0.19.dist-info/licenses/LICENSE,sha256=w42ohoEUfhyT0NgiivAL4fWg2AMRLGnfXPMAR4EO-MU,1094
+xwlazy-0.1.0.19.dist-info/RECORD,,

xwlazy-0.1.0.11.dist-info/RECORD

@@ -1,5 +0,0 @@
-README.md,sha256=1IRJekBUKeGQc_v35FNiroU_ztNKFJtMbNgNicgvh50,12572
-xwlazy-0.1.0.11.dist-info/METADATA,sha256=ptw6Ji9QfPCvAnCtBCiUH5D46WbuKxvorduMUQCykGU,13724
-xwlazy-0.1.0.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-xwlazy-0.1.0.11.dist-info/licenses/LICENSE,sha256=w42ohoEUfhyT0NgiivAL4fWg2AMRLGnfXPMAR4EO-MU,1094
-xwlazy-0.1.0.11.dist-info/RECORD,,