simplibs-object 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- simplibs/object/SimpleBase.py +115 -0
- simplibs/object/SimpleConstant.py +271 -0
- simplibs/object/SimpleObject.py +293 -0
- simplibs/object/__init__.py +7 -0
- simplibs/object/_core/__init__.py +66 -0
- simplibs/object/_core/logic/__init__.py +0 -0
- simplibs/object/_core/logic/constant_methods/__init__.py +22 -0
- simplibs/object/_core/logic/constant_methods/bool_or_raise_validate_error.py +76 -0
- simplibs/object/_core/logic/constant_methods/normalize.py +92 -0
- simplibs/object/_core/logic/constant_methods/validate.py +99 -0
- simplibs/object/_core/logic/constant_methods/validate_type.py +48 -0
- simplibs/object/_core/logic/constant_methods/validations/__init__.py +22 -0
- simplibs/object/_core/logic/constant_methods/validations/_extract_clean_code_lines.py +86 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_missing_value_error.py +71 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_type_error.py +59 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_unexpected_validation_error.py +66 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_validation_error.py +78 -0
- simplibs/object/_core/logic/object_methods/__init__.py +18 -0
- simplibs/object/_core/logic/object_methods/_process_calculate_value_params.py +108 -0
- simplibs/object/_core/logic/object_methods/calculate_value.py +81 -0
- simplibs/object/_core/logic/object_methods/decompose_value.py +91 -0
- simplibs/object/_core/logic/object_methods/validations/__init__.py +22 -0
- simplibs/object/_core/logic/object_methods/validations/raise_class_not_decomposeable.py +82 -0
- simplibs/object/_core/logic/object_methods/validations/raise_duplicate_argument_error.py +77 -0
- simplibs/object/_core/logic/object_methods/validations/raise_too_many_positional_args_error.py +81 -0
- simplibs/object/_core/logic/object_methods/validations/raise_unknown_parameter_error.py +77 -0
- simplibs/object/_core/logic/property_builders/__init__.py +20 -0
- simplibs/object/_core/logic/property_builders/create_instance_property.py +66 -0
- simplibs/object/_core/logic/property_builders/create_properties_for_inner.py +97 -0
- simplibs/object/_core/logic/property_builders/create_value_property.py +98 -0
- simplibs/object/_core/logic/property_builders/value_helpers/__init__.py +18 -0
- simplibs/object/_core/logic/property_builders/value_helpers/create_value_getter.py +52 -0
- simplibs/object/_core/logic/property_builders/value_helpers/create_value_setter.py +95 -0
- simplibs/object/_core/logic/property_builders/value_helpers/validations/__init__.py +16 -0
- simplibs/object/_core/logic/property_builders/value_helpers/validations/raise_locked_value_error.py +103 -0
- simplibs/object/_core/metadata/SimpleBaseMetadata.py +139 -0
- simplibs/object/_core/metadata/SimpleConstantMetadata.py +108 -0
- simplibs/object/_core/metadata/SimpleMeta.py +214 -0
- simplibs/object/_core/metadata/SimpleObjectMetadata.py +165 -0
- simplibs/object/_core/metadata/__init__.py +16 -0
- simplibs/object/_core/metadata/constants/BASE_CLASS_NAMES.py +23 -0
- simplibs/object/_core/metadata/constants/__init__.py +16 -0
- simplibs/object/_core/metadata/init_processors/__init__.py +47 -0
- simplibs/object/_core/metadata/init_processors/blueprint_path/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/blueprint_path/calculate_blueprint_path.py +81 -0
- simplibs/object/_core/metadata/init_processors/default/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/default/process_default_for_constant.py +71 -0
- simplibs/object/_core/metadata/init_processors/default/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/default/validations/_exception_info_for_default.py +66 -0
- simplibs/object/_core/metadata/init_processors/default/validations/raise_default_is_defined_in_composition.py +78 -0
- simplibs/object/_core/metadata/init_processors/default/validations/validate_default_is_defined.py +77 -0
- simplibs/object/_core/metadata/init_processors/default/validations/validate_default_matches_annotation.py +93 -0
- simplibs/object/_core/metadata/init_processors/inners/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/inners/process_inners.py +143 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/__init__.py +33 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/_exception_info_for_inners.py +43 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/_get_collision_path.py +45 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_collision_within_inners.py +78 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_if_collision_with_owner_class.py +66 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_class.py +58 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_not_simple_class.py +60 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_simple_subclass.py +61 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_defined.py +56 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_not_empty.py +57 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_tuple.py +57 -0
- simplibs/object/_core/metadata/init_processors/methods/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/process_classmethod.py +130 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/__init__.py +16 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/exception_info_for_classmethod.py +52 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/expected_structure_for_classmethod.py +80 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/_convert_annotation_to_type_set.py +38 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_annotations.py +84 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_args_defaults.py +76 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_kwargs_defaults.py +74 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/verify_annotations_and_defaults.py +100 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/raise_decompose_unvalide_outcome_length.py +64 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_type.py +77 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_value.py +72 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/verify_decompose_outcome.py +87 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_raised_exceptions.py +56 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_return_unvalide_outcome_type.py +80 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/verify_calculation.py +89 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/_clone_classmethod.py +81 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_callable.py +60 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_classmethod.py +60 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_defined.py +67 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/verify_classmethod.py +117 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_has_exact_args_count.py +59 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_not_use_param_placeholders.py +66 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_param_match_expected.py +61 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/verify_params.py +123 -0
- simplibs/object/_core/metadata/init_processors/names/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/names/_class_name_splitter.py +242 -0
- simplibs/object/_core/metadata/init_processors/names/create_names.py +119 -0
- simplibs/object/_core/metadata/init_processors/names/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_has_no_underscores.py +94 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_ascii.py +95 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_identifier.py +83 -0
- simplibs/object/_core/metadata/init_processors/type/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/type/process_type.py +117 -0
- simplibs/object/_core/metadata/init_processors/type/validations/__init__.py +29 -0
- simplibs/object/_core/metadata/init_processors/type/validations/_exception_info_for_type.py +88 -0
- simplibs/object/_core/metadata/init_processors/type/validations/raise_union_type_contain_none.py +70 -0
- simplibs/object/_core/metadata/init_processors/type/validations/raise_validate_type_is_not_valid.py +92 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_from_tuple_is_not_none.py +94 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_defined.py +85 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_empty.py +93 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_none.py +87 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_tuple_is_not_nested.py +92 -0
- simplibs/object/_core/metadata/instance_builders/__init__.py +55 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/InstanceBase.py +77 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/__init__.py +16 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/__init__.py +16 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_atom_init.py +51 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_root_value_setter.py +67 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/make_atom_class.py +101 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/__init__.py +14 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/__init__.py +20 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/_get_inner_instance_class.py +51 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_composite_init.py +74 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_properties_for_inners.py +50 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_inners.py +57 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_self.py +69 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/make_composite_class.py +93 -0
- simplibs/object/_core/metadata/instance_builders/instance/__init__.py +17 -0
- simplibs/object/_core/metadata/instance_builders/instance/create_instance.py +107 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/__init__.py +25 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_combined_init_mixins.py +40 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_instance_class_dict.py +127 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_extend_instance_class.py +59 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_resolve_flat_mixins.py +74 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_verify_mixin_compatibility.py +83 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/create_instance_class.py +76 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/get_base_class.py +53 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/__init__.py +20 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/__init__.py +29 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_composite.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_constant.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_immutable.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_mutable.py +60 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_support_default_value_type.py +66 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_class.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_simple_base_subclass.py +60 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_invalide_extend_instance_class_definition.py +62 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision_with_base_class.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/__init__.py +21 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_class_is_not_base_class.py +54 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_hashing_for_immutable_value.py +66 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_param_is_bool.py +47 -0
- simplibs/object/_core/metadata/validations/__init__.py +18 -0
- simplibs/object/_core/metadata/validations/raise_attribut_allready_set.py +57 -0
- simplibs/object/_core/metadata/validations/raise_metadata_is_immutable.py +73 -0
- simplibs/object/_core/protocols/__init__.py +118 -0
- simplibs/object/_core/protocols/alias_typings/__init__.py +137 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangeTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangesDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangesTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/changes/__init__.py +18 -0
- simplibs/object/_core/protocols/alias_typings/history/HistoryDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/history/HistoryEntry.py +10 -0
- simplibs/object/_core/protocols/alias_typings/history/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/inners/InnersMap.py +8 -0
- simplibs/object/_core/protocols/alias_typings/inners/InnersTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/inners/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/mixins/MixinsTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/mixins/__init__.py +14 -0
- simplibs/object/_core/protocols/alias_typings/names/NamesSet.py +5 -0
- simplibs/object/_core/protocols/alias_typings/names/NamesTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/names/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodeItem.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesIndexMap.py +6 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesInstanceDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesPathDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/nodes/__init__.py +24 -0
- simplibs/object/_core/protocols/alias_typings/paths/PathDict.py +8 -0
- simplibs/object/_core/protocols/alias_typings/paths/PathTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/paths/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffItem.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/__init__.py +20 -0
- simplibs/object/_core/protocols/alias_typings/state/StateDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/state/__init__.py +14 -0
- simplibs/object/_core/protocols/alias_typings/types/ValidTypes.py +6 -0
- simplibs/object/_core/protocols/alias_typings/types/__init__.py +14 -0
- simplibs/object/_core/protocols/classes/SimpleBaseProtocol.py +25 -0
- simplibs/object/_core/protocols/classes/SimpleConstantProtocol.py +54 -0
- simplibs/object/_core/protocols/classes/SimpleObjectProtocol.py +50 -0
- simplibs/object/_core/protocols/classes/__init__.py +26 -0
- simplibs/object/_core/protocols/instance/SimpleConstantInstanceProtocol.py +13 -0
- simplibs/object/_core/protocols/instance/SimpleInstanceBaseProtocol.py +24 -0
- simplibs/object/_core/protocols/instance/SimpleObjectInstanceProtocol.py +13 -0
- simplibs/object/_core/protocols/instance/__init__.py +29 -0
- simplibs/object/_core/protocols/instance/core_classes/AtomInstanceProtocol.py +46 -0
- simplibs/object/_core/protocols/instance/core_classes/CompositeInstanceProtocol.py +37 -0
- simplibs/object/_core/protocols/instance/core_classes/InstanceBaseProtocol.py +28 -0
- simplibs/object/_core/protocols/instance/core_classes/__init__.py +19 -0
- simplibs/object/_core/protocols/metadata/SimpleBaseMetadataProtocol.py +37 -0
- simplibs/object/_core/protocols/metadata/SimpleConstantMetadataProtocol.py +45 -0
- simplibs/object/_core/protocols/metadata/SimpleMetaProtocol.py +39 -0
- simplibs/object/_core/protocols/metadata/SimpleObjectMetadataProtocol.py +49 -0
- simplibs/object/_core/protocols/metadata/__init__.py +28 -0
- simplibs/object/_core/protocols/methods/ClassMethodProtocol.py +29 -0
- simplibs/object/_core/protocols/methods/LogicSignature.py +20 -0
- simplibs/object/_core/protocols/methods/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/__init__.py +120 -0
- simplibs/object/_core/protocols/mixins/base_class/SimpleMixinProtocol.py +46 -0
- simplibs/object/_core/protocols/mixins/base_class/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/core_mixins/InfrastructureProtocol.py +16 -0
- simplibs/object/_core/protocols/mixins/core_mixins/NodesDictsProtocol.py +38 -0
- simplibs/object/_core/protocols/mixins/core_mixins/NodesTupleProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/core_mixins/SerializationProtocol.py +55 -0
- simplibs/object/_core/protocols/mixins/core_mixins/SnapshotProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/core_mixins/__init__.py +27 -0
- simplibs/object/_core/protocols/mixins/dunders/__init__.py +123 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/CollectionBaseProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/CollectionProtocol.py +20 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/IterableProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/MappingProtocol.py +52 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/__init__.py +21 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/EqualityProtocol.py +31 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/OrderingProtocol.py +32 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/generics/ClassGetItemProtocol.py +23 -0
- simplibs/object/_core/protocols/mixins/dunders/generics/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/CallProtocol.py +26 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/ContextProtocol.py +38 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/CopyableProtocol.py +33 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/LifecycleProtocol.py +21 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleReduceProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleStateProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/__init__.py +20 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/PicklePlan.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/ArithmeticProtocol.py +95 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/BitwiseProtocol.py +79 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/ConversionProtocol.py +57 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/InplaceProtocol.py +66 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/UnaryProtocol.py +35 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/__init__.py +22 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/Operator.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/UnaryOperator.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/ValueDisplayProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/ValueFormattingProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsProtocol.py +69 -0
- simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsWithInnersProtocol.py +27 -0
- simplibs/object/_core/protocols/mixins/immutable/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/numerical/EqualizerProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/numerical/VolumeProtocol.py +32 -0
- simplibs/object/_core/protocols/mixins/numerical/__init__.py +17 -0
- simplibs/object/_core/protocols/mixins/numerical/internal_types/SteppersMap.py +8 -0
- simplibs/object/_core/protocols/mixins/numerical/internal_types/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/StepperProtocol.py +95 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/LimitAction.py +5 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/StepValue.py +6 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/properties/InnersPropertyProtocol.py +31 -0
- simplibs/object/_core/protocols/mixins/properties/MetaShortcutsProtocol.py +49 -0
- simplibs/object/_core/protocols/mixins/properties/__init__.py +17 -0
- simplibs/object/_core/protocols/mixins/state/DefaultStateProtocol.py +41 -0
- simplibs/object/_core/protocols/mixins/state/DirtyTrackingProtocol.py +61 -0
- simplibs/object/_core/protocols/mixins/state/HistoryProtocol.py +112 -0
- simplibs/object/_core/protocols/mixins/state/PermissionProtocol.py +35 -0
- simplibs/object/_core/protocols/mixins/state/__init__.py +22 -0
- simplibs/object/exceptions/SimpleDefinitionError.py +45 -0
- simplibs/object/exceptions/SimpleInitializationError.py +43 -0
- simplibs/object/exceptions/SimpleRuntimeError.py +50 -0
- simplibs/object/exceptions/__init__.py +62 -0
- simplibs/object/exceptions/base_exception/SimpleObjectError.py +107 -0
- simplibs/object/exceptions/base_exception/__init__.py +19 -0
- simplibs/object/mixins/__init__.py +99 -0
- simplibs/object/mixins/_common_logic/__init__.py +41 -0
- simplibs/object/mixins/_common_logic/constants/__init__.py +27 -0
- simplibs/object/mixins/_common_logic/constants/names/HISTORY.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/OWNER_CLASS.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/STEPPER.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/VALUE.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/__init__.py +28 -0
- simplibs/object/mixins/_common_logic/constants/sets/FORBIDDEN_NAMES.py +27 -0
- simplibs/object/mixins/_common_logic/constants/sets/RESTRICTION_FLAGS.py +18 -0
- simplibs/object/mixins/_common_logic/constants/sets/__init__.py +22 -0
- simplibs/object/mixins/_common_logic/immutability/__init__.py +28 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/__init__.py +22 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/get_top_composite_paths.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/process_single_change.py +143 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_changes.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths.py +147 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths2.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/__init__.py +23 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_split_changes_unknown_name.py +107 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_with_any_unknown_name.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/__init__.py +24 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_changes_is_not_tuple.py +65 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_child_composite_mismatch.py +68 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_contained_constant_mismatch.py +67 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/with_any.py +238 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/utils/__init__.py +15 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/utils/reacalculate_inners.py +112 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/__init__.py +21 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_is_decomposeable.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_name_exists.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/with_composite.py +176 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/__init__.py +20 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_new_instance.py +130 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_snapshot_dict.py +83 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/reacalculate_owner_value.py +131 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/__init__.py +16 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/raise_immutability_constant_not_found.py +93 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/with_constant.py +147 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/utils/__init__.py +15 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/utils/find_longest_keys.py +112 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/__init__.py +25 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_batch_constant_not_found.py +94 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_constants_changes_not_tuple.py +94 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_has_length_two.py +91 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_is_tuple.py +99 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_name_is_str.py +90 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/with_constants.py +193 -0
- simplibs/object/mixins/base_class/SimpleMixin.py +118 -0
- simplibs/object/mixins/base_class/__init__.py +17 -0
- simplibs/object/mixins/base_class/_meta/SimpleMixinMeta.py +59 -0
- simplibs/object/mixins/base_class/_meta/__init__.py +21 -0
- simplibs/object/mixins/base_class/_meta/_verify_mixin_definition.py +161 -0
- simplibs/object/mixins/base_class/_meta/validations/__init__.py +34 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_dict_contains_forbidden_attributes.py +101 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_flag_is_not_bool.py +122 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_init_mixins_contains_super_call.py +75 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_only_types_invalid.py +107 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contain_unvalid_type.py +85 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contains_forbidden_slot_names.py +102 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_is_not_defined.py +79 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_unsuport_type.py +88 -0
- simplibs/object/mixins/core_mixins/Infrastructure.py +49 -0
- simplibs/object/mixins/core_mixins/NodesDicts.py +104 -0
- simplibs/object/mixins/core_mixins/NodesTuple.py +86 -0
- simplibs/object/mixins/core_mixins/Serialization.py +120 -0
- simplibs/object/mixins/core_mixins/Snapshot.py +104 -0
- simplibs/object/mixins/core_mixins/__init__.py +32 -0
- simplibs/object/mixins/core_mixins/_utils/__init__.py +49 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/__init__.py +17 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/_collect_nodes_data.py +131 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/build_nodes_tuple.py +104 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/__init__.py +20 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/from_dict.py +190 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/from_dict_constants.py +151 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/to_dict.py +158 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/__init__.py +30 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_invalid_composite_structure.py +65 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_composite_key.py +64 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_value_key.py +66 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_owner_class_mismatch_for_state_dict.py +77 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_state_dict_input.py +67 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/__init__.py +15 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/compare_snapshots.py +102 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/validations/__init__.py +16 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/validations/raise_snapshot_incompatible_error.py +101 -0
- simplibs/object/mixins/dunders/__init__.py +61 -0
- simplibs/object/mixins/dunders/collections/CollectionBase.py +129 -0
- simplibs/object/mixins/dunders/collections/Iterable.py +81 -0
- simplibs/object/mixins/dunders/collections/Mapping.py +131 -0
- simplibs/object/mixins/dunders/collections/__init__.py +29 -0
- simplibs/object/mixins/dunders/collections/main/Collection.py +47 -0
- simplibs/object/mixins/dunders/collections/main/__init__.py +20 -0
- simplibs/object/mixins/dunders/comparison/Equality.py +128 -0
- simplibs/object/mixins/dunders/comparison/Ordering.py +130 -0
- simplibs/object/mixins/dunders/comparison/__init__.py +25 -0
- simplibs/object/mixins/dunders/generics/ClassGetItem.py +105 -0
- simplibs/object/mixins/dunders/generics/__init__.py +20 -0
- simplibs/object/mixins/dunders/interfaces/Call.py +101 -0
- simplibs/object/mixins/dunders/interfaces/Context.py +100 -0
- simplibs/object/mixins/dunders/interfaces/__init__.py +23 -0
- simplibs/object/mixins/dunders/lifecycles/Copyable.py +103 -0
- simplibs/object/mixins/dunders/lifecycles/PickleReduce.py +88 -0
- simplibs/object/mixins/dunders/lifecycles/PickleState.py +104 -0
- simplibs/object/mixins/dunders/lifecycles/__init__.py +29 -0
- simplibs/object/mixins/dunders/lifecycles/_utils/__init__.py +20 -0
- simplibs/object/mixins/dunders/lifecycles/_utils/rebuild_simple_instance.py +51 -0
- simplibs/object/mixins/dunders/lifecycles/main/Lifecycle.py +45 -0
- simplibs/object/mixins/dunders/lifecycles/main/__init__.py +20 -0
- simplibs/object/mixins/dunders/numeric/Arithmetic.py +195 -0
- simplibs/object/mixins/dunders/numeric/Bitwise.py +172 -0
- simplibs/object/mixins/dunders/numeric/Conversion.py +149 -0
- simplibs/object/mixins/dunders/numeric/Inplace.py +124 -0
- simplibs/object/mixins/dunders/numeric/Unary.py +89 -0
- simplibs/object/mixins/dunders/numeric/__init__.py +31 -0
- simplibs/object/mixins/dunders/numeric/_utils/__init__.py +41 -0
- simplibs/object/mixins/dunders/numeric/_utils/_align_operand_type.py +111 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_arithmetic_op.py +157 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_bitwise_op.py +116 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_conversion.py +107 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_inplace_op.py +139 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_unary_op.py +121 -0
- simplibs/object/mixins/dunders/representation/ValueDisplay.py +96 -0
- simplibs/object/mixins/dunders/representation/ValueFormatting.py +144 -0
- simplibs/object/mixins/dunders/representation/__init__.py +24 -0
- simplibs/object/mixins/others/__init__.py +48 -0
- simplibs/object/mixins/others/immutable/ImmutableMethods.py +142 -0
- simplibs/object/mixins/others/immutable/ImmutableMethodsWithInners.py +111 -0
- simplibs/object/mixins/others/immutable/__init__.py +24 -0
- simplibs/object/mixins/others/immutable/_validations/__init__.py +19 -0
- simplibs/object/mixins/others/immutable/_validations/raise_with_changes_input_not_dict.py +60 -0
- simplibs/object/mixins/others/numerical/Equalizer.py +129 -0
- simplibs/object/mixins/others/numerical/Volume.py +100 -0
- simplibs/object/mixins/others/numerical/__init__.py +25 -0
- simplibs/object/mixins/others/numerical/_stepper_class/Stepper.py +227 -0
- simplibs/object/mixins/others/numerical/_stepper_class/__init__.py +31 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/__init__.py +35 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/__init__.py +33 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/process_step_value.py +114 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/__init__.py +29 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_down_limit_reached.py +115 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_up_limit_reached.py +110 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_down_limit.py +141 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_up_limit.py +141 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/set_value.py +163 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/step_down.py +154 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/step_up.py +154 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/__init__.py +38 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_down_limit_value.py +143 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_limit_action.py +118 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_up_limit_value.py +143 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_value.py +142 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validate_instance.py +138 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/__init__.py +39 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_action.py +118 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_down_limit.py +125 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_instance.py +117 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_up_limit.py +125 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_non_numeric_value.py +122 -0
- simplibs/object/mixins/others/properties/InnersProperty.py +91 -0
- simplibs/object/mixins/others/properties/MetaShortcuts.py +113 -0
- simplibs/object/mixins/others/properties/__init__.py +24 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/__init__.py +23 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/_collect_nested_inner_properties.py +134 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/collect_all_nested_properties.py +132 -0
- simplibs/object/mixins/others/state/DefaultState.py +119 -0
- simplibs/object/mixins/others/state/DirtyTracking.py +144 -0
- simplibs/object/mixins/others/state/History.py +248 -0
- simplibs/object/mixins/others/state/Permission.py +102 -0
- simplibs/object/mixins/others/state/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/__init__.py +50 -0
- simplibs/object/mixins/others/state/_history_utils/core/__init__.py +32 -0
- simplibs/object/mixins/others/state/_history_utils/core/find_snapshot.py +142 -0
- simplibs/object/mixins/others/state/_history_utils/core/record_state.py +130 -0
- simplibs/object/mixins/others/state/_history_utils/core/set_history_limit.py +114 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_history_limit_not_positive_integer.py +65 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snapshot_index.py +67 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_reference.py +67 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_timestamp.py +66 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_timestamp.py +63 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/__init__.py +38 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_index.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_timestamp.py +115 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_last_history.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/history_redo.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/history_undo.py +104 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/export_history_to_dict.py +110 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/import_history_from_dict.py +169 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/__init__.py +24 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_history_import_file.py +66 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_owner_class_mismatch.py +69 -0
- simplibs/object/settings/__init__.py +90 -0
- simplibs/object/settings/logging.py +138 -0
- simplibs/object/testing/__init__.py +90 -0
- simplibs/object/testing/assert_simple_mixin.py +150 -0
- simplibs/object/testing/assert_simple_object.py +219 -0
- simplibs/object/testing/asserts/__init__.py +53 -0
- simplibs/object/testing/asserts/base/__init__.py +22 -0
- simplibs/object/testing/asserts/base/assert_class_inheritance.py +75 -0
- simplibs/object/testing/asserts/base/assert_instance_creation.py +119 -0
- simplibs/object/testing/asserts/base/assert_user_instance_creation.py +97 -0
- simplibs/object/testing/asserts/base/assert_value_change.py +142 -0
- simplibs/object/testing/asserts/methods/__init__.py +20 -0
- simplibs/object/testing/asserts/methods/assert_calculate_value_method.py +113 -0
- simplibs/object/testing/asserts/methods/assert_decompose_value_method.py +109 -0
- simplibs/object/testing/asserts/methods/assert_validate_method.py +111 -0
- simplibs/object/testing/asserts/mixins/__init__.py +22 -0
- simplibs/object/testing/asserts/mixins/assert_instance_hasattr.py +94 -0
- simplibs/object/testing/asserts/mixins/assert_mixin_inheritance.py +72 -0
- simplibs/object/testing/asserts/mixins/assert_mixin_instance_creation.py +142 -0
- simplibs/object/testing/asserts/mixins/assert_mixins_slots_values.py +126 -0
- simplibs/object/testing/asserts/mutability/__init__.py +18 -0
- simplibs/object/testing/asserts/mutability/assert_immutable_behavior.py +118 -0
- simplibs/object/testing/asserts/mutability/assert_mutable_behavior.py +108 -0
- simplibs/object/testing/asserts/reactivity/__init__.py +17 -0
- simplibs/object/testing/asserts/reactivity/assert_reactivity_downward.py +141 -0
- simplibs/object/testing/asserts/reactivity/assert_reactivity_upward.py +109 -0
- simplibs/object/testing/bulk_test.py +150 -0
- simplibs/object/testing/containers/InnerValue.py +102 -0
- simplibs/object/testing/containers/MixinCase.py +89 -0
- simplibs/object/testing/containers/ObjectCase.py +101 -0
- simplibs/object/testing/containers/TestMixin.py +122 -0
- simplibs/object/testing/containers/__init__.py +20 -0
- simplibs/object/testing/containers/_validations/__init__.py +18 -0
- simplibs/object/testing/containers/_validations/raise_inner_value_empty_path.py +39 -0
- simplibs/object/testing/containers/_validations/raise_inner_value_invalid_path_type.py +44 -0
- simplibs/object/tools/__init__.py +0 -0
- simplibs/object/tools/automate_creators/__init__.py +0 -0
- simplibs/object/tools/automate_creators/_helpers/__init__.py +5 -0
- simplibs/object/tools/automate_creators/_helpers/_is_lambda.py +34 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/__init__.py +3 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_calculate_default_failed.py +51 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_inner_is_not_simple_constant_subclass.py +44 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_inners_is_not_tuple.py +41 -0
- simplibs/object/tools/automate_creators/_helpers/calculate_default.py +51 -0
- simplibs/object/tools/automate_creators/_helpers/load_parameters_from_inners.py +72 -0
- simplibs/object/tools/automate_creators/_helpers/process_decompose.py +47 -0
- simplibs/object/tools/automate_creators/_helpers/process_logic.py +57 -0
- simplibs/object/tools/automate_creators/_helpers/process_validate.py +48 -0
- simplibs/object/tools/automate_creators/_validations/__init__.py +7 -0
- simplibs/object/tools/automate_creators/_validations/validate_class_name_is_str.py +36 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_inners.py +43 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_logic.py +44 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_not_default.py +37 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_default.py +48 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_decompose.py +37 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_logic.py +37 -0
- simplibs/object/tools/automate_creators/bulk/BulkCase.py +100 -0
- simplibs/object/tools/automate_creators/bulk/__init__.py +0 -0
- simplibs/object/tools/automate_creators/bulk/create_simple_object_bulk.py +77 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/__init__.py +0 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/__init__.py +8 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_csv_callable_not_supported.py +26 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_data_not_list.py +28 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_decode_failed.py +29 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_sequence.py +27 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_str.py +28 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_item_is_not_bulk_dict.py +39 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_table_row_not_sequence.py +26 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_yaml_import_failed.py +22 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_bulk_case_class.py +57 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_csv.py +68 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_dicts.py +19 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_json.py +24 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_table.py +43 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_yaml.py +29 -0
- simplibs/object/tools/automate_creators/create_constant_class.py +84 -0
- simplibs/object/tools/automate_creators/create_object_class.py +110 -0
- simplibs/object/tools/automate_creators/create_simple_object.py +97 -0
- simplibs/object/tools/randomize/__init__.py +18 -0
- simplibs/object/tools/randomize/_validations/__init__.py +28 -0
- simplibs/object/tools/randomize/_validations/raise_random_data_filler_exhausted.py +55 -0
- simplibs/object/tools/randomize/_validations/validate_instance_is_simple_constant_base.py +52 -0
- simplibs/object/tools/randomize/_validations/validate_registry_is_randomize_registry_base.py +51 -0
- simplibs/object/tools/randomize/_validations/validate_retries_is_greater_than_zero.py +48 -0
- simplibs/object/tools/randomize/_validations/validate_retries_is_int.py +49 -0
- simplibs/object/tools/randomize/_validations/validate_skip_immutable_is_bool.py +43 -0
- simplibs/object/tools/randomize/_validations/validate_skip_unregistered_is_bool.py +44 -0
- simplibs/object/tools/randomize/random_data_filler.py +133 -0
- simplibs/object/tools/randomize/randomize_value.py +122 -0
- simplibs_object-0.1.0.dist-info/METADATA +590 -0
- simplibs_object-0.1.0.dist-info/RECORD +580 -0
- simplibs_object-0.1.0.dist-info/WHEEL +5 -0
- simplibs_object-0.1.0.dist-info/licenses/LICENSE +21 -0
- simplibs_object-0.1.0.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ........exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._convert_annotation_to_type_set import _convert_annotation_to_type_set
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .......protocols.methods import ClassMethodProtocol
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_annotations(
|
|
12
|
+
bound_method_annotations: dict[str, type],
|
|
13
|
+
bound_method: "ClassMethodProtocol",
|
|
14
|
+
exception_info: tuple[str, str, str],
|
|
15
|
+
expected_structure: tuple[str, ...],
|
|
16
|
+
) -> None:
|
|
17
|
+
"""Validates that user-declared type annotations match expected types."""
|
|
18
|
+
|
|
19
|
+
# 1. Extract user annotations
|
|
20
|
+
method_annotations = bound_method.__func__.__annotations__ or {}
|
|
21
|
+
|
|
22
|
+
# 2. Happy path: no annotations declared
|
|
23
|
+
if not method_annotations:
|
|
24
|
+
return
|
|
25
|
+
|
|
26
|
+
class_name, method_name, context = exception_info
|
|
27
|
+
|
|
28
|
+
# 3. Validate each annotation
|
|
29
|
+
for name, annotation in method_annotations.items():
|
|
30
|
+
expected_type = bound_method_annotations.get(name)
|
|
31
|
+
|
|
32
|
+
expected_type_set = _convert_annotation_to_type_set(expected_type)
|
|
33
|
+
annotation_set = _convert_annotation_to_type_set(annotation)
|
|
34
|
+
|
|
35
|
+
# 4. Check subset relationship
|
|
36
|
+
if not annotation_set.issubset(expected_type_set):
|
|
37
|
+
expected_names = " | ".join(t.__name__ for t in expected_type_set)
|
|
38
|
+
annotation_names = " | ".join(t.__name__ for t in annotation_set)
|
|
39
|
+
|
|
40
|
+
raise SimpleDefinitionError(
|
|
41
|
+
error_name="METHOD SIGNATURE ERROR",
|
|
42
|
+
label="_annotation",
|
|
43
|
+
value=annotation_names,
|
|
44
|
+
expected=expected_names,
|
|
45
|
+
problem=f"Annotation for '{name}' does not match expected types.",
|
|
46
|
+
context=context,
|
|
47
|
+
how_to_fix=(
|
|
48
|
+
f"Change the annotation to match '{expected_names}'.",
|
|
49
|
+
"The annotation must be the same type or a valid subset.",
|
|
50
|
+
"You may also remove the annotation entirely; the framework will inject it automatically.",
|
|
51
|
+
) + expected_structure,
|
|
52
|
+
exception=TypeError,
|
|
53
|
+
)
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
_DESIGN_NOTES = """
|
|
57
|
+
# validate_annotations
|
|
58
|
+
|
|
59
|
+
## Purpose
|
|
60
|
+
Ensures that user-declared type annotations match the expected types defined by
|
|
61
|
+
the metadata pipeline.
|
|
62
|
+
Annotations are normalized into sets so that union types can be compared using
|
|
63
|
+
simple subset logic.
|
|
64
|
+
|
|
65
|
+
## Why tuple inputs
|
|
66
|
+
The validator receives:
|
|
67
|
+
- `exception_info` — (class_name, method_name, context)
|
|
68
|
+
- `expected_structure` — code blueprint
|
|
69
|
+
|
|
70
|
+
This keeps the function consistent with all other method-validation helpers.
|
|
71
|
+
|
|
72
|
+
## Behavior
|
|
73
|
+
1. Extract user annotations.
|
|
74
|
+
2. If none exist → exit immediately.
|
|
75
|
+
3. Convert both expected and actual annotations into type sets.
|
|
76
|
+
4. Check whether the actual set is a subset of the expected set.
|
|
77
|
+
5. If not, raise a structured `SimpleDefinitionError` with a copy-paste blueprint.
|
|
78
|
+
|
|
79
|
+
## Notes
|
|
80
|
+
This validator is part of the annotation/defaults verification chain:
|
|
81
|
+
- `validate_annotations`
|
|
82
|
+
- `validate_args_defaults`
|
|
83
|
+
- `validate_kwargs_defaults`
|
|
84
|
+
"""
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ........exceptions import SimpleDefinitionError
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from .......protocols.methods import ClassMethodProtocol
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def validate_args_defaults(
|
|
10
|
+
expected_args_defaults: tuple[Any, ...],
|
|
11
|
+
expected_params: tuple[str, ...],
|
|
12
|
+
bound_method: "ClassMethodProtocol",
|
|
13
|
+
exception_info: tuple[str, str, str],
|
|
14
|
+
expected_structure: tuple[str, ...],
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Validates positional argument default values."""
|
|
17
|
+
|
|
18
|
+
# 1. Extract user-defined positional defaults
|
|
19
|
+
method_args_defaults = bound_method.__func__.__defaults__ or ()
|
|
20
|
+
|
|
21
|
+
# 2. Happy path: no defaults declared
|
|
22
|
+
if not method_args_defaults:
|
|
23
|
+
return
|
|
24
|
+
|
|
25
|
+
class_name, method_name, context = exception_info
|
|
26
|
+
|
|
27
|
+
# 3. Validate each default value
|
|
28
|
+
for index, (value, expected_value) in enumerate(
|
|
29
|
+
zip(method_args_defaults, expected_args_defaults)
|
|
30
|
+
):
|
|
31
|
+
if value != expected_value:
|
|
32
|
+
param_name = expected_params[index]
|
|
33
|
+
|
|
34
|
+
raise SimpleDefinitionError(
|
|
35
|
+
error_name="METHOD SIGNATURE ERROR",
|
|
36
|
+
label="_args_default",
|
|
37
|
+
value=value,
|
|
38
|
+
expected=repr(expected_value),
|
|
39
|
+
problem=f"Parameter '{param_name}' has an incorrect default value.",
|
|
40
|
+
context=context,
|
|
41
|
+
how_to_fix=(
|
|
42
|
+
f"Set the default value of '{param_name}' to '{expected_value}'.",
|
|
43
|
+
"Or remove the default entirely; the framework will inject it automatically.",
|
|
44
|
+
) + expected_structure,
|
|
45
|
+
exception=ValueError,
|
|
46
|
+
)
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
_DESIGN_NOTES = """
|
|
50
|
+
# validate_args_defaults
|
|
51
|
+
|
|
52
|
+
## Purpose
|
|
53
|
+
Ensures that positional argument default values match the deterministic defaults
|
|
54
|
+
defined in `_inners`.
|
|
55
|
+
Users may omit defaults, but they must never override them.
|
|
56
|
+
|
|
57
|
+
## Why tuple inputs
|
|
58
|
+
The validator receives:
|
|
59
|
+
- `exception_info` — (class_name, method_name, context)
|
|
60
|
+
- `expected_structure` — code blueprint
|
|
61
|
+
|
|
62
|
+
This keeps the function consistent with all other method-validation helpers.
|
|
63
|
+
|
|
64
|
+
## Behavior
|
|
65
|
+
1. Extract positional defaults from `__defaults__`.
|
|
66
|
+
2. If none exist → exit immediately.
|
|
67
|
+
3. Compare each default with the expected value.
|
|
68
|
+
4. If any mismatch occurs, raise a structured `SimpleDefinitionError` with a
|
|
69
|
+
copy‑paste ready blueprint.
|
|
70
|
+
|
|
71
|
+
## Notes
|
|
72
|
+
This validator is part of the annotation/defaults verification chain:
|
|
73
|
+
- `validate_annotations`
|
|
74
|
+
- `validate_args_defaults`
|
|
75
|
+
- `validate_kwargs_defaults`
|
|
76
|
+
"""
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ........exceptions import SimpleDefinitionError
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from .......protocols.methods import ClassMethodProtocol
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def validate_kwargs_defaults(
|
|
10
|
+
expected_kwargs_defaults: dict[str, Any],
|
|
11
|
+
bound_method: "ClassMethodProtocol",
|
|
12
|
+
exception_info: tuple[str, str, str],
|
|
13
|
+
expected_structure: tuple[str, ...],
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Validates keyword-only argument default values."""
|
|
16
|
+
|
|
17
|
+
# 1. Extract user-defined keyword defaults
|
|
18
|
+
method_kwargs_defaults = bound_method.__func__.__kwdefaults__ or {}
|
|
19
|
+
|
|
20
|
+
# 2. Happy path: no defaults declared
|
|
21
|
+
if not method_kwargs_defaults:
|
|
22
|
+
return
|
|
23
|
+
|
|
24
|
+
class_name, method_name, context = exception_info
|
|
25
|
+
|
|
26
|
+
# 3. Validate each keyword default
|
|
27
|
+
for name, value in method_kwargs_defaults.items():
|
|
28
|
+
expected_value = expected_kwargs_defaults.get(name)
|
|
29
|
+
|
|
30
|
+
if value != expected_value:
|
|
31
|
+
raise SimpleDefinitionError(
|
|
32
|
+
error_name="METHOD SIGNATURE ERROR",
|
|
33
|
+
label="_kwargs_default",
|
|
34
|
+
value=value,
|
|
35
|
+
expected=repr(expected_value),
|
|
36
|
+
problem=f"Parameter '{name}' has an incorrect default value.",
|
|
37
|
+
context=context,
|
|
38
|
+
how_to_fix=(
|
|
39
|
+
f"Set the default value of '{name}' to '{expected_value}'.",
|
|
40
|
+
"Or remove the default entirely; the framework will inject it automatically.",
|
|
41
|
+
) + expected_structure,
|
|
42
|
+
exception=ValueError,
|
|
43
|
+
)
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
_DESIGN_NOTES = """
|
|
48
|
+
# validate_kwargs_defaults
|
|
49
|
+
|
|
50
|
+
## Purpose
|
|
51
|
+
Ensures that keyword-only argument default values match the deterministic defaults
|
|
52
|
+
defined in `_inners`.
|
|
53
|
+
Users may omit defaults, but they must never override them.
|
|
54
|
+
|
|
55
|
+
## Why tuple inputs
|
|
56
|
+
The validator receives:
|
|
57
|
+
- `exception_info` — (class_name, method_name, context)
|
|
58
|
+
- `expected_structure` — code blueprint
|
|
59
|
+
|
|
60
|
+
This keeps the function consistent with all other method-validation helpers.
|
|
61
|
+
|
|
62
|
+
## Behavior
|
|
63
|
+
1. Extract keyword defaults from `__kwdefaults__`.
|
|
64
|
+
2. If none exist → exit immediately.
|
|
65
|
+
3. Compare each default with the expected value.
|
|
66
|
+
4. If any mismatch occurs, raise a structured `SimpleDefinitionError` with a
|
|
67
|
+
copy‑paste ready blueprint.
|
|
68
|
+
|
|
69
|
+
## Notes
|
|
70
|
+
This validator is part of the annotation/defaults verification chain:
|
|
71
|
+
- `validate_annotations`
|
|
72
|
+
- `validate_args_defaults`
|
|
73
|
+
- `validate_kwargs_defaults`
|
|
74
|
+
"""
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from .._exceptions_helpers import (
|
|
4
|
+
exception_info_for_classmethod,
|
|
5
|
+
expected_structure_for_classmethod,
|
|
6
|
+
)
|
|
7
|
+
# Inners
|
|
8
|
+
from .validations import (
|
|
9
|
+
validate_annotations,
|
|
10
|
+
validate_args_defaults,
|
|
11
|
+
validate_kwargs_defaults,
|
|
12
|
+
)
|
|
13
|
+
# Annotations
|
|
14
|
+
if TYPE_CHECKING:
|
|
15
|
+
from ......protocols.methods import ClassMethodProtocol
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
def verify_annotations_and_defaults(
|
|
19
|
+
bound_method: "ClassMethodProtocol",
|
|
20
|
+
expected_params: tuple[str, ...],
|
|
21
|
+
expected_args_params_count: int,
|
|
22
|
+
bound_method_annotations: dict[str, Any],
|
|
23
|
+
expected_args_defaults: tuple[Any, ...],
|
|
24
|
+
expected_kwargs_defaults: dict[str, Any],
|
|
25
|
+
) -> None:
|
|
26
|
+
"""Verifies type annotations and default values for classmethod signatures."""
|
|
27
|
+
|
|
28
|
+
# 1. Build exception metadata
|
|
29
|
+
exception_info = exception_info_for_classmethod(bound_method)
|
|
30
|
+
expected_structure = expected_structure_for_classmethod(
|
|
31
|
+
bound_method,
|
|
32
|
+
expected_params,
|
|
33
|
+
expected_args_params_count,
|
|
34
|
+
)
|
|
35
|
+
|
|
36
|
+
func = bound_method.__func__
|
|
37
|
+
|
|
38
|
+
# 2. Validate annotations
|
|
39
|
+
if func.__annotations__:
|
|
40
|
+
validate_annotations(
|
|
41
|
+
bound_method_annotations,
|
|
42
|
+
bound_method,
|
|
43
|
+
exception_info,
|
|
44
|
+
expected_structure,
|
|
45
|
+
)
|
|
46
|
+
|
|
47
|
+
# 3. Validate positional defaults
|
|
48
|
+
if func.__defaults__:
|
|
49
|
+
validate_args_defaults(
|
|
50
|
+
expected_args_defaults,
|
|
51
|
+
expected_params,
|
|
52
|
+
bound_method,
|
|
53
|
+
exception_info,
|
|
54
|
+
expected_structure,
|
|
55
|
+
)
|
|
56
|
+
|
|
57
|
+
# 4. Validate keyword-only defaults
|
|
58
|
+
if func.__kwdefaults__:
|
|
59
|
+
validate_kwargs_defaults(
|
|
60
|
+
expected_kwargs_defaults,
|
|
61
|
+
bound_method,
|
|
62
|
+
exception_info,
|
|
63
|
+
expected_structure,
|
|
64
|
+
)
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
_DESIGN_NOTES = """
|
|
68
|
+
# verify_annotations_and_defaults
|
|
69
|
+
|
|
70
|
+
## Purpose
|
|
71
|
+
Ensures that user-declared type annotations and default values match the
|
|
72
|
+
framework’s deterministic metadata configuration.
|
|
73
|
+
Annotations may be omitted, but if present, they must be correct.
|
|
74
|
+
Defaults may be omitted, but if present, they must match `_inners`.
|
|
75
|
+
|
|
76
|
+
## Step-by-step behavior
|
|
77
|
+
|
|
78
|
+
### 1. Exception metadata
|
|
79
|
+
The function prepares:
|
|
80
|
+
- `exception_info` — (class_name, method_name, context)
|
|
81
|
+
- `expected_structure` — blueprint of the correct method signature
|
|
82
|
+
|
|
83
|
+
Both are passed to all validators.
|
|
84
|
+
|
|
85
|
+
### 2. Annotation validation
|
|
86
|
+
If the method defines annotations, `validate_annotations` checks that each
|
|
87
|
+
annotation is a subset of the expected type set.
|
|
88
|
+
|
|
89
|
+
### 3. Positional defaults
|
|
90
|
+
If positional defaults exist (`__defaults__`), `validate_args_defaults` ensures
|
|
91
|
+
they match the deterministic defaults defined in `_inners`.
|
|
92
|
+
|
|
93
|
+
### 4. Keyword-only defaults
|
|
94
|
+
If keyword-only defaults exist (`__kwdefaults__`), `validate_kwargs_defaults`
|
|
95
|
+
ensures they match the expected mapping.
|
|
96
|
+
|
|
97
|
+
## Notes
|
|
98
|
+
This orchestrator is called after `verify_classmethod` and `verify_params`.
|
|
99
|
+
It completes the full signature validation pipeline.
|
|
100
|
+
"""
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from .verify_calculation import verify_calculation
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Calculation Verification Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Orchestrates functional logic evaluation audits. It encapsulates runtime tracking execution rules, ensuring computed outcomes match structural system definitions, while also anchoring nested object decomposition validations under a single lifecycle controller.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
14
|
+
| `verify_calculation` | Function | Orchestration controller verifying computation execution, return matching, and splitting.|
|
|
15
|
+
"""
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from .verify_decompose_outcome import verify_decompose_outcome
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Decompose Method Verification Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Handles deep state structural unpack validation routines. It acts as an integration gateway that validates that compound mathematical breakdowns or complex object partitions returned by method tracks match item-by-item metadata configurations.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
14
|
+
| `verify_decompose_outcome` | Function | Main coordinator auditing decomposed sequence parameters, bounds, types, and values. |
|
|
15
|
+
"""
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
from .raise_decompose_unvalide_outcome_length import raise_decompose_unvalide_outcome_length
|
|
2
|
+
from .validate_decompose_unvalide_item_type import validate_decompose_unvalide_item_type
|
|
3
|
+
from .validate_decompose_unvalide_item_value import validate_decompose_unvalide_item_value
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
_DESIGN_NOTES = """
|
|
7
|
+
# Decompose Method Validation Sub-Package
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Enforces granular value and item structural validations across structured split array payloads.
|
|
11
|
+
|
|
12
|
+
## Internal Components Registry
|
|
13
|
+
|
|
14
|
+
| Component | Type | Description |
|
|
15
|
+
| :-------------------------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
16
|
+
| `raise_decompose_unvalide_outcome_length` | Function | Panics when the unrolled decomposition tuple length drifts from expected sizing. |
|
|
17
|
+
| `validate_decompose_unvalide_item_type` | Function | Audits individual elements within the decomposed collection for type compliance. |
|
|
18
|
+
| `validate_decompose_unvalide_item_value` | Function | Audits individual elements within the decomposed collection for value rules. |
|
|
19
|
+
"""
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from .........exceptions import SimpleDefinitionError
|
|
4
|
+
from ...._exceptions_helpers import exception_info_for_classmethod
|
|
5
|
+
# Annotations
|
|
6
|
+
if TYPE_CHECKING:
|
|
7
|
+
from ........protocols.methods import ClassMethodProtocol
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def raise_decompose_unvalide_outcome_length(
|
|
11
|
+
calculate_default: tuple,
|
|
12
|
+
inners: tuple,
|
|
13
|
+
bound_method: "ClassMethodProtocol",
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Raises an exception when _decompose returns an incorrect number of items."""
|
|
16
|
+
|
|
17
|
+
# 1. Extract diagnostic context
|
|
18
|
+
_, method_name, context = exception_info_for_classmethod(bound_method)
|
|
19
|
+
|
|
20
|
+
expected_count = len(inners)
|
|
21
|
+
got_count = len(calculate_default)
|
|
22
|
+
|
|
23
|
+
inner_names = tuple(inner.meta.name_snake for inner in inners)
|
|
24
|
+
inner_defaults = tuple(repr(inner.meta.default) for inner in inners)
|
|
25
|
+
|
|
26
|
+
# 2. Raise domain exception
|
|
27
|
+
raise SimpleDefinitionError(
|
|
28
|
+
error_name="METHOD LOGIC ERROR",
|
|
29
|
+
label="_decompose_length",
|
|
30
|
+
value=calculate_default,
|
|
31
|
+
expected=repr(inner_names),
|
|
32
|
+
problem=f"Expected {expected_count} items, received {got_count}.",
|
|
33
|
+
context=context,
|
|
34
|
+
how_to_fix=(
|
|
35
|
+
"The '_decompose' method must return values matching the defined inner elements.",
|
|
36
|
+
f"Ensure the return tuple contains exactly {expected_count} items.",
|
|
37
|
+
f"Expected order: {', '.join(inner_names)}.",
|
|
38
|
+
"Example based on default values:",
|
|
39
|
+
f" return ({', '.join(inner_defaults)})",
|
|
40
|
+
),
|
|
41
|
+
exception=ValueError,
|
|
42
|
+
)
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
_DESIGN_NOTES = """
|
|
46
|
+
# raise_decompose_unvalide_outcome_length
|
|
47
|
+
|
|
48
|
+
## Purpose
|
|
49
|
+
Ensures that `_decompose` returns a tuple whose length matches the number of
|
|
50
|
+
inner components defined in the metadata (`_inners`).
|
|
51
|
+
|
|
52
|
+
## Behavior
|
|
53
|
+
1. Extracts diagnostic context using `exception_context_for_classmethod`.
|
|
54
|
+
2. Computes:
|
|
55
|
+
- expected item count
|
|
56
|
+
- actual item count
|
|
57
|
+
- expected inner names
|
|
58
|
+
- example default values
|
|
59
|
+
3. Raises a structured `SimpleDefinitionError` with clear remediation instructions.
|
|
60
|
+
|
|
61
|
+
## Notes
|
|
62
|
+
This validator is used exclusively inside `verify_decompose_outcome` and is the
|
|
63
|
+
first structural check before type/value validation.
|
|
64
|
+
"""
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from types import UnionType
|
|
3
|
+
# Outers
|
|
4
|
+
from .........exceptions import SimpleDefinitionError
|
|
5
|
+
from ...._exceptions_helpers import exception_info_for_classmethod
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from ........protocols.methods import ClassMethodProtocol
|
|
9
|
+
from ........protocols.classes import SimpleClassLike
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def validate_decompose_unvalide_item_type(
|
|
13
|
+
value: Any,
|
|
14
|
+
expected_type: type | UnionType,
|
|
15
|
+
inner: "SimpleClassLike",
|
|
16
|
+
inners: tuple["SimpleClassLike", ...],
|
|
17
|
+
bound_method: "ClassMethodProtocol",
|
|
18
|
+
) -> None:
|
|
19
|
+
"""Validates that a decomposed item matches its expected type."""
|
|
20
|
+
|
|
21
|
+
# 1. Structural evaluation checkpoint
|
|
22
|
+
if isinstance(value, expected_type):
|
|
23
|
+
return
|
|
24
|
+
|
|
25
|
+
# 2. Extract diagnostic context
|
|
26
|
+
class_name, method_name, context = exception_info_for_classmethod(bound_method)
|
|
27
|
+
|
|
28
|
+
meta = inner.meta
|
|
29
|
+
expected_type_name = (
|
|
30
|
+
expected_type.__name__
|
|
31
|
+
if hasattr(expected_type, "__name__")
|
|
32
|
+
else str(expected_type)
|
|
33
|
+
)
|
|
34
|
+
|
|
35
|
+
inner_defaults = tuple(repr(i.meta.default) for i in inners)
|
|
36
|
+
inner_names = tuple(i.meta.name_snake for i in inners)
|
|
37
|
+
|
|
38
|
+
# 3. Raise domain exception
|
|
39
|
+
raise SimpleDefinitionError(
|
|
40
|
+
error_name="METHOD LOGIC ERROR",
|
|
41
|
+
label="_decompose_item_type",
|
|
42
|
+
value=value,
|
|
43
|
+
expected=expected_type_name,
|
|
44
|
+
problem=f"Item '{meta.name_snake}' does not match its expected type.",
|
|
45
|
+
context=context,
|
|
46
|
+
how_to_fix=(
|
|
47
|
+
f"Ensure that '{meta.name_snake}' is computed as an instance of '{expected_type_name}'.",
|
|
48
|
+
f"Received type: '{type(value).__name__}'.",
|
|
49
|
+
"Verify that the returned tuple preserves the exact order defined in '_inners'.",
|
|
50
|
+
f"Expected order: {', '.join(inner_names)}.",
|
|
51
|
+
"Example based on default values:",
|
|
52
|
+
f" return ({', '.join(inner_defaults)})",
|
|
53
|
+
),
|
|
54
|
+
exception=TypeError,
|
|
55
|
+
)
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
_DESIGN_NOTES = """
|
|
59
|
+
# validate_decompose_unvalide_item_type
|
|
60
|
+
|
|
61
|
+
## Purpose
|
|
62
|
+
Ensures that each item returned by `_decompose` matches the expected type
|
|
63
|
+
defined in the corresponding inner metadata (`inner.meta.value_type`).
|
|
64
|
+
|
|
65
|
+
## Behavior
|
|
66
|
+
1. Performs a fast `isinstance` check.
|
|
67
|
+
2. If the value is invalid:
|
|
68
|
+
- extracts diagnostic context
|
|
69
|
+
- determines expected type name
|
|
70
|
+
- builds example default tuple
|
|
71
|
+
- raises a structured `SimpleDefinitionError`
|
|
72
|
+
|
|
73
|
+
## Notes
|
|
74
|
+
This validator is used inside `verify_decompose_outcome` immediately after the
|
|
75
|
+
length check.
|
|
76
|
+
It is the first type-level validation before checking default-value compliance.
|
|
77
|
+
"""
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from .........exceptions import SimpleDefinitionError
|
|
4
|
+
from ...._exceptions_helpers import exception_info_for_classmethod
|
|
5
|
+
# Annotations
|
|
6
|
+
if TYPE_CHECKING:
|
|
7
|
+
from ........protocols.methods import ClassMethodProtocol
|
|
8
|
+
from ........protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_decompose_unvalide_item_value(
|
|
12
|
+
value: Any,
|
|
13
|
+
inner: "SimpleClassLike",
|
|
14
|
+
inners: tuple["SimpleClassLike", ...],
|
|
15
|
+
bound_method: "ClassMethodProtocol",
|
|
16
|
+
) -> None:
|
|
17
|
+
"""Validates that a decomposed item matches its expected default value."""
|
|
18
|
+
|
|
19
|
+
# 1. Structural evaluation checkpoint
|
|
20
|
+
if value == inner.meta.default:
|
|
21
|
+
return
|
|
22
|
+
|
|
23
|
+
# 2. Extract diagnostic context
|
|
24
|
+
class_name, method_name, context = exception_info_for_classmethod(bound_method)
|
|
25
|
+
|
|
26
|
+
meta = inner.meta
|
|
27
|
+
expected_value = meta.default
|
|
28
|
+
|
|
29
|
+
inner_defaults = tuple(repr(i.meta.default) for i in inners)
|
|
30
|
+
inner_names = tuple(i.meta.name_snake for i in inners)
|
|
31
|
+
|
|
32
|
+
# 3. Raise domain exception
|
|
33
|
+
raise SimpleDefinitionError(
|
|
34
|
+
error_name="METHOD LOGIC ERROR",
|
|
35
|
+
label="_decompose_item_value",
|
|
36
|
+
value=value,
|
|
37
|
+
expected=repr(expected_value),
|
|
38
|
+
problem=f"Item '{meta.name_snake}' does not match its expected default value.",
|
|
39
|
+
context=context,
|
|
40
|
+
how_to_fix=(
|
|
41
|
+
f"Ensure that '{meta.name_snake}' is computed as '{expected_value!r}'.",
|
|
42
|
+
f"Received value: '{value!r}'.",
|
|
43
|
+
"Verify that the returned tuple preserves the exact order defined in '_inners'.",
|
|
44
|
+
f"Expected order: {', '.join(inner_names)}.",
|
|
45
|
+
"Example based on default values:",
|
|
46
|
+
f" return ({', '.join(inner_defaults)})",
|
|
47
|
+
),
|
|
48
|
+
exception=ValueError,
|
|
49
|
+
)
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
_DESIGN_NOTES = """
|
|
53
|
+
# validate_decompose_unvalide_item_value
|
|
54
|
+
|
|
55
|
+
## Purpose
|
|
56
|
+
Ensures that each item returned by `_decompose` matches the default value defined
|
|
57
|
+
in the corresponding inner metadata (`inner.meta.default`).
|
|
58
|
+
|
|
59
|
+
## Behavior
|
|
60
|
+
1. Performs a fast equality check.
|
|
61
|
+
2. If the value is invalid:
|
|
62
|
+
- extracts diagnostic context
|
|
63
|
+
- determines expected default value
|
|
64
|
+
- builds example default tuple
|
|
65
|
+
- raises a structured `SimpleDefinitionError`
|
|
66
|
+
|
|
67
|
+
## Notes
|
|
68
|
+
This validator is used inside `verify_decompose_outcome` immediately after the
|
|
69
|
+
type validation.
|
|
70
|
+
It is the final structural check for `_decompose` before returning the verified
|
|
71
|
+
tuple.
|
|
72
|
+
"""
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Inners
|
|
3
|
+
from .validations import (
|
|
4
|
+
raise_decompose_unvalide_outcome_length,
|
|
5
|
+
validate_decompose_unvalide_item_type,
|
|
6
|
+
validate_decompose_unvalide_item_value,
|
|
7
|
+
)
|
|
8
|
+
# Annotations
|
|
9
|
+
if TYPE_CHECKING:
|
|
10
|
+
from .......protocols.methods import ClassMethodProtocol
|
|
11
|
+
from .......protocols.classes import SimpleClassLike
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def verify_decompose_outcome(
|
|
15
|
+
calculate_default: tuple[Any, ...],
|
|
16
|
+
owner_class: "SimpleClassLike",
|
|
17
|
+
bound_method: "ClassMethodProtocol",
|
|
18
|
+
) -> None:
|
|
19
|
+
"""Verifies structural correctness of the tuple returned by '_decompose'."""
|
|
20
|
+
|
|
21
|
+
# 1. Extract inner metadata
|
|
22
|
+
# noinspection PyProtectedMember
|
|
23
|
+
inners = owner_class._inners
|
|
24
|
+
|
|
25
|
+
# 2. Validate tuple length
|
|
26
|
+
if len(calculate_default) != len(inners):
|
|
27
|
+
raise_decompose_unvalide_outcome_length(
|
|
28
|
+
calculate_default,
|
|
29
|
+
inners,
|
|
30
|
+
bound_method,
|
|
31
|
+
)
|
|
32
|
+
return
|
|
33
|
+
|
|
34
|
+
# 3. Validate each item
|
|
35
|
+
for index, inner in enumerate(inners):
|
|
36
|
+
value = calculate_default[index]
|
|
37
|
+
expected_type = inner.meta.value_type
|
|
38
|
+
|
|
39
|
+
# 3.1 Type or default mismatch → run micro-validations
|
|
40
|
+
if not isinstance(value, expected_type) and value != inner.meta.default:
|
|
41
|
+
validate_decompose_unvalide_item_type(
|
|
42
|
+
value,
|
|
43
|
+
expected_type,
|
|
44
|
+
inner,
|
|
45
|
+
inners,
|
|
46
|
+
bound_method,
|
|
47
|
+
)
|
|
48
|
+
validate_decompose_unvalide_item_value(
|
|
49
|
+
value,
|
|
50
|
+
inner,
|
|
51
|
+
inners,
|
|
52
|
+
bound_method,
|
|
53
|
+
)
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
_DESIGN_NOTES = """
|
|
58
|
+
# verify_decompose_outcome
|
|
59
|
+
|
|
60
|
+
## Purpose
|
|
61
|
+
Ensures that the tuple returned by `_decompose` matches the structural metadata
|
|
62
|
+
defined in `owner_class.meta.inners`.
|
|
63
|
+
|
|
64
|
+
## Behavior
|
|
65
|
+
|
|
66
|
+
### 1. Metadata extraction
|
|
67
|
+
The function retrieves the list of inner components (`_inners`) from the class
|
|
68
|
+
metadata.
|
|
69
|
+
|
|
70
|
+
### 2. Length validation
|
|
71
|
+
Before checking individual items, the function verifies that the returned tuple
|
|
72
|
+
has the same number of elements as `_inners`.
|
|
73
|
+
If not, it delegates to `raise_decompose_unvalide_outcome_length`.
|
|
74
|
+
|
|
75
|
+
### 3. Item validation
|
|
76
|
+
For each item:
|
|
77
|
+
- It checks whether the value is either:
|
|
78
|
+
- an instance of the expected type, or
|
|
79
|
+
- equal to the default sentinel value.
|
|
80
|
+
- If both checks fail, it delegates to:
|
|
81
|
+
- `validate_decompose_unvalide_item_type`
|
|
82
|
+
- `validate_decompose_unvalide_item_value`
|
|
83
|
+
|
|
84
|
+
## Notes
|
|
85
|
+
This orchestrator is used exclusively inside `verify_calculation` when the
|
|
86
|
+
method being validated is `_decompose`.
|
|
87
|
+
"""
|