exonware-xwsystem 0.0.1.407__py3-none-any.whl → 0.0.1.409__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (244) hide show
  1. exonware/__init__.py +21 -12
  2. exonware/conf.py +89 -149
  3. exonware/xwsystem/__init__.py +18 -159
  4. exonware/xwsystem/caching/__init__.py +1 -1
  5. exonware/xwsystem/caching/base.py +1 -1
  6. exonware/xwsystem/caching/bloom_cache.py +1 -1
  7. exonware/xwsystem/caching/cache_manager.py +1 -1
  8. exonware/xwsystem/caching/conditional.py +1 -1
  9. exonware/xwsystem/caching/contracts.py +1 -1
  10. exonware/xwsystem/caching/decorators.py +1 -1
  11. exonware/xwsystem/caching/defs.py +1 -1
  12. exonware/xwsystem/caching/disk_cache.py +1 -1
  13. exonware/xwsystem/caching/distributed.py +1 -1
  14. exonware/xwsystem/caching/errors.py +1 -1
  15. exonware/xwsystem/caching/events.py +1 -1
  16. exonware/xwsystem/caching/eviction_strategies.py +1 -1
  17. exonware/xwsystem/caching/fluent.py +1 -1
  18. exonware/xwsystem/caching/integrity.py +1 -1
  19. exonware/xwsystem/caching/lfu_cache.py +1 -1
  20. exonware/xwsystem/caching/lfu_optimized.py +1 -1
  21. exonware/xwsystem/caching/lru_cache.py +1 -1
  22. exonware/xwsystem/caching/memory_bounded.py +1 -1
  23. exonware/xwsystem/caching/metrics_exporter.py +1 -1
  24. exonware/xwsystem/caching/observable_cache.py +1 -1
  25. exonware/xwsystem/caching/pluggable_cache.py +1 -1
  26. exonware/xwsystem/caching/rate_limiter.py +1 -1
  27. exonware/xwsystem/caching/read_through.py +1 -1
  28. exonware/xwsystem/caching/secure_cache.py +1 -1
  29. exonware/xwsystem/caching/serializable.py +1 -1
  30. exonware/xwsystem/caching/stats.py +1 -1
  31. exonware/xwsystem/caching/tagging.py +1 -1
  32. exonware/xwsystem/caching/ttl_cache.py +1 -1
  33. exonware/xwsystem/caching/two_tier_cache.py +1 -1
  34. exonware/xwsystem/caching/utils.py +1 -1
  35. exonware/xwsystem/caching/validation.py +1 -1
  36. exonware/xwsystem/caching/warming.py +1 -1
  37. exonware/xwsystem/caching/write_behind.py +1 -1
  38. exonware/xwsystem/cli/__init__.py +1 -1
  39. exonware/xwsystem/cli/args.py +1 -1
  40. exonware/xwsystem/cli/base.py +1 -1
  41. exonware/xwsystem/cli/colors.py +1 -1
  42. exonware/xwsystem/cli/console.py +1 -1
  43. exonware/xwsystem/cli/contracts.py +1 -1
  44. exonware/xwsystem/cli/defs.py +1 -1
  45. exonware/xwsystem/cli/errors.py +1 -1
  46. exonware/xwsystem/cli/progress.py +1 -1
  47. exonware/xwsystem/cli/prompts.py +1 -1
  48. exonware/xwsystem/cli/tables.py +1 -1
  49. exonware/xwsystem/conf.py +1 -21
  50. exonware/xwsystem/config/__init__.py +1 -1
  51. exonware/xwsystem/config/base.py +1 -1
  52. exonware/xwsystem/config/contracts.py +1 -1
  53. exonware/xwsystem/config/defaults.py +1 -1
  54. exonware/xwsystem/config/defs.py +1 -1
  55. exonware/xwsystem/config/errors.py +1 -1
  56. exonware/xwsystem/config/logging.py +1 -1
  57. exonware/xwsystem/config/logging_setup.py +1 -1
  58. exonware/xwsystem/config/performance.py +1 -1
  59. exonware/xwsystem/http/__init__.py +1 -1
  60. exonware/xwsystem/http/advanced_client.py +5 -1
  61. exonware/xwsystem/http/base.py +1 -1
  62. exonware/xwsystem/http/client.py +5 -1
  63. exonware/xwsystem/http/contracts.py +1 -1
  64. exonware/xwsystem/http/defs.py +1 -1
  65. exonware/xwsystem/http/errors.py +1 -1
  66. exonware/xwsystem/io/__init__.py +1 -1
  67. exonware/xwsystem/io/archive/__init__.py +1 -1
  68. exonware/xwsystem/io/archive/archive.py +1 -1
  69. exonware/xwsystem/io/archive/archive_files.py +1 -1
  70. exonware/xwsystem/io/archive/archivers.py +1 -1
  71. exonware/xwsystem/io/archive/base.py +1 -1
  72. exonware/xwsystem/io/archive/codec_integration.py +1 -1
  73. exonware/xwsystem/io/archive/compression.py +1 -1
  74. exonware/xwsystem/io/archive/formats/__init__.py +1 -1
  75. exonware/xwsystem/io/archive/formats/brotli_format.py +1 -1
  76. exonware/xwsystem/io/archive/formats/lz4_format.py +1 -1
  77. exonware/xwsystem/io/archive/formats/rar.py +1 -1
  78. exonware/xwsystem/io/archive/formats/sevenzip.py +1 -1
  79. exonware/xwsystem/io/archive/formats/squashfs_format.py +1 -1
  80. exonware/xwsystem/io/archive/formats/tar.py +1 -1
  81. exonware/xwsystem/io/archive/formats/wim_format.py +1 -1
  82. exonware/xwsystem/io/archive/formats/zip.py +1 -1
  83. exonware/xwsystem/io/archive/formats/zpaq_format.py +1 -1
  84. exonware/xwsystem/io/archive/formats/zstandard.py +1 -1
  85. exonware/xwsystem/io/base.py +1 -1
  86. exonware/xwsystem/io/codec/__init__.py +1 -1
  87. exonware/xwsystem/io/codec/base.py +1 -1
  88. exonware/xwsystem/io/codec/contracts.py +1 -1
  89. exonware/xwsystem/io/codec/registry.py +1 -1
  90. exonware/xwsystem/io/common/__init__.py +1 -1
  91. exonware/xwsystem/io/common/base.py +1 -1
  92. exonware/xwsystem/io/common/lock.py +1 -1
  93. exonware/xwsystem/io/common/watcher.py +1 -1
  94. exonware/xwsystem/io/contracts.py +1 -1
  95. exonware/xwsystem/io/defs.py +1 -1
  96. exonware/xwsystem/io/errors.py +1 -1
  97. exonware/xwsystem/io/facade.py +1 -1
  98. exonware/xwsystem/io/file/__init__.py +1 -1
  99. exonware/xwsystem/io/file/base.py +1 -1
  100. exonware/xwsystem/io/file/conversion.py +1 -1
  101. exonware/xwsystem/io/file/file.py +1 -1
  102. exonware/xwsystem/io/file/paged_source.py +1 -1
  103. exonware/xwsystem/io/file/paging/__init__.py +1 -1
  104. exonware/xwsystem/io/file/paging/byte_paging.py +1 -1
  105. exonware/xwsystem/io/file/paging/line_paging.py +1 -1
  106. exonware/xwsystem/io/file/paging/record_paging.py +1 -1
  107. exonware/xwsystem/io/file/paging/registry.py +1 -1
  108. exonware/xwsystem/io/file/source.py +1 -1
  109. exonware/xwsystem/io/filesystem/__init__.py +1 -1
  110. exonware/xwsystem/io/filesystem/base.py +1 -1
  111. exonware/xwsystem/io/filesystem/local.py +1 -1
  112. exonware/xwsystem/io/folder/__init__.py +1 -1
  113. exonware/xwsystem/io/folder/base.py +1 -1
  114. exonware/xwsystem/io/folder/folder.py +1 -1
  115. exonware/xwsystem/io/serialization/__init__.py +1 -1
  116. exonware/xwsystem/io/serialization/auto_serializer.py +1 -1
  117. exonware/xwsystem/io/serialization/base.py +2 -2
  118. exonware/xwsystem/io/serialization/contracts.py +1 -1
  119. exonware/xwsystem/io/serialization/defs.py +1 -1
  120. exonware/xwsystem/io/serialization/errors.py +1 -1
  121. exonware/xwsystem/io/serialization/flyweight.py +1 -1
  122. exonware/xwsystem/io/serialization/format_detector.py +1 -1
  123. exonware/xwsystem/io/serialization/formats/__init__.py +1 -1
  124. exonware/xwsystem/io/serialization/formats/binary/bson.py +1 -1
  125. exonware/xwsystem/io/serialization/formats/binary/cbor.py +1 -1
  126. exonware/xwsystem/io/serialization/formats/binary/marshal.py +1 -1
  127. exonware/xwsystem/io/serialization/formats/binary/msgpack.py +1 -1
  128. exonware/xwsystem/io/serialization/formats/binary/pickle.py +1 -1
  129. exonware/xwsystem/io/serialization/formats/binary/plistlib.py +1 -1
  130. exonware/xwsystem/io/serialization/formats/database/dbm.py +1 -1
  131. exonware/xwsystem/io/serialization/formats/database/shelve.py +1 -1
  132. exonware/xwsystem/io/serialization/formats/database/sqlite3.py +1 -1
  133. exonware/xwsystem/io/serialization/formats/text/configparser.py +1 -1
  134. exonware/xwsystem/io/serialization/formats/text/csv.py +1 -1
  135. exonware/xwsystem/io/serialization/formats/text/formdata.py +1 -1
  136. exonware/xwsystem/io/serialization/formats/text/json.py +1 -1
  137. exonware/xwsystem/io/serialization/formats/text/json5.py +1 -1
  138. exonware/xwsystem/io/serialization/formats/text/jsonlines.py +1 -1
  139. exonware/xwsystem/io/serialization/formats/text/multipart.py +1 -1
  140. exonware/xwsystem/io/serialization/formats/text/toml.py +1 -1
  141. exonware/xwsystem/io/serialization/formats/text/xml.py +1 -1
  142. exonware/xwsystem/io/serialization/formats/text/yaml.py +1 -1
  143. exonware/xwsystem/io/serialization/registry.py +1 -1
  144. exonware/xwsystem/io/serialization/serializer.py +1 -1
  145. exonware/xwsystem/io/serialization/utils/__init__.py +1 -1
  146. exonware/xwsystem/io/serialization/utils/path_ops.py +1 -1
  147. exonware/xwsystem/io/stream/__init__.py +1 -1
  148. exonware/xwsystem/io/stream/async_operations.py +1 -1
  149. exonware/xwsystem/io/stream/base.py +1 -1
  150. exonware/xwsystem/io/stream/codec_io.py +1 -1
  151. exonware/xwsystem/ipc/async_fabric.py +1 -1
  152. exonware/xwsystem/ipc/base.py +1 -1
  153. exonware/xwsystem/ipc/contracts.py +1 -1
  154. exonware/xwsystem/ipc/defs.py +1 -1
  155. exonware/xwsystem/ipc/errors.py +1 -1
  156. exonware/xwsystem/lazy_bootstrap.py +79 -0
  157. exonware/xwsystem/monitoring/base.py +1 -1
  158. exonware/xwsystem/monitoring/contracts.py +1 -1
  159. exonware/xwsystem/monitoring/defs.py +1 -1
  160. exonware/xwsystem/monitoring/errors.py +1 -1
  161. exonware/xwsystem/monitoring/performance_manager_generic.py +1 -1
  162. exonware/xwsystem/monitoring/system_monitor.py +1 -1
  163. exonware/xwsystem/monitoring/tracing.py +17 -15
  164. exonware/xwsystem/monitoring/tracker.py +1 -1
  165. exonware/xwsystem/operations/__init__.py +1 -1
  166. exonware/xwsystem/operations/base.py +1 -1
  167. exonware/xwsystem/operations/defs.py +1 -1
  168. exonware/xwsystem/operations/diff.py +1 -1
  169. exonware/xwsystem/operations/merge.py +1 -1
  170. exonware/xwsystem/operations/patch.py +1 -1
  171. exonware/xwsystem/patterns/base.py +1 -1
  172. exonware/xwsystem/patterns/contracts.py +1 -1
  173. exonware/xwsystem/patterns/defs.py +1 -1
  174. exonware/xwsystem/patterns/errors.py +1 -1
  175. exonware/xwsystem/patterns/registry.py +1 -1
  176. exonware/xwsystem/plugins/__init__.py +1 -1
  177. exonware/xwsystem/plugins/base.py +1 -1
  178. exonware/xwsystem/plugins/contracts.py +1 -1
  179. exonware/xwsystem/plugins/defs.py +1 -1
  180. exonware/xwsystem/plugins/errors.py +1 -1
  181. exonware/xwsystem/runtime/__init__.py +1 -1
  182. exonware/xwsystem/runtime/base.py +1 -1
  183. exonware/xwsystem/runtime/contracts.py +1 -1
  184. exonware/xwsystem/runtime/defs.py +1 -1
  185. exonware/xwsystem/runtime/env.py +1 -1
  186. exonware/xwsystem/runtime/errors.py +1 -1
  187. exonware/xwsystem/runtime/reflection.py +1 -1
  188. exonware/xwsystem/security/auth.py +1 -1
  189. exonware/xwsystem/security/base.py +1 -1
  190. exonware/xwsystem/security/contracts.py +1 -1
  191. exonware/xwsystem/security/crypto.py +1 -1
  192. exonware/xwsystem/security/defs.py +1 -1
  193. exonware/xwsystem/security/errors.py +1 -1
  194. exonware/xwsystem/security/hazmat.py +1 -1
  195. exonware/xwsystem/shared/__init__.py +1 -1
  196. exonware/xwsystem/shared/base.py +1 -1
  197. exonware/xwsystem/shared/contracts.py +1 -1
  198. exonware/xwsystem/shared/defs.py +1 -1
  199. exonware/xwsystem/shared/errors.py +1 -1
  200. exonware/xwsystem/structures/base.py +1 -1
  201. exonware/xwsystem/structures/contracts.py +1 -1
  202. exonware/xwsystem/structures/defs.py +1 -1
  203. exonware/xwsystem/structures/errors.py +1 -1
  204. exonware/xwsystem/threading/async_primitives.py +1 -1
  205. exonware/xwsystem/threading/base.py +1 -1
  206. exonware/xwsystem/threading/contracts.py +1 -1
  207. exonware/xwsystem/threading/defs.py +1 -1
  208. exonware/xwsystem/threading/errors.py +1 -1
  209. exonware/xwsystem/utils/base.py +1 -1
  210. exonware/xwsystem/utils/contracts.py +1 -1
  211. exonware/xwsystem/utils/dt/__init__.py +1 -1
  212. exonware/xwsystem/utils/dt/base.py +1 -1
  213. exonware/xwsystem/utils/dt/contracts.py +1 -1
  214. exonware/xwsystem/utils/dt/defs.py +1 -1
  215. exonware/xwsystem/utils/dt/errors.py +1 -1
  216. exonware/xwsystem/utils/dt/formatting.py +1 -1
  217. exonware/xwsystem/utils/dt/humanize.py +1 -1
  218. exonware/xwsystem/utils/dt/parsing.py +1 -1
  219. exonware/xwsystem/utils/dt/timezone_utils.py +1 -1
  220. exonware/xwsystem/utils/errors.py +1 -1
  221. exonware/xwsystem/utils/test_runner.py +1 -1
  222. exonware/xwsystem/utils/utils_contracts.py +1 -1
  223. exonware/xwsystem/validation/__init__.py +1 -1
  224. exonware/xwsystem/validation/base.py +1 -1
  225. exonware/xwsystem/validation/contracts.py +1 -1
  226. exonware/xwsystem/validation/declarative.py +1 -1
  227. exonware/xwsystem/validation/defs.py +1 -1
  228. exonware/xwsystem/validation/errors.py +1 -1
  229. exonware/xwsystem/validation/fluent_validator.py +1 -1
  230. exonware/xwsystem/version.py +2 -2
  231. {exonware_xwsystem-0.0.1.407.dist-info → exonware_xwsystem-0.0.1.409.dist-info}/METADATA +3 -3
  232. exonware_xwsystem-0.0.1.409.dist-info/RECORD +274 -0
  233. exonware/xwsystem/_lazy_bootstrap.py +0 -77
  234. exonware/xwsystem/utils/lazy_package/ARCHITECTURE.md +0 -820
  235. exonware/xwsystem/utils/lazy_package/__init__.py +0 -268
  236. exonware/xwsystem/utils/lazy_package/config.py +0 -163
  237. exonware/xwsystem/utils/lazy_package/lazy_base.py +0 -465
  238. exonware/xwsystem/utils/lazy_package/lazy_contracts.py +0 -290
  239. exonware/xwsystem/utils/lazy_package/lazy_core.py +0 -2248
  240. exonware/xwsystem/utils/lazy_package/lazy_errors.py +0 -253
  241. exonware/xwsystem/utils/lazy_package/lazy_state.py +0 -86
  242. exonware_xwsystem-0.0.1.407.dist-info/RECORD +0 -282
  243. {exonware_xwsystem-0.0.1.407.dist-info → exonware_xwsystem-0.0.1.409.dist-info}/WHEEL +0 -0
  244. {exonware_xwsystem-0.0.1.407.dist-info → exonware_xwsystem-0.0.1.409.dist-info}/licenses/LICENSE +0 -0
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: November 2, 2025
7
7
 
