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,17 @@
1
+ from .raise_method_raised_exceptions import raise_method_raised_exceptions
2
+ from .raise_method_return_unvalide_outcome_type import raise_method_return_unvalide_outcome_type
3
+
4
+
5
+ _DESIGN_NOTES = """
6
+ # Calculation Validation Sub-Package
7
+
8
+ ## Purpose
9
+ Isolates diagnostic panic routines responsible for catching and handling evaluations that violate runtime execution schemas.
10
+
11
+ ## Internal Components Registry
12
+
13
+ | Component | Type | Description |
14
+ | :-------------------------------------------- | :------- | :----------------------------------------------------------------------------------- |
15
+ | `raise_method_raised_exceptions` | Function | Standardized wrapper converting unexpected computation errors into domain exceptions. |
16
+ | `raise_method_return_unvalide_outcome_type` | Function | Panics when a method computation yields an object mismatching schema expectations. |
17
+ """
@@ -0,0 +1,56 @@
1
+ from typing import TYPE_CHECKING
2
+ # Outers
3
+ from ........exceptions import SimpleDefinitionError
4
+ from ..._exceptions_helpers import exception_info_for_classmethod
5
+ # Annotations
6
+ if TYPE_CHECKING:
7
+ from .......protocols.methods import ClassMethodProtocol
8
+
9
+
10
+ def raise_method_raised_exceptions(
11
+ intercepted_exception: Exception,
12
+ bound_method: "ClassMethodProtocol",
13
+ ) -> None:
14
+ """Raises a structured metadata exception when a dry-run execution fails."""
15
+
16
+ # 1. Extract diagnostic context
17
+ class_name, method_name, context = exception_info_for_classmethod(bound_method)
18
+
19
+ # 2. Raise domain exception with packaged underlying error
20
+ raise SimpleDefinitionError(
21
+ error_name="METHOD LOGIC ERROR",
22
+ label="_exception",
23
+ expected="Method execution without raising exceptions.",
24
+ problem="An unexpected error occurred during dry-run execution.",
25
+ context=context,
26
+ how_to_fix=(
27
+ f"Inspect the internal logic of '{method_name}'.",
28
+ "Verify correct handling of default values and input parameters.",
29
+ "See the intercepted exception below for the exact root cause.",
30
+ ),
31
+ exception=intercepted_exception,
32
+ )
33
+
34
+
35
+
36
+ _DESIGN_NOTES = """
37
+ # raise_method_raised_exceptions
38
+
39
+ ## Purpose
40
+ Captures any exception thrown during a dry-run execution of a classmethod and
41
+ repackages it into a structured `SimpleDefinitionError`.
42
+ This prevents raw runtime crashes from leaking into the metadata pipeline.
43
+
44
+ ## Behavior
45
+ 1. Extracts diagnostic context using `exception_context_for_classmethod`.
46
+ 2. Raises a structured domain error containing:
47
+ - class name
48
+ - method name
49
+ - execution context
50
+ - remediation instructions
51
+ - the original intercepted exception
52
+
53
+ ## Notes
54
+ This validator is used exclusively inside `verify_calculation` and is the first
55
+ line of defense against runtime failures in method hooks.
56
+ """
@@ -0,0 +1,80 @@
1
+ from typing import Any, TYPE_CHECKING
2
+ from types import UnionType
3
+ # Outers
4
+ from ........exceptions import SimpleDefinitionError
5
+ from ..._exceptions_helpers import exception_info_for_classmethod
6
+ # Annotations
7
+ if TYPE_CHECKING:
8
+ from .......protocols.methods import ClassMethodProtocol
9
+
10
+
11
+ def raise_method_return_unvalide_outcome_type(
12
+ calculated_value: Any,
13
+ expected_return_type: type | UnionType,
14
+ bound_method: "ClassMethodProtocol",
15
+ ) -> None:
16
+ """Raises a structured exception when a method returns an invalid type."""
17
+
18
+ # 1. Extract diagnostic context
19
+ class_name, method_name, context = exception_info_for_classmethod(bound_method)
20
+
21
+ expected_type_name = (
22
+ expected_return_type.__name__
23
+ if hasattr(expected_return_type, "__name__")
24
+ else str(expected_return_type)
25
+ )
26
+ calculated_type_name = type(calculated_value).__name__
27
+
28
+ # 2. Select method-specific remediation hint
29
+ if method_name == "_logic":
30
+ hint = f"Return value must match '{class_name}._type'."
31
+ elif method_name == "_decompose":
32
+ hint = f"Return value must be a tuple matching '{class_name}._inners'."
33
+ elif method_name == "_validate":
34
+ hint = "Return value must be 'bool', 'None', or 'bool | None'."
35
+ else:
36
+ hint = ""
37
+
38
+ # 3. Raise domain exception
39
+ raise SimpleDefinitionError(
40
+ error_name="METHOD LOGIC ERROR",
41
+ label="_return_type",
42
+ value=calculated_value,
43
+ expected=expected_type_name,
44
+ problem=f"Method '{method_name}' returned an invalid type '{calculated_type_name}'.",
45
+ context=context,
46
+ how_to_fix=(
47
+ "Inspect the method logic and ensure the returned value matches the expected type.",
48
+ hint,
49
+ f"Modify the method so that it returns an instance of '{expected_type_name}'.",
50
+ f"Or update the type definition to allow '{calculated_type_name}'.",
51
+ "Example:",
52
+ " @classmethod",
53
+ f" def {method_name}(cls, ...) -> {expected_type_name}:",
54
+ f" return ... # Must be an instance of {expected_type_name}",
55
+ ),
56
+ exception=TypeError,
57
+ )
58
+
59
+
60
+ _DESIGN_NOTES = """
61
+ # raise_method_return_unvalide_outcome_type
62
+
63
+ ## Purpose
64
+ Ensures that the return value of `_logic`, `_decompose`, or `_validate` matches
65
+ the expected type defined by the metadata pipeline.
66
+
67
+ ## Behavior
68
+ 1. Extracts diagnostic context using `exception_context_for_classmethod`.
69
+ 2. Determines the expected type name and the actual returned type.
70
+ 3. Selects a method-specific remediation hint:
71
+ - `_logic` → must match `_type`
72
+ - `_decompose` → must match `_inners`
73
+ - `_validate` → must be `bool | None`
74
+ 4. Raises a structured `SimpleDefinitionError` with a clear explanation and
75
+ copy‑paste ready remediation instructions.
76
+
77
+ ## Notes
78
+ This validator is used inside `verify_calculation` immediately after the dry-run
79
+ execution of the method.
80
+ """
@@ -0,0 +1,89 @@
1
+ from typing import Any, TYPE_CHECKING
2
+ from types import UnionType
3
+ from simplibs.sentinels import UNSET
4
+ # Inners
5
+ from .decompose_method import verify_decompose_outcome
6
+ from .validations import (
7
+ raise_method_raised_exceptions,
8
+ raise_method_return_unvalide_outcome_type,
9
+ )
10
+ # Annotations
11
+ if TYPE_CHECKING:
12
+ from ......protocols.classes import SimpleClassLike
13
+ from ......protocols.methods import ClassMethodProtocol
14
+
15
+
16
+ def verify_calculation(
17
+ bound_method: "ClassMethodProtocol",
18
+ test_value: Any,
19
+ expected_return_type: type | UnionType,
20
+ owner_class: "SimpleClassLike",
21
+ ) -> Any:
22
+ """Executes a dry-run of the method and validates its return type and structure."""
23
+
24
+ if bound_method is UNSET:
25
+ return UNSET
26
+
27
+ # 1. Initialize result placeholder
28
+ calculate_result = UNSET
29
+
30
+ # 2. Execute dry-run and intercept exceptions
31
+ try:
32
+ calculate_result = bound_method(*test_value)
33
+ except Exception as e:
34
+ raise_method_raised_exceptions(e, bound_method)
35
+
36
+ # 3. Validate return type
37
+ if not isinstance(calculate_result, expected_return_type):
38
+ raise_method_return_unvalide_outcome_type(
39
+ calculate_result,
40
+ expected_return_type,
41
+ bound_method,
42
+ )
43
+
44
+ # 4. Special validation for '_decompose'
45
+ if bound_method.__func__.__name__ == "_decompose":
46
+ # noinspection PyTypeChecker
47
+ verify_decompose_outcome(
48
+ calculate_result,
49
+ owner_class,
50
+ bound_method,
51
+ )
52
+
53
+ # 5. Return verified result
54
+ return calculate_result
55
+
56
+
57
+
58
+ _DESIGN_NOTES = """
59
+ # verify_calculation
60
+
61
+ ## Purpose
62
+ Runs a controlled dry-run of a classmethod to ensure:
63
+ - it executes without raising exceptions,
64
+ - it returns a value of the expected type,
65
+ - and for `_decompose`, the returned tuple matches the structural metadata.
66
+
67
+ ## Behavior
68
+
69
+ ### 1. Dry-run execution
70
+ The method is invoked with `*test_value`.
71
+ Any exception is intercepted and repackaged via `raise_method_raised_exceptions`.
72
+
73
+ ### 2. Type validation
74
+ The result is checked using `isinstance` against the expected return type.
75
+ If invalid, `raise_method_return_unvalide_outcome_type` is triggered.
76
+
77
+ ### 3. Decompose-specific validation
78
+ If the method is `_decompose`, the result is passed to `verify_decompose_outcome`,
79
+ which validates:
80
+ - tuple length,
81
+ - item types,
82
+ - item default values.
83
+
84
+ ### 4. Verified output
85
+ If all checks pass, the result is returned unchanged.
86
+
87
+ ## Notes
88
+ This orchestrator is the final operational validation step in the method pipeline.
89
+ """
@@ -0,0 +1,15 @@
1
+ from .verify_classmethod import verify_classmethod
2
+
3
+
4
+ _DESIGN_NOTES = """
5
+ # Classmethod Verification Package
6
+
7
+ ## Purpose
8
+ Acts as the front gate interface verifier for class-bound procedures. It runs structural environment assessments to verify that object methods are properly declared, bounded, and ready for internal execution flow pipelines.
9
+
10
+ ## Internal Components Registry
11
+
12
+ | Component | Type | Description |
13
+ | :------------------- | :------- | :----------------------------------------------------------------------------------- |
14
+ | `verify_classmethod` | Function | Orchestration coordinator enforcing early definition and class-binding validations. |
15
+ """
@@ -0,0 +1,81 @@
1
+ from typing import TYPE_CHECKING, Callable
2
+ from types import FunctionType
3
+ # Annotations
4
+ if TYPE_CHECKING:
5
+ from ......protocols.methods import ClassMethodProtocol
6
+
7
+
8
+ def _clone_classmethod(
9
+ cm: "ClassMethodProtocol",
10
+ ) -> classmethod:
11
+ """Creates a fully isolated clone of a classmethod."""
12
+
13
+ # 1. Extract underlying function
14
+ func = cm.__func__
15
+
16
+ # 2. Rebuild a new function object
17
+ new_func: Callable = FunctionType(
18
+ func.__code__,
19
+ func.__globals__,
20
+ name=func.__name__,
21
+ argdefs=func.__defaults__,
22
+ closure=func.__closure__,
23
+ )
24
+
25
+ # 3. Copy annotations
26
+ new_func.__annotations__ = dict(func.__annotations__)
27
+
28
+ # 4. Copy keyword-only defaults
29
+ new_func.__kwdefaults__ = (
30
+ dict(func.__kwdefaults__) if func.__kwdefaults__ else None
31
+ )
32
+
33
+ # 5. Copy custom attributes
34
+ if func.__dict__:
35
+ new_func.__dict__.update(func.__dict__)
36
+
37
+ # 6. Wrap into a fresh classmethod descriptor
38
+ return classmethod(new_func)
39
+
40
+
41
+
42
+ _DESIGN_NOTES = """
43
+ # _clone_classmethod
44
+
45
+ ## Purpose
46
+ Creates a fully isolated clone of a classmethod.
47
+ Used when a subclass inherits a method but needs its own independent copy so that
48
+ metadata injection does not modify the parent class.
49
+
50
+ ## Why cloning is required
51
+ Python's `classmethod` wraps a single underlying function object.
52
+ If a subclass modifies that function (annotations, defaults, attributes), the
53
+ changes propagate upward to the parent class.
54
+ This breaks isolation and causes shared‑state bugs.
55
+
56
+ Cloning prevents this by reconstructing a new function object.
57
+
58
+ ## How cloning works
59
+ 1. **Extract the underlying function**
60
+ `cm.__func__` gives the raw function object.
61
+
62
+ 2. **Rebuild a new function**
63
+ A new `FunctionType` is created using:
64
+ - bytecode (`__code__`)
65
+ - globals (`__globals__`)
66
+ - name (`__name__`)
67
+ - defaults (`__defaults__`)
68
+ - closure (`__closure__`)
69
+
70
+ 3. **Copy metadata safely**
71
+ - annotations → copied into a new dict
72
+ - keyword defaults → copied or set to None
73
+ - custom attributes → copied via `.update()`
74
+
75
+ 4. **Wrap back into classmethod**
76
+ The new function is wrapped in a fresh `classmethod` descriptor.
77
+
78
+ ## Notes
79
+ This helper is used only inside the method‑verification pipeline.
80
+ It is intentionally minimal and does not perform validation.
81
+ """
@@ -0,0 +1,19 @@
1
+ from .validate_method_is_callable import validate_method_is_callable
2
+ from .validate_method_is_classmethod import validate_method_is_classmethod
3
+ from .validate_method_is_defined import validate_method_is_defined
4
+
5
+
6
+ _DESIGN_NOTES = """
7
+ # Classmethod Base Validation Sub-Package
8
+
9
+ ## Purpose
10
+ Houses fundamental object nature, existence, and signature layout validation rules before deeper runtime metadata verification.
11
+
12
+ ## Internal Components Registry
13
+
14
+ | Component | Type | Description |
15
+ | :------------------------------ | :------- | :----------------------------------------------------------------------------------- |
16
+ | `validate_method_is_callable` | Function | Assures that the captured signature target can be actively invoked as a routine. |
17
+ | `validate_method_is_classmethod`| Function | Assures the target is bounded as a true classmethod type descriptor inside the class. |
18
+ | `validate_method_is_defined` | Function | Checks for target object presence within the target operational namespace context. |
19
+ """
@@ -0,0 +1,60 @@
1
+ from typing import Any
2
+ # Outers
3
+ from ........exceptions import SimpleDefinitionError
4
+
5
+
6
+ def validate_method_is_callable(
7
+ raw_method: Any,
8
+ exception_info: tuple[str, str, str],
9
+ expected_structure: tuple[str, ...],
10
+ ) -> None:
11
+ """Validates that the reflected method is callable."""
12
+
13
+ if not callable(raw_method):
14
+ class_name, method_name, context = exception_info
15
+
16
+ raise SimpleDefinitionError(
17
+ error_name="METHOD LOGIC ERROR",
18
+ label="_method",
19
+ value=raw_method,
20
+ problem=f"'{class_name}.{method_name}' is not callable.",
21
+ expected="A callable classmethod.",
22
+ how_to_fix=(
23
+ f"Ensure '{method_name}' is defined as a function.",
24
+ "Verify it was not overwritten by a data attribute.",
25
+ ) + expected_structure,
26
+ context=context,
27
+ exception=TypeError,
28
+ )
29
+
30
+
31
+ _DESIGN_NOTES = """
32
+ # validate_method_is_callable
33
+
34
+ ## Purpose
35
+ Ensures that the reflected class attribute is a callable object.
36
+ This prevents signature validation from running on non‑callable values such as
37
+ strings, integers, or accidental data attributes.
38
+
39
+ ## Why tuple inputs
40
+ The function receives:
41
+ - `exception_info` — (class_name, method_name, context)
42
+ - `expected_structure` — code blueprint
43
+
44
+ This keeps the validator consistent with all other method‑validation helpers.
45
+
46
+ ## Behavior
47
+ If `callable(raw_method)` is false, the validator raises a structured
48
+ `SimpleDefinitionError` containing:
49
+ - the class and method name,
50
+ - a clear explanation of the issue,
51
+ - a copy‑paste ready blueprint showing the correct method layout.
52
+
53
+ ## Notes
54
+ This validator is used for all three method types:
55
+ - `_validate`
56
+ - `_logic`
57
+ - `_decompose`
58
+
59
+ It is the second guard in the classmethod verification chain.
60
+ """
@@ -0,0 +1,60 @@
1
+ from typing import Any
2
+ # Outers
3
+ from ........exceptions import SimpleDefinitionError
4
+
5
+
6
+ def validate_method_is_classmethod(
7
+ raw_method: Any,
8
+ exception_info: tuple[str, str, str],
9
+ expected_structure: tuple[str, ...],
10
+ ) -> None:
11
+ """Validates that the method is decorated with @classmethod."""
12
+
13
+ if not isinstance(raw_method, classmethod):
14
+ class_name, method_name, context = exception_info
15
+
16
+ raise SimpleDefinitionError(
17
+ error_name="METHOD LOGIC ERROR",
18
+ label="_method",
19
+ value=raw_method,
20
+ problem=f"'{class_name}.{method_name}' is not a classmethod.",
21
+ expected="A method decorated with '@classmethod'.",
22
+ how_to_fix=(
23
+ f"Add '@classmethod' to '{method_name}'.",
24
+ "Without this decorator, the system cannot bind the method correctly.",
25
+ ) + expected_structure,
26
+ context=context,
27
+ exception=TypeError,
28
+ )
29
+
30
+
31
+ _DESIGN_NOTES = """
32
+ # validate_method_is_classmethod
33
+
34
+ ## Purpose
35
+ Ensures that the reflected method is explicitly decorated with `@classmethod`.
36
+ The metadata pipeline relies on class‑bound semantics, so instance methods or
37
+ plain attributes cannot be used.
38
+
39
+ ## Why tuple inputs
40
+ The validator receives:
41
+ - `exception_info` — (class_name, method_name, context)
42
+ - `expected_structure` — code blueprint
43
+
44
+ This keeps the function consistent with all other method‑validation helpers.
45
+
46
+ ## Behavior
47
+ If the raw attribute is not a `classmethod` instance, the validator raises a
48
+ structured `SimpleDefinitionError` containing:
49
+ - the class and method name,
50
+ - a clear explanation of the issue,
51
+ - a copy‑paste ready blueprint showing the correct method layout.
52
+
53
+ ## Notes
54
+ This validator is used for all three method types:
55
+ - `_validate`
56
+ - `_logic`
57
+ - `_decompose`
58
+
59
+ It is the third guard in the classmethod verification chain.
60
+ """
@@ -0,0 +1,67 @@
1
+ from typing import TYPE_CHECKING
2
+ # Outers
3
+ from ........exceptions import SimpleDefinitionError
4
+ # Annotations
5
+ if TYPE_CHECKING:
6
+ from .......protocols.classes import SimpleClassLike
7
+
8
+
9
+ def validate_method_is_defined(
10
+ method_name: str,
11
+ owner_class: "SimpleClassLike",
12
+ exception_info: tuple[str, str, str],
13
+ expected_structure: tuple[str, ...],
14
+ ) -> None:
15
+ """Validates that the method is defined directly on the class."""
16
+
17
+ if method_name not in owner_class.__dict__:
18
+ class_name, _, context = exception_info
19
+
20
+ raise SimpleDefinitionError(
21
+ error_name="METHOD LOGIC ERROR",
22
+ label="_method",
23
+ value=method_name,
24
+ problem=f"Class '{class_name}' does not define this method.",
25
+ expected=f"Method '{method_name}' must be declared in class '{class_name}'.",
26
+ how_to_fix=(
27
+ f"Add '{method_name}' directly to the class definition.",
28
+ "Decorate it with '@classmethod'.",
29
+ "Ensure its parameters match the expected signature.",
30
+ ) + expected_structure,
31
+ context=context,
32
+ exception=AttributeError,
33
+ )
34
+
35
+
36
+ _DESIGN_NOTES = """
37
+ # validate_method_is_defined
38
+
39
+ ## Purpose
40
+ Ensures that the class explicitly defines the method in its own namespace.
41
+ The check uses `owner_class.__dict__` to avoid inherited methods and detect
42
+ missing overrides reliably.
43
+
44
+ ## Why tuple inputs
45
+ The validation receives:
46
+ - `exception_info` — (class_name, method_name, context)
47
+ - `expected_structure` — code blueprint
48
+
49
+ This keeps the function simple, fast, and consistent with all other
50
+ exception‑helpers in the metadata pipeline.
51
+
52
+ ## Behavior
53
+ If the method is not found in `__dict__`, the validator raises a structured
54
+ `SimpleDefinitionError` containing:
55
+ - the missing method name,
56
+ - the class name,
57
+ - a clear explanation,
58
+ - a copy‑paste ready blueprint showing the correct method layout.
59
+
60
+ ## Notes
61
+ This validator is used for all three method types:
62
+ - `_validate`
63
+ - `_logic`
64
+ - `_decompose`
65
+
66
+ It is the first guard in the classmethod verification chain.
67
+ """
@@ -0,0 +1,117 @@
1
+ from typing import TYPE_CHECKING
2
+ from simplibs.sentinels import UNSET
3
+ # Outers
4
+ from .._exceptions_helpers import (
5
+ exception_info_for_classmethod,
6
+ expected_structure_for_classmethod,
7
+ )
8
+ # Inners
9
+ from ._clone_classmethod import _clone_classmethod
10
+ from .validations import (
11
+ validate_method_is_defined,
12
+ validate_method_is_callable,
13
+ validate_method_is_classmethod,
14
+ )
15
+ # Annotations
16
+ if TYPE_CHECKING:
17
+ from ......protocols.classes import SimpleClassLike
18
+ from ......protocols.methods import ClassMethodProtocol
19
+
20
+
21
+ def verify_classmethod(
22
+ method_name: str,
23
+ owner_class: "SimpleClassLike",
24
+ expected_params: tuple[str, ...],
25
+ expected_args_params_count: int,
26
+ ) -> tuple[bool, "classmethod | ClassMethodProtocol"]:
27
+ """Verifies classmethod existence, inheritance boundaries, and isolation rules."""
28
+ from .......SimpleObject import SimpleObject
29
+
30
+ # 1. Prepare raw layout metadata
31
+ raw_method = owner_class.__dict__.get(method_name, UNSET)
32
+ bound_method = getattr(owner_class, method_name)
33
+
34
+ # 2. Early exit for default/undefined _decompose
35
+ if (
36
+ method_name == "_decompose"
37
+ and raw_method is UNSET
38
+ and getattr(bound_method, "__func__", None) is SimpleObject._decompose.__func__
39
+ ):
40
+ return False, UNSET
41
+
42
+ # 3. Check if the attribute is a classmethod descriptor
43
+ if (
44
+ raw_method is not UNSET
45
+ and isinstance(raw_method, classmethod)
46
+ ) or raw_method is UNSET:
47
+ bound_method: ClassMethodProtocol
48
+
49
+ # 3.1 Local override → validate
50
+ if raw_method is not UNSET:
51
+ return True, bound_method
52
+
53
+ # 3.2 Inherited _validate → never re-validate
54
+ if method_name == "_validate":
55
+ return False, bound_method
56
+
57
+ # 3.3 Check direct inheritance from SimpleObject
58
+ is_direct_descendant = SimpleObject in owner_class.__bases__
59
+
60
+ # 3.4 Deep subclass → clone if structural keys exist
61
+ if not is_direct_descendant:
62
+ need_validations = bool(owner_class.__dict__.keys() & {"_inners", "_type", "_logic"})
63
+ output = _clone_classmethod(bound_method) if need_validations else bound_method
64
+ return need_validations, output
65
+
66
+ # 4. Build exception metadata
67
+ exception_info = exception_info_for_classmethod(bound_method)
68
+ expected_structure = expected_structure_for_classmethod(
69
+ bound_method,
70
+ expected_params,
71
+ expected_args_params_count,
72
+ )
73
+
74
+ # 5. Run micro-validations
75
+ validate_method_is_defined(method_name, owner_class, exception_info, expected_structure)
76
+ validate_method_is_callable(raw_method, exception_info, expected_structure)
77
+ validate_method_is_classmethod(raw_method, exception_info, expected_structure)
78
+ return False, UNSET
79
+
80
+
81
+
82
+ _DESIGN_NOTES = """
83
+ # verify_classmethod
84
+
85
+ ## Purpose
86
+ Acts as the central gatekeeper for classmethod validation (`_validate`, `_logic`, `_decompose`).
87
+ It determines whether a method should be validated, cloned, inherited, or rejected before dry-run execution.
88
+
89
+ ## Step-by-step behavior
90
+
91
+ ### 1. Namespace extraction
92
+ Two views of the method are captured:
93
+ - `raw_method` → local class namespace (`owner_class.__dict__`). Checked to determine local override.
94
+ - `bound_method` → resolved through full MRO (`getattr(owner_class, method_name)`). Unset fallback is intentionally omitted because all supported lifecycle methods (_validate, _logic, _decompose) are guaranteed to exist in MRO contracts.
95
+
96
+ ### 2. Early-exit for default `_decompose`
97
+ Decomposition is optional. `SimpleObject` defines a default fallback `@classmethod def _decompose` that returns `UNSET`.
98
+ To avoid triggering unnecessary validation pipelines or dry-run evaluation failures on nested subclasses:
99
+ - If `method_name == "_decompose"` AND `raw_method is UNSET` (not overridden locally) AND `bound_method.__func__` points to `SimpleObject._decompose.__func__` (memory identity check via `is`), the process immediately short-circuits returning `(False, UNSET)`.
100
+ - If an intermediate ancestor defines a custom `_decompose`, memory pointers won't match `SimpleObject._decompose.__func__`, allowing proper inheritance and re-validation down the hierarchy.
101
+
102
+ ### 3. Descriptor routing & isolation rules
103
+ If the method is a valid `classmethod` or inherited descriptor:
104
+ - **Local override (`raw_method is not UNSET`)**: Always requires full signature and dry-run validation (`return True, bound_method`).
105
+ - **Inherited `_validate`**: Validation rules belong to the declaring class; inherited `_validate` methods are never re-validated (`return False, bound_method`).
106
+ - **Deep subclassing (non-direct descendants)**: Inherited methods are cloned using `_clone_classmethod` if the subclass alters structural keys (`_inners`, `_type`, `_logic`) to isolate method state and prevent side-effects.
107
+
108
+ ### 4. Exception metadata & Micro-validations
109
+ If a method fails structural descriptor checks (e.g. defined as standard function instead of `@classmethod`), descriptive diagnostics are compiled (`exception_info`, `expected_structure`) and dispatched to targeted micro-validators:
110
+ - `validate_method_is_defined`
111
+ - `validate_method_is_callable`
112
+ - `validate_method_is_classmethod`
113
+
114
+ ## Notes
115
+ - `is` comparison on `.__func__` operates at CPython pointer level (O(1) efficiency) without requiring expensive MRO traversals.
116
+ - Early exit guarantees that unhandled `_decompose` hooks will not leak `UNSET` outcomes into dry-run validators.
117
+ """
@@ -0,0 +1,15 @@
1
+ from .verify_params import verify_params
2
+
3
+
4
+ _DESIGN_NOTES = """
5
+ # Params Verification Package
6
+
7
+ ## Purpose
8
+ Orchestrates structural footprint audits across method inputs. It aligns physical method signatures directly with metadata naming registries, preventing illegal positional layouts, missing parameters, or forbidden variable arguments.
9
+
10
+ ## Internal Components Registry
11
+
12
+ | Component | Type | Description |
13
+ | :-------------- | :------- | :----------------------------------------------------------------------------------- |
14
+ | `verify_params` | Function | High-level coordinator validating complete argument naming layouts and signature counts. |
15
+ """