simplibs-object 0.1.0__tar.gz

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 (588) hide show
  1. simplibs_object-0.1.0/LICENSE +21 -0
  2. simplibs_object-0.1.0/PKG-INFO +590 -0
  3. simplibs_object-0.1.0/README.md +557 -0
  4. simplibs_object-0.1.0/pyproject.toml +64 -0
  5. simplibs_object-0.1.0/setup.cfg +4 -0
  6. simplibs_object-0.1.0/src/simplibs/object/SimpleBase.py +115 -0
  7. simplibs_object-0.1.0/src/simplibs/object/SimpleConstant.py +271 -0
  8. simplibs_object-0.1.0/src/simplibs/object/SimpleObject.py +293 -0
  9. simplibs_object-0.1.0/src/simplibs/object/__init__.py +7 -0
  10. simplibs_object-0.1.0/src/simplibs/object/_core/__init__.py +66 -0
  11. simplibs_object-0.1.0/src/simplibs/object/_core/logic/__init__.py +0 -0
  12. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/__init__.py +22 -0
  13. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/bool_or_raise_validate_error.py +76 -0
  14. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/normalize.py +92 -0
  15. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validate.py +99 -0
  16. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validate_type.py +48 -0
  17. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/__init__.py +22 -0
  18. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/_extract_clean_code_lines.py +86 -0
  19. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/raise_missing_value_error.py +71 -0
  20. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/raise_type_error.py +59 -0
  21. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/raise_unexpected_validation_error.py +66 -0
  22. simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/raise_validation_error.py +78 -0
  23. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/__init__.py +18 -0
  24. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/_process_calculate_value_params.py +108 -0
  25. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/calculate_value.py +81 -0
  26. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/decompose_value.py +91 -0
  27. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/__init__.py +22 -0
  28. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/raise_class_not_decomposeable.py +82 -0
  29. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/raise_duplicate_argument_error.py +77 -0
  30. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/raise_too_many_positional_args_error.py +81 -0
  31. simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/raise_unknown_parameter_error.py +77 -0
  32. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/__init__.py +20 -0
  33. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/create_instance_property.py +66 -0
  34. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/create_properties_for_inner.py +97 -0
  35. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/create_value_property.py +98 -0
  36. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/__init__.py +18 -0
  37. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/create_value_getter.py +52 -0
  38. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/create_value_setter.py +95 -0
  39. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/validations/__init__.py +16 -0
  40. simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/validations/raise_locked_value_error.py +103 -0
  41. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/SimpleBaseMetadata.py +139 -0
  42. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/SimpleConstantMetadata.py +108 -0
  43. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/SimpleMeta.py +214 -0
  44. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/SimpleObjectMetadata.py +165 -0
  45. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/__init__.py +16 -0
  46. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/constants/BASE_CLASS_NAMES.py +23 -0
  47. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/constants/__init__.py +16 -0
  48. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/__init__.py +47 -0
  49. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/blueprint_path/__init__.py +15 -0
  50. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/blueprint_path/calculate_blueprint_path.py +81 -0
  51. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/__init__.py +17 -0
  52. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/process_default_for_constant.py +71 -0
  53. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/__init__.py +19 -0
  54. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/_exception_info_for_default.py +66 -0
  55. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/raise_default_is_defined_in_composition.py +78 -0
  56. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/validate_default_is_defined.py +77 -0
  57. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/validate_default_matches_annotation.py +93 -0
  58. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/__init__.py +15 -0
  59. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/process_inners.py +143 -0
  60. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/__init__.py +33 -0
  61. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/_exception_info_for_inners.py +43 -0
  62. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/_get_collision_path.py +45 -0
  63. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_collision_within_inners.py +78 -0
  64. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_if_collision_with_owner_class.py +66 -0
  65. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_class.py +58 -0
  66. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_not_simple_class.py +60 -0
  67. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_simple_subclass.py +61 -0
  68. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_defined.py +56 -0
  69. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_not_empty.py +57 -0
  70. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_tuple.py +57 -0
  71. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/__init__.py +15 -0
  72. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/process_classmethod.py +130 -0
  73. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/__init__.py +16 -0
  74. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/__init__.py +17 -0
  75. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/exception_info_for_classmethod.py +52 -0
  76. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/expected_structure_for_classmethod.py +80 -0
  77. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/__init__.py +15 -0
  78. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/__init__.py +19 -0
  79. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/_convert_annotation_to_type_set.py +38 -0
  80. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_annotations.py +84 -0
  81. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_args_defaults.py +76 -0
  82. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_kwargs_defaults.py +74 -0
  83. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/verify_annotations_and_defaults.py +100 -0
  84. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/__init__.py +15 -0
  85. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/__init__.py +15 -0
  86. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/__init__.py +19 -0
  87. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/raise_decompose_unvalide_outcome_length.py +64 -0
  88. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_type.py +77 -0
  89. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_value.py +72 -0
  90. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/verify_decompose_outcome.py +87 -0
  91. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/__init__.py +17 -0
  92. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_raised_exceptions.py +56 -0
  93. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_return_unvalide_outcome_type.py +80 -0
  94. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/verify_calculation.py +89 -0
  95. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/__init__.py +15 -0
  96. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/_clone_classmethod.py +81 -0
  97. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/__init__.py +19 -0
  98. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_callable.py +60 -0
  99. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_classmethod.py +60 -0
  100. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_defined.py +67 -0
  101. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/verify_classmethod.py +117 -0
  102. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/__init__.py +15 -0
  103. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/__init__.py +19 -0
  104. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_has_exact_args_count.py +59 -0
  105. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_not_use_param_placeholders.py +66 -0
  106. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_param_match_expected.py +61 -0
  107. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/verify_params.py +123 -0
  108. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/__init__.py +15 -0
  109. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/_class_name_splitter.py +242 -0
  110. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/create_names.py +119 -0
  111. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/validations/__init__.py +19 -0
  112. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_has_no_underscores.py +94 -0
  113. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_ascii.py +95 -0
  114. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_identifier.py +83 -0
  115. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/__init__.py +15 -0
  116. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/process_type.py +117 -0
  117. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/__init__.py +29 -0
  118. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/_exception_info_for_type.py +88 -0
  119. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/raise_union_type_contain_none.py +70 -0
  120. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/raise_validate_type_is_not_valid.py +92 -0
  121. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_from_tuple_is_not_none.py +94 -0
  122. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_defined.py +85 -0
  123. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_empty.py +93 -0
  124. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_none.py +87 -0
  125. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_tuple_is_not_nested.py +92 -0
  126. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/__init__.py +55 -0
  127. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/InstanceBase.py +77 -0
  128. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/__init__.py +16 -0
  129. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/helpers/__init__.py +16 -0
  130. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_atom_init.py +51 -0
  131. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_root_value_setter.py +67 -0
  132. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/make_atom_class.py +101 -0
  133. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/__init__.py +14 -0
  134. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/__init__.py +20 -0
  135. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/_get_inner_instance_class.py +51 -0
  136. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_composite_init.py +74 -0
  137. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_properties_for_inners.py +50 -0
  138. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_inners.py +57 -0
  139. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_self.py +69 -0
  140. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/make_composite_class.py +93 -0
  141. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/__init__.py +17 -0
  142. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/create_instance.py +107 -0
  143. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/__init__.py +25 -0
  144. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_combined_init_mixins.py +40 -0
  145. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_instance_class_dict.py +127 -0
  146. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_extend_instance_class.py +59 -0
  147. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_resolve_flat_mixins.py +74 -0
  148. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_verify_mixin_compatibility.py +83 -0
  149. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/create_instance_class.py +76 -0
  150. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/get_base_class.py +53 -0
  151. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/__init__.py +20 -0
  152. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/__init__.py +29 -0
  153. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_composite.py +61 -0
  154. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_constant.py +61 -0
  155. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_immutable.py +61 -0
  156. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_mutable.py +60 -0
  157. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_support_default_value_type.py +66 -0
  158. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_class.py +56 -0
  159. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_simple_base_subclass.py +60 -0
  160. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_invalide_extend_instance_class_definition.py +62 -0
  161. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision.py +56 -0
  162. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision_with_base_class.py +56 -0
  163. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/validations/__init__.py +21 -0
  164. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/validations/validate_class_is_not_base_class.py +54 -0
  165. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/validations/validate_hashing_for_immutable_value.py +66 -0
  166. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/validations/validate_param_is_bool.py +47 -0
  167. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/validations/__init__.py +18 -0
  168. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/validations/raise_attribut_allready_set.py +57 -0
  169. simplibs_object-0.1.0/src/simplibs/object/_core/metadata/validations/raise_metadata_is_immutable.py +73 -0
  170. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/__init__.py +118 -0
  171. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/__init__.py +137 -0
  172. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/changes/ChangeTuple.py +5 -0
  173. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/changes/ChangesDict.py +5 -0
  174. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/changes/ChangesTuple.py +8 -0
  175. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/changes/__init__.py +18 -0
  176. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/history/HistoryDict.py +5 -0
  177. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/history/HistoryEntry.py +10 -0
  178. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/history/__init__.py +16 -0
  179. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/inners/InnersMap.py +8 -0
  180. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/inners/InnersTuple.py +8 -0
  181. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/inners/__init__.py +16 -0
  182. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/mixins/MixinsTuple.py +8 -0
  183. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/mixins/__init__.py +14 -0
  184. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/names/NamesSet.py +5 -0
  185. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/names/NamesTuple.py +5 -0
  186. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/names/__init__.py +16 -0
  187. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodeItem.py +9 -0
  188. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesDict.py +9 -0
  189. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesIndexMap.py +6 -0
  190. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesInstanceDict.py +9 -0
  191. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesPathDict.py +9 -0
  192. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesTuple.py +8 -0
  193. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/__init__.py +24 -0
  194. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/paths/PathDict.py +8 -0
  195. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/paths/PathTuple.py +5 -0
  196. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/paths/__init__.py +16 -0
  197. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDict.py +5 -0
  198. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffItem.py +5 -0
  199. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffTuple.py +8 -0
  200. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotTuple.py +5 -0
  201. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/__init__.py +20 -0
  202. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/state/StateDict.py +5 -0
  203. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/state/__init__.py +14 -0
  204. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/types/ValidTypes.py +6 -0
  205. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/types/__init__.py +14 -0
  206. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/classes/SimpleBaseProtocol.py +25 -0
  207. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/classes/SimpleConstantProtocol.py +54 -0
  208. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/classes/SimpleObjectProtocol.py +50 -0
  209. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/classes/__init__.py +26 -0
  210. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/SimpleConstantInstanceProtocol.py +13 -0
  211. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/SimpleInstanceBaseProtocol.py +24 -0
  212. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/SimpleObjectInstanceProtocol.py +13 -0
  213. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/__init__.py +29 -0
  214. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/core_classes/AtomInstanceProtocol.py +46 -0
  215. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/core_classes/CompositeInstanceProtocol.py +37 -0
  216. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/core_classes/InstanceBaseProtocol.py +28 -0
  217. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/core_classes/__init__.py +19 -0
  218. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/SimpleBaseMetadataProtocol.py +37 -0
  219. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/SimpleConstantMetadataProtocol.py +45 -0
  220. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/SimpleMetaProtocol.py +39 -0
  221. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/SimpleObjectMetadataProtocol.py +49 -0
  222. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/__init__.py +28 -0
  223. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/methods/ClassMethodProtocol.py +29 -0
  224. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/methods/LogicSignature.py +20 -0
  225. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/methods/__init__.py +18 -0
  226. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/__init__.py +120 -0
  227. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/base_class/SimpleMixinProtocol.py +46 -0
  228. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/base_class/__init__.py +18 -0
  229. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/InfrastructureProtocol.py +16 -0
  230. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/NodesDictsProtocol.py +38 -0
  231. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/NodesTupleProtocol.py +30 -0
  232. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/SerializationProtocol.py +55 -0
  233. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/SnapshotProtocol.py +42 -0
  234. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/__init__.py +27 -0
  235. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/__init__.py +123 -0
  236. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/CollectionBaseProtocol.py +37 -0
  237. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/CollectionProtocol.py +20 -0
  238. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/IterableProtocol.py +37 -0
  239. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/MappingProtocol.py +52 -0
  240. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/__init__.py +21 -0
  241. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/comparison/EqualityProtocol.py +31 -0
  242. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/comparison/OrderingProtocol.py +32 -0
  243. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/comparison/__init__.py +16 -0
  244. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/generics/ClassGetItemProtocol.py +23 -0
  245. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/generics/__init__.py +14 -0
  246. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/interfaces/CallProtocol.py +26 -0
  247. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/interfaces/ContextProtocol.py +38 -0
  248. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/interfaces/__init__.py +16 -0
  249. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/CopyableProtocol.py +33 -0
  250. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/LifecycleProtocol.py +21 -0
  251. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleReduceProtocol.py +30 -0
  252. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleStateProtocol.py +42 -0
  253. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/__init__.py +20 -0
  254. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/PicklePlan.py +5 -0
  255. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/__init__.py +14 -0
  256. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/ArithmeticProtocol.py +95 -0
  257. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/BitwiseProtocol.py +79 -0
  258. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/ConversionProtocol.py +57 -0
  259. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/InplaceProtocol.py +66 -0
  260. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/UnaryProtocol.py +35 -0
  261. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/__init__.py +22 -0
  262. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/Operator.py +5 -0
  263. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/UnaryOperator.py +5 -0
  264. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/__init__.py +16 -0
  265. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/representation/ValueDisplayProtocol.py +30 -0
  266. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/representation/ValueFormattingProtocol.py +42 -0
  267. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/representation/__init__.py +16 -0
  268. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsProtocol.py +69 -0
  269. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsWithInnersProtocol.py +27 -0
  270. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/immutable/__init__.py +18 -0
  271. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/EqualizerProtocol.py +37 -0
  272. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/VolumeProtocol.py +32 -0
  273. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/__init__.py +17 -0
  274. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/internal_types/SteppersMap.py +8 -0
  275. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/internal_types/__init__.py +14 -0
  276. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/StepperProtocol.py +95 -0
  277. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/__init__.py +14 -0
  278. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/LimitAction.py +5 -0
  279. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/StepValue.py +6 -0
  280. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/__init__.py +16 -0
  281. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/properties/InnersPropertyProtocol.py +31 -0
  282. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/properties/MetaShortcutsProtocol.py +49 -0
  283. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/properties/__init__.py +17 -0
  284. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/DefaultStateProtocol.py +41 -0
  285. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/DirtyTrackingProtocol.py +61 -0
  286. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/HistoryProtocol.py +112 -0
  287. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/PermissionProtocol.py +35 -0
  288. simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/__init__.py +22 -0
  289. simplibs_object-0.1.0/src/simplibs/object/exceptions/SimpleDefinitionError.py +45 -0
  290. simplibs_object-0.1.0/src/simplibs/object/exceptions/SimpleInitializationError.py +43 -0
  291. simplibs_object-0.1.0/src/simplibs/object/exceptions/SimpleRuntimeError.py +50 -0
  292. simplibs_object-0.1.0/src/simplibs/object/exceptions/__init__.py +62 -0
  293. simplibs_object-0.1.0/src/simplibs/object/exceptions/base_exception/SimpleObjectError.py +107 -0
  294. simplibs_object-0.1.0/src/simplibs/object/exceptions/base_exception/__init__.py +19 -0
  295. simplibs_object-0.1.0/src/simplibs/object/mixins/__init__.py +99 -0
  296. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/__init__.py +41 -0
  297. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/__init__.py +27 -0
  298. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/HISTORY.py +14 -0
  299. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/OWNER_CLASS.py +14 -0
  300. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/STEPPER.py +14 -0
  301. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/VALUE.py +14 -0
  302. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/__init__.py +28 -0
  303. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/sets/FORBIDDEN_NAMES.py +27 -0
  304. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/sets/RESTRICTION_FLAGS.py +18 -0
  305. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/sets/__init__.py +22 -0
  306. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/__init__.py +28 -0
  307. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/__init__.py +17 -0
  308. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/__init__.py +22 -0
  309. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/get_top_composite_paths.py +142 -0
  310. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/process_single_change.py +143 -0
  311. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_changes.py +142 -0
  312. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths.py +147 -0
  313. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths2.py +142 -0
  314. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/__init__.py +23 -0
  315. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_split_changes_unknown_name.py +107 -0
  316. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_with_any_unknown_name.py +71 -0
  317. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/__init__.py +24 -0
  318. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_changes_is_not_tuple.py +65 -0
  319. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_child_composite_mismatch.py +68 -0
  320. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_contained_constant_mismatch.py +67 -0
  321. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/with_any.py +238 -0
  322. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/__init__.py +17 -0
  323. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/utils/__init__.py +15 -0
  324. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/utils/reacalculate_inners.py +112 -0
  325. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/__init__.py +21 -0
  326. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_is_decomposeable.py +71 -0
  327. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_name_exists.py +71 -0
  328. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/with_composite.py +176 -0
  329. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/__init__.py +17 -0
  330. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/utils/__init__.py +20 -0
  331. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_new_instance.py +130 -0
  332. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_snapshot_dict.py +83 -0
  333. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/utils/reacalculate_owner_value.py +131 -0
  334. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/__init__.py +16 -0
  335. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/raise_immutability_constant_not_found.py +93 -0
  336. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/with_constant.py +147 -0
  337. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/__init__.py +17 -0
  338. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/utils/__init__.py +15 -0
  339. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/utils/find_longest_keys.py +112 -0
  340. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/__init__.py +25 -0
  341. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_batch_constant_not_found.py +94 -0
  342. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_constants_changes_not_tuple.py +94 -0
  343. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_has_length_two.py +91 -0
  344. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_is_tuple.py +99 -0
  345. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_name_is_str.py +90 -0
  346. simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/with_constants.py +193 -0
  347. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/SimpleMixin.py +118 -0
  348. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/__init__.py +17 -0
  349. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/SimpleMixinMeta.py +59 -0
  350. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/__init__.py +21 -0
  351. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/_verify_mixin_definition.py +161 -0
  352. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/__init__.py +34 -0
  353. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_dict_contains_forbidden_attributes.py +101 -0
  354. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_flag_is_not_bool.py +122 -0
  355. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_init_mixins_contains_super_call.py +75 -0
  356. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_only_types_invalid.py +107 -0
  357. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contain_unvalid_type.py +85 -0
  358. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contains_forbidden_slot_names.py +102 -0
  359. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_is_not_defined.py +79 -0
  360. simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_unsuport_type.py +88 -0
  361. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/Infrastructure.py +49 -0
  362. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/NodesDicts.py +104 -0
  363. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/NodesTuple.py +86 -0
  364. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/Serialization.py +120 -0
  365. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/Snapshot.py +104 -0
  366. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/__init__.py +32 -0
  367. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/__init__.py +49 -0
  368. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/nodes_tuple/__init__.py +17 -0
  369. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/nodes_tuple/_collect_nodes_data.py +131 -0
  370. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/nodes_tuple/build_nodes_tuple.py +104 -0
  371. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/__init__.py +20 -0
  372. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/from_dict.py +190 -0
  373. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/from_dict_constants.py +151 -0
  374. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/to_dict.py +158 -0
  375. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/__init__.py +30 -0
  376. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_invalid_composite_structure.py +65 -0
  377. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_composite_key.py +64 -0
  378. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_value_key.py +66 -0
  379. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_owner_class_mismatch_for_state_dict.py +77 -0
  380. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_state_dict_input.py +67 -0
  381. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/snapshot/__init__.py +15 -0
  382. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/snapshot/compare_snapshots.py +102 -0
  383. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/snapshot/validations/__init__.py +16 -0
  384. simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/snapshot/validations/raise_snapshot_incompatible_error.py +101 -0
  385. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/__init__.py +61 -0
  386. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/CollectionBase.py +129 -0
  387. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/Iterable.py +81 -0
  388. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/Mapping.py +131 -0
  389. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/__init__.py +29 -0
  390. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/main/Collection.py +47 -0
  391. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/main/__init__.py +20 -0
  392. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/comparison/Equality.py +128 -0
  393. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/comparison/Ordering.py +130 -0
  394. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/comparison/__init__.py +25 -0
  395. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/generics/ClassGetItem.py +105 -0
  396. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/generics/__init__.py +20 -0
  397. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/interfaces/Call.py +101 -0
  398. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/interfaces/Context.py +100 -0
  399. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/interfaces/__init__.py +23 -0
  400. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/Copyable.py +103 -0
  401. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/PickleReduce.py +88 -0
  402. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/PickleState.py +104 -0
  403. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/__init__.py +29 -0
  404. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/_utils/__init__.py +20 -0
  405. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/_utils/rebuild_simple_instance.py +51 -0
  406. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/main/Lifecycle.py +45 -0
  407. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/main/__init__.py +20 -0
  408. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Arithmetic.py +195 -0
  409. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Bitwise.py +172 -0
  410. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Conversion.py +149 -0
  411. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Inplace.py +124 -0
  412. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Unary.py +89 -0
  413. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/__init__.py +31 -0
  414. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/__init__.py +41 -0
  415. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/_align_operand_type.py +111 -0
  416. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_arithmetic_op.py +157 -0
  417. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_bitwise_op.py +116 -0
  418. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_conversion.py +107 -0
  419. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_inplace_op.py +139 -0
  420. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_unary_op.py +121 -0
  421. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/representation/ValueDisplay.py +96 -0
  422. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/representation/ValueFormatting.py +144 -0
  423. simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/representation/__init__.py +24 -0
  424. simplibs_object-0.1.0/src/simplibs/object/mixins/others/__init__.py +48 -0
  425. simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/ImmutableMethods.py +142 -0
  426. simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/ImmutableMethodsWithInners.py +111 -0
  427. simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/__init__.py +24 -0
  428. simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/_validations/__init__.py +19 -0
  429. simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/_validations/raise_with_changes_input_not_dict.py +60 -0
  430. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/Equalizer.py +129 -0
  431. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/Volume.py +100 -0
  432. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/__init__.py +25 -0
  433. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/Stepper.py +227 -0
  434. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/__init__.py +31 -0
  435. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/__init__.py +35 -0
  436. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/__init__.py +33 -0
  437. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/process_step_value.py +114 -0
  438. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/__init__.py +29 -0
  439. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_down_limit_reached.py +115 -0
  440. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_up_limit_reached.py +110 -0
  441. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_down_limit.py +141 -0
  442. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_up_limit.py +141 -0
  443. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/set_value.py +163 -0
  444. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/step_down.py +154 -0
  445. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/step_up.py +154 -0
  446. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/__init__.py +38 -0
  447. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/process_down_limit_value.py +143 -0
  448. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/process_limit_action.py +118 -0
  449. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/process_up_limit_value.py +143 -0
  450. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/process_value.py +142 -0
  451. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validate_instance.py +138 -0
  452. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/__init__.py +39 -0
  453. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_action.py +118 -0
  454. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_down_limit.py +125 -0
  455. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_instance.py +117 -0
  456. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_up_limit.py +125 -0
  457. simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_non_numeric_value.py +122 -0
  458. simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/InnersProperty.py +91 -0
  459. simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/MetaShortcuts.py +113 -0
  460. simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/__init__.py +24 -0
  461. simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/_inners_property_utils/__init__.py +23 -0
  462. simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/_inners_property_utils/_collect_nested_inner_properties.py +134 -0
  463. simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/_inners_property_utils/collect_all_nested_properties.py +132 -0
  464. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/DefaultState.py +119 -0
  465. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/DirtyTracking.py +144 -0
  466. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/History.py +248 -0
  467. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/Permission.py +102 -0
  468. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/__init__.py +31 -0
  469. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/__init__.py +50 -0
  470. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/__init__.py +32 -0
  471. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/find_snapshot.py +142 -0
  472. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/record_state.py +130 -0
  473. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/set_history_limit.py +114 -0
  474. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/__init__.py +31 -0
  475. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_history_limit_not_positive_integer.py +65 -0
  476. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snapshot_index.py +67 -0
  477. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_reference.py +67 -0
  478. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_timestamp.py +66 -0
  479. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_timestamp.py +63 -0
  480. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/__init__.py +38 -0
  481. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_index.py +103 -0
  482. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_timestamp.py +115 -0
  483. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/go_to_last_history.py +103 -0
  484. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/history_redo.py +103 -0
  485. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/history_undo.py +104 -0
  486. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/__init__.py +31 -0
  487. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/export_history_to_dict.py +110 -0
  488. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/import_history_from_dict.py +169 -0
  489. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/validations/__init__.py +24 -0
  490. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_history_import_file.py +66 -0
  491. simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_owner_class_mismatch.py +69 -0
  492. simplibs_object-0.1.0/src/simplibs/object/settings/__init__.py +90 -0
  493. simplibs_object-0.1.0/src/simplibs/object/settings/logging.py +138 -0
  494. simplibs_object-0.1.0/src/simplibs/object/testing/__init__.py +90 -0
  495. simplibs_object-0.1.0/src/simplibs/object/testing/assert_simple_mixin.py +150 -0
  496. simplibs_object-0.1.0/src/simplibs/object/testing/assert_simple_object.py +219 -0
  497. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/__init__.py +53 -0
  498. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/__init__.py +22 -0
  499. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/assert_class_inheritance.py +75 -0
  500. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/assert_instance_creation.py +119 -0
  501. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/assert_user_instance_creation.py +97 -0
  502. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/assert_value_change.py +142 -0
  503. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/methods/__init__.py +20 -0
  504. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/methods/assert_calculate_value_method.py +113 -0
  505. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/methods/assert_decompose_value_method.py +109 -0
  506. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/methods/assert_validate_method.py +111 -0
  507. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/__init__.py +22 -0
  508. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/assert_instance_hasattr.py +94 -0
  509. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/assert_mixin_inheritance.py +72 -0
  510. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/assert_mixin_instance_creation.py +142 -0
  511. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/assert_mixins_slots_values.py +126 -0
  512. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mutability/__init__.py +18 -0
  513. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mutability/assert_immutable_behavior.py +118 -0
  514. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mutability/assert_mutable_behavior.py +108 -0
  515. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/reactivity/__init__.py +17 -0
  516. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/reactivity/assert_reactivity_downward.py +141 -0
  517. simplibs_object-0.1.0/src/simplibs/object/testing/asserts/reactivity/assert_reactivity_upward.py +109 -0
  518. simplibs_object-0.1.0/src/simplibs/object/testing/bulk_test.py +150 -0
  519. simplibs_object-0.1.0/src/simplibs/object/testing/containers/InnerValue.py +102 -0
  520. simplibs_object-0.1.0/src/simplibs/object/testing/containers/MixinCase.py +89 -0
  521. simplibs_object-0.1.0/src/simplibs/object/testing/containers/ObjectCase.py +101 -0
  522. simplibs_object-0.1.0/src/simplibs/object/testing/containers/TestMixin.py +122 -0
  523. simplibs_object-0.1.0/src/simplibs/object/testing/containers/__init__.py +20 -0
  524. simplibs_object-0.1.0/src/simplibs/object/testing/containers/_validations/__init__.py +18 -0
  525. simplibs_object-0.1.0/src/simplibs/object/testing/containers/_validations/raise_inner_value_empty_path.py +39 -0
  526. simplibs_object-0.1.0/src/simplibs/object/testing/containers/_validations/raise_inner_value_invalid_path_type.py +44 -0
  527. simplibs_object-0.1.0/src/simplibs/object/tools/__init__.py +0 -0
  528. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/__init__.py +0 -0
  529. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/__init__.py +5 -0
  530. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_is_lambda.py +34 -0
  531. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_validations/__init__.py +3 -0
  532. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_validations/raise_calculate_default_failed.py +51 -0
  533. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_validations/raise_inner_is_not_simple_constant_subclass.py +44 -0
  534. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_validations/raise_inners_is_not_tuple.py +41 -0
  535. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/calculate_default.py +51 -0
  536. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/load_parameters_from_inners.py +72 -0
  537. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/process_decompose.py +47 -0
  538. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/process_logic.py +57 -0
  539. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/process_validate.py +48 -0
  540. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/__init__.py +7 -0
  541. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_class_name_is_str.py +36 -0
  542. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_composite_has_inners.py +43 -0
  543. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_composite_has_logic.py +44 -0
  544. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_composite_has_not_default.py +37 -0
  545. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_constant_has_default.py +48 -0
  546. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_decompose.py +37 -0
  547. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_logic.py +37 -0
  548. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/BulkCase.py +100 -0
  549. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/__init__.py +0 -0
  550. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/create_simple_object_bulk.py +77 -0
  551. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/__init__.py +0 -0
  552. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/__init__.py +8 -0
  553. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_csv_callable_not_supported.py +26 -0
  554. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_data_not_list.py +28 -0
  555. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_decode_failed.py +29 -0
  556. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_sequence.py +27 -0
  557. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_str.py +28 -0
  558. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_item_is_not_bulk_dict.py +39 -0
  559. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_table_row_not_sequence.py +26 -0
  560. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_yaml_import_failed.py +22 -0
  561. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_bulk_case_class.py +57 -0
  562. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_csv.py +68 -0
  563. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_dicts.py +19 -0
  564. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_json.py +24 -0
  565. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_table.py +43 -0
  566. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_yaml.py +29 -0
  567. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/create_constant_class.py +84 -0
  568. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/create_object_class.py +110 -0
  569. simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/create_simple_object.py +97 -0
  570. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/__init__.py +18 -0
  571. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/__init__.py +28 -0
  572. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/raise_random_data_filler_exhausted.py +55 -0
  573. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_instance_is_simple_constant_base.py +52 -0
  574. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_registry_is_randomize_registry_base.py +51 -0
  575. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_retries_is_greater_than_zero.py +48 -0
  576. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_retries_is_int.py +49 -0
  577. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_skip_immutable_is_bool.py +43 -0
  578. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_skip_unregistered_is_bool.py +44 -0
  579. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/random_data_filler.py +133 -0
  580. simplibs_object-0.1.0/src/simplibs/object/tools/randomize/randomize_value.py +122 -0
  581. simplibs_object-0.1.0/src/simplibs_object.egg-info/PKG-INFO +590 -0
  582. simplibs_object-0.1.0/src/simplibs_object.egg-info/SOURCES.txt +586 -0
  583. simplibs_object-0.1.0/src/simplibs_object.egg-info/dependency_links.txt +1 -0
  584. simplibs_object-0.1.0/src/simplibs_object.egg-info/requires.txt +10 -0
  585. simplibs_object-0.1.0/src/simplibs_object.egg-info/top_level.txt +1 -0
  586. simplibs_object-0.1.0/tests/test_SimpleBase.py +18 -0
  587. simplibs_object-0.1.0/tests/test_SimpleConstant.py +60 -0
  588. simplibs_object-0.1.0/tests/test_SimpleObject.py +42 -0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Dalibor Sova (Sudip2708)
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
@@ -0,0 +1,590 @@
1
+ Metadata-Version: 2.4
2
+ Name: simplibs-object
3
+ Version: 0.1.0
4
+ Summary: A powerful meta-programming framework for building structured, validated, and composable parametric classes.
5
+ Author-email: "Dalibor Sova (Sudip2708)" <daliborsova@seznam.cz>
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/simplibs/simplibs-object
8
+ Project-URL: Repository, https://github.com/simplibs/simplibs-object
9
+ Project-URL: Issues, https://github.com/simplibs/simplibs-object/issues
10
+ Project-URL: Changelog, https://github.com/simplibs/simplibs-object/blob/main/CHANGELOG.md
11
+ Keywords: meta-programming,data-modeling,validation,composition,parametric-classes,simplibs,simple-object,developer-tools
12
+ Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Programming Language :: Python :: 3.14
19
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
20
+ Classifier: Topic :: Software Development :: Quality Assurance
21
+ Requires-Python: >=3.11
22
+ Description-Content-Type: text/markdown
23
+ License-File: LICENSE
24
+ Requires-Dist: simplibs-exception>=1.0.0
25
+ Requires-Dist: simplibs-sentinels>=0.1.0
26
+ Requires-Dist: simplibs-randomize>=0.1.0
27
+ Provides-Extra: yaml
28
+ Requires-Dist: pyyaml>=6.0; extra == "yaml"
29
+ Provides-Extra: dev
30
+ Requires-Dist: pytest>=7.0; extra == "dev"
31
+ Requires-Dist: pyyaml>=6.0; extra == "dev"
32
+ Dynamic: license-file
33
+
34
+ # 🧬 `simplibs-object`
35
+
36
+ [![PyPI](https://img.shields.io/pypi/v/simplibs-object)](https://pypi.org/project/simplibs-object/)
37
+ [![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
38
+ [![Licence](https://img.shields.io/badge/licence-MIT-green)](https://github.com/simplibs/simplibs-object/blob/main/LICENSE)
39
+
40
+ **A system for building deterministic, type-safe, and reactive objects.**
41
+
42
+
43
+ `simplibs-object` is a library for **declarative data modeling**.
44
+
45
+ Instead of writing constructors, setters, validators, and manually recalculating
46
+ dependencies, you define a class and tell it what type it has, what its default
47
+ value is, what it's composed of, and how the resulting value is built from those
48
+ parts. The library takes care of the rest.
49
+
50
+ ```bash
51
+ pip install simplibs-object
52
+ ```
53
+
54
+ ---
55
+
56
+ The library is built on three simple building blocks:
57
+
58
+ * **`SimpleConstant`** — an atomic value,
59
+ * **`SimpleObject`** — a composition of other objects,
60
+ * **`SimpleMixin`** — a capability that can be added to an object.
61
+
62
+ These blocks can be combined into simple objects as well as larger structures.
63
+
64
+ For example, you might write:
65
+
66
+ ```python
67
+ class Age(SimpleConstant):
68
+ _type = int
69
+ _default = 20
70
+ ```
71
+
72
+ or:
73
+
74
+ ```python
75
+ class Person(SimpleObject):
76
+ _type = str
77
+ _inners = (FirstName, LastName)
78
+
79
+ @classmethod
80
+ def _logic(cls, first_name, last_name):
81
+ return f"{first_name} {last_name}"
82
+ ```
83
+
84
+ And that's it — no constructors to write, no validation, no manual checks.
85
+
86
+ The library knows that the `Age` constant holds an `int`, knows its default
87
+ value, and prepares an object with the matching interface.
88
+
89
+ A composition is then an object made up of constants and other objects, and its
90
+ resulting value is derived from theirs.
91
+
92
+ That's the core principle of the whole library.
93
+
94
+ ---
95
+
96
+ ## 🏛️ Architecture at a glance
97
+
98
+ The whole system can be understood, in simplified form, as a series of layers:
99
+
100
+ ```text
101
+ ┌────────────────────────────────┐
102
+ │ Definition classes │ ◄── SimpleBase, SimpleConstant, SimpleObject
103
+ └──────────────┬─────────────────┘ (what the user writes)
104
+ ▼
105
+ ┌────────────────────────────────┐
106
+ │ Metadata process │ ◄── SimpleMeta and *Metadata classes
107
+ └──────────────┬─────────────────┘ (validation and compilation at definition time)
108
+ ▼
109
+ ┌────────────────────────────────┐
110
+ │ Instance creation │ ◄── atom/composite × mutable/immutable, mixin injection
111
+ └──────────────┬─────────────────┘ (dynamically creates a new class and instance)
112
+ ▼
113
+ ┌────────────────────────────────┐
114
+ │ Mixins │ ◄── optional capabilities
115
+ └──────────────┬─────────────────┘ (extensibility without touching the core)
116
+ ▼
117
+ ┌────────────────────────────────┐
118
+ │ Tools & testing │ ◄── automate_creators, randomize, and testing utilities
119
+ └────────────────────────────────┘ (makes life easier for developers)
120
+ ```
121
+
122
+ Each layer has its own responsibility and can be studied in more detail on its own.
123
+
124
+ ---
125
+ ## 🧩 Definition classes
126
+
127
+ `SimpleBase`
128
+ is the root of the hierarchy — purely architectural, not used directly.
129
+
130
+ `SimpleConstant`
131
+ defines an atom (`_type`, `_default`, optional `_validate`) and the public API
132
+ for validation and normalization.
133
+
134
+ `SimpleObject`
135
+ extends `SimpleConstant` with composition (`_inners`, `_logic`, optional
136
+ `_decompose`) — its `_default` is never written by hand; it's always derived
137
+ automatically from `_logic(inners' defaults)`.
138
+
139
+ ➡️ [README_SIMPLE_BASE](https://github.com/simplibs/simplibs-object/blob/main/docs/core/README_SIMPLE_BASE.md)
140
+ ➡️ [README_SIMPLE_CONSTANT](https://github.com/simplibs/simplibs-object/blob/main/docs/core/README_SIMPLE_CONSTANT.md)
141
+ ➡️ [README_SIMPLE_OBJECT](https://github.com/simplibs/simplibs-object/blob/main/docs/core/README_SIMPLE_OBJECT.md)
142
+
143
+ ---
144
+
145
+ ### Defining constants
146
+
147
+ When you write, for example:
148
+
149
+ ```python
150
+ class Age(SimpleConstant):
151
+ _type = int
152
+ _default = 18
153
+ ```
154
+
155
+ you no longer need to write a constructor by hand, store the value, check its
156
+ type, or write a setter.
157
+
158
+ The library derives the necessary behavior from the definition.
159
+
160
+ ```python
161
+ age = Age()
162
+
163
+ age.value = 25
164
+ ```
165
+
166
+ If you need to add a custom rule, you can simply do so:
167
+
168
+ ```python
169
+ class Age(SimpleConstant):
170
+ _type = int
171
+ _default = 18
172
+
173
+ @classmethod
174
+ def _validate(cls, value, *, return_bool=False):
175
+ if value < 0:
176
+ return cls.bool_or_raise_validate_error(
177
+ value,
178
+ "Age cannot be negative.",
179
+ return_bool=return_bool,
180
+ )
181
+ return True
182
+ ```
183
+
184
+ This gives you an object that knows its type, its default value, and the rules
185
+ for what counts as a valid value.
186
+
187
+ ---
188
+
189
+ ### Composition and reactivity
190
+
191
+ The library's strength becomes much more apparent once objects start being
192
+ composed of other objects.
193
+
194
+ `SimpleObject` defines:
195
+
196
+ * `_inners` — what objects it's composed of,
197
+ * `_logic` — how the resulting value is built from them,
198
+ * `_decompose` — how the resulting value can optionally be decomposed back.
199
+
200
+ For example:
201
+
202
+ ```python
203
+ class FullName(SimpleObject):
204
+ _type = str
205
+ _inners = (FirstName, LastName)
206
+
207
+ @classmethod
208
+ def _logic(cls, first_name, last_name):
209
+ return f"{first_name} {last_name}"
210
+ ```
211
+
212
+ A change to an inner value is automatically propagated to the composition:
213
+
214
+ ```python
215
+ person.first_name = "Peter"
216
+
217
+ # person.value == "Peter Smith"
218
+ ```
219
+
220
+ And if the composition supports `_decompose`, the reverse direction also works:
221
+
222
+ ```text
223
+ ┌───────────────┐
224
+ │ FullName │
225
+ │ "Peter Smith" │
226
+ └───────┬───────┘
227
+ │
228
+ _decompose
229
+ ↙ ↘
230
+ ┌──────────┐ ┌─────────┐
231
+ │ FirstName│ │LastName │
232
+ │ "Peter" │ │ "Smith" │
233
+ └──────────┘ └─────────┘
234
+ ```
235
+
236
+ This makes the library build a **bidirectionally reactive tree of values**:
237
+
238
+ * changes inside propagate up toward the root,
239
+ * a composition's change can be decomposed down toward its parts.
240
+
241
+ An important property here is determinism — recalculation isn't based on a
242
+ hidden event system or magic dependencies. The relationships between the parts
243
+ are determined entirely by the object's own definition.
244
+
245
+ ---
246
+
247
+ ## 🧠 Metadata process
248
+
249
+ Behind the declarative layer sits the `SimpleMeta` metaclass and the metadata
250
+ system.
251
+
252
+ `SimpleMeta`
253
+ is the metaclass that governs a class's entire lifecycle — creation, write-once
254
+ protection, instance creation, and representation.
255
+
256
+ When a class is defined, its metadata is computed and permanently fixed:
257
+ `SimpleBaseMetadata` → `SimpleConstantMetadata` → `SimpleObjectMetadata`
258
+ A dry run is performed, along with validation of the provided attributes and
259
+ methods.
260
+
261
+
262
+ Every element is checked:
263
+
264
+ * `_type` — whether it matches the default value,
265
+ * `_default` — whether it passes validation,
266
+ * `_inners` — whether they're composed of `SimpleObject`/`SimpleConstant`
267
+ classes and don't contain conflicting names,
268
+ * `_validate` — whether it can correctly validate a value,
269
+ * `_logic` — whether it can compute its own default from the inners' default
270
+ values,
271
+ * `_decompose` — whether it can compute the inners' default values from its
272
+ own default.
273
+
274
+ This means definition errors can surface **at class-creation time**, rather
275
+ than later when the object is actually used.
276
+
277
+ The metadata also serves as a fixed description of the blueprint, from which a
278
+ concrete runtime instance is later prepared.
279
+
280
+ ➡️ [README_SIMPLE_META](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/README_SIMPLE_META.md)
281
+ ➡️ [README_SIMPLE_BASE_METADATA](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/README_SIMPLE_BASE_METADATA.md)
282
+ ➡️ [README_SIMPLE_CONSTANT_METADATA](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/README_SIMPLE_CONSTANT_METADATA.md)
283
+ ➡️ [README_SIMPLE_OBJECT_METADATA](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/README_SIMPLE_OBJECT_METADATA.md)
284
+ ➡️ [README_METHOD_PROCESSING](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/README_METHOD_PROCESSING.md)
285
+
286
+ ---
287
+
288
+ ## 🧱 Instance creation
289
+
290
+ A blueprint is not itself an instance.
291
+
292
+ The actual runtime instance is created through dynamic compilation —
293
+ `make_atom_class` and `make_composite_class` assemble a concrete class with
294
+ slots, properties, and (for compositions) reactive hooks, and `create_instance`
295
+ safely attaches mixins to it via namespace injection. This avoids `__slots__`
296
+ conflicts while keeping a flat MRO regardless of how many mixins are used.
297
+
298
+ When an object is created, the library assembles a concrete runtime class
299
+ based on the definition and prepares everything it needs:
300
+
301
+ * slots,
302
+ * properties,
303
+ * validation,
304
+ * reactive mechanisms,
305
+ * inner objects,
306
+ * any mixins.
307
+
308
+ The instance therefore contains only what it actually needs.
309
+
310
+ Thanks to the use of `__slots__` and dynamic runtime-class assembly, there's no
311
+ need for a generic instance structure full of methods the given object will
312
+ never use.
313
+
314
+ ➡️ [README_ATOM_CLASS](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/instance/README_ATOM_CLASS.md)
315
+ ➡️ [README_COMPOSITE_CLASS](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/instance/README_COMPOSITE_CLASS.md)
316
+ ➡️ [README_CREATE_INSTANCE](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/instance/README_CREATE_INSTANCE.md)
317
+ ➡️ [README_INSTANCE_PROTOCOLS](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/instance/README_INSTANCE_PROTOCOLS.md)
318
+ ➡️ [README_VALUE_PROPERTIES](https://github.com/simplibs/simplibs-object/blob/main/docs/metadata/instance/README_VALUE_PROPERTIES.md)
319
+
320
+ ---
321
+
322
+ ## 🧩 Mixins
323
+
324
+ Mixins are what give instances their concrete capabilities — serialization,
325
+ comparison, arithmetic, change history, an immutable update API, and much more.
326
+
327
+ The library ships with a rich set of ready-made mixins, and also offers the
328
+ `SimpleMixin` base class so you **can write your own logic**.
329
+
330
+ A mixin never inherits from `SimpleObject` directly — only from `SimpleMixin`.
331
+ When an instance is created, only the structural foundation (type, slots,
332
+ validation) is taken from the blueprint (`SimpleObject`/`SimpleConstant`), and
333
+ the mixin is layered on top of that.
334
+
335
+ A custom mixin therefore doesn't need to (and must not) know anything about the
336
+ specific domain logic of the class it's applied to — it's a purely separate,
337
+ reusable capability.
338
+
339
+ The library deliberately separates an object's structure from its capabilities:
340
+
341
+ `SimpleObject` says **what an object is**.
342
+
343
+ `SimpleMixin` says **what an object can do**.
344
+
345
+ This means the same structure can be used in different ways, depending on which
346
+ capabilities you add to it.
347
+
348
+
349
+ ➡️ [README_SIMPLE_MIXIN](https://github.com/simplibs/simplibs-object/blob/main/docs/mixins/base_class/README_SIMPLE_MIXIN.md)
350
+
351
+ ---
352
+
353
+ ### Overview of available mixins
354
+
355
+ | Category | What they provide |
356
+ | ---------------- | --------------------------------------------------------------------------- |
357
+ | **Core** | `NodesTuple`, `NodesDicts`, `Snapshot`, `Infrastructure`, `Serialization` |
358
+ | **Collections** | `CollectionBase`, `Iterable`, `Mapping`, `Collection` |
359
+ | **Comparison** | `Equality`, `Ordering` |
360
+ | **Generics** | `ClassGetItem` |
361
+ | **Interfaces** | `Call`, `ContextManager` |
362
+ | **Lifecycles** | `Copyable`, `PickleState`, `PickleReduce`, `Lifecycle` |
363
+ | **Numeric** | `Arithmetic`, `Unary`, `Bitwise`, `Inplace`, `Conversion` |
364
+ | **Representation**| `ValueDisplay`, `ValueFormatting` |
365
+ | **Immutable** | `ImmutableMethods`, `ImmutableWithInners` |
366
+ | **Numerical** | `Volume`, `Equalizer` |
367
+ | **Properties** | `InnersProperty`, `MetaShortcuts` |
368
+ | **State** | `DefaultState`, `DirtyTracking`, `History`, `Permission` |
369
+
370
+ A full description of each individual mixin (compatibility flags, slots,
371
+ methods, what it builds on) is available in a dedicated overview:
372
+
373
+ ➡️ [README_MIXINS_OVERVIEW](https://github.com/simplibs/simplibs-object/blob/main/docs/mixins/README_MIXINS_OVERVIEW.md)
374
+
375
+ ---
376
+
377
+ ## 🛠️ Tools & testing
378
+
379
+ The library isn't limited to manually defining classes by hand — the project
380
+ also includes tools for:
381
+
382
+
383
+ - `automate_creators` — Programmatically creating blueprints without writing a
384
+ classic `class` definition.
385
+ ➡️ [README_AUTOMATE_CREATORS](https://github.com/simplibs/simplibs-object/blob/main/docs/tools/README_AUTOMATE_CREATORS.md)
386
+
387
+
388
+ - `bulk` — Bulk creation of blueprints and instances from various inputs, such
389
+ as JSON, YAML, CSV, or Python structures.
390
+ ➡️ [README_BULK](https://github.com/simplibs/simplibs-object/blob/main/docs/tools/README_BULK.md)
391
+
392
+
393
+ - `randomize` — Generating random values for objects and entire composition
394
+ trees. Useful for fuzz testing or quickly generating test data.
395
+ ➡️ [README_RANDOMIZE](https://github.com/simplibs/simplibs-object/blob/main/docs/tools/README_RANDOMIZE.md)
396
+
397
+
398
+
399
+ - `testing` — Testing utilities that let you verify whole blueprints or mixins
400
+ without having to write dozens of individual tests by hand.
401
+ ➡️ [README_TESTING_OVERVIEW](https://github.com/simplibs/simplibs-object/blob/main/docs/testing/README_TESTING_OVERVIEW.md)
402
+ ➡️ [README_BULK_TEST](https://github.com/simplibs/simplibs-object/blob/main/docs/testing/README_BULK_TEST.md)
403
+ ➡️ [README_MIXIN_TESTING](https://github.com/simplibs/simplibs-object/blob/main/docs/testing/README_MIXIN_TESTING.md)
404
+ ➡️ [README_OBJECT_TESTING](https://github.com/simplibs/simplibs-object/blob/main/docs/testing/README_OBJECT_TESTING.md)
405
+
406
+ ---
407
+
408
+ ### ⚠️ Exceptions
409
+
410
+ Every error the library raises inherits from a common root,
411
+ `SimpleObjectError` (built on top of [`simplibs-exception`](https://github.com/simplibs/simplibs-exception) —
412
+ structured, readable diagnostic cards instead of a bare traceback).
413
+ This means you can catch **any** error from the library with a single
414
+ `except SimpleObjectError`, or target just one specific category:
415
+
416
+ | Exception | When it happens |
417
+ |--------------------------------|------------------|
418
+ | `SimpleDefinitionError` | An error in a **class definition** — a malformed `_inners`, a disallowed `_default` on a composition, an invalid `_logic` signature. Raised at class import/definition time. |
419
+ | `SimpleInitializationError` | An error during **instance creation** — invalid `mixins`/`mutable` parameters, an incompatible mixin, failure to assemble inner elements. |
420
+ | `SimpleRuntimeError` | An error in **data or at runtime** — an invalid value on write, a failed `_validate`, an attempt to write to an immutable instance. This is the exception you'll run into most often during normal use. |
421
+
422
+ ```python
423
+ from simplibs.object.exceptions import SimpleObjectError
424
+
425
+ try:
426
+ age.value = -5
427
+ except SimpleObjectError as e:
428
+ print(e) # a structured diagnostic card: what, why, how to fix it
429
+ ```
430
+
431
+ `SimpleObjectError` also filters the library's own internal frames out of the
432
+ error's traceback (`_skip_locations`) — the error message points to **your**
433
+ code, not the library's internal implementation.
434
+
435
+ ---
436
+
437
+ ### ⚙️ Settings
438
+
439
+ The library has one configurable point: logging. There's no automatic handler
440
+ setup and no interference with the root logger — everything is opt-in and
441
+ fully under your control.
442
+
443
+ ```python
444
+ import logging
445
+ logging.getLogger("simple").setLevel(logging.DEBUG)
446
+ ```
447
+
448
+ You can also register a custom callback that runs on every value change
449
+ (`value = ...` at the root level):
450
+
451
+ ```python
452
+ import simplibs.object.settings.logging as simple_logging
453
+
454
+ def my_callback(cls, value, event):
455
+ print(f"{cls.__name__}: {event} -> {value}")
456
+
457
+ simple_logging.on_value_change = my_callback
458
+ ```
459
+
460
+
461
+ ---
462
+
463
+ ## 🧱 Benefits of the library
464
+
465
+ Every object has its own type and rules for working with its value.
466
+
467
+ Depending on the definition, it can have:
468
+
469
+ * a default value,
470
+ * validation,
471
+ * normalization,
472
+ * composition,
473
+ * automatic recalculation,
474
+ * mutable or immutable behavior,
475
+ * custom mixins.
476
+
477
+ This means the same foundation can be used for very simple values as well as
478
+ for more complex data models.
479
+
480
+ ### Declarative data models
481
+
482
+ An object's structure can be described with a handful of class attributes
483
+ instead of a pile of repetitive boilerplate.
484
+
485
+ ### Validation and normalization
486
+
487
+ Type checking, default values, and custom validation rules are part of the
488
+ object's own definition.
489
+
490
+ ### Reactive calculations
491
+
492
+ When one part of the model affects another, the change automatically
493
+ propagates to the corresponding part of the tree.
494
+
495
+ This can be useful for things like:
496
+
497
+ * configuration,
498
+ * calculations,
499
+ * simulations,
500
+ * state models,
501
+ * forms,
502
+ * API data,
503
+ * or your own domain models.
504
+
505
+ ### Immutability
506
+
507
+ An immutable instance has no setter for changing its value.
508
+
509
+ Instead of modifying an existing instance, you can create a new one via the
510
+ immutable API:
511
+
512
+ ```python
513
+ new_age = age.with_value(25)
514
+ ```
515
+
516
+ The original instance remains untouched.
517
+
518
+ ---
519
+
520
+ ## 🔭 About the library, from the author's point of view
521
+
522
+ The library grew out of a simple observation — a recurring pattern of
523
+ "type + default + validation + logic" — and a wish to give it a deterministic,
524
+ reusable foundation once and for all. It's a bit like a small language of its
525
+ own for talking to Python: minimal logic, maximum usefulness. Every function
526
+ parameter becomes its own object, and together they form a reactive system.
527
+
528
+ I plan to use it myself as the foundation for the upcoming `simplibs-validate`
529
+ — validation logic, where a `SimpleConstant` with its own `_validate` is
530
+ exactly the right building block. But I see the potential as broader than
531
+ that: since any constant can be turned into a composition by adding `_inners`,
532
+ and any composition can conversely be simplified into a constant (by removing
533
+ `_inners`, or by creating an instance with `as_atom=True`), the library can
534
+ also be used as a general **declarative building system** — extensible and
535
+ specifiable in both directions, starting from the smallest units and building
536
+ up. One idea I'd like to try out at some point: using constants as elementary
537
+ building blocks and composing descriptions of atoms and molecules out of them
538
+ — literally, not in the metaphorical programming sense.
539
+
540
+ This is the **first version** — the result of all the original ideas, but
541
+ definitely not a finished work. It's more of a solid foundation and structure
542
+ that's a pleasure to keep building on, than a finished product. Real-world use
543
+ will show, over time, what still needs tuning, extending, or rethinking
544
+ entirely.
545
+
546
+
547
+ ---
548
+
549
+ ## ☯️ About simplibs
550
+
551
+ All libraries in the **simplibs** (Simple Libraries) ecosystem share a common
552
+ engineering philosophy:
553
+
554
+ * **Dyslexia-friendly:** We actively minimize cognitive load. Code is atomized
555
+ into small, self-contained units, files are named directly after the job
556
+ they do, and explanations focus more on *why* something is designed the way
557
+ it is than just *what* it does.
558
+ * **Programmer's peace of mind:** Nothing should be missing, and nothing
559
+ should be redundant. We value clean execution paths and understandable
560
+ architecture over a rushed, disorganized pile of features.
561
+ * **Defensive style:** We actively anticipate edge cases and error states, so
562
+ that only safe execution paths remain. Code is built to degrade gracefully,
563
+ not to crash unexpectedly.
564
+ * **Minimalism:** Find the most direct path to the goal in as few steps as
565
+ possible, without compromising on safety, readability, or completeness.
566
+ * **Code as craft:** Code should be pleasant to look at, readable at a glance,
567
+ and evoke structural harmony. We treat software engineering as a precise
568
+ craft.
569
+
570
+ ---
571
+
572
+ ### 🤝 Contributing and community
573
+
574
+ This is an **open-source project**, made with care. We deeply value
575
+ collaboration with the community and welcome any feedback, bug reports, or
576
+ ideas for new features!
577
+
578
+ * **Want to contribute?** Feel free to open an Issue or send a Pull Request.
579
+ * **Want to reach out?** If you'd like to discuss the project further,
580
+ collaborate, or just say hi, open a GitHub Issue or start a Discussion.
581
+
582
+ ---
583
+
584
+ ### 📝 License
585
+
586
+ This library is released under the **MIT** license. Build great things!
587
+
588
+ ---
589
+
590
+ [▲ Back to top](#-simplibs-object)