8
8
  Multipart serialization - Multipart form data format.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: November 2, 2025
7
7
 
8
8
  TOML serialization - Configuration file format.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: November 2, 2025
7
7
 
8
8
  XML serialization - Extensible Markup Language.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: November 2, 2025
7
7
 
8
8
  YAML serialization - Human-readable data serialization format.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: November 2, 2025
7
7
 
8
8
  Serialization Registry - Delegates to UniversalCodecRegistry.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  XWSerializer - Unified intelligent serializer with I/O integration and auto-serialization.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: November 9, 2025
9
9
 
10
10
  Serialization utilities module.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: November 9, 2025
9
9
 
10
10
  Path operations utilities for serialization formats.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: 30-Oct-2025
9
9
 
10
10
  Stream operations and codec-integrated I/O.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  Asynchronous I/O operations for non-blocking file handling.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: 30-Oct-2025
9
9
 
10
10
  Base classes for stream operations.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: 30-Oct-2025
9
9
 
10
10
  Codec-integrated I/O - THE KILLER FEATURE!
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: 09-Nov-2025
8
8
 
9
9
  Async Process Fabric
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  IPC module base classes - abstract classes for inter-process communication functionality.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  IPC module contracts - interfaces and enums for inter-process communication.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: 07-Sep-2025
9
9
 
