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,120 @@
|
|
|
1
|
+
# Base Class
|
|
2
|
+
from .base_class import (
|
|
3
|
+
SimpleMixinProtocol,
|
|
4
|
+
SimpleMixinLike
|
|
5
|
+
|
|
6
|
+
)
|
|
7
|
+
# Core Mixins
|
|
8
|
+
from .core_mixins import (
|
|
9
|
+
InfrastructureProtocol,
|
|
10
|
+
NodesDictsProtocol,
|
|
11
|
+
NodesTupleProtocol,
|
|
12
|
+
SerializationProtocol,
|
|
13
|
+
SnapshotProtocol,
|
|
14
|
+
)
|
|
15
|
+
# Dunders Sub-Package
|
|
16
|
+
from . import dunders
|
|
17
|
+
# Immutable
|
|
18
|
+
from .immutable import (
|
|
19
|
+
ImmutableMethodsProtocol,
|
|
20
|
+
ImmutableMethodsWithInnersProtocol,
|
|
21
|
+
)
|
|
22
|
+
# Numerical & Stepper
|
|
23
|
+
from .numerical import (
|
|
24
|
+
EqualizerProtocol,
|
|
25
|
+
VolumeProtocol,
|
|
26
|
+
)
|
|
27
|
+
from .numerical.internal_types import (
|
|
28
|
+
SteppersMap,
|
|
29
|
+
)
|
|
30
|
+
from .numerical.stepper import (
|
|
31
|
+
StepperProtocol,
|
|
32
|
+
)
|
|
33
|
+
from .numerical.stepper.internal_types import (
|
|
34
|
+
LimitAction,
|
|
35
|
+
StepValue,
|
|
36
|
+
)
|
|
37
|
+
# Properties
|
|
38
|
+
from .properties import (
|
|
39
|
+
InnersPropertyProtocol,
|
|
40
|
+
MetaShortcutsProtocol,
|
|
41
|
+
)
|
|
42
|
+
# State
|
|
43
|
+
from .state import (
|
|
44
|
+
DefaultStateProtocol,
|
|
45
|
+
DirtyTrackingProtocol,
|
|
46
|
+
HistoryProtocol,
|
|
47
|
+
PermissionProtocol,
|
|
48
|
+
)
|
|
49
|
+
|
|
50
|
+
__all__ = [
|
|
51
|
+
# Base Class
|
|
52
|
+
"SimpleMixinProtocol",
|
|
53
|
+
"SimpleMixinLike",
|
|
54
|
+
|
|
55
|
+
# Core Mixins
|
|
56
|
+
"InfrastructureProtocol",
|
|
57
|
+
"NodesDictsProtocol",
|
|
58
|
+
"NodesTupleProtocol",
|
|
59
|
+
"SerializationProtocol",
|
|
60
|
+
"SnapshotProtocol",
|
|
61
|
+
|
|
62
|
+
# Dunders Sub-Package Re-export Module
|
|
63
|
+
"dunders",
|
|
64
|
+
|
|
65
|
+
# Immutable
|
|
66
|
+
"ImmutableMethodsProtocol",
|
|
67
|
+
"ImmutableMethodsWithInnersProtocol",
|
|
68
|
+
|
|
69
|
+
# Numerical
|
|
70
|
+
"EqualizerProtocol",
|
|
71
|
+
"VolumeProtocol",
|
|
72
|
+
"StepperProtocol",
|
|
73
|
+
"SteppersMap",
|
|
74
|
+
"LimitAction",
|
|
75
|
+
"StepValue",
|
|
76
|
+
|
|
77
|
+
# Properties
|
|
78
|
+
"InnersPropertyProtocol",
|
|
79
|
+
"MetaShortcutsProtocol",
|
|
80
|
+
|
|
81
|
+
# State
|
|
82
|
+
"DefaultStateProtocol",
|
|
83
|
+
"DirtyTrackingProtocol",
|
|
84
|
+
"HistoryProtocol",
|
|
85
|
+
"PermissionProtocol",
|
|
86
|
+
]
|
|
87
|
+
|
|
88
|
+
_DESIGN_NOTES = """
|
|
89
|
+
# Mixin Protocols Main Package
|
|
90
|
+
|
|
91
|
+
## Purpose
|
|
92
|
+
Aggregates all architectural mixin protocols across the system, guaranteeing clear structural contracts
|
|
93
|
+
for runtime behavior, core state operations, numerical manipulation, immutability, and state tracking.
|
|
94
|
+
|
|
95
|
+
## Internal Components Registry
|
|
96
|
+
|
|
97
|
+
| Component | Type | Category | Description |
|
|
98
|
+
| :------------------------------------ | :-------- | :----------- | :--------------------------------------------------------------------------- |
|
|
99
|
+
| `SimpleMixinProtocol` | Protocol | Base Class | Foundational protocol for all mixin classes ensuring base initialization. |
|
|
100
|
+
| `InfrastructureProtocol` | Protocol | Core Mixins | Internal low-level utility and lifecycle mixin interface. |
|
|
101
|
+
| `NodesDictsProtocol` | Protocol | Core Mixins | Interface for managing named child nodes via dictionary representations. |
|
|
102
|
+
| `NodesTupleProtocol` | Protocol | Core Mixins | Interface for accessing ordered composite child node tuples. |
|
|
103
|
+
| `SerializationProtocol` | Protocol | Core Mixins | Pure serialization contract for exporting and importing instance data. |
|
|
104
|
+
| `SnapshotProtocol` | Protocol | Core Mixins | Interface for creating and restoring full state snapshots. |
|
|
105
|
+
| `dunders` | Module | Sub-Package | Sub-package namespace re-exporting all Python magic method protocols. |
|
|
106
|
+
| `ImmutableMethodsProtocol` | Protocol | Immutable | Functional interface for state transformations returning new instances. |
|
|
107
|
+
| `ImmutableMethodsWithInnersProtocol` | Protocol | Immutable | Dynamic inner attribute fallback interface for setter generation. |
|
|
108
|
+
| `EqualizerProtocol` | Protocol | Numerical | Multi-node numerical controller mapping interface. |
|
|
109
|
+
| `VolumeProtocol` | Protocol | Numerical | Single primary value stepper controller interface. |
|
|
110
|
+
| `StepperProtocol` | Protocol | Numerical | Encapsulated numeric stepping controller with bound verification. |
|
|
111
|
+
| `SteppersMap` | TypeAlias | Numerical | Dictionary mapping of snake_case names to respective Steppers. |
|
|
112
|
+
| `LimitAction` | TypeAlias | Numerical | Callback/action type invoked when hitting numerical boundaries. |
|
|
113
|
+
| `StepValue` | TypeAlias | Numerical | Shift delta value or Ellipsis (`...`) default indicator. |
|
|
114
|
+
| `InnersPropertyProtocol` | Protocol | Properties | Interface exposing direct access to inner elements and structure. |
|
|
115
|
+
| `MetaShortcutsProtocol` | Protocol | Properties | Fast access shortcuts for metadata, system attributes, and tags. |
|
|
116
|
+
| `DefaultStateProtocol` | Protocol | State | Interface for state resets and initial value defaults restoration. |
|
|
117
|
+
| `DirtyTrackingProtocol` | Protocol | State | Interface for tracking modified fields and dirty flags across instances. |
|
|
118
|
+
| `HistoryProtocol` | Protocol | State | Contract for undo/redo state stack traversal. |
|
|
119
|
+
| `PermissionProtocol` | Protocol | State | Access control contract for reading and writing instance values. |
|
|
120
|
+
"""
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ...instance import SimpleInstanceLike
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ...alias_typings import ValidTypes
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
@runtime_checkable
|
|
10
|
+
class SimpleMixinProtocol(
|
|
11
|
+
SimpleInstanceLike,
|
|
12
|
+
Protocol
|
|
13
|
+
):
|
|
14
|
+
"""
|
|
15
|
+
Protocol representing the foundational interface for all mixins in the Simple system.
|
|
16
|
+
|
|
17
|
+
Declares the presence of the initialization hook and configuration flags
|
|
18
|
+
that control which instance types a mixin can be applied to within the factory.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
# --- DECLARATIVE MIXIN CONSTRAINTS (Class-level configuration) ---
|
|
22
|
+
_constant_only: bool
|
|
23
|
+
_composite_only: bool
|
|
24
|
+
_mutable_only: bool
|
|
25
|
+
_immutable_only: bool
|
|
26
|
+
_only_types: "ValidTypes"
|
|
27
|
+
|
|
28
|
+
# --- INITIALIZATION LOGIC ---
|
|
29
|
+
def init_mixins(self) -> None:
|
|
30
|
+
"""
|
|
31
|
+
Anchor for reactive mixin initialization.
|
|
32
|
+
|
|
33
|
+
Implementations are expected to call super().init_mixins() to pass
|
|
34
|
+
control to the next mixin or base class along the MRO chain.
|
|
35
|
+
"""
|
|
36
|
+
...
|
|
37
|
+
|
|
38
|
+
@staticmethod
|
|
39
|
+
def __extend_instance_class__(instance_cls: "SimpleInstanceLike") -> "SimpleInstanceLike":
|
|
40
|
+
"""
|
|
41
|
+
Optional hook enabling a mixin to modify the instance class
|
|
42
|
+
prior to runtime instance creation (e.g., attaching dynamic properties).
|
|
43
|
+
"""
|
|
44
|
+
...
|
|
45
|
+
|
|
46
|
+
__name__: str
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
from .SimpleMixinProtocol import SimpleMixinProtocol
|
|
2
|
+
|
|
3
|
+
# Element defining the largest set (superset for annotations)
|
|
4
|
+
SimpleMixinLike = SimpleMixinProtocol
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
_DESIGN_NOTES = """
|
|
8
|
+
# Mixin Base Class Protocols Sub-Package
|
|
9
|
+
|
|
10
|
+
## Purpose
|
|
11
|
+
Provides the foundational base protocol for all mixin classes across the framework.
|
|
12
|
+
|
|
13
|
+
## Internal Components Registry
|
|
14
|
+
|
|
15
|
+
| Component | Type | Description |
|
|
16
|
+
| :------------------- | :------- | :--------------------------------------------------------------------------- |
|
|
17
|
+
| `SimpleMixinProtocol`| Protocol | Base anchor protocol guaranteeing identity and mixin initialization hooks. |
|
|
18
|
+
"""
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable
|
|
2
|
+
# Inners
|
|
3
|
+
from .NodesDictsProtocol import NodesDictsProtocol
|
|
4
|
+
from .SnapshotProtocol import SnapshotProtocol
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
@runtime_checkable
|
|
8
|
+
class InfrastructureProtocol(
|
|
9
|
+
NodesDictsProtocol,
|
|
10
|
+
SnapshotProtocol,
|
|
11
|
+
Protocol
|
|
12
|
+
):
|
|
13
|
+
"""
|
|
14
|
+
Protocol for shared infrastructure components (nodes and snapshots) required
|
|
15
|
+
for immutability logic, serialization, and reactive execution.
|
|
16
|
+
"""
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, TYPE_CHECKING
|
|
2
|
+
# Inners
|
|
3
|
+
from .NodesTupleProtocol import NodesTupleProtocol
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ...alias_typings import (
|
|
7
|
+
NodesDict,
|
|
8
|
+
NodesInstanceDict,
|
|
9
|
+
NodesPathDict,
|
|
10
|
+
NodesIndexMap
|
|
11
|
+
)
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
@runtime_checkable
|
|
15
|
+
class NodesDictsProtocol(
|
|
16
|
+
NodesTupleProtocol,
|
|
17
|
+
Protocol
|
|
18
|
+
):
|
|
19
|
+
"""
|
|
20
|
+
Protocol for the NodesDicts mixin.
|
|
21
|
+
|
|
22
|
+
Extends NodesTuple with fast, immutable lookup dictionaries (O(1) lookup)
|
|
23
|
+
mapping sub-node elements by their semantic snake-case names (name_snake).
|
|
24
|
+
"""
|
|
25
|
+
|
|
26
|
+
# --- TECHNICAL ATTRIBUTES (Initialized in init_mixins) ---
|
|
27
|
+
|
|
28
|
+
# Maps name_snake to a tuple of (live_instance, relative_path)
|
|
29
|
+
_nodes_dict: "NodesDict"
|
|
30
|
+
|
|
31
|
+
# Maps name_snake strictly to the live instance of the sub-node element
|
|
32
|
+
_nodes_instance_dict: "NodesInstanceDict"
|
|
33
|
+
|
|
34
|
+
# Maps name_snake strictly to the relative path to the element
|
|
35
|
+
_nodes_path_dict: "NodesPathDict"
|
|
36
|
+
|
|
37
|
+
# Maps name_snake to the integer index position inside the original _nodes_tuple
|
|
38
|
+
_nodes_index_map: "NodesIndexMap"
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, TYPE_CHECKING, TypeAlias
|
|
2
|
+
# Outers
|
|
3
|
+
from ..base_class import SimpleMixinProtocol
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ...alias_typings import NodesTuple, NamesTuple
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
@runtime_checkable
|
|
10
|
+
class NodesTupleProtocol(
|
|
11
|
+
SimpleMixinProtocol,
|
|
12
|
+
Protocol
|
|
13
|
+
):
|
|
14
|
+
"""
|
|
15
|
+
Protocol for the NodesTuple mixin.
|
|
16
|
+
|
|
17
|
+
Guarantees the presence of tuples containing flattened sub-node instances,
|
|
18
|
+
serving as the primary source of truth for serialization and history management.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
# --- TECHNICAL ATTRIBUTES (Initialized in init_mixins) ---
|
|
22
|
+
|
|
23
|
+
# Contains a tuple of pairs: (live_element_instance, relative_path)
|
|
24
|
+
_nodes_tuple: "NodesTuple"
|
|
25
|
+
|
|
26
|
+
# Contains a tuple of clean snake_case names for all sub-node elements
|
|
27
|
+
_node_names_tuple: "NamesTuple"
|
|
28
|
+
|
|
29
|
+
# Set of snake_case names for all internal constant (atomic) elements
|
|
30
|
+
_constant_names_set: set[str]
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any, Self, TYPE_CHECKING
|
|
2
|
+
# Inners
|
|
3
|
+
from .InfrastructureProtocol import InfrastructureProtocol
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ...alias_typings import StateDict
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
@runtime_checkable
|
|
10
|
+
class SerializationProtocol(
|
|
11
|
+
InfrastructureProtocol,
|
|
12
|
+
Protocol
|
|
13
|
+
):
|
|
14
|
+
"""
|
|
15
|
+
Protocol for the universal master mixin Serialization.
|
|
16
|
+
|
|
17
|
+
Guarantees a complete set of methods for export (to_dict, to_json) and
|
|
18
|
+
import/update (from_dict, from_json, update_constants, update) of object data.
|
|
19
|
+
Safely covers both in-place mutations and immutable transformations.
|
|
20
|
+
"""
|
|
21
|
+
|
|
22
|
+
# ----------------------------------------
|
|
23
|
+
# 1) EXPORT (Export API)
|
|
24
|
+
# ----------------------------------------
|
|
25
|
+
def to_dict(self, *, constant_only: bool = False) -> "StateDict":
|
|
26
|
+
"""Serializes the instance into a human-readable flat dictionary."""
|
|
27
|
+
...
|
|
28
|
+
|
|
29
|
+
def to_json(self, **kwargs: Any) -> str:
|
|
30
|
+
"""Serializes the instance into a JSON formatted string."""
|
|
31
|
+
...
|
|
32
|
+
|
|
33
|
+
# ----------------------------------------
|
|
34
|
+
# 2) IMPORT / UPDATE (Import API supporting Fluent API)
|
|
35
|
+
# ----------------------------------------
|
|
36
|
+
def from_dict(self, user_dict: "StateDict") -> Self:
|
|
37
|
+
"""
|
|
38
|
+
Reconstructs the instance state from the provided dictionary.
|
|
39
|
+
Returns the instance (Self) to enable method chaining.
|
|
40
|
+
"""
|
|
41
|
+
...
|
|
42
|
+
|
|
43
|
+
def from_json(self, json_str: str) -> Self:
|
|
44
|
+
"""
|
|
45
|
+
Reconstructs the instance state from a JSON string.
|
|
46
|
+
Returns the instance (Self) to enable method chaining.
|
|
47
|
+
"""
|
|
48
|
+
...
|
|
49
|
+
|
|
50
|
+
def update_constants(self, user_dict: "StateDict") -> Self:
|
|
51
|
+
"""
|
|
52
|
+
Updates constants (atoms) from the provided partial or full dictionary.
|
|
53
|
+
Returns the instance (Self) to enable method chaining.
|
|
54
|
+
"""
|
|
55
|
+
...
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, TYPE_CHECKING
|
|
2
|
+
# Inners
|
|
3
|
+
from .NodesTupleProtocol import NodesTupleProtocol
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ...alias_typings import SnapshotTuple, SnapshotDiffTuple
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
@runtime_checkable
|
|
10
|
+
class SnapshotProtocol(
|
|
11
|
+
NodesTupleProtocol,
|
|
12
|
+
Protocol
|
|
13
|
+
):
|
|
14
|
+
"""
|
|
15
|
+
Protocol for the Snapshot mixin.
|
|
16
|
+
|
|
17
|
+
Defines the interface for creating, restoring, and comparing complete
|
|
18
|
+
state snapshots across the entire element hierarchy.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
# The mixin has no custom slots/attributes; we only define methods.
|
|
22
|
+
|
|
23
|
+
def _build_snapshot(self) -> "SnapshotTuple":
|
|
24
|
+
"""Creates and returns a snapshot as a pure tuple of values for all sub-node elements."""
|
|
25
|
+
...
|
|
26
|
+
|
|
27
|
+
def _restore_snapshot(self, snapshot: "SnapshotTuple") -> None:
|
|
28
|
+
"""Restores the internal state of all sub-node elements from the provided snapshot."""
|
|
29
|
+
...
|
|
30
|
+
|
|
31
|
+
def _compare_snapshots(
|
|
32
|
+
self,
|
|
33
|
+
snapshot1: "SnapshotTuple",
|
|
34
|
+
snapshot2: "SnapshotTuple",
|
|
35
|
+
*,
|
|
36
|
+
constants_only: bool = False
|
|
37
|
+
) -> "SnapshotDiffTuple":
|
|
38
|
+
"""
|
|
39
|
+
Compares two snapshots and returns the diff analysis result.
|
|
40
|
+
Allows filtering to include only constant (atomic) elements.
|
|
41
|
+
"""
|
|
42
|
+
...
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
from .NodesDictsProtocol import NodesDictsProtocol
|
|
2
|
+
from .NodesTupleProtocol import NodesTupleProtocol
|
|
3
|
+
from .SnapshotProtocol import SnapshotProtocol
|
|
4
|
+
from .SerializationProtocol import SerializationProtocol
|
|
5
|
+
from .InfrastructureProtocol import InfrastructureProtocol
|
|
6
|
+
|
|
7
|
+
from typing import TypeVar
|
|
8
|
+
InfrastructuredComponent = TypeVar("InfrastructuredComponent", bound="InfrastructureProtocol")
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
_DESIGN_NOTES = """
|
|
12
|
+
# Core Mixin Protocols Sub-Package
|
|
13
|
+
|
|
14
|
+
## Purpose
|
|
15
|
+
Provides foundational protocols for internal object graph navigation, fast lookup mappings,
|
|
16
|
+
state snapshotting, core infrastructure, and full serialization support.
|
|
17
|
+
|
|
18
|
+
## Internal Components Registry
|
|
19
|
+
|
|
20
|
+
| Component | Type | Description |
|
|
21
|
+
| :----------------------- | :------- | :--------------------------------------------------------------------------- |
|
|
22
|
+
| `NodesTupleProtocol` | Protocol | Primary source of truth for sub-node flattened tuple structures. |
|
|
23
|
+
| `NodesDictsProtocol` | Protocol | Immutable O(1) lookup dictionary mappings by sub-node semantic names. |
|
|
24
|
+
| `SnapshotProtocol` | Protocol | Interface for state creation, restoration, and diff comparison. |
|
|
25
|
+
| `InfrastructureProtocol` | Protocol | Shared infrastructure backbone uniting node graphs and snapshots. |
|
|
26
|
+
| `SerializationProtocol` | Protocol | Master import/export interface supporting JSON, dicts, and fluent updates. |
|
|
27
|
+
"""
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# Collections
|
|
2
|
+
from .collections import (
|
|
3
|
+
CollectionBaseProtocol,
|
|
4
|
+
CollectionProtocol,
|
|
5
|
+
IterableProtocol,
|
|
6
|
+
MappingProtocol,
|
|
7
|
+
)
|
|
8
|
+
# Comparison
|
|
9
|
+
from .comparison import (
|
|
10
|
+
EqualityProtocol,
|
|
11
|
+
OrderingProtocol,
|
|
12
|
+
)
|
|
13
|
+
# Generics
|
|
14
|
+
from .generics import (
|
|
15
|
+
ClassGetItemProtocol,
|
|
16
|
+
)
|
|
17
|
+
# Interfaces
|
|
18
|
+
from .interfaces import (
|
|
19
|
+
CallProtocol,
|
|
20
|
+
ContextProtocol,
|
|
21
|
+
)
|
|
22
|
+
# Lifecycles
|
|
23
|
+
from .lifecycles import (
|
|
24
|
+
CopyableProtocol,
|
|
25
|
+
LifecycleProtocol,
|
|
26
|
+
PickleReduceProtocol,
|
|
27
|
+
PickleStateProtocol,
|
|
28
|
+
)
|
|
29
|
+
from .lifecycles.internal_types import (
|
|
30
|
+
PicklePlan,
|
|
31
|
+
)
|
|
32
|
+
# Numeric
|
|
33
|
+
from .numeric import (
|
|
34
|
+
ArithmeticProtocol,
|
|
35
|
+
BitwiseProtocol,
|
|
36
|
+
ConversionProtocol,
|
|
37
|
+
InplaceProtocol,
|
|
38
|
+
UnaryProtocol,
|
|
39
|
+
)
|
|
40
|
+
from .numeric.internal_types import (
|
|
41
|
+
Operator,
|
|
42
|
+
UnaryOperator,
|
|
43
|
+
)
|
|
44
|
+
# Representation
|
|
45
|
+
from .representation import (
|
|
46
|
+
ValueDisplayProtocol,
|
|
47
|
+
ValueFormattingProtocol,
|
|
48
|
+
)
|
|
49
|
+
|
|
50
|
+
__all__ = [
|
|
51
|
+
# Collections
|
|
52
|
+
"CollectionBaseProtocol",
|
|
53
|
+
"CollectionProtocol",
|
|
54
|
+
"IterableProtocol",
|
|
55
|
+
"MappingProtocol",
|
|
56
|
+
|
|
57
|
+
# Comparison
|
|
58
|
+
"EqualityProtocol",
|
|
59
|
+
"OrderingProtocol",
|
|
60
|
+
|
|
61
|
+
# Generics
|
|
62
|
+
"ClassGetItemProtocol",
|
|
63
|
+
|
|
64
|
+
# Interfaces
|
|
65
|
+
"CallProtocol",
|
|
66
|
+
"ContextProtocol",
|
|
67
|
+
|
|
68
|
+
# Lifecycles
|
|
69
|
+
"CopyableProtocol",
|
|
70
|
+
"LifecycleProtocol",
|
|
71
|
+
"PickleReduceProtocol",
|
|
72
|
+
"PickleStateProtocol",
|
|
73
|
+
"PicklePlan",
|
|
74
|
+
|
|
75
|
+
# Numeric
|
|
76
|
+
"ArithmeticProtocol",
|
|
77
|
+
"BitwiseProtocol",
|
|
78
|
+
"ConversionProtocol",
|
|
79
|
+
"InplaceProtocol",
|
|
80
|
+
"UnaryProtocol",
|
|
81
|
+
"Operator",
|
|
82
|
+
"UnaryOperator",
|
|
83
|
+
|
|
84
|
+
# Representation
|
|
85
|
+
"ValueDisplayProtocol",
|
|
86
|
+
"ValueFormattingProtocol",
|
|
87
|
+
]
|
|
88
|
+
|
|
89
|
+
_DESIGN_NOTES = """
|
|
90
|
+
# Dunders Mixin Protocols Main Package
|
|
91
|
+
|
|
92
|
+
## Purpose
|
|
93
|
+
Aggregates all low-level Python magic method (dunder) protocols into a single entry-point package.
|
|
94
|
+
Covers collections, comparisons, generic indexing, function invocation/context management, object lifecycles/serialization, numeric operators, and string representations.
|
|
95
|
+
|
|
96
|
+
## Internal Components Registry
|
|
97
|
+
|
|
98
|
+
| Component | Type | Category | Description |
|
|
99
|
+
| :------------------------------------ | :-------- | :------------- | :--------------------------------------------------------------------------- |
|
|
100
|
+
| `CollectionBaseProtocol` | Protocol | Collections | Structural anchor for collection mixins with size and containment support. |
|
|
101
|
+
| `CollectionProtocol` | Protocol | Collections | Complete container interface combining sizing, containment, and iteration. |
|
|
102
|
+
| `IterableProtocol` | Protocol | Collections | Interface guaranteeing element iteration capability via `__iter__`. |
|
|
103
|
+
| `MappingProtocol` | Protocol | Collections | Key-value mapping interface with item retrieval, assignment, and deletion. |
|
|
104
|
+
| `EqualityProtocol` | Protocol | Comparison | Interface for equality (`__eq__`, `__ne__`) and hashing (`__hash__`). |
|
|
105
|
+
| `OrderingProtocol` | Protocol | Comparison | Interface for rich comparison operators (`<`, `<=`, `>`, `>=`). |
|
|
106
|
+
| `ClassGetItemProtocol` | Protocol | Generics | Interface guaranteeing class-level generic subscripting via `__class_getitem__`.|
|
|
107
|
+
| `CallProtocol` | Protocol | Interfaces | Interface enabling instance invocation as a function for state updates. |
|
|
108
|
+
| `ContextProtocol` | Protocol | Interfaces | Interface for context manager protocol (`__enter__` and `__exit__`). |
|
|
109
|
+
| `CopyableProtocol` | Protocol | Lifecycles | Interface for shallow (`__copy__`) and deep (`__deepcopy__`) copying. |
|
|
110
|
+
| `LifecycleProtocol` | Protocol | Lifecycles | Master structural aggregator combining copying and pickle protocols. |
|
|
111
|
+
| `PickleReduceProtocol` | Protocol | Lifecycles | Low-level pickle protocol interface via factory reconstruction (`__reduce__`).|
|
|
112
|
+
| `PickleStateProtocol` | Protocol | Lifecycles | State persistence interface using `__getstate__` and `__setstate__`. |
|
|
113
|
+
| `PicklePlan` | TypeAlias | Lifecycles | Tuple structure defining class, empty arguments, and state dictionary for pickle.|
|
|
114
|
+
| `ArithmeticProtocol` | Protocol | Numeric | Standard and right-hand arithmetic operators (`+`, `-`, `*`, `/`, etc.). |
|
|
115
|
+
| `BitwiseProtocol` | Protocol | Numeric | Bitwise logical operators (`&`, `|`, `^`, `<<`, `>>`, `~`). |
|
|
116
|
+
| `ConversionProtocol` | Protocol | Numeric | Native type conversion (`int`, `float`, `complex`) and rounding functions. |
|
|
117
|
+
| `InplaceProtocol` | Protocol | Numeric | In-place arithmetic assignment operators (`+=`, `-=`, `*=`, etc.). |
|
|
118
|
+
| `UnaryProtocol` | Protocol | Numeric | Unary mathematical sign and absolute value operators (`-x`, `+x`, `abs(x)`). |
|
|
119
|
+
| `Operator` | TypeAlias | Numeric | Binary operator function accepting two arguments and returning a result. |
|
|
120
|
+
| `UnaryOperator` | TypeAlias | Numeric | Unary operator function accepting a single argument and returning a result. |
|
|
121
|
+
| `ValueDisplayProtocol` | Protocol | Representation | Interface for string conversion (`__str__`) and developer repr (`__repr__`). |
|
|
122
|
+
| `ValueFormattingProtocol` | Protocol | Representation | Interface for f-string formatting, byte conversion, and boolean evaluation. |
|
|
123
|
+
"""
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, TYPE_CHECKING
|
|
2
|
+
# outers
|
|
3
|
+
from ...base_class import SimpleMixinProtocol
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ...core_mixins.NodesTupleProtocol import NamesTuple
|
|
7
|
+
from ....alias_typings import NamesSet, NamesTuple
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
@runtime_checkable
|
|
11
|
+
class CollectionBaseProtocol(
|
|
12
|
+
SimpleMixinProtocol,
|
|
13
|
+
Protocol
|
|
14
|
+
):
|
|
15
|
+
"""
|
|
16
|
+
Protocol for the CollectionBase mixin.
|
|
17
|
+
|
|
18
|
+
Guarantees the core mapping API for composite instances (O(1) lookups
|
|
19
|
+
and deterministic key ordering based on the blueprint).
|
|
20
|
+
"""
|
|
21
|
+
|
|
22
|
+
# --- TECHNICAL ATTRIBUTES (Initialized in init_mixins) ---
|
|
23
|
+
_inners_name_set: "NamesSet"
|
|
24
|
+
_inners_name_tuple: "NamesTuple"
|
|
25
|
+
|
|
26
|
+
# --- PUBLIC MAPPING API ---
|
|
27
|
+
def keys(self) -> list[str]:
|
|
28
|
+
"""Returns a list of keys (name_snake) for all direct inner elements (inners)."""
|
|
29
|
+
...
|
|
30
|
+
|
|
31
|
+
def values(self) -> list[object]:
|
|
32
|
+
"""Returns a list of values corresponding to individual inner elements (inners)."""
|
|
33
|
+
...
|
|
34
|
+
|
|
35
|
+
def items(self) -> list[tuple[str, object]]:
|
|
36
|
+
"""Returns a list of (key, value) pairs for all inner elements (inners)."""
|
|
37
|
+
...
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable
|
|
2
|
+
# Inners
|
|
3
|
+
from .IterableProtocol import IterableProtocol
|
|
4
|
+
from .MappingProtocol import MappingProtocol
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
@runtime_checkable
|
|
8
|
+
class CollectionProtocol(
|
|
9
|
+
IterableProtocol,
|
|
10
|
+
MappingProtocol,
|
|
11
|
+
Protocol
|
|
12
|
+
):
|
|
13
|
+
"""
|
|
14
|
+
Protocol for the Collection mixin.
|
|
15
|
+
|
|
16
|
+
Encompasses full collection capabilities for composite instances.
|
|
17
|
+
Fully combines mapping (dict-like) API with comprehensive iteration interfaces.
|
|
18
|
+
"""
|
|
19
|
+
|
|
20
|
+
# The mixin itself acts solely as a structural aggregator, declaring no additional slots or methods.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable
|
|
2
|
+
from collections.abc import Iterator
|
|
3
|
+
# Inners
|
|
4
|
+
from .CollectionBaseProtocol import CollectionBaseProtocol
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
@runtime_checkable
|
|
8
|
+
class IterableProtocol(
|
|
9
|
+
CollectionBaseProtocol,
|
|
10
|
+
Protocol
|
|
11
|
+
):
|
|
12
|
+
"""
|
|
13
|
+
Protocol for the CollectionIterable mixin.
|
|
14
|
+
|
|
15
|
+
Guarantees the iteration interface for composite objects, reverse iteration
|
|
16
|
+
support, and extension of system introspection via dir().
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
def __iter__(self) -> Iterator[str]:
|
|
20
|
+
"""
|
|
21
|
+
Returns an iterator over keys (name_snake) of all direct inner elements
|
|
22
|
+
in the order defined by the blueprint.
|
|
23
|
+
"""
|
|
24
|
+
...
|
|
25
|
+
|
|
26
|
+
def __reversed__(self) -> Iterator[str]:
|
|
27
|
+
"""
|
|
28
|
+
Returns an iterator for traversing inner element keys in reverse order.
|
|
29
|
+
"""
|
|
30
|
+
...
|
|
31
|
+
|
|
32
|
+
def __dir__(self) -> list[str]:
|
|
33
|
+
"""
|
|
34
|
+
Returns a sorted list of all object attributes and methods,
|
|
35
|
+
extended with the names of all inner elements (inners).
|
|
36
|
+
"""
|
|
37
|
+
...
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any
|
|
2
|
+
# Inners
|
|
3
|
+
from .CollectionBaseProtocol import CollectionBaseProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class MappingProtocol(
|
|
8
|
+
CollectionBaseProtocol,
|
|
9
|
+
Protocol
|
|
10
|
+
):
|
|
11
|
+
"""
|
|
12
|
+
Protocol for the CollectionMapping mixin.
|
|
13
|
+
|
|
14
|
+
Guarantees the dictionary (Mapping) interface for composite objects,
|
|
15
|
+
including reading, writing, key containment checks, and safe lookups.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
def __len__(self) -> int:
|
|
19
|
+
"""Returns the total count of direct inner elements (inners) in the composite."""
|
|
20
|
+
...
|
|
21
|
+
|
|
22
|
+
def __contains__(self, key: str) -> bool:
|
|
23
|
+
"""Returns True if the composite contains an inner element with the given key (name_snake)."""
|
|
24
|
+
...
|
|
25
|
+
|
|
26
|
+
def __missing__(self, key: str) -> None:
|
|
27
|
+
"""
|
|
28
|
+
Raises a detailed KeyError with context about available keys
|
|
29
|
+
when the requested inner element does not exist in the composite.
|
|
30
|
+
"""
|
|
31
|
+
...
|
|
32
|
+
|
|
33
|
+
def __getitem__(self, key: str) -> Any:
|
|
34
|
+
"""
|
|
35
|
+
Returns the value of an inner element by its key.
|
|
36
|
+
If the key does not exist, delegates handling to __missing__.
|
|
37
|
+
"""
|
|
38
|
+
...
|
|
39
|
+
|
|
40
|
+
def get(self, key: str, default: Any = None) -> Any:
|
|
41
|
+
"""
|
|
42
|
+
Safely returns the value of an inner element by key.
|
|
43
|
+
If the key does not exist, returns the specified default value.
|
|
44
|
+
"""
|
|
45
|
+
...
|
|
46
|
+
|
|
47
|
+
def __setitem__(self, key: str, value: Any) -> None:
|
|
48
|
+
"""
|
|
49
|
+
Sets a new value for the inner element specified by key.
|
|
50
|
+
Raises a TypeError on immutable objects or a KeyError if the key does not exist.
|
|
51
|
+
"""
|
|
52
|
+
...
|