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,99 @@
|
|
|
1
|
+
from .core_mixins import (
|
|
2
|
+
Infrastructure,
|
|
3
|
+
NodesDicts,
|
|
4
|
+
NodesTuple,
|
|
5
|
+
Serialization,
|
|
6
|
+
Snapshot,
|
|
7
|
+
)
|
|
8
|
+
|
|
9
|
+
from .dunders.collections import CollectionBase, Iterable, Mapping, Collection
|
|
10
|
+
from .dunders.comparison import Equality, Ordering
|
|
11
|
+
from .dunders.generics import ClassGetItem
|
|
12
|
+
from .dunders.interfaces import Call, ContextManager
|
|
13
|
+
from .dunders.lifecycles import Copyable, PickleState, PickleReduce, Lifecycle
|
|
14
|
+
from .dunders.numeric import Arithmetic, Bitwise, Conversion, Inplace, Unary
|
|
15
|
+
from .dunders.representation import ValueDisplay, ValueFormatting
|
|
16
|
+
|
|
17
|
+
from .others.immutable import ImmutableMethods, ImmutableWithInners
|
|
18
|
+
from .others.numerical import Equalizer, Volume
|
|
19
|
+
from .others.properties import InnersProperty, MetaShortcuts
|
|
20
|
+
from .others.state import DefaultState, DirtyTracking, History, Permission
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
__all__ = [
|
|
24
|
+
# core_mixins
|
|
25
|
+
"Infrastructure",
|
|
26
|
+
"NodesDicts",
|
|
27
|
+
"NodesTuple",
|
|
28
|
+
"Serialization",
|
|
29
|
+
"Snapshot",
|
|
30
|
+
# dunders.collections
|
|
31
|
+
"CollectionBase",
|
|
32
|
+
"Iterable",
|
|
33
|
+
"Mapping",
|
|
34
|
+
"Collection",
|
|
35
|
+
# dunders.comparison
|
|
36
|
+
"Equality",
|
|
37
|
+
"Ordering",
|
|
38
|
+
# dunders.generics
|
|
39
|
+
"ClassGetItem",
|
|
40
|
+
# dunders.interfaces
|
|
41
|
+
"Call",
|
|
42
|
+
"ContextManager",
|
|
43
|
+
# dunders.lifecycles
|
|
44
|
+
"Copyable",
|
|
45
|
+
"PickleState",
|
|
46
|
+
"PickleReduce",
|
|
47
|
+
"Lifecycle",
|
|
48
|
+
# dunders.numeric
|
|
49
|
+
"Arithmetic",
|
|
50
|
+
"Bitwise",
|
|
51
|
+
"Conversion",
|
|
52
|
+
"Inplace",
|
|
53
|
+
"Unary",
|
|
54
|
+
# dunders.representation
|
|
55
|
+
"ValueDisplay",
|
|
56
|
+
"ValueFormatting",
|
|
57
|
+
# others.immutable
|
|
58
|
+
"ImmutableMethods",
|
|
59
|
+
"ImmutableWithInners",
|
|
60
|
+
# others.numerical
|
|
61
|
+
"Equalizer",
|
|
62
|
+
"Volume",
|
|
63
|
+
# others.properties
|
|
64
|
+
"InnersProperty",
|
|
65
|
+
"MetaShortcuts",
|
|
66
|
+
# others.state
|
|
67
|
+
"DefaultState",
|
|
68
|
+
"DirtyTracking",
|
|
69
|
+
"History",
|
|
70
|
+
"Permission",
|
|
71
|
+
]
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
_DESIGN_NOTES = """
|
|
75
|
+
# Mixins Package Overview
|
|
76
|
+
|
|
77
|
+
The `mixins` package is the public entry point for the entire Simple
|
|
78
|
+
mixin ecosystem. It propagates every mixin from every sub-package —
|
|
79
|
+
`core_mixins`, `dunders`, and `others` — so any mixin can be imported
|
|
80
|
+
directly from `simplibs.object.mixins` rather than reaching into a
|
|
81
|
+
specific sub-package.
|
|
82
|
+
|
|
83
|
+
## Sub-Packages
|
|
84
|
+
|
|
85
|
+
| Sub-package | Type | Description |
|
|
86
|
+
| :-------------- | :--------- | :----------------------------------------------------------------- |
|
|
87
|
+
| `core_mixins` | Foundation | Node-tree walking, snapshotting, serialization — shared by both. |
|
|
88
|
+
| `dunders` | Category | Mixins implementing standard Python dunder protocols. |
|
|
89
|
+
| `others` | Category | Mixins adding Simple-ecosystem-specific behavior. |
|
|
90
|
+
|
|
91
|
+
## Notes
|
|
92
|
+
- This is the only `__init__.py` in the package that defines `__all__`
|
|
93
|
+
or re-exports across sub-package boundaries — every inner `__init__.py`
|
|
94
|
+
(including `dunders/__init__.py` and `others/__init__.py`) is scoped to
|
|
95
|
+
its own folder and does not propagate further.
|
|
96
|
+
- `core_mixins` is exposed at the top level alongside `dunders` and
|
|
97
|
+
`others`, reflecting that it is shared infrastructure rather than a
|
|
98
|
+
sibling category of either.
|
|
99
|
+
"""
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
_DESIGN_NOTES = """
|
|
2
|
+
# Common Mixins Package Overview
|
|
3
|
+
|
|
4
|
+
The `_common_logic` package aggregates foundational mixin subsystems used across the
|
|
5
|
+
Simple object framework. Each sub-package focuses on a specific structural
|
|
6
|
+
domain: internal constants, immutability pipelines, and shared helper logic.
|
|
7
|
+
|
|
8
|
+
This package does not re-export any components. All functionality is accessed
|
|
9
|
+
directly through the corresponding sub-packages.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## Sub-Packages
|
|
14
|
+
|
|
15
|
+
### 1. constants
|
|
16
|
+
Provides canonical internal attribute names and structural constraint sets:
|
|
17
|
+
- name tokens for mixin internals,
|
|
18
|
+
- forbidden attribute names,
|
|
19
|
+
- compatibility flags.
|
|
20
|
+
|
|
21
|
+
These constants form the stable backbone of mixin configuration.
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
### 2. immutability
|
|
26
|
+
Implements the full immutability subsystem:
|
|
27
|
+
- single constant updates,
|
|
28
|
+
- batch constant updates,
|
|
29
|
+
- composite updates,
|
|
30
|
+
- mixed updates (`with_any`),
|
|
31
|
+
- snapshot-based instance reconstruction.
|
|
32
|
+
|
|
33
|
+
This subsystem ensures deterministic, structural, and dependency-aware updates.
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## Notes
|
|
38
|
+
- This package is internal and not intended for direct user interaction.
|
|
39
|
+
- Each sub-package is self-contained and exposes its own public API.
|
|
40
|
+
- The structure is designed for clarity, modularity, and predictable behavior.
|
|
41
|
+
"""
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
from .names import HISTORY, OWNER_CLASS, STEPPER, VALUE
|
|
2
|
+
from .sets import FORBIDDEN_NAMES, RESTRICTION_FLAGS
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Simple Mixin Constants Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Aggregates all internal constants used by the Simple mixin subsystem. Provides
|
|
9
|
+
a unified import surface for attribute name tokens and structural constraint
|
|
10
|
+
sets.
|
|
11
|
+
|
|
12
|
+
## Internal Components Registry
|
|
13
|
+
|
|
14
|
+
| Component | Type | Description |
|
|
15
|
+
| :------------------ | :------- | :------------------------------------------------------- |
|
|
16
|
+
| `HISTORY` | Constant | Canonical internal attribute name for history tracking. |
|
|
17
|
+
| `OWNER_CLASS` | Constant | Canonical internal attribute name for owner class. |
|
|
18
|
+
| `STEPPER` | Constant | Canonical internal attribute name for stepper logic. |
|
|
19
|
+
| `VALUE` | Constant | Canonical internal attribute name for value storage. |
|
|
20
|
+
| `FORBIDDEN_NAMES` | Set | Reserved internal names that mixins must never define. |
|
|
21
|
+
| `RESTRICTION_FLAGS` | Tuple | Declarative mixin compatibility flag identifiers. |
|
|
22
|
+
|
|
23
|
+
## Notes
|
|
24
|
+
This package acts as the single authoritative source of truth for all mixin
|
|
25
|
+
constants. Its stability is essential for correct runtime behavior across the
|
|
26
|
+
entire Simple object system.
|
|
27
|
+
"""
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
HISTORY = "history"
|
|
2
|
+
|
|
3
|
+
_DESIGN_NOTES = """
|
|
4
|
+
# Constant Name Token
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
Represents a single, immutable string token used as an internal attribute
|
|
8
|
+
identifier within the Simple system. Serves as the sole source of truth for
|
|
9
|
+
the history attribute name, preventing accidental typos or shadowing.
|
|
10
|
+
|
|
11
|
+
## Notes
|
|
12
|
+
Changing this constant would break mixin attribute resolution and internal
|
|
13
|
+
object wiring. It is treated as a core invariant of the system.
|
|
14
|
+
"""
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
OWNER_CLASS = "_owner_class"
|
|
2
|
+
|
|
3
|
+
_DESIGN_NOTES = """
|
|
4
|
+
# Constant Name Token
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
Represents a single, immutable string token used as an internal attribute
|
|
8
|
+
identifier within the Simple system. Serves as the sole source of truth for
|
|
9
|
+
the owner class attribute name, preventing accidental typos or shadowing.
|
|
10
|
+
|
|
11
|
+
## Notes
|
|
12
|
+
Changing this constant would break mixin attribute resolution and internal
|
|
13
|
+
object wiring. It is treated as a core invariant of the system.
|
|
14
|
+
"""
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
STEPPER = "_stepper"
|
|
2
|
+
|
|
3
|
+
_DESIGN_NOTES = """
|
|
4
|
+
# Constant Name Token
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
Represents a single, immutable string token used as an internal attribute
|
|
8
|
+
identifier within the Simple system. Serves as the sole source of truth for
|
|
9
|
+
the stepper attribute name, preventing accidental typos or shadowing.
|
|
10
|
+
|
|
11
|
+
## Notes
|
|
12
|
+
Changing this constant would break mixin attribute resolution and internal
|
|
13
|
+
object wiring. It is treated as a core invariant of the system.
|
|
14
|
+
"""
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
VALUE = "_value"
|
|
2
|
+
|
|
3
|
+
_DESIGN_NOTES = """
|
|
4
|
+
# Constant Name Token
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
Represents a single, immutable string token used as an internal attribute
|
|
8
|
+
identifier within the Simple system. Serves as the sole source of truth for
|
|
9
|
+
the value attribute name, preventing accidental typos or shadowing.
|
|
10
|
+
|
|
11
|
+
## Notes
|
|
12
|
+
Changing this constant would break mixin attribute resolution and internal
|
|
13
|
+
object wiring. It is treated as a core invariant of the system.
|
|
14
|
+
"""
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
from .HISTORY import HISTORY
|
|
2
|
+
from .OWNER_CLASS import OWNER_CLASS
|
|
3
|
+
from .STEPPER import STEPPER
|
|
4
|
+
from .VALUE import VALUE
|
|
5
|
+
|
|
6
|
+
_DESIGN_NOTES = """
|
|
7
|
+
# Internal Attribute Name Tokens
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Provides a collection of atomic, immutable string tokens used as canonical
|
|
11
|
+
attribute identifiers throughout the Simple mixin and object system. Each
|
|
12
|
+
constant represents a single internal attribute name and acts as the sole
|
|
13
|
+
source of truth for that identifier.
|
|
14
|
+
|
|
15
|
+
## Internal Components Registry
|
|
16
|
+
|
|
17
|
+
| Component | Type | Description |
|
|
18
|
+
| :------------- | :------- | :------------------------------------------------------ |
|
|
19
|
+
| `HISTORY` | Constant | Internal attribute name for history tracking. |
|
|
20
|
+
| `OWNER_CLASS` | Constant | Internal attribute name for owner class reference. |
|
|
21
|
+
| `STEPPER` | Constant | Internal attribute name for stepper logic. |
|
|
22
|
+
| `VALUE` | Constant | Internal attribute name for value storage. |
|
|
23
|
+
|
|
24
|
+
## Notes
|
|
25
|
+
These constants prevent accidental typos, shadowing, and inconsistent naming
|
|
26
|
+
across mixins and internal utilities. Each is intentionally isolated in its own
|
|
27
|
+
module to maintain a clear mental map of the system’s internal vocabulary.
|
|
28
|
+
"""
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
FORBIDDEN_NAMES = {
|
|
2
|
+
"__init__",
|
|
3
|
+
"__metadata__",
|
|
4
|
+
"_decompose",
|
|
5
|
+
"_inners",
|
|
6
|
+
"_logic",
|
|
7
|
+
"_owner",
|
|
8
|
+
"_recalculate_inners",
|
|
9
|
+
"_recalculate_self",
|
|
10
|
+
"_value",
|
|
11
|
+
"meta",
|
|
12
|
+
"owner",
|
|
13
|
+
"value",
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
_DESIGN_NOTES = """
|
|
17
|
+
# FORBIDDEN_NAMES
|
|
18
|
+
|
|
19
|
+
## Purpose
|
|
20
|
+
Defines a protected set of attribute names that must never appear inside mixin
|
|
21
|
+
definitions. These names are reserved for internal Simple system mechanics and
|
|
22
|
+
are critical for maintaining deterministic instance behavior.
|
|
23
|
+
|
|
24
|
+
## Notes
|
|
25
|
+
Used by the mixin validation pipeline to detect collisions in both `__slots__`
|
|
26
|
+
and class-level namespaces. Treated as a core invariant of the system.
|
|
27
|
+
"""
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
RESTRICTION_FLAGS = (
|
|
2
|
+
"_constant_only",
|
|
3
|
+
"_composite_only",
|
|
4
|
+
"_mutable_only",
|
|
5
|
+
"_immutable_only",
|
|
6
|
+
)
|
|
7
|
+
|
|
8
|
+
_DESIGN_NOTES = """
|
|
9
|
+
# RESTRICTION_FLAGS
|
|
10
|
+
|
|
11
|
+
## Purpose
|
|
12
|
+
Defines the complete set of declarative compatibility flags used by mixins to
|
|
13
|
+
express structural constraints on where they may be applied.
|
|
14
|
+
|
|
15
|
+
## Notes
|
|
16
|
+
Used by the mixin validation pipeline to ensure all declared flags are boolean.
|
|
17
|
+
Acts as a schema definition for mixin compatibility metadata.
|
|
18
|
+
"""
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
from .FORBIDDEN_NAMES import FORBIDDEN_NAMES
|
|
2
|
+
from .RESTRICTION_FLAGS import RESTRICTION_FLAGS
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Mixin Structural Constraint Sets
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Provides centralized sets of structural constraints used by the mixin
|
|
9
|
+
validation pipeline. These sets define forbidden attribute names and allowed
|
|
10
|
+
declarative compatibility flags.
|
|
11
|
+
|
|
12
|
+
## Internal Components Registry
|
|
13
|
+
|
|
14
|
+
| Component | Type | Description |
|
|
15
|
+
| :------------------ | :------- | :------------------------------------------------------- |
|
|
16
|
+
| `FORBIDDEN_NAMES` | Set | Reserved internal names that mixins must never define. |
|
|
17
|
+
| `RESTRICTION_FLAGS` | Tuple | Declarative mixin compatibility flag identifiers. |
|
|
18
|
+
|
|
19
|
+
## Notes
|
|
20
|
+
These sets act as schema definitions for mixin structure. They are intentionally
|
|
21
|
+
small, explicit, and immutable to ensure deterministic validation behavior.
|
|
22
|
+
"""
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
from .with_constant import with_constant
|
|
2
|
+
from .with_constants import with_constants
|
|
3
|
+
from .with_composite import with_composite
|
|
4
|
+
from .with_any import with_any
|
|
5
|
+
from .with_constant.utils.create_new_instance import create_new_instance
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
_DESIGN_NOTES = """
|
|
9
|
+
# Immutability Pipeline
|
|
10
|
+
|
|
11
|
+
## Purpose
|
|
12
|
+
Provides the high-level immutable update operations used throughout the Simple
|
|
13
|
+
object framework. These functions form the public immutability API and route
|
|
14
|
+
updates to the correct structural pipelines.
|
|
15
|
+
|
|
16
|
+
In addition, this module re-exports `create_new_instance`, a core utility used
|
|
17
|
+
across all immutability operations to construct fresh instances from snapshots.
|
|
18
|
+
|
|
19
|
+
## Internal Components Registry
|
|
20
|
+
|
|
21
|
+
| Component | Type | Description |
|
|
22
|
+
| :-------------------- | :------- | :----------------------------------------------- |
|
|
23
|
+
| `with_constant` | Function | Updates a single constant value immutably. |
|
|
24
|
+
| `with_constants` | Function | Applies multiple constant updates immutably. |
|
|
25
|
+
| `with_composite` | Function | Updates composite nodes and recalculates inners. |
|
|
26
|
+
| `with_any` | Function | Unified entry point for mixed update operations. |
|
|
27
|
+
| `create_new_instance` | Function | Builds a new instance from a snapshot. |
|
|
28
|
+
"""
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
from .with_any import with_any
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# with_any
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Provides the unified entry point for mixed updates.
|
|
9
|
+
This function orchestrates constant updates, composite updates, and
|
|
10
|
+
structural validation in a deterministic pipeline.
|
|
11
|
+
|
|
12
|
+
## Component
|
|
13
|
+
|
|
14
|
+
| Component | Type | Description |
|
|
15
|
+
| :--------- | :------- | :---------------------------------------- |
|
|
16
|
+
| `with_any` | Function | Unified dispatcher for mixed updates. |
|
|
17
|
+
"""
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
from .get_top_composite_paths import get_top_composite_paths
|
|
2
|
+
from .process_single_change import process_single_change
|
|
3
|
+
from .split_changes import split_changes
|
|
4
|
+
from .split_constants_paths import split_constants_paths
|
|
5
|
+
|
|
6
|
+
_DESIGN_NOTES = """
|
|
7
|
+
# Helpers for with_any Pipeline
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Provides structural and routing utilities used by the mixed update pipeline
|
|
11
|
+
(`with_any`). These helpers classify updates, determine composite hierarchy,
|
|
12
|
+
and validate structural correctness.
|
|
13
|
+
|
|
14
|
+
## Internal Components Registry
|
|
15
|
+
|
|
16
|
+
| Component | Type | Description |
|
|
17
|
+
| :------------------------ | :------- | :-------------------------------------------------- |
|
|
18
|
+
| `get_top_composite_paths` | Function | Determines root vs child composite paths. |
|
|
19
|
+
| `process_single_change` | Function | Routes single update to correct pipeline. |
|
|
20
|
+
| `split_changes` | Function | Splits updates into constants and composites. |
|
|
21
|
+
| `split_constants_paths` | Function | Splits constants into contained vs unique groups. |
|
|
22
|
+
"""
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Annotations
|
|
3
|
+
if TYPE_CHECKING:
|
|
4
|
+
from ......_core.protocols.alias_typings import NodesPathDict, ChangesTuple, PathDict
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def get_top_composite_paths(
|
|
8
|
+
composite: "ChangesTuple",
|
|
9
|
+
nodes_path_dict: "NodesPathDict",
|
|
10
|
+
) -> tuple["PathDict", "PathDict"]:
|
|
11
|
+
"""
|
|
12
|
+
Returns only the composite paths closest to the root — i.e., those that
|
|
13
|
+
are not subpaths of any other composite path in the dictionary.
|
|
14
|
+
|
|
15
|
+
Logic:
|
|
16
|
+
- Sort paths by length (shorter = higher in hierarchy)
|
|
17
|
+
- For each path, check whether it is a prefix of any already stored root path
|
|
18
|
+
- If not a prefix → it is a new root composite
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
# 1. Prepare variables
|
|
22
|
+
top_composite = {}
|
|
23
|
+
top_composite_paths = []
|
|
24
|
+
child_composite = {}
|
|
25
|
+
|
|
26
|
+
# 2. Build sorted list of (name, path) pairs
|
|
27
|
+
composite_names = (name for name, _ in composite)
|
|
28
|
+
sorted_paths = sorted(
|
|
29
|
+
((name, nodes_path_dict[name]) for name in composite_names),
|
|
30
|
+
key=lambda item: len(item[1]),
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
# 3. Filter root composite paths
|
|
34
|
+
for key, path in sorted_paths:
|
|
35
|
+
|
|
36
|
+
# 3.1 Process top-level composites
|
|
37
|
+
if not any(
|
|
38
|
+
path[:len(parent)] == parent
|
|
39
|
+
for parent in top_composite_paths
|
|
40
|
+
):
|
|
41
|
+
top_composite[key] = path
|
|
42
|
+
top_composite_paths.append(path)
|
|
43
|
+
|
|
44
|
+
# 3.2 Process inner composites
|
|
45
|
+
else:
|
|
46
|
+
child_composite[key] = path
|
|
47
|
+
|
|
48
|
+
# 4. Return both dictionaries
|
|
49
|
+
return top_composite, child_composite
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
_DESIGN_NOTES = """
|
|
53
|
+
# get_top_composite_paths
|
|
54
|
+
|
|
55
|
+
## Purpose
|
|
56
|
+
Identifies which composite nodes in a change set are **root composites** and
|
|
57
|
+
which are **child composites**.
|
|
58
|
+
Root composites are those whose structural paths are not prefixes of any other
|
|
59
|
+
composite path.
|
|
60
|
+
Child composites are those that lie inside another composite’s structural path.
|
|
61
|
+
|
|
62
|
+
This function is essential for determining the correct update order in the
|
|
63
|
+
[with_any](ca://s?q=Explain_with_any) pipeline.
|
|
64
|
+
|
|
65
|
+
## Architectural role
|
|
66
|
+
This function is used by:
|
|
67
|
+
|
|
68
|
+
- [with_any](ca://s?q=Explain_with_any) — mixed update pipeline
|
|
69
|
+
- indirectly by composite recalculation logic
|
|
70
|
+
- debugging and structural validation tools
|
|
71
|
+
|
|
72
|
+
It provides the structural classification needed to apply composite updates
|
|
73
|
+
in the correct hierarchical order.
|
|
74
|
+
|
|
75
|
+
## How it works
|
|
76
|
+
The function performs four deterministic phases:
|
|
77
|
+
|
|
78
|
+
### 1. Prepare containers
|
|
79
|
+
Creates dictionaries for:
|
|
80
|
+
- **top_composite** — root-level composites
|
|
81
|
+
- **child_composite** — nested composites
|
|
82
|
+
And a list `top_composite_paths` for prefix comparison.
|
|
83
|
+
|
|
84
|
+
### 2. Sort composite paths by length
|
|
85
|
+
Shorter paths represent higher-level composites.
|
|
86
|
+
Sorting ensures that parent paths are processed before child paths.
|
|
87
|
+
|
|
88
|
+
### 3. Classify composites
|
|
89
|
+
For each `(name, path)` pair:
|
|
90
|
+
|
|
91
|
+
- If the path is **not** a prefix of any already stored root path →
|
|
92
|
+
it is a **root composite**.
|
|
93
|
+
|
|
94
|
+
- If the path **is** a prefix match →
|
|
95
|
+
it is a **child composite**.
|
|
96
|
+
|
|
97
|
+
This classification is purely structural and deterministic.
|
|
98
|
+
|
|
99
|
+
### 4. Return both dictionaries
|
|
100
|
+
The caller receives:
|
|
101
|
+
- root composites → to be applied first
|
|
102
|
+
- child composites → validated after root updates
|
|
103
|
+
|
|
104
|
+
## Why root composites matter
|
|
105
|
+
Composite updates must be applied **from the top down**:
|
|
106
|
+
|
|
107
|
+
- Root composites define the highest-level structural changes
|
|
108
|
+
- Child composites must be validated **after** root updates
|
|
109
|
+
- This prevents inconsistent or impossible composite states
|
|
110
|
+
|
|
111
|
+
Correct ordering ensures:
|
|
112
|
+
|
|
113
|
+
- deterministic immutability behavior
|
|
114
|
+
- minimal recomputation
|
|
115
|
+
- structural correctness
|
|
116
|
+
|
|
117
|
+
## Deterministic behavior
|
|
118
|
+
The classification is deterministic because:
|
|
119
|
+
|
|
120
|
+
- sorting is stable
|
|
121
|
+
- prefix comparison is structural
|
|
122
|
+
- metadata paths are canonical
|
|
123
|
+
- output ordering matches structural hierarchy
|
|
124
|
+
|
|
125
|
+
This determinism is essential for immutability pipelines.
|
|
126
|
+
|
|
127
|
+
## Stability guarantee
|
|
128
|
+
Any change to this function would affect:
|
|
129
|
+
|
|
130
|
+
- composite update order
|
|
131
|
+
- immutability correctness
|
|
132
|
+
- validation logic in `with_any`
|
|
133
|
+
- debugging behavior
|
|
134
|
+
|
|
135
|
+
Therefore, `get_top_composite_paths` is treated as a **core invariant** of the
|
|
136
|
+
immutability subsystem.
|
|
137
|
+
|
|
138
|
+
## Notes
|
|
139
|
+
- This function is intentionally minimal and side-effect-free.
|
|
140
|
+
- It is not part of the public API; it is used internally by mixins.
|
|
141
|
+
- All structural logic is delegated to path metadata (`nodes_path_dict`).
|
|
142
|
+
"""
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ...with_constant import with_constant
|
|
4
|
+
from ...with_composite import with_composite
|
|
5
|
+
from ...with_constants.vaidations import (
|
|
6
|
+
validate_inner_tuple_is_tuple,
|
|
7
|
+
validate_inner_tuple_has_length_two,
|
|
8
|
+
validate_inner_tuple_name_is_str
|
|
9
|
+
)
|
|
10
|
+
# Inners
|
|
11
|
+
from .validations import raise_with_any_unknown_name
|
|
12
|
+
# Annotations
|
|
13
|
+
if TYPE_CHECKING:
|
|
14
|
+
from ......_core.protocols.mixins.core_mixins import (
|
|
15
|
+
InfrastructureProtocol,
|
|
16
|
+
InfrastructuredComponent,
|
|
17
|
+
)
|
|
18
|
+
from ......_core.protocols.alias_typings import ChangeTuple
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def process_single_change(
|
|
22
|
+
self: "InfrastructureProtocol",
|
|
23
|
+
change: "ChangeTuple",
|
|
24
|
+
) -> "InfrastructuredComponent":
|
|
25
|
+
"""
|
|
26
|
+
Processes a single (name, value) change.
|
|
27
|
+
Returns a new instance with the applied update.
|
|
28
|
+
|
|
29
|
+
Integration requirement:
|
|
30
|
+
The provided instance MUST inherit from:
|
|
31
|
+
1. Snapshot (provides _restore_snapshot)
|
|
32
|
+
2. NodesDicts (provides metadata and node access)
|
|
33
|
+
Otherwise, the pipeline will raise AttributeError.
|
|
34
|
+
"""
|
|
35
|
+
|
|
36
|
+
# 1. Validate tuple structure
|
|
37
|
+
if (
|
|
38
|
+
not isinstance(change, tuple)
|
|
39
|
+
or len(change) != 2
|
|
40
|
+
or not isinstance(change[0], str)
|
|
41
|
+
):
|
|
42
|
+
validate_inner_tuple_is_tuple(self, change)
|
|
43
|
+
validate_inner_tuple_has_length_two(self, change)
|
|
44
|
+
validate_inner_tuple_name_is_str(self, change)
|
|
45
|
+
|
|
46
|
+
name, value = change
|
|
47
|
+
|
|
48
|
+
# 2. Constant update
|
|
49
|
+
if name in self._constant_names_set:
|
|
50
|
+
return with_constant(self, name, value)
|
|
51
|
+
|
|
52
|
+
# 3. Composite update
|
|
53
|
+
if name in self.meta.node_names_set:
|
|
54
|
+
return with_composite(self, name, value)
|
|
55
|
+
|
|
56
|
+
# 4. Unknown name
|
|
57
|
+
raise_with_any_unknown_name(self, name, value)
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
_DESIGN_NOTES = """
|
|
61
|
+
# process_single_change
|
|
62
|
+
|
|
63
|
+
## Purpose
|
|
64
|
+
Handles a single `(name, value)` update in the immutability pipeline.
|
|
65
|
+
This function is the smallest routing unit of the `with_any` mechanism and
|
|
66
|
+
decides whether the update should be processed as a constant or composite
|
|
67
|
+
change.
|
|
68
|
+
|
|
69
|
+
It ensures that even the simplest update follows the full immutability rules.
|
|
70
|
+
|
|
71
|
+
## Architectural role
|
|
72
|
+
This function is used exclusively by:
|
|
73
|
+
|
|
74
|
+
- [with_any](ca://s?q=Explain_with_any) — mixed update pipeline
|
|
75
|
+
|
|
76
|
+
It provides the minimal dispatch logic for single-value updates.
|
|
77
|
+
|
|
78
|
+
## How it works
|
|
79
|
+
The function performs four deterministic steps:
|
|
80
|
+
|
|
81
|
+
### 1. Validate tuple structure
|
|
82
|
+
Ensures the input is a `(name, value)` pair with a string name.
|
|
83
|
+
This prevents malformed updates from entering the immutability pipeline.
|
|
84
|
+
|
|
85
|
+
### 2. Route constant updates
|
|
86
|
+
If the name refers to a constant, the function delegates to
|
|
87
|
+
[with_constant](ca://s?q=Explain_with_constant).
|
|
88
|
+
|
|
89
|
+
### 3. Route composite updates
|
|
90
|
+
If the name refers to a composite node, the function delegates to
|
|
91
|
+
[with_composite](ca://s?q=Explain_with_composite).
|
|
92
|
+
|
|
93
|
+
### 4. Reject unknown names
|
|
94
|
+
If the name is neither a constant nor a composite, the update is invalid.
|
|
95
|
+
|
|
96
|
+
## Why this function exists
|
|
97
|
+
`with_any` must support both:
|
|
98
|
+
|
|
99
|
+
- single-value updates,
|
|
100
|
+
- multi-value updates.
|
|
101
|
+
|
|
102
|
+
Instead of duplicating logic, `process_single_change` provides a clean,
|
|
103
|
+
minimal, and deterministic dispatch mechanism.
|
|
104
|
+
|
|
105
|
+
This separation improves:
|
|
106
|
+
|
|
107
|
+
- readability,
|
|
108
|
+
- maintainability,
|
|
109
|
+
- testability,
|
|
110
|
+
- correctness.
|
|
111
|
+
|
|
112
|
+
## Deterministic behavior
|
|
113
|
+
The update is deterministic because:
|
|
114
|
+
|
|
115
|
+
- routing is based on canonical metadata (`_constant_names_set`, `node_names_set`),
|
|
116
|
+
- delegated functions (`with_constant`, `with_composite`) are pure and stable,
|
|
117
|
+
- validation prevents malformed updates.
|
|
118
|
+
|
|
119
|
+
## Integration requirements
|
|
120
|
+
The function assumes the instance implements:
|
|
121
|
+
|
|
122
|
+
- [Snapshot](ca://s?q=Explain_Snapshot_mixin) — provides `_restore_snapshot`
|
|
123
|
+
- [NodesDicts](ca://s?q=Explain_NodesDicts_mixin) — provides node metadata
|
|
124
|
+
|
|
125
|
+
Without these mixins, the pipeline cannot reconstruct the instance.
|
|
126
|
+
|
|
127
|
+
## Stability guarantee
|
|
128
|
+
Any change to this function would affect:
|
|
129
|
+
|
|
130
|
+
- routing logic in `with_any`,
|
|
131
|
+
- immutability correctness,
|
|
132
|
+
- debugging behavior,
|
|
133
|
+
- serialization consistency.
|
|
134
|
+
|
|
135
|
+
Therefore, `process_single_change` is treated as a **core invariant** of the
|
|
136
|
+
immutability subsystem.
|
|
137
|
+
|
|
138
|
+
## Notes
|
|
139
|
+
- This function is intentionally minimal and side-effect-free.
|
|
140
|
+
- It is not part of the public API; it is used internally by mixins.
|
|
141
|
+
- All structural logic is delegated to metadata and helper functions.
|
|
142
|
+
|
|
143
|
+
"""
|