10
10
  IPC types and enums for XWSystem.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  IPC module errors - exception classes for inter-process communication functionality.
@@ -0,0 +1,79 @@
1
+ """
2
+ Minimal-intrusion lazy mode bootstrap for xwsystem.
3
+
4
+ This module provides a simple one-line integration to enable optimized lazy mode
5
+ for xwsystem using the fastest mode combination from benchmarks.
6
+
7
+ Company: eXonware.com
8
+ Author: Eng. Muhammad AlShehri
9
+ Email: connect@exonware.com
10
+ Version: 0.0.1.409
11
+ Generation Date: 19-Nov-2025
12
+ """
13
+
14
+ # Fastest mode from benchmarks: cached + full (1.482 ms - fastest overall)
15
+ _OPTIMAL_LOAD_MODE = "cached" # LazyLoadMode.CACHED
16
+ _OPTIMAL_INSTALL_MODE = "full" # LazyInstallMode.FULL
17
+
18
+
19
+ def _bootstrap_lazy_mode() -> None:
20
+ """
21
+ Bootstrap lazy mode for xwsystem with optimal performance settings.
22
+
23
+ Uses fastest mode from benchmarks:
24
+ - Load Mode: CACHED (fastest for light/enterprise loads)
25
+ - Install Mode: FULL (fastest overall: 1.482 ms)
26
+
27
+ This is completely non-intrusive:
28
+ - Only activates if xwlazy is installed
29
+ - Zero overhead when xwlazy is not available
30
+ - Scoped to xwsystem package only
31
+ - No interference with xwsystem's own imports
32
+ """
33
+ try:
34
+ from xwlazy.lazy import (
35
+ config_package_lazy_install_enabled,
36
+ install_import_hook,
37
+ LazyLoadMode,
38
+ LazyInstallMode,
39
+ )
40
+ from xwlazy.host.packages import register_host_package
41
+
42
+ # Register xwsystem as host package (for serialization prefixes)
43
+ register_host_package(
44
+ "xwsystem",
45
+ module_prefixes=(
46
+ "exonware.xwsystem.io.serialization.",
47
+ "exonware.xwsystem.io.archive.formats.",
48
+ "xwsystem.io.serialization.",
49
+ "xwsystem.io.archive.formats.",
50
+ ),
51
+ method_prefixes=(
52
+ "exonware.xwsystem.io.serialization.",
53
+ "xwsystem.io.serialization.",
54
+ ),
55
+ auto_config=False, # We handle config ourselves
56
+ )
57
+
58
+ # Configure with optimal mode from benchmarks
59
+ config_package_lazy_install_enabled(
60
+ "xwsystem",
61
+ enabled=True,
62
+ load_mode=LazyLoadMode(_OPTIMAL_LOAD_MODE),
63
+ install_mode=LazyInstallMode(_OPTIMAL_INSTALL_MODE),
64
+ )
65
+
66
+ # Install the import hook
67
+ install_import_hook("xwsystem")
68
+
69
+ except ImportError:
70
+ # xwlazy not installed - silently continue (non-intrusive)
71
+ pass
72
+ except Exception:
73
+ # Best-effort: xwsystem must continue even if lazy setup fails
74
+ pass
75
+
76
+
77
+ # Auto-bootstrap on module import (non-intrusive - only if xwlazy is available)
78
+ _bootstrap_lazy_mode()
79
+
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Monitoring module base classes - abstract classes for monitoring functionality.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Monitoring protocol interfaces for XWSystem.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: 07-Sep-2025
9
9
 
