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,17 @@
|
|
|
1
|
+
from .assert_reactivity_downward import assert_reactivity_downward
|
|
2
|
+
from .assert_reactivity_upward import assert_reactivity_upward
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
_DESIGN_NOTES = """
|
|
6
|
+
# Testing Asserts Reactivity Sub-Package
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Provides assertions for testing multi-directional reactive state updates across composite object trees.
|
|
10
|
+
|
|
11
|
+
## Internal Components Registry
|
|
12
|
+
|
|
13
|
+
| Component | Type | Description |
|
|
14
|
+
| :-------------------------- | :------- | :------------------------------------------------------------------------ |
|
|
15
|
+
| `assert_reactivity_downward`| Function | Validates top-down decomposition propagation into inner instances. |
|
|
16
|
+
| `assert_reactivity_upward` | Function | Asserts bottom-up reactive calculation updates upon inner leaf changes. |
|
|
17
|
+
"""
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
import pytest
|
|
3
|
+
from simplibs.exception.testing import maybe_subtest
|
|
4
|
+
# Outers
|
|
5
|
+
from ..base.assert_value_change import assert_value_change
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
# noinspection PyTypeChecker
|
|
9
|
+
def assert_reactivity_downward(
|
|
10
|
+
subtests: Any,
|
|
11
|
+
instance: Any,
|
|
12
|
+
*,
|
|
13
|
+
new_value: Any,
|
|
14
|
+
verbose: bool = True,
|
|
15
|
+
verbose_value_change: bool = True,
|
|
16
|
+
intro: str = "",
|
|
17
|
+
) -> None:
|
|
18
|
+
"""Assert downward reactivity across composite object instances.
|
|
19
|
+
|
|
20
|
+
Validates that updating the root value of a composite instance automatically decomposes and
|
|
21
|
+
propagates updated states down to all nested inner components according to the defined
|
|
22
|
+
decomposition contract.
|
|
23
|
+
|
|
24
|
+
Args:
|
|
25
|
+
subtests: The native pytest subtests fixture manager instance.
|
|
26
|
+
instance: Root composite object instance under test.
|
|
27
|
+
new_value: Candidate raw composite value to apply to the root instance.
|
|
28
|
+
verbose: Enables isolated pytest subtests reporting for this wrapper.
|
|
29
|
+
verbose_value_change: Enables isolated subtests reporting inside the nested ``assert_value_change``.
|
|
30
|
+
intro: Optional prefix string added to the generated subtest identity name.
|
|
31
|
+
"""
|
|
32
|
+
subintro = "test_reactivity_downward::"
|
|
33
|
+
|
|
34
|
+
# 1. Target instance must be a composite (non-constant) object
|
|
35
|
+
meta = instance.meta
|
|
36
|
+
with maybe_subtest(
|
|
37
|
+
subtests,
|
|
38
|
+
name=f"{intro}{subintro}is_composite",
|
|
39
|
+
verbose=verbose,
|
|
40
|
+
):
|
|
41
|
+
if getattr(meta, "is_constant", False):
|
|
42
|
+
pytest.fail(
|
|
43
|
+
f"Cannot test downward reactivity on atomic constant '{meta.class_name}', "
|
|
44
|
+
f"because constants do not contain inner components."
|
|
45
|
+
)
|
|
46
|
+
|
|
47
|
+
# 1.1 Guard clause: Halt execution if instance is an atomic constant
|
|
48
|
+
if getattr(meta, "is_constant", False):
|
|
49
|
+
return
|
|
50
|
+
|
|
51
|
+
# 2. Target composite must explicitly support decomposition
|
|
52
|
+
is_decomposeable = getattr(meta, "is_decomposeable", False)
|
|
53
|
+
with maybe_subtest(
|
|
54
|
+
subtests,
|
|
55
|
+
name=f"{intro}{subintro}supports_decompose",
|
|
56
|
+
verbose=verbose,
|
|
57
|
+
):
|
|
58
|
+
if not is_decomposeable:
|
|
59
|
+
pytest.fail(
|
|
60
|
+
f"Composite '{meta.class_name}' does not define a decomposition method; "
|
|
61
|
+
f"downward reactivity cannot be verified."
|
|
62
|
+
)
|
|
63
|
+
|
|
64
|
+
# 2.1 Guard clause: Halt execution if composite does not support decomposition
|
|
65
|
+
if not is_decomposeable:
|
|
66
|
+
return
|
|
67
|
+
|
|
68
|
+
# 3. Apply composite value change to root via shared assertion
|
|
69
|
+
with maybe_subtest(
|
|
70
|
+
subtests,
|
|
71
|
+
name=f"{intro}{subintro}apply_composite_value",
|
|
72
|
+
verbose=verbose,
|
|
73
|
+
):
|
|
74
|
+
assert_value_change(
|
|
75
|
+
subtests,
|
|
76
|
+
instance,
|
|
77
|
+
value=new_value,
|
|
78
|
+
verbose=verbose_value_change and verbose,
|
|
79
|
+
intro=intro,
|
|
80
|
+
)
|
|
81
|
+
|
|
82
|
+
# 4. Compute expected decomposed inner values
|
|
83
|
+
expected_values = None
|
|
84
|
+
with maybe_subtest(
|
|
85
|
+
subtests,
|
|
86
|
+
name=f"{intro}{subintro}compute_expected",
|
|
87
|
+
verbose=verbose,
|
|
88
|
+
):
|
|
89
|
+
try:
|
|
90
|
+
expected_values = instance.decompose_value(new_value)
|
|
91
|
+
except Exception as exc:
|
|
92
|
+
pytest.fail(
|
|
93
|
+
f"decompose_value raised an unexpected exception on '{meta.class_name}': {exc}"
|
|
94
|
+
)
|
|
95
|
+
|
|
96
|
+
# 4.1 Guard clause: Halt execution if decomposition calculation failed
|
|
97
|
+
if expected_values is None:
|
|
98
|
+
return
|
|
99
|
+
|
|
100
|
+
# 5. Compare inner property attributes against expected decomposed values
|
|
101
|
+
with maybe_subtest(
|
|
102
|
+
subtests,
|
|
103
|
+
name=f"{intro}{subintro}compare_inners",
|
|
104
|
+
verbose=verbose,
|
|
105
|
+
):
|
|
106
|
+
for inner, expected_value in zip(getattr(meta, "inners", ()), expected_values):
|
|
107
|
+
name_snake = inner.meta.name_snake
|
|
108
|
+
actual_value = getattr(instance, name_snake)
|
|
109
|
+
|
|
110
|
+
if actual_value != expected_value:
|
|
111
|
+
pytest.fail(
|
|
112
|
+
f"Downward reactivity state mismatch for inner property '{name_snake}': "
|
|
113
|
+
f"expected {expected_value!r}, got {actual_value!r}."
|
|
114
|
+
)
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
_DESIGN_NOTES = """
|
|
118
|
+
# assert_reactivity_downward (Downward State Cascade Gate)
|
|
119
|
+
|
|
120
|
+
## Purpose
|
|
121
|
+
Verifies downward reactivity within composite object hierarchies. It ensures that when a new root
|
|
122
|
+
composite value is assigned, the underlying framework decomposes the root payload into individual
|
|
123
|
+
component state values and propagates them down to each nested inner object.
|
|
124
|
+
|
|
125
|
+
## Execution Pipeline Steps
|
|
126
|
+
1. **Composite Type & Guard Gate:** Verifies that the target instance is a composite node (`not meta.is_constant`).
|
|
127
|
+
Aborts early via a guard clause if the target is an atomic constant.
|
|
128
|
+
2. **Decomposition Contract & Guard Gate:** Confirms the composite class defines decomposition capabilities
|
|
129
|
+
(`meta.is_decomposeable`). Halts execution if decomposition is unsupported.
|
|
130
|
+
3. **Root Mutation Intercept:** Mutates the root composite value using `assert_value_change`, which handles pre-validation
|
|
131
|
+
and in-place assignment.
|
|
132
|
+
4. **Decomposition Calculation & Guard Gate:** Calls `instance.decompose_value(new_value)` to derive the expected
|
|
133
|
+
sequence of child values, guarded by a fail-fast exit if calculation raises an exception.
|
|
134
|
+
5. **Inner State Reconciliation:** Iterates over `meta.inners`, fetching the runtime inner attribute via
|
|
135
|
+
`getattr(instance, name_snake)`, and asserts that every child state strictly reflects the decomposed expected value.
|
|
136
|
+
|
|
137
|
+
## Pipeline Lifecycle Role
|
|
138
|
+
Serves as one of the twin reactivity validation blades in the framework. While `assert_reactivity_upward`
|
|
139
|
+
verifies state aggregation from leaf to root, `assert_reactivity_downward` ensures top-down state distribution
|
|
140
|
+
and decomposition remain fully synchronized across the entire object tree.
|
|
141
|
+
"""
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
import pytest
|
|
3
|
+
from simplibs.exception.testing import maybe_subtest
|
|
4
|
+
# Outers
|
|
5
|
+
from ...containers.InnerValue import InnerValue
|
|
6
|
+
from ..base.assert_value_change import assert_value_change
|
|
7
|
+
# Annotations
|
|
8
|
+
if TYPE_CHECKING:
|
|
9
|
+
from ...._core.protocols import SimpleInstanceLike
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
# noinspection PyTypeChecker
|
|
13
|
+
def assert_reactivity_upward(
|
|
14
|
+
subtests: Any,
|
|
15
|
+
instance: "SimpleInstanceLike",
|
|
16
|
+
*,
|
|
17
|
+
new_value: InnerValue,
|
|
18
|
+
verbose: bool = True,
|
|
19
|
+
verbose_value_change: bool = True,
|
|
20
|
+
intro: str = "",
|
|
21
|
+
) -> None:
|
|
22
|
+
"""Assert upward reactivity across composite object instances.
|
|
23
|
+
|
|
24
|
+
Validates that updating a nested inner component's state (targeted via an ``InnerValue`` payload)
|
|
25
|
+
automatically triggers a recalculation cascade upwards, updating the root composite instance's value.
|
|
26
|
+
|
|
27
|
+
Args:
|
|
28
|
+
subtests: The native pytest subtests fixture manager instance.
|
|
29
|
+
instance: Root composite object instance under test.
|
|
30
|
+
new_value: An ``InnerValue`` container referencing the target inner attribute and its new value.
|
|
31
|
+
verbose: Enables isolated pytest subtests reporting for this wrapper.
|
|
32
|
+
verbose_value_change: Enables isolated subtests reporting inside the nested ``assert_value_change``.
|
|
33
|
+
intro: Optional prefix string added to the generated subtest identity name.
|
|
34
|
+
"""
|
|
35
|
+
subintro = "test_reactivity_upward::"
|
|
36
|
+
|
|
37
|
+
# 1. Capture initial composite root value
|
|
38
|
+
with maybe_subtest(
|
|
39
|
+
subtests,
|
|
40
|
+
name=f"{intro}{subintro}capture_original_composite",
|
|
41
|
+
verbose=verbose,
|
|
42
|
+
):
|
|
43
|
+
original_composite_value = instance.value
|
|
44
|
+
|
|
45
|
+
# 2. Input parameter MUST be an InnerValue container
|
|
46
|
+
is_inner_value = isinstance(new_value, InnerValue)
|
|
47
|
+
with maybe_subtest(
|
|
48
|
+
subtests,
|
|
49
|
+
name=f"{intro}{subintro}validate_input_type",
|
|
50
|
+
verbose=verbose,
|
|
51
|
+
):
|
|
52
|
+
if not is_inner_value:
|
|
53
|
+
pytest.fail(
|
|
54
|
+
"Upward reactivity assertion requires an InnerValue container; direct values cannot be used."
|
|
55
|
+
)
|
|
56
|
+
|
|
57
|
+
# 2.1 Guard clause: Halt execution if input is not an InnerValue container
|
|
58
|
+
if not is_inner_value:
|
|
59
|
+
return
|
|
60
|
+
|
|
61
|
+
# 3. Apply inner value change via shared value change assertion
|
|
62
|
+
with maybe_subtest(
|
|
63
|
+
subtests,
|
|
64
|
+
name=f"{intro}{subintro}apply_inner_value",
|
|
65
|
+
verbose=verbose,
|
|
66
|
+
):
|
|
67
|
+
assert_value_change(
|
|
68
|
+
subtests,
|
|
69
|
+
instance,
|
|
70
|
+
value=new_value,
|
|
71
|
+
verbose=verbose_value_change and verbose,
|
|
72
|
+
intro=intro,
|
|
73
|
+
)
|
|
74
|
+
|
|
75
|
+
# 4. Composite root value MUST have changed
|
|
76
|
+
with maybe_subtest(
|
|
77
|
+
subtests,
|
|
78
|
+
name=f"{intro}{subintro}composite_changed",
|
|
79
|
+
verbose=verbose,
|
|
80
|
+
):
|
|
81
|
+
if instance.value == original_composite_value:
|
|
82
|
+
pytest.fail(
|
|
83
|
+
f"Composite root value on '{instance.meta.class_name}' remained unchanged "
|
|
84
|
+
f"({original_composite_value!r}) after inner component update — upward reactivity is broken."
|
|
85
|
+
)
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
_DESIGN_NOTES = """
|
|
89
|
+
# assert_reactivity_upward (Upward State Cascade Gate)
|
|
90
|
+
|
|
91
|
+
## Purpose
|
|
92
|
+
Verifies bottom-up upward reactivity within composite object hierarchies. It guarantees that when
|
|
93
|
+
a leaf or nested child node's state mutates, the runtime owner notifications (`_recalculate_self`)
|
|
94
|
+
recompute the parent composite state, propagating updated values up to the root instance.
|
|
95
|
+
|
|
96
|
+
## Execution Pipeline Steps
|
|
97
|
+
1. **Initial State Snapshot:** Captures the root instance's current composite value (`instance.value`).
|
|
98
|
+
2. **Type & Guard Gate:** Validates that `new_value` is explicitly provided as an `InnerValue` container,
|
|
99
|
+
halting execution early via a guard clause if a raw non-inner value is passed.
|
|
100
|
+
3. **Inner Node Mutation:** Passes the `InnerValue` payload to `assert_value_change`. The base assertion resolves
|
|
101
|
+
the inner target attribute, pre-validates the candidate inner state, and executes the setter on the child object.
|
|
102
|
+
4. **Root State Mutation Assertion:** Asserts that `instance.value != original_composite_value`, confirming that
|
|
103
|
+
the bottom-up recalculation cascade successfully updated the top-level parent state.
|
|
104
|
+
|
|
105
|
+
## Pipeline Lifecycle Role
|
|
106
|
+
Functions as the upward reactivity validation blade in test runners (e.g., `assert_simple_object`).
|
|
107
|
+
Complements `assert_reactivity_downward` to guarantee full, bidirectional state consistency across the entire
|
|
108
|
+
reactive object graph.
|
|
109
|
+
"""
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Inners
|
|
4
|
+
from .containers import ObjectCase, MixinCase
|
|
5
|
+
from .assert_simple_object import assert_simple_object
|
|
6
|
+
from .assert_simple_mixin import assert_simple_mixin
|
|
7
|
+
# Outers
|
|
8
|
+
from ..SimpleConstant import SimpleConstant
|
|
9
|
+
from ..mixins.base_class import SimpleMixin
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
# noinspection PyTypeChecker
|
|
13
|
+
def bulk_test(
|
|
14
|
+
subtests: Any,
|
|
15
|
+
items: list[Any] | tuple[Any, ...],
|
|
16
|
+
*,
|
|
17
|
+
verbose: bool = True,
|
|
18
|
+
deep_check: bool = True,
|
|
19
|
+
) -> None:
|
|
20
|
+
"""Unified bulk test runner orchestrating batch execution of object and mixin test cases.
|
|
21
|
+
|
|
22
|
+
Iterates over a sequence of test definitions, automatically dispatching each item based on its type:
|
|
23
|
+
- ``ObjectCase``: Executes structured object testing via ``item.run_test``.
|
|
24
|
+
- ``MixinCase``: Executes structured mixin testing via ``item.run_test``.
|
|
25
|
+
- Raw ``SimpleConstant`` class: Invokes ``assert_simple_object`` without mixins.
|
|
26
|
+
- Tuple ``(test_class, mixins)``: Invokes ``assert_simple_object`` with attached mixins.
|
|
27
|
+
- Tuple ``(mixin_class, test_class)``: Invokes ``assert_simple_mixin`` for mixin verification.
|
|
28
|
+
|
|
29
|
+
Args:
|
|
30
|
+
subtests: The native pytest subtests fixture manager instance.
|
|
31
|
+
items: Sequence of test case objects, raw class types, or tuple configurations to test.
|
|
32
|
+
verbose: Enables isolated pytest subtests reporting across child assertions.
|
|
33
|
+
deep_check: Enables deep validation (synthetic mixins & internal methods) for object tests.
|
|
34
|
+
|
|
35
|
+
Raises:
|
|
36
|
+
AssertionError: If an item in ``items`` does not match any recognized test definition schema.
|
|
37
|
+
"""
|
|
38
|
+
for item in items:
|
|
39
|
+
|
|
40
|
+
# ------------------------------------------------------------
|
|
41
|
+
# 1. ObjectCase Instance
|
|
42
|
+
# ------------------------------------------------------------
|
|
43
|
+
if isinstance(item, ObjectCase):
|
|
44
|
+
intro = f"object_{item.test_class.__name__}::"
|
|
45
|
+
item.run_test(
|
|
46
|
+
subtests,
|
|
47
|
+
verbose=verbose,
|
|
48
|
+
intro=intro,
|
|
49
|
+
deep_check=deep_check,
|
|
50
|
+
)
|
|
51
|
+
continue
|
|
52
|
+
|
|
53
|
+
# ------------------------------------------------------------
|
|
54
|
+
# 2. MixinCase Instance
|
|
55
|
+
# ------------------------------------------------------------
|
|
56
|
+
if isinstance(item, MixinCase):
|
|
57
|
+
intro = f"mixin_{item.mixin_class.__name__}::"
|
|
58
|
+
item.run_test(
|
|
59
|
+
subtests,
|
|
60
|
+
verbose=verbose,
|
|
61
|
+
intro=intro,
|
|
62
|
+
)
|
|
63
|
+
continue
|
|
64
|
+
|
|
65
|
+
# ------------------------------------------------------------
|
|
66
|
+
# 3. Raw Object Class (SimpleConstant / SimpleObject, no mixins)
|
|
67
|
+
# ------------------------------------------------------------
|
|
68
|
+
if isinstance(item, type) and issubclass(item, SimpleConstant):
|
|
69
|
+
cls = item
|
|
70
|
+
intro = f"object_{cls.__name__}::"
|
|
71
|
+
assert_simple_object(
|
|
72
|
+
subtests,
|
|
73
|
+
cls,
|
|
74
|
+
mixins=UNSET,
|
|
75
|
+
verbose=verbose,
|
|
76
|
+
intro=intro,
|
|
77
|
+
deep_check=deep_check,
|
|
78
|
+
)
|
|
79
|
+
continue
|
|
80
|
+
|
|
81
|
+
# ------------------------------------------------------------
|
|
82
|
+
# 4. Raw Object Class with Mixins / Mixin with Base Class
|
|
83
|
+
# ------------------------------------------------------------
|
|
84
|
+
if isinstance(item, tuple) and len(item) == 2:
|
|
85
|
+
|
|
86
|
+
# 4a. Object Class + Mixin Tuple: (test_class, (mixin_1, mixin_2, ...))
|
|
87
|
+
cls, mixins = item
|
|
88
|
+
if (
|
|
89
|
+
isinstance(cls, type)
|
|
90
|
+
and issubclass(cls, SimpleConstant)
|
|
91
|
+
and isinstance(mixins, tuple)
|
|
92
|
+
and all(issubclass(mixin, SimpleMixin) for mixin in mixins)
|
|
93
|
+
):
|
|
94
|
+
intro = f"object_{cls.__name__}::"
|
|
95
|
+
assert_simple_object(
|
|
96
|
+
subtests,
|
|
97
|
+
cls,
|
|
98
|
+
mixins=mixins,
|
|
99
|
+
verbose=verbose,
|
|
100
|
+
intro=intro,
|
|
101
|
+
deep_check=deep_check,
|
|
102
|
+
)
|
|
103
|
+
continue
|
|
104
|
+
|
|
105
|
+
# 4b. Mixin Class + Target Class Tuple: (mixin_class, test_class)
|
|
106
|
+
mixin_class, test_class = item
|
|
107
|
+
if (
|
|
108
|
+
isinstance(mixin_class, type)
|
|
109
|
+
and issubclass(mixin_class, SimpleMixin)
|
|
110
|
+
and isinstance(test_class, type)
|
|
111
|
+
and issubclass(test_class, SimpleConstant)
|
|
112
|
+
):
|
|
113
|
+
intro = f"mixin_{mixin_class.__name__}::"
|
|
114
|
+
assert_simple_mixin(
|
|
115
|
+
subtests,
|
|
116
|
+
mixin_class,
|
|
117
|
+
test_class=test_class,
|
|
118
|
+
verbose=verbose,
|
|
119
|
+
intro=intro,
|
|
120
|
+
)
|
|
121
|
+
continue
|
|
122
|
+
|
|
123
|
+
# ------------------------------------------------------------
|
|
124
|
+
# 5. Unsupported / Unrecognized Test Item Schema
|
|
125
|
+
# ------------------------------------------------------------
|
|
126
|
+
raise AssertionError(f"Unsupported bulk test item provided to bulk_test: {item!r}")
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
_DESIGN_NOTES = """
|
|
130
|
+
# bulk_test (Batch Test Suite Orchestration Engine)
|
|
131
|
+
|
|
132
|
+
## Purpose
|
|
133
|
+
Acts as a polymorphic batch execution entry point for suite-level testing. It accepts heterogeneous collections
|
|
134
|
+
of test configurations—ranging from fully declarative `ObjectCase` / `MixinCase` instances to quick raw class types
|
|
135
|
+
and tuples—and automatically routes them to the appropriate test orchestrator.
|
|
136
|
+
|
|
137
|
+
## Dispatch Resolution Pipeline
|
|
138
|
+
1. **`ObjectCase` Container:** Directly calls `item.run_test(subtests, ...)`.
|
|
139
|
+
2. **`MixinCase` Container:** Directly calls `item.run_test(subtests, ...)`.
|
|
140
|
+
3. **Raw Blueprint Class (`type` deriving from `SimpleConstant`):** Automatically wraps and dispatches to `assert_simple_object`.
|
|
141
|
+
4. **Tuple Pair Resolution:**
|
|
142
|
+
- **Object + Mixins (`(SimpleConstant, tuple[SimpleMixin, ...])`):** Dispatches to `assert_simple_object(cls, mixins=mixins)`.
|
|
143
|
+
- **Mixin + Base Target (`(SimpleMixin, SimpleConstant)`):** Dispatches to `assert_simple_mixin(mixin_class, test_class=test_class)`.
|
|
144
|
+
5. **Fallback / Invalid Item Intercept:** Directly raises an `AssertionError` to immediately halt execution when an invalid
|
|
145
|
+
item schema is encountered (fail-fast contract validation).
|
|
146
|
+
|
|
147
|
+
## Pipeline Lifecycle Role
|
|
148
|
+
Provides a lightweight, zero-boilerplate batch testing runner for test suites, allowing entire packages of objects
|
|
149
|
+
and mixins to be validated in a single pytest test function call.
|
|
150
|
+
"""
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
from dataclasses import dataclass
|
|
2
|
+
from typing import Any, Iterable
|
|
3
|
+
from simplibs.sentinels import UNSET, UnsetType
|
|
4
|
+
# Inners
|
|
5
|
+
from ._validations import (
|
|
6
|
+
raise_inner_value_empty_path,
|
|
7
|
+
raise_inner_value_invalid_path_type,
|
|
8
|
+
)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
@dataclass(frozen=True)
|
|
12
|
+
class InnerValue:
|
|
13
|
+
"""Represents a target property path update and value payload for nested composite testing.
|
|
14
|
+
|
|
15
|
+
Encapsulates nested property paths (e.g. ``"address.city.zip"`` or ``("address", "city", "zip")``)
|
|
16
|
+
and their corresponding target test values. Normalizes path specifications into uniform string tuples
|
|
17
|
+
and provides dynamic instance navigation utilities.
|
|
18
|
+
|
|
19
|
+
Args:
|
|
20
|
+
path: A dot-separated property path string or an iterable sequence of string attribute identifiers.
|
|
21
|
+
value: Candidate payload value to assign or assert at the resolved property location.
|
|
22
|
+
"""
|
|
23
|
+
|
|
24
|
+
path: str | Iterable[str]
|
|
25
|
+
value: Any
|
|
26
|
+
|
|
27
|
+
def __post_init__(self) -> None:
|
|
28
|
+
"""Normalizes and validates the property path upon dataclass initialization.
|
|
29
|
+
|
|
30
|
+
Raises:
|
|
31
|
+
SimpleRuntimeError: If the path evaluates to an empty sequence or contains non-string items.
|
|
32
|
+
"""
|
|
33
|
+
# 1. Normalize path input into a list of string segments
|
|
34
|
+
if isinstance(self.path, str):
|
|
35
|
+
parts = self.path.split(".")
|
|
36
|
+
else:
|
|
37
|
+
parts = tuple(self.path)
|
|
38
|
+
|
|
39
|
+
# 2. Validate non-empty path constraint
|
|
40
|
+
if not parts:
|
|
41
|
+
raise_inner_value_empty_path()
|
|
42
|
+
|
|
43
|
+
# 3. Validate string item types in path
|
|
44
|
+
for part in parts:
|
|
45
|
+
if not isinstance(part, str):
|
|
46
|
+
raise_inner_value_invalid_path_type(self.path, part)
|
|
47
|
+
|
|
48
|
+
# 4. Freeze normalized path as an immutable tuple of strings
|
|
49
|
+
object.__setattr__(self, "path", tuple(parts))
|
|
50
|
+
|
|
51
|
+
def as_instance_tuple(self, instance: Any) -> tuple[Any, Any] | UnsetType:
|
|
52
|
+
"""Navigates nested child instances and returns the target parent instance and value pair.
|
|
53
|
+
|
|
54
|
+
Traverses child composite property chains using the convention ``<part>_instance``. If any intermediate
|
|
55
|
+
property is missing or resolves to ``None``, returns ``UNSET``.
|
|
56
|
+
|
|
57
|
+
Args:
|
|
58
|
+
instance: Root composite object instance to traverse.
|
|
59
|
+
|
|
60
|
+
Returns:
|
|
61
|
+
A tuple ``(resolved_inner_instance, target_value)`` if navigation succeeds, otherwise ``UNSET``.
|
|
62
|
+
"""
|
|
63
|
+
current = instance
|
|
64
|
+
|
|
65
|
+
for part in self.path:
|
|
66
|
+
inner_prop = f"{part}_instance"
|
|
67
|
+
|
|
68
|
+
if not hasattr(current, inner_prop):
|
|
69
|
+
return UNSET
|
|
70
|
+
|
|
71
|
+
current = getattr(current, inner_prop)
|
|
72
|
+
|
|
73
|
+
if current is None:
|
|
74
|
+
return UNSET
|
|
75
|
+
|
|
76
|
+
return current, self.value
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
_DESIGN_NOTES = """
|
|
80
|
+
# InnerValue (Nested Property Mutation & Assert Value Container)
|
|
81
|
+
|
|
82
|
+
## Purpose
|
|
83
|
+
Acts as a declarative value-and-path container used during upward/downward reactivity testing,
|
|
84
|
+
state mutation assertions, and parameter tests on nested `SimpleObject` composites.
|
|
85
|
+
|
|
86
|
+
## Path Normalization & Exception Safeguards
|
|
87
|
+
1. **Normalization:** Converted from dot-notation strings (`"address.city"`) or sequences (`("address", "city")`)
|
|
88
|
+
into an immutable tuple of string segments (`("address", "city")`).
|
|
89
|
+
2. **Validation Errors:**
|
|
90
|
+
- Empty path -> Triggers `raise_inner_value_empty_path()` (`SimpleRuntimeError` wrapping `ValueError`).
|
|
91
|
+
- Non-string path segments -> Triggers `raise_inner_value_invalid_path_type()` (`SimpleRuntimeError` wrapping `TypeError`).
|
|
92
|
+
|
|
93
|
+
## Navigation Lifecycle (`as_instance_tuple`)
|
|
94
|
+
Navigates composite hierarchies via `getattr(current, f"{part}_instance")`.
|
|
95
|
+
If all nested instances exist, returns `(target_inner_instance, target_value)`.
|
|
96
|
+
If any intermediate reference is missing or `None`, gracefully returns `UNSET`.
|
|
97
|
+
|
|
98
|
+
## Framework Usage Locations
|
|
99
|
+
1. **`asserts/reactivity/assert_reactivity_upward.py`:** Reads `.as_instance_tuple(instance)` to perform child property mutation and root recalculation checks.
|
|
100
|
+
2. **`asserts/base/assert_value_change.py`:** Detects `isinstance(value, InnerValue)` to unpack targeted nested value updates.
|
|
101
|
+
3. **`assert_simple_object.py`:** Used in parameter signatures (`test_value_change`, `test_reactivity_up`, `test_mutability`, `test_immutability`).
|
|
102
|
+
"""
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
from dataclasses import dataclass
|
|
2
|
+
from typing import Any, TYPE_CHECKING
|
|
3
|
+
from simplibs.sentinels import UNSET, UnsetType
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ..._core.protocols import SimpleClassType, SimpleMixinType
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
@dataclass(slots=True, kw_only=True)
|
|
10
|
+
class MixinCase:
|
|
11
|
+
"""Declarative reusable container configuration for testing Simple mixins.
|
|
12
|
+
|
|
13
|
+
Mirrors the parameter structure of ``assert_simple_mixin``, enabling declarative specification,
|
|
14
|
+
reuse, and batch execution of mixin test scenarios across bulk testing setups.
|
|
15
|
+
|
|
16
|
+
Attributes:
|
|
17
|
+
mixin_class: Target mixin blueprint class under test.
|
|
18
|
+
test_class: Target base object class used to bind and instantiate the mixin.
|
|
19
|
+
slots_names: Optional tuple of expected slot string identifiers to check for presence.
|
|
20
|
+
slots_values: Optional tuple of single or multiple ``(slot_name, expected_value)`` pairs.
|
|
21
|
+
attribute_names: Optional tuple of expected attribute identifiers to check for presence.
|
|
22
|
+
method_names: Optional tuple of expected method identifiers to check for presence.
|
|
23
|
+
"""
|
|
24
|
+
|
|
25
|
+
# ------------------------------------------------------------
|
|
26
|
+
# Required Configuration
|
|
27
|
+
# ------------------------------------------------------------
|
|
28
|
+
mixin_class: "SimpleMixinType"
|
|
29
|
+
test_class: "SimpleClassType"
|
|
30
|
+
|
|
31
|
+
# ------------------------------------------------------------
|
|
32
|
+
# Optional Parameter Test Cases
|
|
33
|
+
# ------------------------------------------------------------
|
|
34
|
+
slots_names: tuple[str, ...] | UnsetType = UNSET
|
|
35
|
+
slots_values: tuple[tuple[str, Any], ...] | tuple[str, Any] | UnsetType = UNSET
|
|
36
|
+
attribute_names: tuple[str, ...] | UnsetType = UNSET
|
|
37
|
+
method_names: tuple[str, ...] | UnsetType = UNSET
|
|
38
|
+
|
|
39
|
+
# ------------------------------------------------------------
|
|
40
|
+
# Execution Methods
|
|
41
|
+
# ------------------------------------------------------------
|
|
42
|
+
def run_test(
|
|
43
|
+
self,
|
|
44
|
+
subtests: Any,
|
|
45
|
+
*,
|
|
46
|
+
verbose: bool = True,
|
|
47
|
+
intro: str = "",
|
|
48
|
+
) -> Any:
|
|
49
|
+
"""Executes this mixin test scenario via the master orchestrator function.
|
|
50
|
+
|
|
51
|
+
Args:
|
|
52
|
+
subtests: The native pytest subtests fixture manager instance.
|
|
53
|
+
verbose: Enables isolated pytest subtests reporting across child assertions.
|
|
54
|
+
intro: Optional prefix string added to generated subtest identity names.
|
|
55
|
+
|
|
56
|
+
Returns:
|
|
57
|
+
The created instance with the target mixin applied.
|
|
58
|
+
"""
|
|
59
|
+
from ..assert_simple_mixin import assert_simple_mixin
|
|
60
|
+
return assert_simple_mixin(
|
|
61
|
+
subtests,
|
|
62
|
+
self.mixin_class,
|
|
63
|
+
test_class=self.test_class,
|
|
64
|
+
slots_names=self.slots_names,
|
|
65
|
+
slots_values=self.slots_values,
|
|
66
|
+
attribute_names=self.attribute_names,
|
|
67
|
+
method_names=self.method_names,
|
|
68
|
+
verbose=verbose,
|
|
69
|
+
intro=intro,
|
|
70
|
+
)
|
|
71
|
+
|
|
72
|
+
|
|
73
|
+
_DESIGN_NOTES = """
|
|
74
|
+
# MixinCase (Declarative Mixin Test Specification Container)
|
|
75
|
+
|
|
76
|
+
## Purpose
|
|
77
|
+
Acts as a declarative dataclass container wrapping all configurable parameters required to test
|
|
78
|
+
a `SimpleMixin` subclass. It separates mixin test definitions from execution, allowing mixin scenarios
|
|
79
|
+
to be constructed as data structures and run in batch suites.
|
|
80
|
+
|
|
81
|
+
## Architectural Lifecycle
|
|
82
|
+
1. **Definition:** Users instantiate `MixinCase(mixin_class=MyMixin, test_class=MyObject, ...)` as data objects.
|
|
83
|
+
2. **Batch Dispatch:** Passed to `bulk_test`, which detects `isinstance(item, MixinCase)` and delegates execution.
|
|
84
|
+
3. **Delegation:** Calls `self.run_test(...)`, unpacking stored parameters into `assert_simple_mixin(...)`.
|
|
85
|
+
|
|
86
|
+
## Framework Usage Locations
|
|
87
|
+
1. **`bulk_test.py`:** Evaluated in the main dispatch loop (`isinstance(item, MixinCase)`) to trigger `item.run_test(...)`.
|
|
88
|
+
2. **External Test Suites:** Used directly by developers to declare lists of mixin test scenarios for bulk processing.
|
|
89
|
+
"""
|