simplibs-object 0.1.0__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 (580) hide show
  1. simplibs/object/SimpleBase.py +115 -0
  2. simplibs/object/SimpleConstant.py +271 -0
  3. simplibs/object/SimpleObject.py +293 -0
  4. simplibs/object/__init__.py +7 -0
  5. simplibs/object/_core/__init__.py +66 -0
  6. simplibs/object/_core/logic/__init__.py +0 -0
  7. simplibs/object/_core/logic/constant_methods/__init__.py +22 -0
  8. simplibs/object/_core/logic/constant_methods/bool_or_raise_validate_error.py +76 -0
  9. simplibs/object/_core/logic/constant_methods/normalize.py +92 -0
  10. simplibs/object/_core/logic/constant_methods/validate.py +99 -0
  11. simplibs/object/_core/logic/constant_methods/validate_type.py +48 -0
  12. simplibs/object/_core/logic/constant_methods/validations/__init__.py +22 -0
  13. simplibs/object/_core/logic/constant_methods/validations/_extract_clean_code_lines.py +86 -0
  14. simplibs/object/_core/logic/constant_methods/validations/raise_missing_value_error.py +71 -0
  15. simplibs/object/_core/logic/constant_methods/validations/raise_type_error.py +59 -0
  16. simplibs/object/_core/logic/constant_methods/validations/raise_unexpected_validation_error.py +66 -0
  17. simplibs/object/_core/logic/constant_methods/validations/raise_validation_error.py +78 -0
  18. simplibs/object/_core/logic/object_methods/__init__.py +18 -0
  19. simplibs/object/_core/logic/object_methods/_process_calculate_value_params.py +108 -0
  20. simplibs/object/_core/logic/object_methods/calculate_value.py +81 -0
  21. simplibs/object/_core/logic/object_methods/decompose_value.py +91 -0
  22. simplibs/object/_core/logic/object_methods/validations/__init__.py +22 -0
  23. simplibs/object/_core/logic/object_methods/validations/raise_class_not_decomposeable.py +82 -0
  24. simplibs/object/_core/logic/object_methods/validations/raise_duplicate_argument_error.py +77 -0
  25. simplibs/object/_core/logic/object_methods/validations/raise_too_many_positional_args_error.py +81 -0
  26. simplibs/object/_core/logic/object_methods/validations/raise_unknown_parameter_error.py +77 -0
  27. simplibs/object/_core/logic/property_builders/__init__.py +20 -0
  28. simplibs/object/_core/logic/property_builders/create_instance_property.py +66 -0
  29. simplibs/object/_core/logic/property_builders/create_properties_for_inner.py +97 -0
  30. simplibs/object/_core/logic/property_builders/create_value_property.py +98 -0
  31. simplibs/object/_core/logic/property_builders/value_helpers/__init__.py +18 -0
  32. simplibs/object/_core/logic/property_builders/value_helpers/create_value_getter.py +52 -0
  33. simplibs/object/_core/logic/property_builders/value_helpers/create_value_setter.py +95 -0
  34. simplibs/object/_core/logic/property_builders/value_helpers/validations/__init__.py +16 -0
  35. simplibs/object/_core/logic/property_builders/value_helpers/validations/raise_locked_value_error.py +103 -0
  36. simplibs/object/_core/metadata/SimpleBaseMetadata.py +139 -0
  37. simplibs/object/_core/metadata/SimpleConstantMetadata.py +108 -0
  38. simplibs/object/_core/metadata/SimpleMeta.py +214 -0
  39. simplibs/object/_core/metadata/SimpleObjectMetadata.py +165 -0
  40. simplibs/object/_core/metadata/__init__.py +16 -0
  41. simplibs/object/_core/metadata/constants/BASE_CLASS_NAMES.py +23 -0
  42. simplibs/object/_core/metadata/constants/__init__.py +16 -0
  43. simplibs/object/_core/metadata/init_processors/__init__.py +47 -0
  44. simplibs/object/_core/metadata/init_processors/blueprint_path/__init__.py +15 -0
  45. simplibs/object/_core/metadata/init_processors/blueprint_path/calculate_blueprint_path.py +81 -0
  46. simplibs/object/_core/metadata/init_processors/default/__init__.py +17 -0
  47. simplibs/object/_core/metadata/init_processors/default/process_default_for_constant.py +71 -0
  48. simplibs/object/_core/metadata/init_processors/default/validations/__init__.py +19 -0
  49. simplibs/object/_core/metadata/init_processors/default/validations/_exception_info_for_default.py +66 -0
  50. simplibs/object/_core/metadata/init_processors/default/validations/raise_default_is_defined_in_composition.py +78 -0
  51. simplibs/object/_core/metadata/init_processors/default/validations/validate_default_is_defined.py +77 -0
  52. simplibs/object/_core/metadata/init_processors/default/validations/validate_default_matches_annotation.py +93 -0
  53. simplibs/object/_core/metadata/init_processors/inners/__init__.py +15 -0
  54. simplibs/object/_core/metadata/init_processors/inners/process_inners.py +143 -0
  55. simplibs/object/_core/metadata/init_processors/inners/validations/__init__.py +33 -0
  56. simplibs/object/_core/metadata/init_processors/inners/validations/_exception_info_for_inners.py +43 -0
  57. simplibs/object/_core/metadata/init_processors/inners/validations/_get_collision_path.py +45 -0
  58. simplibs/object/_core/metadata/init_processors/inners/validations/validate_collision_within_inners.py +78 -0
  59. simplibs/object/_core/metadata/init_processors/inners/validations/validate_if_collision_with_owner_class.py +66 -0
  60. simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_class.py +58 -0
  61. simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_not_simple_class.py +60 -0
  62. simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_simple_subclass.py +61 -0
  63. simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_defined.py +56 -0
  64. simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_not_empty.py +57 -0
  65. simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_tuple.py +57 -0
  66. simplibs/object/_core/metadata/init_processors/methods/__init__.py +15 -0
  67. simplibs/object/_core/metadata/init_processors/methods/process_classmethod.py +130 -0
  68. simplibs/object/_core/metadata/init_processors/methods/verifiers/__init__.py +16 -0
  69. simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/__init__.py +17 -0
  70. simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/exception_info_for_classmethod.py +52 -0
  71. simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/expected_structure_for_classmethod.py +80 -0
  72. simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/__init__.py +15 -0
  73. simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/__init__.py +19 -0
  74. simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/_convert_annotation_to_type_set.py +38 -0
  75. simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_annotations.py +84 -0
  76. simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_args_defaults.py +76 -0
  77. simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_kwargs_defaults.py +74 -0
  78. simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/verify_annotations_and_defaults.py +100 -0
  79. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/__init__.py +15 -0
  80. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/__init__.py +15 -0
  81. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/__init__.py +19 -0
  82. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/raise_decompose_unvalide_outcome_length.py +64 -0
  83. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_type.py +77 -0
  84. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_value.py +72 -0
  85. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/verify_decompose_outcome.py +87 -0
  86. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/__init__.py +17 -0
  87. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_raised_exceptions.py +56 -0
  88. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_return_unvalide_outcome_type.py +80 -0
  89. simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/verify_calculation.py +89 -0
  90. simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/__init__.py +15 -0
  91. simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/_clone_classmethod.py +81 -0
  92. simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/__init__.py +19 -0
  93. simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_callable.py +60 -0
  94. simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_classmethod.py +60 -0
  95. simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_defined.py +67 -0
  96. simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/verify_classmethod.py +117 -0
  97. simplibs/object/_core/metadata/init_processors/methods/verifiers/params/__init__.py +15 -0
  98. simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/__init__.py +19 -0
  99. simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_has_exact_args_count.py +59 -0
  100. simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_not_use_param_placeholders.py +66 -0
  101. simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_param_match_expected.py +61 -0
  102. simplibs/object/_core/metadata/init_processors/methods/verifiers/params/verify_params.py +123 -0
  103. simplibs/object/_core/metadata/init_processors/names/__init__.py +15 -0
  104. simplibs/object/_core/metadata/init_processors/names/_class_name_splitter.py +242 -0
  105. simplibs/object/_core/metadata/init_processors/names/create_names.py +119 -0
  106. simplibs/object/_core/metadata/init_processors/names/validations/__init__.py +19 -0
  107. simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_has_no_underscores.py +94 -0
  108. simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_ascii.py +95 -0
  109. simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_identifier.py +83 -0
  110. simplibs/object/_core/metadata/init_processors/type/__init__.py +15 -0
  111. simplibs/object/_core/metadata/init_processors/type/process_type.py +117 -0
  112. simplibs/object/_core/metadata/init_processors/type/validations/__init__.py +29 -0
  113. simplibs/object/_core/metadata/init_processors/type/validations/_exception_info_for_type.py +88 -0
  114. simplibs/object/_core/metadata/init_processors/type/validations/raise_union_type_contain_none.py +70 -0
  115. simplibs/object/_core/metadata/init_processors/type/validations/raise_validate_type_is_not_valid.py +92 -0
  116. simplibs/object/_core/metadata/init_processors/type/validations/validate_type_from_tuple_is_not_none.py +94 -0
  117. simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_defined.py +85 -0
  118. simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_empty.py +93 -0
  119. simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_none.py +87 -0
  120. simplibs/object/_core/metadata/init_processors/type/validations/validate_type_tuple_is_not_nested.py +92 -0
  121. simplibs/object/_core/metadata/instance_builders/__init__.py +55 -0
  122. simplibs/object/_core/metadata/instance_builders/atom_class/InstanceBase.py +77 -0
  123. simplibs/object/_core/metadata/instance_builders/atom_class/__init__.py +16 -0
  124. simplibs/object/_core/metadata/instance_builders/atom_class/helpers/__init__.py +16 -0
  125. simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_atom_init.py +51 -0
  126. simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_root_value_setter.py +67 -0
  127. simplibs/object/_core/metadata/instance_builders/atom_class/make_atom_class.py +101 -0
  128. simplibs/object/_core/metadata/instance_builders/composite_class/__init__.py +14 -0
  129. simplibs/object/_core/metadata/instance_builders/composite_class/helpers/__init__.py +20 -0
  130. simplibs/object/_core/metadata/instance_builders/composite_class/helpers/_get_inner_instance_class.py +51 -0
  131. simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_composite_init.py +74 -0
  132. simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_properties_for_inners.py +50 -0
  133. simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_inners.py +57 -0
  134. simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_self.py +69 -0
  135. simplibs/object/_core/metadata/instance_builders/composite_class/make_composite_class.py +93 -0
  136. simplibs/object/_core/metadata/instance_builders/instance/__init__.py +17 -0
  137. simplibs/object/_core/metadata/instance_builders/instance/create_instance.py +107 -0
  138. simplibs/object/_core/metadata/instance_builders/instance/helpers/__init__.py +25 -0
  139. simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_combined_init_mixins.py +40 -0
  140. simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_instance_class_dict.py +127 -0
  141. simplibs/object/_core/metadata/instance_builders/instance/helpers/_extend_instance_class.py +59 -0
  142. simplibs/object/_core/metadata/instance_builders/instance/helpers/_resolve_flat_mixins.py +74 -0
  143. simplibs/object/_core/metadata/instance_builders/instance/helpers/_verify_mixin_compatibility.py +83 -0
  144. simplibs/object/_core/metadata/instance_builders/instance/helpers/create_instance_class.py +76 -0
  145. simplibs/object/_core/metadata/instance_builders/instance/helpers/get_base_class.py +53 -0
  146. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/__init__.py +20 -0
  147. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/__init__.py +29 -0
  148. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_composite.py +61 -0
  149. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_constant.py +61 -0
  150. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_immutable.py +61 -0
  151. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_mutable.py +60 -0
  152. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_support_default_value_type.py +66 -0
  153. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_class.py +56 -0
  154. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_simple_base_subclass.py +60 -0
  155. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_invalide_extend_instance_class_definition.py +62 -0
  156. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision.py +56 -0
  157. simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision_with_base_class.py +56 -0
  158. simplibs/object/_core/metadata/instance_builders/instance/validations/__init__.py +21 -0
  159. simplibs/object/_core/metadata/instance_builders/instance/validations/validate_class_is_not_base_class.py +54 -0
  160. simplibs/object/_core/metadata/instance_builders/instance/validations/validate_hashing_for_immutable_value.py +66 -0
  161. simplibs/object/_core/metadata/instance_builders/instance/validations/validate_param_is_bool.py +47 -0
  162. simplibs/object/_core/metadata/validations/__init__.py +18 -0
  163. simplibs/object/_core/metadata/validations/raise_attribut_allready_set.py +57 -0
  164. simplibs/object/_core/metadata/validations/raise_metadata_is_immutable.py +73 -0
  165. simplibs/object/_core/protocols/__init__.py +118 -0
  166. simplibs/object/_core/protocols/alias_typings/__init__.py +137 -0
  167. simplibs/object/_core/protocols/alias_typings/changes/ChangeTuple.py +5 -0
  168. simplibs/object/_core/protocols/alias_typings/changes/ChangesDict.py +5 -0
  169. simplibs/object/_core/protocols/alias_typings/changes/ChangesTuple.py +8 -0
  170. simplibs/object/_core/protocols/alias_typings/changes/__init__.py +18 -0
  171. simplibs/object/_core/protocols/alias_typings/history/HistoryDict.py +5 -0
  172. simplibs/object/_core/protocols/alias_typings/history/HistoryEntry.py +10 -0
  173. simplibs/object/_core/protocols/alias_typings/history/__init__.py +16 -0
  174. simplibs/object/_core/protocols/alias_typings/inners/InnersMap.py +8 -0
  175. simplibs/object/_core/protocols/alias_typings/inners/InnersTuple.py +8 -0
  176. simplibs/object/_core/protocols/alias_typings/inners/__init__.py +16 -0
  177. simplibs/object/_core/protocols/alias_typings/mixins/MixinsTuple.py +8 -0
  178. simplibs/object/_core/protocols/alias_typings/mixins/__init__.py +14 -0
  179. simplibs/object/_core/protocols/alias_typings/names/NamesSet.py +5 -0
  180. simplibs/object/_core/protocols/alias_typings/names/NamesTuple.py +5 -0
  181. simplibs/object/_core/protocols/alias_typings/names/__init__.py +16 -0
  182. simplibs/object/_core/protocols/alias_typings/nodes/NodeItem.py +9 -0
  183. simplibs/object/_core/protocols/alias_typings/nodes/NodesDict.py +9 -0
  184. simplibs/object/_core/protocols/alias_typings/nodes/NodesIndexMap.py +6 -0
  185. simplibs/object/_core/protocols/alias_typings/nodes/NodesInstanceDict.py +9 -0
  186. simplibs/object/_core/protocols/alias_typings/nodes/NodesPathDict.py +9 -0
  187. simplibs/object/_core/protocols/alias_typings/nodes/NodesTuple.py +8 -0
  188. simplibs/object/_core/protocols/alias_typings/nodes/__init__.py +24 -0
  189. simplibs/object/_core/protocols/alias_typings/paths/PathDict.py +8 -0
  190. simplibs/object/_core/protocols/alias_typings/paths/PathTuple.py +5 -0
  191. simplibs/object/_core/protocols/alias_typings/paths/__init__.py +16 -0
  192. simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDict.py +5 -0
  193. simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffItem.py +5 -0
  194. simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffTuple.py +8 -0
  195. simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotTuple.py +5 -0
  196. simplibs/object/_core/protocols/alias_typings/snapshots/__init__.py +20 -0
  197. simplibs/object/_core/protocols/alias_typings/state/StateDict.py +5 -0
  198. simplibs/object/_core/protocols/alias_typings/state/__init__.py +14 -0
  199. simplibs/object/_core/protocols/alias_typings/types/ValidTypes.py +6 -0
  200. simplibs/object/_core/protocols/alias_typings/types/__init__.py +14 -0
  201. simplibs/object/_core/protocols/classes/SimpleBaseProtocol.py +25 -0
  202. simplibs/object/_core/protocols/classes/SimpleConstantProtocol.py +54 -0
  203. simplibs/object/_core/protocols/classes/SimpleObjectProtocol.py +50 -0
  204. simplibs/object/_core/protocols/classes/__init__.py +26 -0
  205. simplibs/object/_core/protocols/instance/SimpleConstantInstanceProtocol.py +13 -0
  206. simplibs/object/_core/protocols/instance/SimpleInstanceBaseProtocol.py +24 -0
  207. simplibs/object/_core/protocols/instance/SimpleObjectInstanceProtocol.py +13 -0
  208. simplibs/object/_core/protocols/instance/__init__.py +29 -0
  209. simplibs/object/_core/protocols/instance/core_classes/AtomInstanceProtocol.py +46 -0
  210. simplibs/object/_core/protocols/instance/core_classes/CompositeInstanceProtocol.py +37 -0
  211. simplibs/object/_core/protocols/instance/core_classes/InstanceBaseProtocol.py +28 -0
  212. simplibs/object/_core/protocols/instance/core_classes/__init__.py +19 -0
  213. simplibs/object/_core/protocols/metadata/SimpleBaseMetadataProtocol.py +37 -0
  214. simplibs/object/_core/protocols/metadata/SimpleConstantMetadataProtocol.py +45 -0
  215. simplibs/object/_core/protocols/metadata/SimpleMetaProtocol.py +39 -0
  216. simplibs/object/_core/protocols/metadata/SimpleObjectMetadataProtocol.py +49 -0
  217. simplibs/object/_core/protocols/metadata/__init__.py +28 -0
  218. simplibs/object/_core/protocols/methods/ClassMethodProtocol.py +29 -0
  219. simplibs/object/_core/protocols/methods/LogicSignature.py +20 -0
  220. simplibs/object/_core/protocols/methods/__init__.py +18 -0
  221. simplibs/object/_core/protocols/mixins/__init__.py +120 -0
  222. simplibs/object/_core/protocols/mixins/base_class/SimpleMixinProtocol.py +46 -0
  223. simplibs/object/_core/protocols/mixins/base_class/__init__.py +18 -0
  224. simplibs/object/_core/protocols/mixins/core_mixins/InfrastructureProtocol.py +16 -0
  225. simplibs/object/_core/protocols/mixins/core_mixins/NodesDictsProtocol.py +38 -0
  226. simplibs/object/_core/protocols/mixins/core_mixins/NodesTupleProtocol.py +30 -0
  227. simplibs/object/_core/protocols/mixins/core_mixins/SerializationProtocol.py +55 -0
  228. simplibs/object/_core/protocols/mixins/core_mixins/SnapshotProtocol.py +42 -0
  229. simplibs/object/_core/protocols/mixins/core_mixins/__init__.py +27 -0
  230. simplibs/object/_core/protocols/mixins/dunders/__init__.py +123 -0
  231. simplibs/object/_core/protocols/mixins/dunders/collections/CollectionBaseProtocol.py +37 -0
  232. simplibs/object/_core/protocols/mixins/dunders/collections/CollectionProtocol.py +20 -0
  233. simplibs/object/_core/protocols/mixins/dunders/collections/IterableProtocol.py +37 -0
  234. simplibs/object/_core/protocols/mixins/dunders/collections/MappingProtocol.py +52 -0
  235. simplibs/object/_core/protocols/mixins/dunders/collections/__init__.py +21 -0
  236. simplibs/object/_core/protocols/mixins/dunders/comparison/EqualityProtocol.py +31 -0
  237. simplibs/object/_core/protocols/mixins/dunders/comparison/OrderingProtocol.py +32 -0
  238. simplibs/object/_core/protocols/mixins/dunders/comparison/__init__.py +16 -0
  239. simplibs/object/_core/protocols/mixins/dunders/generics/ClassGetItemProtocol.py +23 -0
  240. simplibs/object/_core/protocols/mixins/dunders/generics/__init__.py +14 -0
  241. simplibs/object/_core/protocols/mixins/dunders/interfaces/CallProtocol.py +26 -0
  242. simplibs/object/_core/protocols/mixins/dunders/interfaces/ContextProtocol.py +38 -0
  243. simplibs/object/_core/protocols/mixins/dunders/interfaces/__init__.py +16 -0
  244. simplibs/object/_core/protocols/mixins/dunders/lifecycles/CopyableProtocol.py +33 -0
  245. simplibs/object/_core/protocols/mixins/dunders/lifecycles/LifecycleProtocol.py +21 -0
  246. simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleReduceProtocol.py +30 -0
  247. simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleStateProtocol.py +42 -0
  248. simplibs/object/_core/protocols/mixins/dunders/lifecycles/__init__.py +20 -0
  249. simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/PicklePlan.py +5 -0
  250. simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/__init__.py +14 -0
  251. simplibs/object/_core/protocols/mixins/dunders/numeric/ArithmeticProtocol.py +95 -0
  252. simplibs/object/_core/protocols/mixins/dunders/numeric/BitwiseProtocol.py +79 -0
  253. simplibs/object/_core/protocols/mixins/dunders/numeric/ConversionProtocol.py +57 -0
  254. simplibs/object/_core/protocols/mixins/dunders/numeric/InplaceProtocol.py +66 -0
  255. simplibs/object/_core/protocols/mixins/dunders/numeric/UnaryProtocol.py +35 -0
  256. simplibs/object/_core/protocols/mixins/dunders/numeric/__init__.py +22 -0
  257. simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/Operator.py +5 -0
  258. simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/UnaryOperator.py +5 -0
  259. simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/__init__.py +16 -0
  260. simplibs/object/_core/protocols/mixins/dunders/representation/ValueDisplayProtocol.py +30 -0
  261. simplibs/object/_core/protocols/mixins/dunders/representation/ValueFormattingProtocol.py +42 -0
  262. simplibs/object/_core/protocols/mixins/dunders/representation/__init__.py +16 -0
  263. simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsProtocol.py +69 -0
  264. simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsWithInnersProtocol.py +27 -0
  265. simplibs/object/_core/protocols/mixins/immutable/__init__.py +18 -0
  266. simplibs/object/_core/protocols/mixins/numerical/EqualizerProtocol.py +37 -0
  267. simplibs/object/_core/protocols/mixins/numerical/VolumeProtocol.py +32 -0
  268. simplibs/object/_core/protocols/mixins/numerical/__init__.py +17 -0
  269. simplibs/object/_core/protocols/mixins/numerical/internal_types/SteppersMap.py +8 -0
  270. simplibs/object/_core/protocols/mixins/numerical/internal_types/__init__.py +14 -0
  271. simplibs/object/_core/protocols/mixins/numerical/stepper/StepperProtocol.py +95 -0
  272. simplibs/object/_core/protocols/mixins/numerical/stepper/__init__.py +14 -0
  273. simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/LimitAction.py +5 -0
  274. simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/StepValue.py +6 -0
  275. simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/__init__.py +16 -0
  276. simplibs/object/_core/protocols/mixins/properties/InnersPropertyProtocol.py +31 -0
  277. simplibs/object/_core/protocols/mixins/properties/MetaShortcutsProtocol.py +49 -0
  278. simplibs/object/_core/protocols/mixins/properties/__init__.py +17 -0
  279. simplibs/object/_core/protocols/mixins/state/DefaultStateProtocol.py +41 -0
  280. simplibs/object/_core/protocols/mixins/state/DirtyTrackingProtocol.py +61 -0
  281. simplibs/object/_core/protocols/mixins/state/HistoryProtocol.py +112 -0
  282. simplibs/object/_core/protocols/mixins/state/PermissionProtocol.py +35 -0
  283. simplibs/object/_core/protocols/mixins/state/__init__.py +22 -0
  284. simplibs/object/exceptions/SimpleDefinitionError.py +45 -0
  285. simplibs/object/exceptions/SimpleInitializationError.py +43 -0
  286. simplibs/object/exceptions/SimpleRuntimeError.py +50 -0
  287. simplibs/object/exceptions/__init__.py +62 -0
  288. simplibs/object/exceptions/base_exception/SimpleObjectError.py +107 -0
  289. simplibs/object/exceptions/base_exception/__init__.py +19 -0
  290. simplibs/object/mixins/__init__.py +99 -0
  291. simplibs/object/mixins/_common_logic/__init__.py +41 -0
  292. simplibs/object/mixins/_common_logic/constants/__init__.py +27 -0
  293. simplibs/object/mixins/_common_logic/constants/names/HISTORY.py +14 -0
  294. simplibs/object/mixins/_common_logic/constants/names/OWNER_CLASS.py +14 -0
  295. simplibs/object/mixins/_common_logic/constants/names/STEPPER.py +14 -0
  296. simplibs/object/mixins/_common_logic/constants/names/VALUE.py +14 -0
  297. simplibs/object/mixins/_common_logic/constants/names/__init__.py +28 -0
  298. simplibs/object/mixins/_common_logic/constants/sets/FORBIDDEN_NAMES.py +27 -0
  299. simplibs/object/mixins/_common_logic/constants/sets/RESTRICTION_FLAGS.py +18 -0
  300. simplibs/object/mixins/_common_logic/constants/sets/__init__.py +22 -0
  301. simplibs/object/mixins/_common_logic/immutability/__init__.py +28 -0
  302. simplibs/object/mixins/_common_logic/immutability/with_any/__init__.py +17 -0
  303. simplibs/object/mixins/_common_logic/immutability/with_any/utils/__init__.py +22 -0
  304. simplibs/object/mixins/_common_logic/immutability/with_any/utils/get_top_composite_paths.py +142 -0
  305. simplibs/object/mixins/_common_logic/immutability/with_any/utils/process_single_change.py +143 -0
  306. simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_changes.py +142 -0
  307. simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths.py +147 -0
  308. simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths2.py +142 -0
  309. simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/__init__.py +23 -0
  310. simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_split_changes_unknown_name.py +107 -0
  311. simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_with_any_unknown_name.py +71 -0
  312. simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/__init__.py +24 -0
  313. simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_changes_is_not_tuple.py +65 -0
  314. simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_child_composite_mismatch.py +68 -0
  315. simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_contained_constant_mismatch.py +67 -0
  316. simplibs/object/mixins/_common_logic/immutability/with_any/with_any.py +238 -0
  317. simplibs/object/mixins/_common_logic/immutability/with_composite/__init__.py +17 -0
  318. simplibs/object/mixins/_common_logic/immutability/with_composite/utils/__init__.py +15 -0
  319. simplibs/object/mixins/_common_logic/immutability/with_composite/utils/reacalculate_inners.py +112 -0
  320. simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/__init__.py +21 -0
  321. simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_is_decomposeable.py +71 -0
  322. simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_name_exists.py +71 -0
  323. simplibs/object/mixins/_common_logic/immutability/with_composite/with_composite.py +176 -0
  324. simplibs/object/mixins/_common_logic/immutability/with_constant/__init__.py +17 -0
  325. simplibs/object/mixins/_common_logic/immutability/with_constant/utils/__init__.py +20 -0
  326. simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_new_instance.py +130 -0
  327. simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_snapshot_dict.py +83 -0
  328. simplibs/object/mixins/_common_logic/immutability/with_constant/utils/reacalculate_owner_value.py +131 -0
  329. simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/__init__.py +16 -0
  330. simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/raise_immutability_constant_not_found.py +93 -0
  331. simplibs/object/mixins/_common_logic/immutability/with_constant/with_constant.py +147 -0
  332. simplibs/object/mixins/_common_logic/immutability/with_constants/__init__.py +17 -0
  333. simplibs/object/mixins/_common_logic/immutability/with_constants/utils/__init__.py +15 -0
  334. simplibs/object/mixins/_common_logic/immutability/with_constants/utils/find_longest_keys.py +112 -0
  335. simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/__init__.py +25 -0
  336. simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_batch_constant_not_found.py +94 -0
  337. simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_constants_changes_not_tuple.py +94 -0
  338. simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_has_length_two.py +91 -0
  339. simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_is_tuple.py +99 -0
  340. simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_name_is_str.py +90 -0
  341. simplibs/object/mixins/_common_logic/immutability/with_constants/with_constants.py +193 -0
  342. simplibs/object/mixins/base_class/SimpleMixin.py +118 -0
  343. simplibs/object/mixins/base_class/__init__.py +17 -0
  344. simplibs/object/mixins/base_class/_meta/SimpleMixinMeta.py +59 -0
  345. simplibs/object/mixins/base_class/_meta/__init__.py +21 -0
  346. simplibs/object/mixins/base_class/_meta/_verify_mixin_definition.py +161 -0
  347. simplibs/object/mixins/base_class/_meta/validations/__init__.py +34 -0
  348. simplibs/object/mixins/base_class/_meta/validations/raise_mixin_dict_contains_forbidden_attributes.py +101 -0
  349. simplibs/object/mixins/base_class/_meta/validations/raise_mixin_flag_is_not_bool.py +122 -0
  350. simplibs/object/mixins/base_class/_meta/validations/raise_mixin_init_mixins_contains_super_call.py +75 -0
  351. simplibs/object/mixins/base_class/_meta/validations/raise_mixin_only_types_invalid.py +107 -0
  352. simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contain_unvalid_type.py +85 -0
  353. simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contains_forbidden_slot_names.py +102 -0
  354. simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_is_not_defined.py +79 -0
  355. simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_unsuport_type.py +88 -0
  356. simplibs/object/mixins/core_mixins/Infrastructure.py +49 -0
  357. simplibs/object/mixins/core_mixins/NodesDicts.py +104 -0
  358. simplibs/object/mixins/core_mixins/NodesTuple.py +86 -0
  359. simplibs/object/mixins/core_mixins/Serialization.py +120 -0
  360. simplibs/object/mixins/core_mixins/Snapshot.py +104 -0
  361. simplibs/object/mixins/core_mixins/__init__.py +32 -0
  362. simplibs/object/mixins/core_mixins/_utils/__init__.py +49 -0
  363. simplibs/object/mixins/core_mixins/_utils/nodes_tuple/__init__.py +17 -0
  364. simplibs/object/mixins/core_mixins/_utils/nodes_tuple/_collect_nodes_data.py +131 -0
  365. simplibs/object/mixins/core_mixins/_utils/nodes_tuple/build_nodes_tuple.py +104 -0
  366. simplibs/object/mixins/core_mixins/_utils/serialization/__init__.py +20 -0
  367. simplibs/object/mixins/core_mixins/_utils/serialization/from_dict.py +190 -0
  368. simplibs/object/mixins/core_mixins/_utils/serialization/from_dict_constants.py +151 -0
  369. simplibs/object/mixins/core_mixins/_utils/serialization/to_dict.py +158 -0
  370. simplibs/object/mixins/core_mixins/_utils/serialization/validations/__init__.py +30 -0
  371. simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_invalid_composite_structure.py +65 -0
  372. simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_composite_key.py +64 -0
  373. simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_value_key.py +66 -0
  374. simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_owner_class_mismatch_for_state_dict.py +77 -0
  375. simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_state_dict_input.py +67 -0
  376. simplibs/object/mixins/core_mixins/_utils/snapshot/__init__.py +15 -0
  377. simplibs/object/mixins/core_mixins/_utils/snapshot/compare_snapshots.py +102 -0
  378. simplibs/object/mixins/core_mixins/_utils/snapshot/validations/__init__.py +16 -0
  379. simplibs/object/mixins/core_mixins/_utils/snapshot/validations/raise_snapshot_incompatible_error.py +101 -0
  380. simplibs/object/mixins/dunders/__init__.py +61 -0
  381. simplibs/object/mixins/dunders/collections/CollectionBase.py +129 -0
  382. simplibs/object/mixins/dunders/collections/Iterable.py +81 -0
  383. simplibs/object/mixins/dunders/collections/Mapping.py +131 -0
  384. simplibs/object/mixins/dunders/collections/__init__.py +29 -0
  385. simplibs/object/mixins/dunders/collections/main/Collection.py +47 -0
  386. simplibs/object/mixins/dunders/collections/main/__init__.py +20 -0
  387. simplibs/object/mixins/dunders/comparison/Equality.py +128 -0
  388. simplibs/object/mixins/dunders/comparison/Ordering.py +130 -0
  389. simplibs/object/mixins/dunders/comparison/__init__.py +25 -0
  390. simplibs/object/mixins/dunders/generics/ClassGetItem.py +105 -0
  391. simplibs/object/mixins/dunders/generics/__init__.py +20 -0
  392. simplibs/object/mixins/dunders/interfaces/Call.py +101 -0
  393. simplibs/object/mixins/dunders/interfaces/Context.py +100 -0
  394. simplibs/object/mixins/dunders/interfaces/__init__.py +23 -0
  395. simplibs/object/mixins/dunders/lifecycles/Copyable.py +103 -0
  396. simplibs/object/mixins/dunders/lifecycles/PickleReduce.py +88 -0
  397. simplibs/object/mixins/dunders/lifecycles/PickleState.py +104 -0
  398. simplibs/object/mixins/dunders/lifecycles/__init__.py +29 -0
  399. simplibs/object/mixins/dunders/lifecycles/_utils/__init__.py +20 -0
  400. simplibs/object/mixins/dunders/lifecycles/_utils/rebuild_simple_instance.py +51 -0
  401. simplibs/object/mixins/dunders/lifecycles/main/Lifecycle.py +45 -0
  402. simplibs/object/mixins/dunders/lifecycles/main/__init__.py +20 -0
  403. simplibs/object/mixins/dunders/numeric/Arithmetic.py +195 -0
  404. simplibs/object/mixins/dunders/numeric/Bitwise.py +172 -0
  405. simplibs/object/mixins/dunders/numeric/Conversion.py +149 -0
  406. simplibs/object/mixins/dunders/numeric/Inplace.py +124 -0
  407. simplibs/object/mixins/dunders/numeric/Unary.py +89 -0
  408. simplibs/object/mixins/dunders/numeric/__init__.py +31 -0
  409. simplibs/object/mixins/dunders/numeric/_utils/__init__.py +41 -0
  410. simplibs/object/mixins/dunders/numeric/_utils/_align_operand_type.py +111 -0
  411. simplibs/object/mixins/dunders/numeric/_utils/execute_arithmetic_op.py +157 -0
  412. simplibs/object/mixins/dunders/numeric/_utils/execute_bitwise_op.py +116 -0
  413. simplibs/object/mixins/dunders/numeric/_utils/execute_conversion.py +107 -0
  414. simplibs/object/mixins/dunders/numeric/_utils/execute_inplace_op.py +139 -0
  415. simplibs/object/mixins/dunders/numeric/_utils/execute_unary_op.py +121 -0
  416. simplibs/object/mixins/dunders/representation/ValueDisplay.py +96 -0
  417. simplibs/object/mixins/dunders/representation/ValueFormatting.py +144 -0
  418. simplibs/object/mixins/dunders/representation/__init__.py +24 -0
  419. simplibs/object/mixins/others/__init__.py +48 -0
  420. simplibs/object/mixins/others/immutable/ImmutableMethods.py +142 -0
  421. simplibs/object/mixins/others/immutable/ImmutableMethodsWithInners.py +111 -0
  422. simplibs/object/mixins/others/immutable/__init__.py +24 -0
  423. simplibs/object/mixins/others/immutable/_validations/__init__.py +19 -0
  424. simplibs/object/mixins/others/immutable/_validations/raise_with_changes_input_not_dict.py +60 -0
  425. simplibs/object/mixins/others/numerical/Equalizer.py +129 -0
  426. simplibs/object/mixins/others/numerical/Volume.py +100 -0
  427. simplibs/object/mixins/others/numerical/__init__.py +25 -0
  428. simplibs/object/mixins/others/numerical/_stepper_class/Stepper.py +227 -0
  429. simplibs/object/mixins/others/numerical/_stepper_class/__init__.py +31 -0
  430. simplibs/object/mixins/others/numerical/_stepper_class/methods/__init__.py +35 -0
  431. simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/__init__.py +33 -0
  432. simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/process_step_value.py +114 -0
  433. simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/__init__.py +29 -0
  434. simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_down_limit_reached.py +115 -0
  435. simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_up_limit_reached.py +110 -0
  436. simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_down_limit.py +141 -0
  437. simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_up_limit.py +141 -0
  438. simplibs/object/mixins/others/numerical/_stepper_class/methods/set_value.py +163 -0
  439. simplibs/object/mixins/others/numerical/_stepper_class/methods/step_down.py +154 -0
  440. simplibs/object/mixins/others/numerical/_stepper_class/methods/step_up.py +154 -0
  441. simplibs/object/mixins/others/numerical/_stepper_class/processors/__init__.py +38 -0
  442. simplibs/object/mixins/others/numerical/_stepper_class/processors/process_down_limit_value.py +143 -0
  443. simplibs/object/mixins/others/numerical/_stepper_class/processors/process_limit_action.py +118 -0
  444. simplibs/object/mixins/others/numerical/_stepper_class/processors/process_up_limit_value.py +143 -0
  445. simplibs/object/mixins/others/numerical/_stepper_class/processors/process_value.py +142 -0
  446. simplibs/object/mixins/others/numerical/_stepper_class/processors/validate_instance.py +138 -0
  447. simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/__init__.py +39 -0
  448. simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_action.py +118 -0
  449. simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_down_limit.py +125 -0
  450. simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_instance.py +117 -0
  451. simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_up_limit.py +125 -0
  452. simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_non_numeric_value.py +122 -0
  453. simplibs/object/mixins/others/properties/InnersProperty.py +91 -0
  454. simplibs/object/mixins/others/properties/MetaShortcuts.py +113 -0
  455. simplibs/object/mixins/others/properties/__init__.py +24 -0
  456. simplibs/object/mixins/others/properties/_inners_property_utils/__init__.py +23 -0
  457. simplibs/object/mixins/others/properties/_inners_property_utils/_collect_nested_inner_properties.py +134 -0
  458. simplibs/object/mixins/others/properties/_inners_property_utils/collect_all_nested_properties.py +132 -0
  459. simplibs/object/mixins/others/state/DefaultState.py +119 -0
  460. simplibs/object/mixins/others/state/DirtyTracking.py +144 -0
  461. simplibs/object/mixins/others/state/History.py +248 -0
  462. simplibs/object/mixins/others/state/Permission.py +102 -0
  463. simplibs/object/mixins/others/state/__init__.py +31 -0
  464. simplibs/object/mixins/others/state/_history_utils/__init__.py +50 -0
  465. simplibs/object/mixins/others/state/_history_utils/core/__init__.py +32 -0
  466. simplibs/object/mixins/others/state/_history_utils/core/find_snapshot.py +142 -0
  467. simplibs/object/mixins/others/state/_history_utils/core/record_state.py +130 -0
  468. simplibs/object/mixins/others/state/_history_utils/core/set_history_limit.py +114 -0
  469. simplibs/object/mixins/others/state/_history_utils/core/validations/__init__.py +31 -0
  470. simplibs/object/mixins/others/state/_history_utils/core/validations/raise_history_limit_not_positive_integer.py +65 -0
  471. simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snapshot_index.py +67 -0
  472. simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_reference.py +67 -0
  473. simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_timestamp.py +66 -0
  474. simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_timestamp.py +63 -0
  475. simplibs/object/mixins/others/state/_history_utils/navigations/__init__.py +38 -0
  476. simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_index.py +103 -0
  477. simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_timestamp.py +115 -0
  478. simplibs/object/mixins/others/state/_history_utils/navigations/go_to_last_history.py +103 -0
  479. simplibs/object/mixins/others/state/_history_utils/navigations/history_redo.py +103 -0
  480. simplibs/object/mixins/others/state/_history_utils/navigations/history_undo.py +104 -0
  481. simplibs/object/mixins/others/state/_history_utils/transfer/__init__.py +31 -0
  482. simplibs/object/mixins/others/state/_history_utils/transfer/export_history_to_dict.py +110 -0
  483. simplibs/object/mixins/others/state/_history_utils/transfer/import_history_from_dict.py +169 -0
  484. simplibs/object/mixins/others/state/_history_utils/transfer/validations/__init__.py +24 -0
  485. simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_history_import_file.py +66 -0
  486. simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_owner_class_mismatch.py +69 -0
  487. simplibs/object/settings/__init__.py +90 -0
  488. simplibs/object/settings/logging.py +138 -0
  489. simplibs/object/testing/__init__.py +90 -0
  490. simplibs/object/testing/assert_simple_mixin.py +150 -0
  491. simplibs/object/testing/assert_simple_object.py +219 -0
  492. simplibs/object/testing/asserts/__init__.py +53 -0
  493. simplibs/object/testing/asserts/base/__init__.py +22 -0
  494. simplibs/object/testing/asserts/base/assert_class_inheritance.py +75 -0
  495. simplibs/object/testing/asserts/base/assert_instance_creation.py +119 -0
  496. simplibs/object/testing/asserts/base/assert_user_instance_creation.py +97 -0
  497. simplibs/object/testing/asserts/base/assert_value_change.py +142 -0
  498. simplibs/object/testing/asserts/methods/__init__.py +20 -0
  499. simplibs/object/testing/asserts/methods/assert_calculate_value_method.py +113 -0
  500. simplibs/object/testing/asserts/methods/assert_decompose_value_method.py +109 -0
  501. simplibs/object/testing/asserts/methods/assert_validate_method.py +111 -0
  502. simplibs/object/testing/asserts/mixins/__init__.py +22 -0
  503. simplibs/object/testing/asserts/mixins/assert_instance_hasattr.py +94 -0
  504. simplibs/object/testing/asserts/mixins/assert_mixin_inheritance.py +72 -0
  505. simplibs/object/testing/asserts/mixins/assert_mixin_instance_creation.py +142 -0
  506. simplibs/object/testing/asserts/mixins/assert_mixins_slots_values.py +126 -0
  507. simplibs/object/testing/asserts/mutability/__init__.py +18 -0
  508. simplibs/object/testing/asserts/mutability/assert_immutable_behavior.py +118 -0
  509. simplibs/object/testing/asserts/mutability/assert_mutable_behavior.py +108 -0
  510. simplibs/object/testing/asserts/reactivity/__init__.py +17 -0
  511. simplibs/object/testing/asserts/reactivity/assert_reactivity_downward.py +141 -0
  512. simplibs/object/testing/asserts/reactivity/assert_reactivity_upward.py +109 -0
  513. simplibs/object/testing/bulk_test.py +150 -0
  514. simplibs/object/testing/containers/InnerValue.py +102 -0
  515. simplibs/object/testing/containers/MixinCase.py +89 -0
  516. simplibs/object/testing/containers/ObjectCase.py +101 -0
  517. simplibs/object/testing/containers/TestMixin.py +122 -0
  518. simplibs/object/testing/containers/__init__.py +20 -0
  519. simplibs/object/testing/containers/_validations/__init__.py +18 -0
  520. simplibs/object/testing/containers/_validations/raise_inner_value_empty_path.py +39 -0
  521. simplibs/object/testing/containers/_validations/raise_inner_value_invalid_path_type.py +44 -0
  522. simplibs/object/tools/__init__.py +0 -0
  523. simplibs/object/tools/automate_creators/__init__.py +0 -0
  524. simplibs/object/tools/automate_creators/_helpers/__init__.py +5 -0
  525. simplibs/object/tools/automate_creators/_helpers/_is_lambda.py +34 -0
  526. simplibs/object/tools/automate_creators/_helpers/_validations/__init__.py +3 -0
  527. simplibs/object/tools/automate_creators/_helpers/_validations/raise_calculate_default_failed.py +51 -0
  528. simplibs/object/tools/automate_creators/_helpers/_validations/raise_inner_is_not_simple_constant_subclass.py +44 -0
  529. simplibs/object/tools/automate_creators/_helpers/_validations/raise_inners_is_not_tuple.py +41 -0
  530. simplibs/object/tools/automate_creators/_helpers/calculate_default.py +51 -0
  531. simplibs/object/tools/automate_creators/_helpers/load_parameters_from_inners.py +72 -0
  532. simplibs/object/tools/automate_creators/_helpers/process_decompose.py +47 -0
  533. simplibs/object/tools/automate_creators/_helpers/process_logic.py +57 -0
  534. simplibs/object/tools/automate_creators/_helpers/process_validate.py +48 -0
  535. simplibs/object/tools/automate_creators/_validations/__init__.py +7 -0
  536. simplibs/object/tools/automate_creators/_validations/validate_class_name_is_str.py +36 -0
  537. simplibs/object/tools/automate_creators/_validations/validate_composite_has_inners.py +43 -0
  538. simplibs/object/tools/automate_creators/_validations/validate_composite_has_logic.py +44 -0
  539. simplibs/object/tools/automate_creators/_validations/validate_composite_has_not_default.py +37 -0
  540. simplibs/object/tools/automate_creators/_validations/validate_constant_has_default.py +48 -0
  541. simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_decompose.py +37 -0
  542. simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_logic.py +37 -0
  543. simplibs/object/tools/automate_creators/bulk/BulkCase.py +100 -0
  544. simplibs/object/tools/automate_creators/bulk/__init__.py +0 -0
  545. simplibs/object/tools/automate_creators/bulk/create_simple_object_bulk.py +77 -0
  546. simplibs/object/tools/automate_creators/bulk/specific_bulks/__init__.py +0 -0
  547. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/__init__.py +8 -0
  548. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_csv_callable_not_supported.py +26 -0
  549. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_data_not_list.py +28 -0
  550. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_decode_failed.py +29 -0
  551. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_sequence.py +27 -0
  552. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_str.py +28 -0
  553. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_item_is_not_bulk_dict.py +39 -0
  554. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_table_row_not_sequence.py +26 -0
  555. simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_yaml_import_failed.py +22 -0
  556. simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_bulk_case_class.py +57 -0
  557. simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_csv.py +68 -0
  558. simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_dicts.py +19 -0
  559. simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_json.py +24 -0
  560. simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_table.py +43 -0
  561. simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_yaml.py +29 -0
  562. simplibs/object/tools/automate_creators/create_constant_class.py +84 -0
  563. simplibs/object/tools/automate_creators/create_object_class.py +110 -0
  564. simplibs/object/tools/automate_creators/create_simple_object.py +97 -0
  565. simplibs/object/tools/randomize/__init__.py +18 -0
  566. simplibs/object/tools/randomize/_validations/__init__.py +28 -0
  567. simplibs/object/tools/randomize/_validations/raise_random_data_filler_exhausted.py +55 -0
  568. simplibs/object/tools/randomize/_validations/validate_instance_is_simple_constant_base.py +52 -0
  569. simplibs/object/tools/randomize/_validations/validate_registry_is_randomize_registry_base.py +51 -0
  570. simplibs/object/tools/randomize/_validations/validate_retries_is_greater_than_zero.py +48 -0
  571. simplibs/object/tools/randomize/_validations/validate_retries_is_int.py +49 -0
  572. simplibs/object/tools/randomize/_validations/validate_skip_immutable_is_bool.py +43 -0
  573. simplibs/object/tools/randomize/_validations/validate_skip_unregistered_is_bool.py +44 -0
  574. simplibs/object/tools/randomize/random_data_filler.py +133 -0
  575. simplibs/object/tools/randomize/randomize_value.py +122 -0
  576. simplibs_object-0.1.0.dist-info/METADATA +590 -0
  577. simplibs_object-0.1.0.dist-info/RECORD +580 -0
  578. simplibs_object-0.1.0.dist-info/WHEEL +5 -0
  579. simplibs_object-0.1.0.dist-info/licenses/LICENSE +21 -0
  580. simplibs_object-0.1.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,47 @@