10
10
  Monitoring types and enums for XWSystem.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Monitoring module errors - exception classes for monitoring functionality.
@@ -10,7 +10,7 @@ health monitoring, and recommendations without being tied to specific implementa
10
10
  Company: eXonware.com
11
11
  Author: Eng. Muhammad AlShehri
12
12
  Email: connect@exonware.com
13
- Version: 0.0.1.407
13
+ Version: 0.0.1.409
14
14
  Generation Date: November 04, 2025
15
15
  """
16
16
 
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  System-wide monitoring and hardware introspection utilities.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 05, 2025
7
7
 
8
8
  Distributed Tracing Integration for Enterprise Observability
@@ -26,7 +26,6 @@ from .defs import SpanKind
26
26
  from ..version import __version__
27
27
 
28
28
  from opentelemetry import trace
29
- from opentelemetry.exporter.jaeger.thrift import JaegerExporter
30
29
  from opentelemetry.sdk.trace import TracerProvider
31
30
  from opentelemetry.sdk.trace.export import BatchSpanProcessor
32
31
 
@@ -64,7 +63,7 @@ class OpenTelemetryTracer(ATracingProvider):
64
63
  def __init__(
65
64
  self,
66
65
  service_name: str = "xwsystem",
67
- jaeger_endpoint: Optional[str] = None,
66
+ otlp_endpoint: Optional[str] = None,
68
67
  zipkin_endpoint: Optional[str] = None
69
68
  ):
70
69
  """
