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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exonware-xwlazy
-Version: 0.1.0.11
+Version: 0.1.0.19
 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
@@ -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
 )
 ```
 

exonware_xwlazy-0.1.0.19.dist-info/RECORD

@@ -0,0 +1,87 @@
+exonware/__init__.py,sha256=DHlz8Eb6ureiKpk7J3qfLtjNhPDPC6JShMl_SMqmBmc,633
+exonware/xwlazy/__init__.py,sha256=r9ZxiW4E7fdF0LDsLO_VVCEidYCtTQpTFVP93QLXugk,10253
+exonware/xwlazy/config.py,sha256=1J6dohfWl64_0LFgJKAJ1C1zTCmw-YSZyL0qF9YoIBw,6260
+exonware/xwlazy/contracts.py,sha256=XX8l9hF5PcB11E2Z2Nw-9W0hUpd01bYDpbDAHM3D6C0,44396
+exonware/xwlazy/defs.py,sha256=wlmMYIondagsXbhDDV7cZGETEBlP-WCJamk1DW3Kgxs,12326
+exonware/xwlazy/errors.py,sha256=9pDrHPiJ-pL75V6e4tDDNTuMgE3PcntVl3mPhVK1ZFE,9213
+exonware/xwlazy/facade.py,sha256=YtqHJzl5aJwMqd4gb2wIzik9aqp0JOn0YqzOW08TkDA,38824
+exonware/xwlazy/version.py,sha256=W4y0sW1T7G7LwhxLSe5k4LYNuQlf80qptyEjD_Yl_hM,2351
+exonware/xwlazy/common/__init__.py,sha256=XIC1ipNH34wGVKe622WH4F-VQdLxqUEHkOJQUlW46Ts,877
+exonware/xwlazy/common/base.py,sha256=n49uWNV5Zm5BYY5jt5fZrsY15RpFKZEW_94nQLDN9wo,1423
+exonware/xwlazy/common/cache.py,sha256=Fm5rGHAPHtXcYJ39pbhv01936mkoRPWkx4ttRHFxqa0,17566
+exonware/xwlazy/common/logger.py,sha256=pwykamPOIiggZGAYxKJ8Lm7FKWeg-cBVb7NnPV1mzmE,8378
+exonware/xwlazy/common/services/__init__.py,sha256=LgoL5PdLdaanKKkw1WghiNirLIFpkSkExlXWBezGZdc,1774
+exonware/xwlazy/common/services/dependency_mapper.py,sha256=_i0q1omkUSCPNAMQaLWf-gWLgOKJi4F1H_c5dg4W6UQ,8557
+exonware/xwlazy/common/services/install_async_utils.py,sha256=KQUX60F3J03Msxw_pP25d3pF0q73ixWfDfmSooWoTdw,4987
+exonware/xwlazy/common/services/install_cache_utils.py,sha256=z5ZKi6tCNI91HS6DlfEiSXCi0SD7cZVAor6O7EryZ5Q,7618
+exonware/xwlazy/common/services/keyword_detection.py,sha256=qmawH1RbENZrMoiym-e_nZ9IMrIXf0Hyw7pQroYEVw4,9785
+exonware/xwlazy/common/services/spec_cache.py,sha256=Lh-PwZvueP4K1QyN69EyFoMKfAtRhxkEpKQ7qWHkf28,5343
+exonware/xwlazy/common/services/state_manager.py,sha256=a_pOIDI6apbpu3xWvnofyM3vReV49CXiZmplkpWATmE,3118
+exonware/xwlazy/common/strategies/__init__.py,sha256=DmMFKUbKge4I76395bGtgaooHB4etD4jdTe1AeEueX8,650
+exonware/xwlazy/common/strategies/caching_dict.py,sha256=MOLbPBX12p4gevFdQg-uQ6qhqRZqLhFN9aMKVriRyhQ,1144
+exonware/xwlazy/common/strategies/caching_installation.py,sha256=Zxl0oC6qABsBmkfGcWxa8EQatAsVwE9_K3DxsQ2FR8U,2541
+exonware/xwlazy/common/strategies/caching_lfu.py,sha256=sddShWMEwOe7adkqxgWiTEKHUtrL5gR9wvbX_VusYuc,1989
+exonware/xwlazy/common/strategies/caching_lru.py,sha256=9CA0-EOF4BX8otReE0MshZalkjOpNdBL1b8bN64xnxQ,1850
+exonware/xwlazy/common/strategies/caching_multitier.py,sha256=oC8f85UJL5EYJ0LaphpJm9VikA8CYs-Du9qnh2cgxco,1928
+exonware/xwlazy/common/strategies/caching_ttl.py,sha256=CWooFDWJk1E09OZ0Ou7SnuwigG9k997xOwQZnvs7VUk,1655
+exonware/xwlazy/module/__init__.py,sha256=sL_G0RvpMfif0e3Yzo0CSj2xAPPF6phlQB367agzqfE,627
+exonware/xwlazy/module/base.py,sha256=4Et6hn7mVjhM7TP9bvQHt5sz1HzRy4Ndg-UvunIS5Co,20703
+exonware/xwlazy/module/data.py,sha256=7wbVc1sqtM4yOWgEa0PK5-FVlXEzMwqqMxbqRJTmmKc,335
+exonware/xwlazy/module/facade.py,sha256=kOUSqlXbd07Q-cPv97m-2X2yaqEZKsKOftatj_rFDJ4,8090
+exonware/xwlazy/module/importer_engine.py,sha256=tRhPOC5PPzXUzYxIoNKXXxv0HAlHIXKx0H5jIMWtEns,91879
+exonware/xwlazy/module/strategies/__init__.py,sha256=YFsS8NqyoC_btPW_0lOjf5Eq4Yd_HBLWvs37viOVnHk,484
+exonware/xwlazy/module/strategies/module_helper_lazy.py,sha256=Od7Fu8xESf_JUjkmY4OgfcbZgytmr8WPbdyjpQ3ijb8,2697
+exonware/xwlazy/module/strategies/module_helper_simple.py,sha256=vzvbEi8EpCOkcAEKv8dRE8LYY6LtpXvy1b65mXwM3cc,1701
+exonware/xwlazy/module/strategies/module_manager_advanced.py,sha256=ofzBD2p2mhMmQE3cF2_JtiZMWsD5cEdYhQ2P5z70QN4,3311
+exonware/xwlazy/module/strategies/module_manager_simple.py,sha256=FvhDJXaLrHfJL0lt6nspnmOnUD1hceeHMjfXz35SBUs,2460
+exonware/xwlazy/package/__init__.py,sha256=UI7xwTbFDURAt7kCr3yRhZzZtFrWRDwhJXakSyJwSCU,640
+exonware/xwlazy/package/base.py,sha256=aPLeRIy2p6PEAj7ozyPBGtt6EzjJXqvF5R4mBcX6D4k,27956
+exonware/xwlazy/package/conf.py,sha256=SXq-VeVBn7Aya2e9z7wGEdlaeQaZm6dfgybI41070Jw,14077
+exonware/xwlazy/package/data.py,sha256=5dJECtE5K-_efdQuKIokxCIhGYYUJd88aohItTVsU5Q,340
+exonware/xwlazy/package/facade.py,sha256=ibrpGwF57Sjc9U4cD_jKTJcsIxoI2FvyERQHZDI1pU0,18744
+exonware/xwlazy/package/services/__init__.py,sha256=ydB2kRzx6I3Kpm-bYyecTwHdkE_544X0CAXHZh7AyZY,2240
+exonware/xwlazy/package/services/async_install_handle.py,sha256=TY2H08TbPt96Nf83xG2PZsCSDBY8d2Ge_-na3dDX_Sg,2822
+exonware/xwlazy/package/services/config_manager.py,sha256=2Q71SY8TblFgRsBQ1b0nf-yyNtCMpNruUHayqoCuMuw,10552
+exonware/xwlazy/package/services/discovery.py,sha256=5cTcpFiQNrJpz3mpEd3oQ0MrHUjgfXEC1Xb6NBRANt8,14658
+exonware/xwlazy/package/services/host_packages.py,sha256=QUZWBNzdYVlHAcuSv9pzvh6-Bqv-bjrcTR1TZzQYaZs,5433
+exonware/xwlazy/package/services/install_async.py,sha256=9Vi3x2wmZihzm_S82j3phcu_6Pu9XIFxqWEGUJLMa3M,13297
+exonware/xwlazy/package/services/install_cache.py,sha256=B6Z12dJotKk86mEwYuv-2m_rlRSEohTQa5PTWBL-rUw,5992
+exonware/xwlazy/package/services/install_interactive.py,sha256=dgUAKoLolF0ne5PornmXIkff5Nwy_JZ7upC4x0pTVDw,2173
+exonware/xwlazy/package/services/install_policy.py,sha256=G8eQAKOpwMYRyI3Wa6m6EHTZJM3LX7Tj0_pCFfnp34A,5895
+exonware/xwlazy/package/services/install_registry.py,sha256=XEABwMaUo7L7d2nodw6TxBW-fLuKnZmvBVNSXX-VfZY,1523
+exonware/xwlazy/package/services/install_result.py,sha256=iroxDlXf9OUAEkEKZVfMzlBh61SBd_XxWBzCjNH-5cY,363
+exonware/xwlazy/package/services/install_sbom.py,sha256=0iFBlBvKi9v5TxulKciBra8jlHlEKKBzQ8tyN48fci8,5589
+exonware/xwlazy/package/services/install_utils.py,sha256=uaUY-ABRobTbLkYCNoeoshZlAr2U65AqMuXml-yXroI,2392
+exonware/xwlazy/package/services/installer_engine.py,sha256=kAyUOoNLBhxyFixtb_xADkpgsUfc8mhTE-Xdn_O08Es,15382
+exonware/xwlazy/package/services/lazy_installer.py,sha256=L2D_1puQQIONkJdWT43E4E-awgKIU2vyLrTbTXrOZyc,32117
+exonware/xwlazy/package/services/manifest.py,sha256=Wvou3vWZoXIAGL-MgEI_QRGNJbFZ_2k8Igv2DDg3grY,19173
+exonware/xwlazy/package/services/strategy_registry.py,sha256=FM7apcEkS85WRQoHdGW7zwkCF7vbsazbyD_F3SXHCPU,6815
+exonware/xwlazy/package/strategies/__init__.py,sha256=r_gpreZ6kcsWfHkGABYlZVx69JdvbMwlftitAKEwbrA,1626
+exonware/xwlazy/package/strategies/package_discovery_file.py,sha256=NNtwHdgwm9biSpFmkTHYPOF4hotwprQJmvTQ5lfOOa0,4412
+exonware/xwlazy/package/strategies/package_discovery_hybrid.py,sha256=2WQwrsBWA_Gi3zQPraBtGSS_43L-9B7FNsGPdctGjSg,2672
+exonware/xwlazy/package/strategies/package_discovery_manifest.py,sha256=B4mGUw-_azpNWE7oNhCNZmr7Ib-zTLWxIXP6c3djrec,3386
+exonware/xwlazy/package/strategies/package_execution_async.py,sha256=WdGJC6WdIW4epZNY3oTmDCXlCQS6-HKuN0UWZrqZKy0,3662
+exonware/xwlazy/package/strategies/package_execution_cached.py,sha256=L1mOv3dgj5xzpUUBuS6d9eS8ghG5Lf_DTl3fSwy1i1k,2698
+exonware/xwlazy/package/strategies/package_execution_pip.py,sha256=370s6RKb0Db_RuXzj4h4FJ0dxLQxHCib7vPc3XFg6Os,2981
+exonware/xwlazy/package/strategies/package_execution_wheel.py,sha256=KumGWMkwSW68rgiY7xmOQQFdyMuPspwe5W7xPF2rqGw,3227
+exonware/xwlazy/package/strategies/package_mapping_discovery_first.py,sha256=rwwf1dVtrAM7pEcQ8AIkTf1HWiDfHdvdqTbKzPEfXtA,3297
+exonware/xwlazy/package/strategies/package_mapping_hybrid.py,sha256=_4ITMsQYt2aDARnjGygczsZTXjOeokf9VRoDBjTeHDU,3417
+exonware/xwlazy/package/strategies/package_mapping_manifest_first.py,sha256=gu7PQ4F94GOkFrpXguH30juXkhtfQ63E7VLaLhcphaU,3322
+exonware/xwlazy/package/strategies/package_policy_allow_list.py,sha256=A6Vnm1pnM_9y1UhyAQOZV-y_8mr3H6hfvAABbDT41gM,1574
+exonware/xwlazy/package/strategies/package_policy_deny_list.py,sha256=31xiRikrVmfzadmyHBe69VVqM7UB6fjpwkYjyoPiAjA,1534
+exonware/xwlazy/package/strategies/package_policy_permissive.py,sha256=UJGDmU78rnLIOSqAEKBHUoLq_XqCo1NgG3ZGhoASXGs,1145
+exonware/xwlazy/package/strategies/package_timing_clean.py,sha256=EikXBD7tIe9vbQhaZwf7U5z5QoCncjzBJHxQBRCSKPM,1844
+exonware/xwlazy/package/strategies/package_timing_full.py,sha256=d3rbxO6z37obh1MaZ67RDDV8qx3Wbtb3hntGPkmk4t4,1754
+exonware/xwlazy/package/strategies/package_timing_smart.py,sha256=DIJeObmLA3dF3zWw7WbiiZdioP-CypVjxgTokcLuk68,1853
+exonware/xwlazy/package/strategies/package_timing_temporary.py,sha256=Ixlnh8jVYx_D3qfZ-9YCP_mbzFIteCluF3036RphjGM,1813
+exonware/xwlazy/runtime/__init__.py,sha256=jbIzemqwtWvKu2LxhYU7pIcihNakQHCON8xZW0orqZA,636
+exonware/xwlazy/runtime/adaptive_learner.py,sha256=rnr9mtW6949t6udjvF-FVTFJEGD5_V6WC6lVA3Zi-Tc,5275
+exonware/xwlazy/runtime/base.py,sha256=-Rqzbx_3L3FaxmIXOC3BiK4UzlTe118C6N9DLRYMv1o,10038
+exonware/xwlazy/runtime/facade.py,sha256=8NpdGiMs0dD0Yfxk-1vkIFtZZuMvYIm9ICmLd3hwlwk,3416
+exonware/xwlazy/runtime/intelligent_selector.py,sha256=7ajDIOLteeFcXOetQvXLu1mmtynePz3ADQB90jRnGtU,6551
+exonware/xwlazy/runtime/metrics.py,sha256=IYR6PQkQOIKWMjH7Mw3yspkLjsvP8JXVnUNjTJ67YyY,1991
+exonware/xwlazy/runtime/performance.py,sha256=6Oiuv_bS6-AyIAKMYLSWRcgfs85BcfwKa0yv2HRE8BA,1200
+exonware_xwlazy-0.1.0.19.dist-info/METADATA,sha256=aNq8i5Y816RKut5Z8f88yZPB21vtm4pCUKlhKhkQoZw,16731
+exonware_xwlazy-0.1.0.19.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+exonware_xwlazy-0.1.0.19.dist-info/licenses/LICENSE,sha256=w42ohoEUfhyT0NgiivAL4fWg2AMRLGnfXPMAR4EO-MU,1094
+exonware_xwlazy-0.1.0.19.dist-info/RECORD,,

exonware_xwlazy-0.1.0.11.dist-info/RECORD

@@ -1,20 +0,0 @@
-exonware/xwlazy/__init__.py,sha256=uS0FTfM1r1FqcM2C6FrLgFARp-drdMxnJOg5XATAM3U,1674
-exonware/xwlazy/version.py,sha256=E5aVPnT4mfjNCGF4IEs45FOFv_vH_RspxZBtW_y8je8,2351
-xwlazy/__init__.py,sha256=kMokTnTWqht1Rr4VgPfxpjp6BYQ0Pziu3rpXw93-57k,608
-xwlazy/version.py,sha256=HB5UxTEw9CUiCDNVgFLHpMuojbuugXVR7kXQhdJOy9E,2351
-xwlazy/lazy/__init__.py,sha256=VhBEqwhR_GUrdn5400KWS28pX7T36kqTz9p2QgxqrXA,7361
-xwlazy/lazy/bootstrap.py,sha256=okGe1f30qPXC7uyz7rnY6wzan3Mkt6Z5sukyPfZK4kQ,3721
-xwlazy/lazy/config.py,sha256=Wb6YMqYJT4Car79i8tvFptKlDT-15tplWeZZ2IMfZzY,5344
-xwlazy/lazy/host_conf.py,sha256=w_bT8VQEOtrf8oR-rY08dxB-k-Y7nMWt2mlOiZcVaxI,11377
-xwlazy/lazy/host_packages.py,sha256=7b4XmfcbSHE68aFeXgAp3ELEG0t9poa73MRULzQmtGY,4059
-xwlazy/lazy/lazy_base.py,sha256=mtIq3F4LdH7IIxm0Tizma_4nkxwVVJ7IcwAPmLWqYls,13919
-xwlazy/lazy/lazy_contracts.py,sha256=6GZj3svH4Tsb74Syjh0hKgkMuNGDfGCTVb4QNI9T7dM,7573
-xwlazy/lazy/lazy_core.py,sha256=_FwYz140ueeRgFrQAk0K5xdmKyEcHsfYtBgzytrQ6nI,145139
-xwlazy/lazy/lazy_errors.py,sha256=0ttYzcquv0jAd6cfO2be77sRHWuTPjW8KDQFQ-4JQWo,8642
-xwlazy/lazy/lazy_state.py,sha256=a_pOIDI6apbpu3xWvnofyM3vReV49CXiZmplkpWATmE,3118
-xwlazy/lazy/logging_utils.py,sha256=n2AkfQfFkUxlpAZyRNllwZTFrLfI0HD73ULw-AqQUCo,5830
-xwlazy/lazy/manifest.py,sha256=GCExV9EDOQ3HGIwVp-9wUk5MPUnJGYGKGS7CREPHubU,18497
-exonware_xwlazy-0.1.0.11.dist-info/METADATA,sha256=i77J_GYb3myTc0VCx_P96up0ZjSSaIQvkYF6RQMGb3U,13759
-exonware_xwlazy-0.1.0.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-exonware_xwlazy-0.1.0.11.dist-info/licenses/LICENSE,sha256=w42ohoEUfhyT0NgiivAL4fWg2AMRLGnfXPMAR4EO-MU,1094
-exonware_xwlazy-0.1.0.11.dist-info/RECORD,,

xwlazy/__init__.py

@@ -1,34 +0,0 @@
-"""
-Top-level xwlazy package exposing lazy runtime utilities.
-"""
-
-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,
-)
-
-__all__ = [
-    "__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",
-]
-

xwlazy/lazy/__init__.py

@@ -1,301 +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.1.0.16
-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 xwlazy.lazy 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,
-    WatchedPrefixRegistry,
-    AsyncInstallHandle,
-    
-    # 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,
-    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,
-
-    # Registration helpers
-    register_lazy_module_prefix,
-    register_lazy_module_methods,
-)
-
-from .config import LazyConfig, DEFAULT_LAZY_CONFIG
-from .host_conf import get_conf_module
-from .host_packages import register_host_package, refresh_host_package
-from .logging_utils import (
-    get_log_categories,
-    is_log_category_enabled,
-    set_log_categories,
-    set_log_category,
-)
-
-# 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',
-    'WatchedPrefixRegistry',
-    'AsyncInstallHandle',
-    
-    # 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',
-    'sync_manifest_configuration',
-    'refresh_lazy_manifests',
-    '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',
-
-    # Registration helpers
-    'register_lazy_module_prefix',
-    'register_lazy_module_methods',
-    'register_host_package',
-    'refresh_host_package',
-    'get_conf_module',
-
-    # Logging helpers
-    'get_log_categories',
-    'is_log_category_enabled',
-    'set_log_categories',
-    'set_log_category',
-]
-

xwlazy/lazy/bootstrap.py

@@ -1,106 +0,0 @@
-#exonware/xwlazy/src/exonware/xwlazy/lazy/bootstrap.py
-"""
-Early bootstrap utilities for lazily installing import hooks.
-"""
-
-from __future__ import annotations
-
-import atexit
-import logging
-import os
-import sys
-from typing import Optional
-
-
-def _env_enabled(env_value: Optional[str]) -> Optional[bool]:
-    if not env_value:
-        return None
-    normalized = env_value.strip().lower()
-    if normalized in ('true', '1', 'yes', 'on'):
-        return True
-    if normalized in ('false', '0', 'no', 'off'):
-        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()
-    env_value = os.environ.get(f"{package_name.upper()}_LAZY_INSTALL")
-    env_enabled = _env_enabled(env_value)
-    enabled = env_enabled
-
-    if enabled is None:
-        try:
-            from xwlazy.lazy.lazy_core import _detect_lazy_installation
-            enabled = _detect_lazy_installation(package_name)
-        except Exception as exc:  # pragma: no cover
-            logging.getLogger("xwlazy.lazy.bootstrap").debug(
-                "Lazy detection failed: %s", exc, exc_info=True
-            )
-            enabled = False
-
-    if not enabled:
-        return
-
-    try:
-        from xwlazy.lazy.lazy_core import config_package_lazy_install_enabled
-
-        config_package_lazy_install_enabled(
-            package_name,
-            enabled=True,
-            install_hook=True,
-        )
-    except Exception as exc:  # pragma: no cover
-        logging.getLogger("xwlazy.lazy.bootstrap").debug(
-            "Lazy bootstrap failed for %s: %s", package_name, exc, exc_info=True
-        )
-
-
-def bootstrap_lazy_mode_deferred(package_name: str) -> None:
-    """
-    Schedule lazy mode bootstrap to run AFTER the calling package finishes importing.
-    
-    This avoids hook interference with the package's own imports (e.g., requests/certifi in xwsystem).
-    Uses a post-import hook to detect when the package module is fully loaded.
-    """
-    package_name_lower = package_name.lower()
-    package_module_name = f"exonware.{package_name_lower}"
-    
-    # Store original __import__ to restore later
-    original_import = __builtins__.__import__ if hasattr(__builtins__, '__import__') else __import__
-    
-    def _import_hook(name, *args, **kwargs):
-        # Call original import first
-        result = original_import(name, *args, **kwargs)
-        
-        # Check if the target package just finished importing
-        if name == package_module_name or name.startswith(f"{package_module_name}."):
-            # Check if package root is now fully in sys.modules
-            if package_module_name in sys.modules:
-                # Package is loaded, install hook on next event loop iteration
-                import threading
-                def _install_hook():
-                    # Restore original import
-                    if hasattr(__builtins__, '__import__'):
-                        __builtins__.__import__ = original_import
-                    else:
-                        import builtins
-                        builtins.__import__ = original_import
-                    # Now install the lazy hook
-                    bootstrap_lazy_mode(package_name_lower)
-                
-                # Schedule for immediate execution after current import completes
-                threading.Timer(0.0, _install_hook).start()
-        
-        return result
-    
-    # Install temporary import hook
-    if hasattr(__builtins__, '__import__'):
-        __builtins__.__import__ = _import_hook
-    else:
-        import builtins
-        builtins.__import__ = _import_hook
-