1
+ from typing import Any, Callable
2
+ # Inners
3
+ from ._is_lambda import _is_lambda
4
+
5
+
6
+ def process_decompose(
7
+ decompose: Callable
8
+ ) -> Callable:
9
+ """Normalizes a decompose callable to ensure a unified (cls, value) signature.
10
+
11
+ If the provided ``decompose`` handler is an anonymous lambda, wraps it to accept
12
+ and ignore the class instance context (``cls``) argument automatically.
13
+
14
+ Args:
15
+ decompose: Raw decompose function or lambda handler.
16
+
17
+ Returns:
18
+ A normalized callable adhering to the standard (cls, value) method signature.
19
+ """
20
+
21
+ # 1. Return regular functions directly
22
+ if not _is_lambda(decompose):
23
+ return decompose
24
+
25
+ # 2. Wrap anonymous lambda to accept (cls, value) signature
26
+ def _decompose(cls, value):
27
+ return decompose(value)
28
+
29
+ return _decompose
30
+
31
+
32
+ _DESIGN_NOTES = """
33
+ # process_decompose (Internal Helper Engine)
34
+
35
+ ## Purpose
36
+ Normalizes user-supplied `decompose` callables for composite object blueprints. Anonymous lambda
37
+ functions typically accept only a single value argument `lambda val: ...`; this helper wraps them
38
+ so that the framework can invoke `_decompose(cls, value)` uniformly.
39
+
40
+ ## Execution Workflow
41
+ 1. Checks if `decompose` is an anonymous lambda using `_is_lambda`.
42
+ 2. If it is a regular named function, returns it untouched.
43
+ 3. If it is a lambda, wraps it into a closure `_decompose(cls, value)` that passes only `value` to the lambda.
44
+
45
+ ## Framework Usage
46
+ - Internal helper invoked exclusively within `create_object_class`.
47
+ """
@@ -0,0 +1,57 @@
1
+ from typing import Any, Callable, Iterable
2
+ # Inners
3
+ from ._is_lambda import _is_lambda
4
+
5
+
6
+ def process_logic(
7
+ logic: Callable,
8
+ params_name: Iterable[str]
9
+ ) -> Callable:
10
+ """Normalizes a logic calculation callable to ensure a unified (cls, *args) signature.
11
+
12
+ If the provided ``logic`` callable is an anonymous lambda, dynamically compiles
13
+ a wrapper function via ``exec`` that accepts the class context (``cls``) alongside
14
+ all named child inner parameters.
15
+
16
+ Args:
17
+ logic: Raw logic function or lambda calculation rule.
18
+ params_name: Iterable of parameter snake_case names derived from inner components.
19
+
20
+ Returns:
21
+ A normalized callable adhering to the standard (cls, *params) method signature.
22
+ """
23
+
24
+ # 1. Return regular named functions directly
25
+ if not _is_lambda(logic):
26
+ return logic
27
+
28
+ # 2. Build parameter signature string from inner names
29
+ params = ", ".join(params_name)
30
+ src = f"def _logic(cls, {params}): return logic({params})"
31
+
32
+ # 3. Dynamically compile wrapper function
33
+ namespace: dict[str, Any] = {"logic": logic}
34
+ exec(src, namespace)
35
+
36
+ # 4. Return compiled logic wrapper
37
+ return namespace["_logic"]
38
+
39
+
40
+ _DESIGN_NOTES = """
41
+ # process_logic (Internal Helper Engine)
42
+
43
+ ## Purpose
44
+ Normalizes user-supplied calculation logic for composite object blueprints. Lambda functions
45
+ typically omit the implicit `cls` context argument (e.g. `lambda a, b: a + b`); this helper
46
+ dynamically wraps the lambda using `exec` to create a standard `_logic(cls, a, b)` signature.
47
+
48
+ ## Execution Workflow
49
+ 1. Checks if `logic` is an anonymous lambda using `_is_lambda`.
50
+ 2. If it is a regular function, returns it untouched.
51
+ 3. Joins `params_name` into a comma-separated parameter string.
52
+ 4. Dynamically compiles a signature-correct wrapper via `exec` in a local namespace.
53
+ 5. Extracts and returns the compiled `_logic` function.
54
+
55
+ ## Framework Usage
56
+ - Internal helper invoked exclusively within `create_object_class`.
57
+ """
@@ -0,0 +1,48 @@
1
+ from typing import Any, Callable
2
+ # Inners
3
+ from ._is_lambda import _is_lambda
4
+
5
+
6
+ def process_validate(
7
+ validate: Callable
8
+ ) -> Callable:
9
+ """Normalizes a validation callable to ensure a unified (cls, value, *, return_bool) signature.
10
+
11
+ If the provided ``validate`` handler is an anonymous lambda, wraps it into a classmethod-compatible
12
+ closure that accepts the class context (``cls``) and optional keyword arguments while executing
13
+ the single-argument lambda.
14
+
15
+ Args:
16
+ validate: Raw validation function or lambda callable.
17
+
18
+ Returns:
19
+ A normalized callable adhering to the standard (cls, value, *, return_bool=False) signature.
20
+ """
21
+
22
+ # 1. Return regular named functions directly
23
+ if not _is_lambda(validate):
24
+ return validate
25
+
26
+ # 2. Wrap anonymous lambda to accept (cls, value, *, return_bool=False) signature
27
+ def _validate(cls: Any, value: Any, *, return_bool: bool = False):
28
+ return validate(value)
29
+
30
+ return _validate
31
+
32
+
33
+ _DESIGN_NOTES = """
34
+ # process_validate (Internal Helper Engine)
35
+
36
+ ## Purpose
37
+ Normalizes user-supplied validation rules for both `SimpleConstant` and `SimpleObject` blueprints.
38
+ Anonymous lambdas typically accept only a single value argument (e.g. `lambda val: val > 0`);
39
+ this helper wraps them so they can be mounted as `classmethod` handlers accepting `(cls, value, *, return_bool=False)`.
40
+
41
+ ## Execution Workflow
42
+ 1. Checks if `validate` is an anonymous lambda using `_is_lambda`.
43
+ 2. If it is a regular named function, returns it untouched.
44
+ 3. If it is a lambda, returns a closure `_validate(cls, value, *, return_bool=False)` that forwards `value` to the lambda.
45
+
46
+ ## Framework Usage
47
+ - Internal helper invoked exclusively within `create_constant_class` and `create_object_class`.
48
+ """
@@ -0,0 +1,7 @@
1
+ from .validate_composite_has_logic import validate_composite_has_logic
2
+ from .validate_composite_has_not_default import validate_composite_has_not_default
3
+ from .validate_constant_has_default import validate_constant_has_default
4
+ from .validate_constant_has_not_decompose import validate_constant_has_not_decompose
5
+ from .validate_constant_has_not_logic import validate_constant_has_not_logic
6
+ from .validate_class_name_is_str import validate_class_name_is_str
7
+ from .validate_composite_has_inners import validate_composite_has_inners
@@ -0,0 +1,36 @@
1
+ from typing import Any, NoReturn
2
+ # Outers
3
+ from ....exceptions import SimpleDefinitionError
4
+
5
+
6
+ def validate_class_name_is_str(class_name: Any) -> None | NoReturn:
7
+ """Validates that class_name is a non-empty string."""
8
+
9
+ if isinstance(class_name, str) and class_name.strip():
10
+ return
11
+
12
+ raise SimpleDefinitionError(
13
+ error_name="INVALID CLASS NAME ERROR",
14
+ label="class_name_is_not_str",
15
+ expected="A non-empty string for class name definition",
16
+ value=type(class_name).__name__,
17
+ problem=f"Provided class name must be a non-empty string. Received type '{type(class_name).__name__}'.",
18
+ context="Attempted to dynamically generate a class blueprint, but 'class_name' validation failed.",
19
+ how_to_fix=(
20
+ "Pass a valid string for 'class_name', e.g. class_name='MyCustomConstant'.",
21
+ "Ensure class_name is not empty or whitespace-only.",
22
+ ),
23
+ exception=TypeError,
24
+ )
25
+
26
+
27
+ _DESIGN_NOTES = """
28
+ # validate_class_name_is_str
29
+
30
+ ## Purpose
31
+ Guarantees that the target name for dynamically generated classes is a valid non-empty string.
32
+
33
+ ## Behavior
34
+ 1. Checks if `class_name` is an instance of `str` and contains non-whitespace characters.
35
+ 2. Raises `SimpleDefinitionError` wrapping `TypeError` if invalid.
36
+ """
@@ -0,0 +1,43 @@
1
+ from typing import Any, NoReturn
2
+ from simplibs.sentinels import UNSET
3
+ # Outers
4
+ from ....exceptions import SimpleRuntimeError
5
+
6
+
7
+ def validate_composite_has_inners(class_name: str, inners: Any) -> None | NoReturn:
8
+ """Validates that a composite object class definition provides a valid tuple of inner components."""
9
+
10
+ if inners in (UNSET, None):
11
+ raise SimpleRuntimeError(
12
+ error_name="COMPOSITE MISSING INNERS ERROR",
13
+ label="composite_missing_or_none_inners",
14
+ expected="A valid non-empty tuple of inner component classes (inners not in (UNSET, None))",
15
+ value=inners,
16
+ problem=(
17
+ f"Attempted to create composite class '{class_name}' without specifying required 'inners' "
18
+ f"child components (received: {inners!r})."
19
+ ),
20
+ context=(
21
+ f"Dynamic creator requires child component blueprints ('inners') to build "
22
+ f"a composite SimpleObject node tree."
23
+ ),
24
+ how_to_fix=(
25
+ "Provide a tuple of child component blueprint classes for 'inners', e.g. inners=(ChildClassA, ChildClassB).",
26
+ "Do not pass None or UNSET for 'inners' when defining composite objects.",
27
+ "Required for composites: 'inners', 'logic'. Optional: 'decompose', 'validate', 'value_type'.",
28
+ "If this is a leaf constant: remove 'logic' and provide a static 'default' value instead.",
29
+ ),
30
+ exception=ValueError,
31
+ )
32
+
33
+
34
+ _DESIGN_NOTES = """
35
+ # validate_composite_has_inners
36
+
37
+ ## Purpose
38
+ Ensures that composite `SimpleObject` definitions explicitly specify their inner child component classes.
39
+
40
+ ## Behavior
41
+ 1. Checks if `inners` is in `(UNSET, None)`.
42
+ 2. Raises structured `SimpleRuntimeError` guiding the developer to pass a valid tuple of child classes.
43
+ """
@@ -0,0 +1,44 @@
1
+ from typing import Any, NoReturn
2
+ from simplibs.sentinels import UNSET
3
+ # Outers
4
+ from ....exceptions import SimpleRuntimeError
5
+
6
+
7
+ def validate_composite_has_logic(class_name: str, logic: Any) -> None | NoReturn:
8
+ """Validates that a composite object class definition provides a valid logic calculation callable."""
9
+
10
+ if logic in (UNSET, None):
11
+ raise SimpleRuntimeError(
12
+ error_name="COMPOSITE MISSING LOGIC ERROR",
13
+ label="composite_missing_or_none_logic",
14
+ expected="A valid non-None and non-UNSET callable logic function (logic not in (UNSET, None))",
15
+ value=logic,
16
+ problem=(
17
+ f"Composite class '{class_name}' specifies 'inners' but is missing the required 'logic' "
18
+ f"calculation rule (received: {logic!r})."
19
+ ),
20
+ context=(
21
+ f"Dynamic creator inferred composite mode for class '{class_name}' because 'inners' was provided, "
22
+ f"but a valid logic pipeline was not supplied."
23
+ ),
24
+ how_to_fix=(
25
+ "SimpleObject composites must derive their value from inner child components via a 'logic' function.",
26
+ "Provide a callable 'logic' function (or lambda) accepting parameters corresponding to inner snake_case names.",
27
+ "Do not pass None or UNSET for 'logic' when defining composite objects.",
28
+ "Required for composites: 'inners', 'logic'. Optional: 'decompose', 'validate', 'value_type'.",
29
+ "If this is a leaf constant: remove 'inners' and provide a static 'default' value instead.",
30
+ ),
31
+ exception=ValueError,
32
+ )
33
+
34
+
35
+ _DESIGN_NOTES = """
36
+ # validate_composite_has_logic
37
+
38
+ ## Purpose
39
+ Guarantees that every composite `SimpleObject` defines a functional `logic` pipeline for value derivation.
40
+
41
+ ## Behavior
42
+ 1. Asserts `logic` is not in `(UNSET, None)` when `inners` is present.
43
+ 2. Raises structured `SimpleRuntimeError` emphasizing mandatory calculation rules for composite nodes.
44
+ """
@@ -0,0 +1,37 @@
1
+ from typing import Any, NoReturn
2
+ from simplibs.sentinels import UNSET
3
+ # Outers
4
+ from ....exceptions import SimpleRuntimeError
5
+
6
+
7
+ def validate_composite_has_not_default(class_name: str, default: Any) -> None | NoReturn:
8
+ """Validates that a composite object class definition does not provide a static default value."""
9
+
10
+ if default is not UNSET:
11
+ raise SimpleRuntimeError(
12
+ error_name="COMPOSITE DEFAULT CONFLICT ERROR",
13
+ label="composite_default_conflict",
14
+ expected="default=UNSET when creating a SimpleObject composite class",
15
+ value=default,
16
+ problem=f"Composite class '{class_name}' received a 'default' parameter, which is reserved for leaf constants.",
17
+ context=f"Dynamic creator detected 'inners' tuple was provided for composite class '{class_name}'.",
18
+ how_to_fix=(
19
+ "SimpleObject composite values are dynamically derived from child 'inners' via 'logic' calculation.",
20
+ "If this is a composite node: remove the 'default' argument.",
21
+ "Required for composites: 'inners', 'logic'. Optional for composites: 'decompose', 'validate', 'value_type'.",
22
+ "If this is a leaf constant: remove 'inners' and 'logic'. Constants require: 'default' (optional: 'validate', 'value_type').",
23
+ ),
24
+ exception=ValueError,
25
+ )
26
+
27
+
28
+ _DESIGN_NOTES = """
29
+ # validate_composite_has_not_default
30
+
31
+ ## Purpose
32
+ Prevents setting a static default on composite nodes whose values must be computed via `logic`.
33
+
34
+ ## Behavior
35
+ 1. Verifies `default` is `UNSET` when `inners` is supplied.
36
+ 2. Guides the developer to remove `default` or switch to constant mode by removing `inners`.
37
+ """
@@ -0,0 +1,48 @@
1
+ from typing import Any, NoReturn
2
+ from simplibs.sentinels import UNSET
3
+ # Outers
4
+ from ....exceptions import SimpleRuntimeError
5
+
6
+
7
+ def validate_constant_has_default(class_name: str, default: Any) -> None | NoReturn:
8
+ """Validates that a constant leaf class definition provides a valid non-None default value."""
9
+
10
+ if default in (UNSET, None):
11
+ raise SimpleRuntimeError(
12
+ error_name="INVALID CONSTANT DEFAULT ERROR",
13
+ label="constant_missing_or_none_default",
14
+ expected="A valid non-UNSET and non-None default value (default not in (UNSET, None))",
15
+ value=default,
16
+ problem=(
17
+ f"Attempted to create constant class '{class_name}' with an invalid default value ({default!r}). ",
18
+ f"Constant default values cannot be UNSET or None."
19
+ ),
20
+ context=(
21
+ f"Dynamic creator requires a concrete non-None default value for constant '{class_name}' ",
22
+ f"to perform type inference and compute composite default values across node trees."
23
+ ),
24
+ how_to_fix=(
25
+ "Provide a concrete initial value for 'default' (e.g. 0, '', False, or a specific domain object).",
26
+ "Do not use None as a default value — Simple framework trees rely on non-None defaults to derive composite logic.",
27
+ "Supported optional parameters for constants: 'value_type', 'validate'.",
28
+ "If you intended to create a SimpleObject (composite node): provide 'inners' tuple and 'logic' callable instead.",
29
+ ),
30
+ exception=ValueError,
31
+ )
32
+
33
+
34
+ _DESIGN_NOTES = """
35
+ # validate_constant_has_default
36
+
37
+ ## Purpose
38
+ Enforces the mandatory presence of a concrete, non-None default value when dynamically instantiating
39
+ a `SimpleConstant` class blueprint.
40
+
41
+ ## Behavior
42
+ 1. Checks if `default` is `UNSET` or `None`.
43
+ 2. Raises `SimpleRuntimeError` explaining that `None` is disallowed due to automatic type inference
44
+ and default value propagation rules across composite object trees.
45
+
46
+ ## Notes
47
+ - Strict non-None default enforcement is a core architectural rule of the Simple library.
48
+ """
@@ -0,0 +1,37 @@
1
+ from typing import Any, NoReturn
2
+ from simplibs.sentinels import UNSET
3
+ # Outers
4
+ from ....exceptions import SimpleRuntimeError
5
+
6
+
7
+ def validate_constant_has_not_decompose(class_name: str, decompose: Any) -> None | NoReturn:
8
+ """Validates that a constant leaf class definition does not provide a decomposition handler."""
9
+
10
+ if decompose is not UNSET:
11
+ raise SimpleRuntimeError(
12
+ error_name="CONSTANT DECOMPOSE CONFLICT ERROR",
13
+ label="constant_decompose_conflict",
14
+ expected="decompose=UNSET when creating a SimpleConstant class",
15
+ value=decompose,
16
+ problem=f"Constant class '{class_name}' received a 'decompose' parameter, which is reserved for composite objects.",
17
+ context=f"Dynamic creator detected 'inners' was UNSET but received 'decompose' for class '{class_name}'.",
18
+ how_to_fix=(
19
+ "SimpleConstant leaf nodes cannot be decomposed into inner children.",
20
+ "If this is a leaf node: remove the 'decompose' argument. Allowed constant parameters: 'default', 'value_type', 'validate'.",
21
+ "If this is a composite node: provide the 'inners' tuple specifying child component types.",
22
+ "Required for composites: 'inners', 'logic'. Optional for composites: 'decompose', 'validate', 'value_type'.",
23
+ ),
24
+ exception=ValueError,
25
+ )
26
+
27
+
28
+ _DESIGN_NOTES = """
29
+ # validate_constant_has_not_decompose
30
+
31
+ ## Purpose
32
+ Ensures top-down decomposition callables are not assigned to single leaf constants.
33
+
34
+ ## Behavior
35
+ 1. Checks if `decompose` is set when `inners` is omitted.
36
+ 2. Raises structured error clarifying that decomposition is exclusive to composite trees.
37
+ """
@@ -0,0 +1,37 @@
1
+ from typing import Any, NoReturn
2
+ from simplibs.sentinels import UNSET
3
+ # Outers
4
+ from ....exceptions import SimpleRuntimeError
5
+
6
+
7
+ def validate_constant_has_not_logic(class_name: str, logic: Any) -> None | NoReturn:
8
+ """Validates that a constant leaf class definition does not provide a logic calculation rule."""
9
+
10
+ if logic is not UNSET:
11
+ raise SimpleRuntimeError(
12
+ error_name="CONSTANT LOGIC CONFLICT ERROR",
13
+ label="constant_logic_conflict",
14
+ expected="logic=UNSET when creating a SimpleConstant class",
15
+ value=logic,
16
+ problem=f"Constant class '{class_name}' received a 'logic' parameter, which is reserved for composite objects.",
17
+ context=f"Dynamic creator detected 'inners' was UNSET but received 'logic' for class '{class_name}'.",
18
+ how_to_fix=(
19
+ "SimpleConstant leaf nodes store raw static values and do not support calculation rules ('logic').",
20
+ "If this is a leaf node: remove the 'logic' argument. Allowed constant parameters: 'default', 'value_type', 'validate'.",
21
+ "If this is a composite node: provide the 'inners' tuple specifying child component types alongside 'logic'.",
22
+ "Required for composites: 'inners', 'logic'. Optional for composites: 'decompose', 'validate', 'value_type'.",
23
+ ),
24
+ exception=ValueError,
25
+ )
26
+
27
+
28
+ _DESIGN_NOTES = """
29
+ # validate_constant_has_not_logic
30
+
31
+ ## Purpose
32
+ Prevents assigning a calculation rule (`logic`) to atomic `SimpleConstant` leaf nodes.
33
+
34
+ ## Behavior
35
+ 1. Ensures `logic` is `UNSET` when `inners` is not supplied.
36
+ 2. Directs the user to either remove `logic` or supply `inners` to switch to composite mode.
37
+ """
@@ -0,0 +1,100 @@
1
+ from dataclasses import dataclass
2
+ from typing import Any, Callable, TYPE_CHECKING
3
+ from simplibs.sentinels import UNSET, UnsetType
4
+ # Inners
5
+ from ..create_simple_object import create_simple_object
6
+ from .._validations import (
7
+ validate_class_name_is_str,
8
+ validate_constant_has_default,
9
+ validate_constant_has_not_logic,
10
+ validate_constant_has_not_decompose,
11
+ validate_composite_has_inners,
12
+ validate_composite_has_logic,
13
+ validate_composite_has_not_default,
14
+ )
15
+ # Annotations
16
+ if TYPE_CHECKING:
17
+ from ...._core.protocols import SimpleClassType, SimpleMixinLike
18
+
19
+
20
+ @dataclass
21
+ class BulkCase:
22
+ """Data container representing a single definition blueprint for bulk object generation.
23
+
24
+ Validates initial specification boundaries during initialization and serves as a
25
+ factory runner forwarding stored configuration parameters to ``create_simple_object``.
26
+ """
27
+
28
+ class_name: str
29
+ default: Any | UnsetType = UNSET
30
+ inners: tuple["SimpleClassType", ...] | UnsetType = UNSET
31
+ value_type: type | UnsetType = UNSET
32
+ validate: Callable | UnsetType = UNSET
33
+ logic: Callable | UnsetType = UNSET
34
+ decompose: Callable | UnsetType = UNSET
35
+ return_instance: bool = False
36
+ mixins: tuple["SimpleMixinLike", ...] = ()
37
+ as_atom: bool = False
38
+ mutable: bool = True
39
+
40
+ def __post_init__(self) -> None:
41
+ """Validates parameter constraints upon dataclass initialization."""
42
+
43
+ # 1. Validate class_name strictly as non-empty string
44
+ validate_class_name_is_str(self.class_name)
45
+
46
+ # 2. Leaf constant definition checks
47
+ if self.inners is UNSET:
48
+ validate_constant_has_default(self.class_name, self.default)
49
+ validate_constant_has_not_logic(self.class_name, self.logic)
50
+ validate_constant_has_not_decompose(self.class_name, self.decompose)
51
+
52
+ # 3. Composite object definition checks
53
+ else:
54
+ validate_composite_has_inners(self.class_name, self.inners)
55
+ validate_composite_has_logic(self.class_name, self.logic)
56
+ validate_composite_has_not_default(self.class_name, self.default)
57
+
58
+ def create_simple_object(self) -> Any:
59
+ """Executes object creation using the encapsulated parameters.
60
+
61
+ Returns:
62
+ Dynamically created Simple class blueprint, or initialized instance if return_instance=True.
63
+ """
64
+ return create_simple_object(
65
+ class_name=self.class_name,
66
+ default=self.default,
67
+ inners=self.inners,
68
+ value_type=self.value_type,
69
+ validate=self.validate,
70
+ logic=self.logic,
71
+ decompose=self.decompose,
72
+ return_instance=self.return_instance,
73
+ mixins=self.mixins,
74
+ as_atom=self.as_atom,
75
+ mutable=self.mutable,
76
+ )
77
+
78
+
79
+ _DESIGN_NOTES = """
80
+ # BulkCase (Bulk Definition Specification Container)
81
+
82
+ ## Purpose
83
+ Acts as an explicit structural container (data object) representing a target `SimpleConstant`
84
+ or `SimpleObject` definition for bulk dynamic generation workflows.
85
+
86
+ ## Post-Initialization Validation Rules
87
+ 1. **Class Name:** Enforces non-empty string via `validate_class_name_is_str`.
88
+ 2. **Leaf Node (`inners` is UNSET):**
89
+ - Must provide concrete non-None default (`validate_constant_has_default`).
90
+ - Must NOT supply `logic` (`validate_constant_has_not_logic`).
91
+ - Must NOT supply `decompose` (`validate_constant_has_not_decompose`).
92
+ 3. **Composite Node (`inners` is supplied):**
93
+ - Must supply non-empty `inners` tuple (`validate_composite_has_inners`).
94
+ - Must supply calculation `logic` (`validate_composite_has_logic`).
95
+ - Must NOT supply `default` (`validate_composite_has_not_default`).
96
+
97
+ ## Execution
98
+ - `create_simple_object()` acts as a runner forwarding stored configuration arguments
99
+ directly to the orchestrator facade.
100
+ """
@@ -0,0 +1,77 @@
1
+ # create_simple_object_bulk.py
2
+ from typing import Any
3
+ from .BulkCase import BulkCase
4
+ from .specific_bulks.create_simple_object_bulk_from_csv import create_simple_object_bulk_from_csv
5
+ from .specific_bulks.create_simple_object_bulk_from_dicts import create_simple_object_bulk_from_dicts
6
+ from .specific_bulks.create_simple_object_bulk_from_json import create_simple_object_bulk_from_json
7
+ from .specific_bulks.create_simple_object_bulk_from_table import create_simple_object_bulk_from_table
8
+ from .specific_bulks.create_simple_object_bulk_from_yaml import create_simple_object_bulk_from_yaml
9
+
10
+
11
+ def create_simple_object_bulk(source: Any):
12
+ """
13
+ Univerzální orchestrátor pro tvorbu bulk objektů.
14
+ Automaticky rozpozná typ vstupu a deleguje zpracování správnému parseru.
15
+
16
+ Podporované typy vstupu:
17
+ - list/tuple s instance `BulkCase`
18
+ - list/tuple s Python `dict`
19
+ - 2D list/tuple (`table`)
20
+ - str obsahující JSON
21
+ - str obsahující YAML (pokud začíná nebo obsahuje typické klíče)
22
+ - str obsahující CSV (s hlavičkou class_name)
23
+ """
24
+ # 1. Je to sekvence (List / Tuple)
25
+ if isinstance(source, (list, tuple)):
26
+ if not source:
27
+ return create_simple_object_bulk_from_dicts([])
28
+
29
+ first_item = source[0]
30
+
31
+ # A) List instancí BulkCase
32
+ if isinstance(first_item, BulkCase):
33
+ from .specific_bulks.create_simple_object_bulk_from_bulk_case_class import (
34
+ create_simple_object_bulk_from_bulk_case_class,
35
+ )
36
+ return create_simple_object_bulk_from_bulk_case_class(tuple(source))
37
+
38
+ # B) List slovníků
39
+ if isinstance(first_item, dict):
40
+ return create_simple_object_bulk_from_dicts(source)
41
+
42
+ # C) Matice / Tabulka (2D list)
43
+ if isinstance(first_item, (list, tuple)):
44
+ return create_simple_object_bulk_from_table(source)
45
+
46
+ raise TypeError(f"Nerozpoznatelný prvek v seznamu: {type(first_item)}")
47
+
48
+ # 2. Je to Textový řetězec (JSON / YAML / CSV)
49
+ if isinstance(source, str):
50
+ cleaned = source.strip()
51
+
52
+ # A) Detekce JSON (začíná '[')
53
+ if cleaned.startswith("["):
54
+ return create_simple_object_bulk_from_json(cleaned)
55
+
56
+ # B) Detekce CSV (první řádek obsahuje 'class_name' A ZÁROVEŇ oddělovač ',' nebo ';')
57
+ first_line = cleaned.splitlines()[0] if cleaned else ""
58
+ if "class_name" in first_line and ("," in first_line or ";" in first_line):
59
+ return create_simple_object_bulk_from_csv(cleaned)
60
+
61
+ # C) Záložní pokus o YAML
62
+ return create_simple_object_bulk_from_yaml(cleaned)
63
+
64
+ raise TypeError(f"Nepodporovaný typ vstupu pro bulk tvorbu: {type(source)}")
65
+
66
+
67
+ """
68
+ # Všechna tato volání vrátí stejný výsledek:
69
+
70
+ # 1. Univerzální fasáda (Doporučeno)
71
+ bulk_1 = create_simple_object_bulk([{"class_name": "MyConstant", "default": 100}])
72
+ bulk_2 = create_simple_object_bulk('[{"class_name": "MyConstant", "default": 100}]')
73
+ bulk_3 = create_simple_object_bulk([["MyConstant", 100]])
74
+
75
+ # 2. Explicitní parser (Když uživatel chce 100% jistotu bez auto-detekce)
76
+ bulk_4 = create_simple_object_bulk_from_json('[{"class_name": "MyConstant", "default": 100}]')
77
+ """
@@ -0,0 +1,8 @@
1
+ from .raise_bulk_item_is_not_bulk_dict import raise_bulk_item_is_not_bulk_dict
2
+ from .raise_bulk_csv_callable_not_supported import raise_bulk_csv_callable_not_supported
3
+ from .raise_bulk_data_not_list import raise_bulk_data_not_list
4
+ from .raise_bulk_decode_failed import raise_bulk_decode_failed
5
+ from .raise_bulk_input_not_sequence import raise_bulk_input_not_sequence
6
+ from .raise_bulk_input_not_str import raise_bulk_input_not_str
7
+ from .raise_bulk_table_row_not_sequence import raise_bulk_table_row_not_sequence
8
+ from .raise_bulk_yaml_import_failed import raise_bulk_yaml_import_failed