@@ -72,7 +71,7 @@ class OpenTelemetryTracer(ATracingProvider):
72
71
 
73
72
  Args:
74
73
  service_name: Name of the service
75
- jaeger_endpoint: Optional Jaeger collector endpoint
74
+ otlp_endpoint: Optional OTLP collector endpoint (modern standard, works with Jaeger/Zipkin)
76
75
  zipkin_endpoint: Optional Zipkin endpoint
77
76
  """
78
77
  # OpenTelemetry is now required
@@ -85,26 +84,29 @@ class OpenTelemetryTracer(ATracingProvider):
85
84
  self.tracer = trace.get_tracer(service_name)
86
85
 
87
86
  # Set up exporters
88
- if jaeger_endpoint:
89
- self._setup_jaeger_exporter(jaeger_endpoint)
87
+ if otlp_endpoint:
88
+ self._setup_otlp_exporter(otlp_endpoint)
90
89
 
91
90
  if zipkin_endpoint:
92
91
  self._setup_zipkin_exporter(zipkin_endpoint)
93
92
 
94
- def _setup_jaeger_exporter(self, endpoint: str) -> None:
95
- """Set up Jaeger exporter."""
93
+ def _setup_otlp_exporter(self, endpoint: str) -> None:
94
+ """Set up OTLP exporter (modern standard, Python 3.8+ only, no legacy deps)."""
96
95
  try:
97
- jaeger_exporter = JaegerExporter(
98
- agent_host_name="localhost",
99
- agent_port=6831,
100
- collector_endpoint=endpoint,
101
- )
96
+ # Lazy import to avoid pulling in dependencies unless actually used
97
+ from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
102
98
 
103
- span_processor = BatchSpanProcessor(jaeger_exporter)
99
+ otlp_exporter = OTLPSpanExporter(endpoint=endpoint)
100
+ span_processor = BatchSpanProcessor(otlp_exporter)
104
101
  trace.get_tracer_provider().add_span_processor(span_processor)
102
+ logger.info(f"OTLP exporter configured for endpoint: {endpoint}")
105
103
 
104
+ except ImportError:
105
+ logger.warning(
106
+ "OTLP exporter not available. Install with: pip install opentelemetry-exporter-otlp-proto-http"
107
+ )
106
108
  except Exception as e:
107
- logger.warning(f"Failed to setup Jaeger exporter: {e}")
109
+ logger.warning(f"Failed to setup OTLP exporter: {e}")
108
110
 
109
111
  def _setup_zipkin_exporter(self, endpoint: str) -> None:
110
112
  """Set up Zipkin exporter."""
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: October 26, 2025
8
8
 
9
9
  Operation tracker for monitoring operations with context management.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: October 26, 2025
8
8
 
9
9
  Universal operations library for data manipulation.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: October 26, 2025
8
8
 
9
9
  Base classes and contracts for operations.
@@ -5,7 +5,7 @@
5
5
  Company: eXonware.com
6
6
  Author: Eng. Muhammad AlShehri
7
7
  Email: connect@exonware.com
8
- Version: 0.0.1.407
8
+ Version: 0.0.1.409
9
9
  Generation Date: October 27, 2025
10
10
 
11
11
  Operations definitions and data structures.
@@ -5,7 +5,7 @@
5
5
  Company: eXonware.com
6
6
  Author: Eng. Muhammad AlShehri
7
7
  Email: connect@exonware.com
8
- Version: 0.0.1.407
8
+ Version: 0.0.1.409
9
9
  Generation Date: October 27, 2025
10
10
 
11
11
  Diff operations implementation.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: October 26, 2025
8
8
 
9
9
  Merge operations implementation.
@@ -5,7 +5,7 @@
5
5
  Company: eXonware.com
6
6
  Author: Eng. Muhammad AlShehri
7
7
  Email: connect@exonware.com
8
- Version: 0.0.1.407
8
+ Version: 0.0.1.409
9
9
  Generation Date: October 27, 2025
10
10
 
11
11
  Patch operations implementation (RFC 6902 JSON Patch).
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Abstract base classes for XSystem patterns.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Pattern contracts and interfaces for XWSystem design patterns.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: 07-Sep-2025
9
9
 
10
10
  Pattern types and enums for XWSystem design patterns.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Pattern-specific error classes for XSystem design patterns.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: October 26, 2025
8
8
 
9
9
  Generic registry pattern for dynamic registration and discovery.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  XSystem Plugins Package
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Plugin system base classes and management.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Plugin protocol interfaces for XWSystem.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: 07-Sep-2025
9
9
 
10
10
  Plugins types and enums for XWSystem.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Plugin-specific error classes for XSystem plugin system.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  XSystem Runtime Package
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Runtime module base classes - abstract classes for runtime functionality.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  Runtime module contracts - interfaces and enums for runtime environment functionality.
@@ -4,7 +4,7 @@
4
4
  Company: eXonware.com
5
5
  Author: Eng. Muhammad AlShehri
6
6
  Email: connect@exonware.com
7
- Version: 0.0.1.407
7
+ Version: 0.0.1.409
8
8
  Generation Date: 07-Sep-2025
9
9
 
10
10
  Runtime types and enums for XWSystem.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  Environment management utilities for runtime configuration and detection.
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Runtime module errors - exception classes for runtime functionality.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  Reflection utilities for dynamic code inspection and manipulation.
@@ -2,7 +2,7 @@
2
2
  Company: eXonware.com
3
3
  Author: Eng. Muhammad AlShehri
4
4
  Email: connect@exonware.com
5
- Version: 0.0.1.407
5
+ Version: 0.0.1.409
6
6
  Generation Date: September 04, 2025
7
7
 
8
8
  Advanced Authentication Providers for Enterprise Integration
@@ -3,7 +3,7 @@
3
3
  Company: eXonware.com
4
4
  Author: Eng. Muhammad AlShehri
5
5
  Email: connect@exonware.com
6
- Version: 0.0.1.407
6
+ Version: 0.0.1.409
7
7
  Generation Date: September 04, 2025
8
8
 
9
9
  Security module base classes - abstract classes for security functionality.