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.
- simplibs_object-0.1.0/LICENSE +21 -0
- simplibs_object-0.1.0/PKG-INFO +590 -0
- simplibs_object-0.1.0/README.md +557 -0
- simplibs_object-0.1.0/pyproject.toml +64 -0
- simplibs_object-0.1.0/setup.cfg +4 -0
- simplibs_object-0.1.0/src/simplibs/object/SimpleBase.py +115 -0
- simplibs_object-0.1.0/src/simplibs/object/SimpleConstant.py +271 -0
- simplibs_object-0.1.0/src/simplibs/object/SimpleObject.py +293 -0
- simplibs_object-0.1.0/src/simplibs/object/__init__.py +7 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/__init__.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/__init__.py +0 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/bool_or_raise_validate_error.py +76 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/normalize.py +92 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validate.py +99 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validate_type.py +48 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/_extract_clean_code_lines.py +86 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/raise_missing_value_error.py +71 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/raise_type_error.py +59 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/raise_unexpected_validation_error.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/constant_methods/validations/raise_validation_error.py +78 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/_process_calculate_value_params.py +108 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/calculate_value.py +81 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/decompose_value.py +91 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/raise_class_not_decomposeable.py +82 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/raise_duplicate_argument_error.py +77 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/raise_too_many_positional_args_error.py +81 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/object_methods/validations/raise_unknown_parameter_error.py +77 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/create_instance_property.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/create_properties_for_inner.py +97 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/create_value_property.py +98 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/create_value_getter.py +52 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/create_value_setter.py +95 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/validations/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/logic/property_builders/value_helpers/validations/raise_locked_value_error.py +103 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/SimpleBaseMetadata.py +139 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/SimpleConstantMetadata.py +108 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/SimpleMeta.py +214 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/SimpleObjectMetadata.py +165 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/constants/BASE_CLASS_NAMES.py +23 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/constants/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/__init__.py +47 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/blueprint_path/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/blueprint_path/calculate_blueprint_path.py +81 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/process_default_for_constant.py +71 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/__init__.py +19 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/_exception_info_for_default.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/raise_default_is_defined_in_composition.py +78 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/validate_default_is_defined.py +77 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/default/validations/validate_default_matches_annotation.py +93 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/process_inners.py +143 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/__init__.py +33 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/_exception_info_for_inners.py +43 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/_get_collision_path.py +45 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_collision_within_inners.py +78 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_if_collision_with_owner_class.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_class.py +58 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_not_simple_class.py +60 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_simple_subclass.py +61 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_defined.py +56 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_not_empty.py +57 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_tuple.py +57 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/process_classmethod.py +130 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/exception_info_for_classmethod.py +52 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/expected_structure_for_classmethod.py +80 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/__init__.py +19 -0
- 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
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_annotations.py +84 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_args_defaults.py +76 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_kwargs_defaults.py +74 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/verify_annotations_and_defaults.py +100 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/__init__.py +19 -0
- 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
- 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
- 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
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/verify_decompose_outcome.py +87 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_raised_exceptions.py +56 -0
- 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
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/verify_calculation.py +89 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/_clone_classmethod.py +81 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/__init__.py +19 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_callable.py +60 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_classmethod.py +60 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_defined.py +67 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/verify_classmethod.py +117 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/__init__.py +19 -0
- 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
- 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
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_param_match_expected.py +61 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/methods/verifiers/params/verify_params.py +123 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/_class_name_splitter.py +242 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/create_names.py +119 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/validations/__init__.py +19 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_has_no_underscores.py +94 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_ascii.py +95 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_identifier.py +83 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/process_type.py +117 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/__init__.py +29 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/_exception_info_for_type.py +88 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/raise_union_type_contain_none.py +70 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/raise_validate_type_is_not_valid.py +92 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_from_tuple_is_not_none.py +94 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_defined.py +85 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_empty.py +93 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_none.py +87 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/init_processors/type/validations/validate_type_tuple_is_not_nested.py +92 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/__init__.py +55 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/InstanceBase.py +77 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/helpers/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_atom_init.py +51 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_root_value_setter.py +67 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/atom_class/make_atom_class.py +101 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/__init__.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/_get_inner_instance_class.py +51 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_composite_init.py +74 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_properties_for_inners.py +50 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_inners.py +57 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_self.py +69 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/composite_class/make_composite_class.py +93 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/create_instance.py +107 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/__init__.py +25 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_combined_init_mixins.py +40 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_instance_class_dict.py +127 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_extend_instance_class.py +59 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_resolve_flat_mixins.py +74 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/_verify_mixin_compatibility.py +83 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/create_instance_class.py +76 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/get_base_class.py +53 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/__init__.py +29 -0
- 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
- 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
- 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
- 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
- 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
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_class.py +56 -0
- 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
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_invalide_extend_instance_class_definition.py +62 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision.py +56 -0
- 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
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/validations/__init__.py +21 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/validations/validate_class_is_not_base_class.py +54 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/validations/validate_hashing_for_immutable_value.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/instance_builders/instance/validations/validate_param_is_bool.py +47 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/validations/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/validations/raise_attribut_allready_set.py +57 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/metadata/validations/raise_metadata_is_immutable.py +73 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/__init__.py +118 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/__init__.py +137 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/changes/ChangeTuple.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/changes/ChangesDict.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/changes/ChangesTuple.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/changes/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/history/HistoryDict.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/history/HistoryEntry.py +10 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/history/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/inners/InnersMap.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/inners/InnersTuple.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/inners/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/mixins/MixinsTuple.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/mixins/__init__.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/names/NamesSet.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/names/NamesTuple.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/names/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodeItem.py +9 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesDict.py +9 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesIndexMap.py +6 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesInstanceDict.py +9 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesPathDict.py +9 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/NodesTuple.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/nodes/__init__.py +24 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/paths/PathDict.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/paths/PathTuple.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/paths/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDict.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffItem.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffTuple.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotTuple.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/snapshots/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/state/StateDict.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/state/__init__.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/types/ValidTypes.py +6 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/alias_typings/types/__init__.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/classes/SimpleBaseProtocol.py +25 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/classes/SimpleConstantProtocol.py +54 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/classes/SimpleObjectProtocol.py +50 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/classes/__init__.py +26 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/SimpleConstantInstanceProtocol.py +13 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/SimpleInstanceBaseProtocol.py +24 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/SimpleObjectInstanceProtocol.py +13 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/__init__.py +29 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/core_classes/AtomInstanceProtocol.py +46 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/core_classes/CompositeInstanceProtocol.py +37 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/core_classes/InstanceBaseProtocol.py +28 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/instance/core_classes/__init__.py +19 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/SimpleBaseMetadataProtocol.py +37 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/SimpleConstantMetadataProtocol.py +45 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/SimpleMetaProtocol.py +39 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/SimpleObjectMetadataProtocol.py +49 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/metadata/__init__.py +28 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/methods/ClassMethodProtocol.py +29 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/methods/LogicSignature.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/methods/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/__init__.py +120 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/base_class/SimpleMixinProtocol.py +46 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/base_class/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/InfrastructureProtocol.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/NodesDictsProtocol.py +38 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/NodesTupleProtocol.py +30 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/SerializationProtocol.py +55 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/SnapshotProtocol.py +42 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/core_mixins/__init__.py +27 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/__init__.py +123 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/CollectionBaseProtocol.py +37 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/CollectionProtocol.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/IterableProtocol.py +37 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/MappingProtocol.py +52 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/collections/__init__.py +21 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/comparison/EqualityProtocol.py +31 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/comparison/OrderingProtocol.py +32 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/comparison/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/generics/ClassGetItemProtocol.py +23 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/generics/__init__.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/interfaces/CallProtocol.py +26 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/interfaces/ContextProtocol.py +38 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/interfaces/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/CopyableProtocol.py +33 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/LifecycleProtocol.py +21 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleReduceProtocol.py +30 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleStateProtocol.py +42 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/PicklePlan.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/__init__.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/ArithmeticProtocol.py +95 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/BitwiseProtocol.py +79 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/ConversionProtocol.py +57 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/InplaceProtocol.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/UnaryProtocol.py +35 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/Operator.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/UnaryOperator.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/representation/ValueDisplayProtocol.py +30 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/representation/ValueFormattingProtocol.py +42 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/dunders/representation/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsProtocol.py +69 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsWithInnersProtocol.py +27 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/immutable/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/EqualizerProtocol.py +37 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/VolumeProtocol.py +32 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/internal_types/SteppersMap.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/internal_types/__init__.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/StepperProtocol.py +95 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/__init__.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/LimitAction.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/StepValue.py +6 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/properties/InnersPropertyProtocol.py +31 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/properties/MetaShortcutsProtocol.py +49 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/properties/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/DefaultStateProtocol.py +41 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/DirtyTrackingProtocol.py +61 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/HistoryProtocol.py +112 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/PermissionProtocol.py +35 -0
- simplibs_object-0.1.0/src/simplibs/object/_core/protocols/mixins/state/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/exceptions/SimpleDefinitionError.py +45 -0
- simplibs_object-0.1.0/src/simplibs/object/exceptions/SimpleInitializationError.py +43 -0
- simplibs_object-0.1.0/src/simplibs/object/exceptions/SimpleRuntimeError.py +50 -0
- simplibs_object-0.1.0/src/simplibs/object/exceptions/__init__.py +62 -0
- simplibs_object-0.1.0/src/simplibs/object/exceptions/base_exception/SimpleObjectError.py +107 -0
- simplibs_object-0.1.0/src/simplibs/object/exceptions/base_exception/__init__.py +19 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/__init__.py +99 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/__init__.py +41 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/__init__.py +27 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/HISTORY.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/OWNER_CLASS.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/STEPPER.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/VALUE.py +14 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/names/__init__.py +28 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/sets/FORBIDDEN_NAMES.py +27 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/sets/RESTRICTION_FLAGS.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/constants/sets/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/__init__.py +28 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/get_top_composite_paths.py +142 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/process_single_change.py +143 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_changes.py +142 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths.py +147 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths2.py +142 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/__init__.py +23 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_split_changes_unknown_name.py +107 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_with_any_unknown_name.py +71 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/__init__.py +24 -0
- 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
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_child_composite_mismatch.py +68 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_contained_constant_mismatch.py +67 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_any/with_any.py +238 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/utils/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/utils/reacalculate_inners.py +112 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/__init__.py +21 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_is_decomposeable.py +71 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_name_exists.py +71 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_composite/with_composite.py +176 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/utils/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_new_instance.py +130 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_snapshot_dict.py +83 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/utils/reacalculate_owner_value.py +131 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/raise_immutability_constant_not_found.py +93 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constant/with_constant.py +147 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/utils/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/utils/find_longest_keys.py +112 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/__init__.py +25 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_batch_constant_not_found.py +94 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_constants_changes_not_tuple.py +94 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_has_length_two.py +91 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_is_tuple.py +99 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_name_is_str.py +90 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/_common_logic/immutability/with_constants/with_constants.py +193 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/SimpleMixin.py +118 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/SimpleMixinMeta.py +59 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/__init__.py +21 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/_verify_mixin_definition.py +161 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/__init__.py +34 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_dict_contains_forbidden_attributes.py +101 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_flag_is_not_bool.py +122 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_init_mixins_contains_super_call.py +75 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_only_types_invalid.py +107 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contain_unvalid_type.py +85 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contains_forbidden_slot_names.py +102 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_is_not_defined.py +79 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_unsuport_type.py +88 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/Infrastructure.py +49 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/NodesDicts.py +104 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/NodesTuple.py +86 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/Serialization.py +120 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/Snapshot.py +104 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/__init__.py +32 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/__init__.py +49 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/nodes_tuple/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/nodes_tuple/_collect_nodes_data.py +131 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/nodes_tuple/build_nodes_tuple.py +104 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/from_dict.py +190 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/from_dict_constants.py +151 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/to_dict.py +158 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/__init__.py +30 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_invalid_composite_structure.py +65 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_composite_key.py +64 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_value_key.py +66 -0
- 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
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_state_dict_input.py +67 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/snapshot/__init__.py +15 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/snapshot/compare_snapshots.py +102 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/snapshot/validations/__init__.py +16 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/core_mixins/_utils/snapshot/validations/raise_snapshot_incompatible_error.py +101 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/__init__.py +61 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/CollectionBase.py +129 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/Iterable.py +81 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/Mapping.py +131 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/__init__.py +29 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/main/Collection.py +47 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/collections/main/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/comparison/Equality.py +128 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/comparison/Ordering.py +130 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/comparison/__init__.py +25 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/generics/ClassGetItem.py +105 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/generics/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/interfaces/Call.py +101 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/interfaces/Context.py +100 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/interfaces/__init__.py +23 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/Copyable.py +103 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/PickleReduce.py +88 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/PickleState.py +104 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/__init__.py +29 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/_utils/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/_utils/rebuild_simple_instance.py +51 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/main/Lifecycle.py +45 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/lifecycles/main/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Arithmetic.py +195 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Bitwise.py +172 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Conversion.py +149 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Inplace.py +124 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/Unary.py +89 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/__init__.py +31 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/__init__.py +41 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/_align_operand_type.py +111 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_arithmetic_op.py +157 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_bitwise_op.py +116 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_conversion.py +107 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_inplace_op.py +139 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/numeric/_utils/execute_unary_op.py +121 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/representation/ValueDisplay.py +96 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/representation/ValueFormatting.py +144 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/dunders/representation/__init__.py +24 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/__init__.py +48 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/ImmutableMethods.py +142 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/ImmutableMethodsWithInners.py +111 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/__init__.py +24 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/_validations/__init__.py +19 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/immutable/_validations/raise_with_changes_input_not_dict.py +60 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/Equalizer.py +129 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/Volume.py +100 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/__init__.py +25 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/Stepper.py +227 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/__init__.py +31 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/__init__.py +35 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/__init__.py +33 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/process_step_value.py +114 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/__init__.py +29 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_down_limit_reached.py +115 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_up_limit_reached.py +110 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_down_limit.py +141 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_up_limit.py +141 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/set_value.py +163 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/step_down.py +154 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/methods/step_up.py +154 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/__init__.py +38 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/process_down_limit_value.py +143 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/process_limit_action.py +118 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/process_up_limit_value.py +143 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/process_value.py +142 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validate_instance.py +138 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/__init__.py +39 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_action.py +118 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_down_limit.py +125 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_instance.py +117 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_up_limit.py +125 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_non_numeric_value.py +122 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/InnersProperty.py +91 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/MetaShortcuts.py +113 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/__init__.py +24 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/_inners_property_utils/__init__.py +23 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/_inners_property_utils/_collect_nested_inner_properties.py +134 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/properties/_inners_property_utils/collect_all_nested_properties.py +132 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/DefaultState.py +119 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/DirtyTracking.py +144 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/History.py +248 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/Permission.py +102 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/__init__.py +31 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/__init__.py +50 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/__init__.py +32 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/find_snapshot.py +142 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/record_state.py +130 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/set_history_limit.py +114 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/__init__.py +31 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_history_limit_not_positive_integer.py +65 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snapshot_index.py +67 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_reference.py +67 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_timestamp.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_timestamp.py +63 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/__init__.py +38 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_index.py +103 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_timestamp.py +115 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/go_to_last_history.py +103 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/history_redo.py +103 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/navigations/history_undo.py +104 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/__init__.py +31 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/export_history_to_dict.py +110 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/import_history_from_dict.py +169 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/validations/__init__.py +24 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_history_import_file.py +66 -0
- simplibs_object-0.1.0/src/simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_owner_class_mismatch.py +69 -0
- simplibs_object-0.1.0/src/simplibs/object/settings/__init__.py +90 -0
- simplibs_object-0.1.0/src/simplibs/object/settings/logging.py +138 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/__init__.py +90 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/assert_simple_mixin.py +150 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/assert_simple_object.py +219 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/__init__.py +53 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/assert_class_inheritance.py +75 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/assert_instance_creation.py +119 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/assert_user_instance_creation.py +97 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/base/assert_value_change.py +142 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/methods/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/methods/assert_calculate_value_method.py +113 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/methods/assert_decompose_value_method.py +109 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/methods/assert_validate_method.py +111 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/__init__.py +22 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/assert_instance_hasattr.py +94 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/assert_mixin_inheritance.py +72 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/assert_mixin_instance_creation.py +142 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mixins/assert_mixins_slots_values.py +126 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mutability/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mutability/assert_immutable_behavior.py +118 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/mutability/assert_mutable_behavior.py +108 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/reactivity/__init__.py +17 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/reactivity/assert_reactivity_downward.py +141 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/asserts/reactivity/assert_reactivity_upward.py +109 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/bulk_test.py +150 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/containers/InnerValue.py +102 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/containers/MixinCase.py +89 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/containers/ObjectCase.py +101 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/containers/TestMixin.py +122 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/containers/__init__.py +20 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/containers/_validations/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/containers/_validations/raise_inner_value_empty_path.py +39 -0
- simplibs_object-0.1.0/src/simplibs/object/testing/containers/_validations/raise_inner_value_invalid_path_type.py +44 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/__init__.py +0 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/__init__.py +0 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/__init__.py +5 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_is_lambda.py +34 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_validations/__init__.py +3 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_validations/raise_calculate_default_failed.py +51 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_validations/raise_inner_is_not_simple_constant_subclass.py +44 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/_validations/raise_inners_is_not_tuple.py +41 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/calculate_default.py +51 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/load_parameters_from_inners.py +72 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/process_decompose.py +47 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/process_logic.py +57 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_helpers/process_validate.py +48 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/__init__.py +7 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_class_name_is_str.py +36 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_composite_has_inners.py +43 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_composite_has_logic.py +44 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_composite_has_not_default.py +37 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_constant_has_default.py +48 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_decompose.py +37 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_logic.py +37 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/BulkCase.py +100 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/__init__.py +0 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/create_simple_object_bulk.py +77 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/__init__.py +0 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/__init__.py +8 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_csv_callable_not_supported.py +26 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_data_not_list.py +28 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_decode_failed.py +29 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_sequence.py +27 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_str.py +28 -0
- 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
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_table_row_not_sequence.py +26 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_yaml_import_failed.py +22 -0
- 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
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_csv.py +68 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_dicts.py +19 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_json.py +24 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_table.py +43 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_yaml.py +29 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/create_constant_class.py +84 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/create_object_class.py +110 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/automate_creators/create_simple_object.py +97 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/__init__.py +18 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/__init__.py +28 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/raise_random_data_filler_exhausted.py +55 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_instance_is_simple_constant_base.py +52 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_registry_is_randomize_registry_base.py +51 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_retries_is_greater_than_zero.py +48 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_retries_is_int.py +49 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_skip_immutable_is_bool.py +43 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/_validations/validate_skip_unregistered_is_bool.py +44 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/random_data_filler.py +133 -0
- simplibs_object-0.1.0/src/simplibs/object/tools/randomize/randomize_value.py +122 -0
- simplibs_object-0.1.0/src/simplibs_object.egg-info/PKG-INFO +590 -0
- simplibs_object-0.1.0/src/simplibs_object.egg-info/SOURCES.txt +586 -0
- simplibs_object-0.1.0/src/simplibs_object.egg-info/dependency_links.txt +1 -0
- simplibs_object-0.1.0/src/simplibs_object.egg-info/requires.txt +10 -0
- simplibs_object-0.1.0/src/simplibs_object.egg-info/top_level.txt +1 -0
- simplibs_object-0.1.0/tests/test_SimpleBase.py +18 -0
- simplibs_object-0.1.0/tests/test_SimpleConstant.py +60 -0
- 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
|
+
[](https://pypi.org/project/simplibs-object/)
|
|
37
|
+
[](https://www.python.org/downloads/)
|
|
38
|
+
[](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)
|