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
simplibs/object/_core/metadata/init_processors/default/validations/validate_default_is_defined.py
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ......exceptions import SimpleDefinitionError
|
|
5
|
+
# Inners
|
|
6
|
+
from ._exception_info_for_default import _exception_info_for_default
|
|
7
|
+
# Annotations
|
|
8
|
+
if TYPE_CHECKING:
|
|
9
|
+
from .....protocols.classes import SimpleClassLike
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def validate_default_is_defined(
|
|
13
|
+
default_value: Any,
|
|
14
|
+
owner_class: "SimpleClassLike"
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Validates that '_default' is explicitly defined for a constant."""
|
|
17
|
+
|
|
18
|
+
if default_value is UNSET:
|
|
19
|
+
(
|
|
20
|
+
class_name,
|
|
21
|
+
class_parent,
|
|
22
|
+
error_name,
|
|
23
|
+
context,
|
|
24
|
+
) = _exception_info_for_default(owner_class)
|
|
25
|
+
|
|
26
|
+
raise SimpleDefinitionError(
|
|
27
|
+
error_name=error_name,
|
|
28
|
+
label="_default",
|
|
29
|
+
value=default_value,
|
|
30
|
+
problem=(
|
|
31
|
+
"The '_default' attribute is missing.",
|
|
32
|
+
),
|
|
33
|
+
expected="A concrete default value.",
|
|
34
|
+
how_to_fix=(
|
|
35
|
+
"Define '_default' inside the class body.",
|
|
36
|
+
"Constants must always declare a default value.",
|
|
37
|
+
"If this class is meant to be a composite, define '_inners' instead.",
|
|
38
|
+
),
|
|
39
|
+
context=context,
|
|
40
|
+
exception=ValueError,
|
|
41
|
+
)
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
_DESIGN_NOTES = """
|
|
46
|
+
# validate_default_is_defined
|
|
47
|
+
|
|
48
|
+
## Purpose
|
|
49
|
+
Ensures that every constant (`SimpleConstant`) declares a `_default` value.
|
|
50
|
+
Constants have no inner structure, so the default value is required to define
|
|
51
|
+
their runtime identity.
|
|
52
|
+
|
|
53
|
+
## Why UNSET is used
|
|
54
|
+
`None` is a valid default value.
|
|
55
|
+
`UNSET` is the only reliable marker for “attribute not provided”.
|
|
56
|
+
|
|
57
|
+
This prevents false positives when a developer intentionally sets:
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
_default = None
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Pipeline position
|
|
64
|
+
This validation is the first step in `process_default_for_constant`.
|
|
65
|
+
If `_default` is missing, no further checks are executed.
|
|
66
|
+
|
|
67
|
+
## Developer experience
|
|
68
|
+
The error message points the developer toward the correct architectural path:
|
|
69
|
+
|
|
70
|
+
- If the class is meant to be a constant → define `_default`.
|
|
71
|
+
- If the class is meant to be a composite → define `_inners` and `_logic`.
|
|
72
|
+
|
|
73
|
+
## Notes
|
|
74
|
+
This validator is used only for constants.
|
|
75
|
+
Compositions use a separate guard that forbids `_default`.
|
|
76
|
+
```
|
|
77
|
+
"""
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_default import _exception_info_for_default
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_default_matches_annotation(
|
|
12
|
+
default_value: Any,
|
|
13
|
+
expected_type: Any,
|
|
14
|
+
owner_class: "SimpleClassLike",
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Validates that '_default' matches the declared '_type'."""
|
|
17
|
+
|
|
18
|
+
if not isinstance(default_value, expected_type):
|
|
19
|
+
(
|
|
20
|
+
class_name,
|
|
21
|
+
class_parent,
|
|
22
|
+
error_name,
|
|
23
|
+
context,
|
|
24
|
+
) = _exception_info_for_default(owner_class)
|
|
25
|
+
|
|
26
|
+
raise SimpleDefinitionError(
|
|
27
|
+
error_name=error_name,
|
|
28
|
+
label="_default",
|
|
29
|
+
value=default_value,
|
|
30
|
+
problem=(
|
|
31
|
+
"The default value does not match the declared type.",
|
|
32
|
+
),
|
|
33
|
+
expected=f"A value of type {expected_type}.",
|
|
34
|
+
how_to_fix=(
|
|
35
|
+
f"Change '_default' to match {expected_type}.",
|
|
36
|
+
"Or update '_type' to include the value's type.",
|
|
37
|
+
"Constants require a type‑compliant default value.",
|
|
38
|
+
),
|
|
39
|
+
context=context,
|
|
40
|
+
exception=TypeError,
|
|
41
|
+
)
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
_DESIGN_NOTES = """
|
|
46
|
+
# validate_default_matches_annotation
|
|
47
|
+
|
|
48
|
+
## Purpose
|
|
49
|
+
Ensures that the `_default` value matches the type declared in `_type`.
|
|
50
|
+
This is the core rule for constant leaf nodes: the default value defines the
|
|
51
|
+
runtime identity of the constant and must be type‑safe.
|
|
52
|
+
|
|
53
|
+
## Why this validation exists
|
|
54
|
+
The type system guarantees that:
|
|
55
|
+
|
|
56
|
+
- `_type` is valid,
|
|
57
|
+
- `_type` is safe for `isinstance`,
|
|
58
|
+
- `_type` is normalized (atomic, UnionType, or tuple → UnionType).
|
|
59
|
+
|
|
60
|
+
Because of this, the validator can rely on a simple `isinstance` check.
|
|
61
|
+
|
|
62
|
+
Examples of invalid definitions:
|
|
63
|
+
|
|
64
|
+
```
|
|
65
|
+
_type = int
|
|
66
|
+
_default = "hello" # invalid
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
_type = int | str
|
|
71
|
+
_default = 3.14 # invalid
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Pipeline position
|
|
75
|
+
This validation runs after:
|
|
76
|
+
|
|
77
|
+
- `_default` is confirmed to exist,
|
|
78
|
+
- `_type` is fully validated and normalized.
|
|
79
|
+
|
|
80
|
+
If the type does not match, initialization stops immediately.
|
|
81
|
+
|
|
82
|
+
## Developer experience
|
|
83
|
+
The error message clearly explains:
|
|
84
|
+
|
|
85
|
+
- what type was expected,
|
|
86
|
+
- what value was provided,
|
|
87
|
+
- how to fix the mismatch.
|
|
88
|
+
|
|
89
|
+
## Notes
|
|
90
|
+
This validator is used only for constants.
|
|
91
|
+
Compositions do not allow `_default` at all.
|
|
92
|
+
```
|
|
93
|
+
"""
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from .process_inners import process_inners
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Inners Processor Core Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Acts as the root entry point for the structural components framework, exporting the central orchestration engine to the metadata lifecycle.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :------------------------------------ | :------- | :----------------------------------------------------------------------------------- |
|
|
14
|
+
| `process_inners` | Function | Runs container checks, iterates through components, and registers collision-free trees.|
|
|
15
|
+
"""
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
# Inners
|
|
3
|
+
from .validations import (
|
|
4
|
+
validate_inners_is_not_empty,
|
|
5
|
+
validate_inners_is_tuple,
|
|
6
|
+
validate_inner_is_simple_subclass,
|
|
7
|
+
validate_inner_is_not_simple_class,
|
|
8
|
+
validate_inner_is_class,
|
|
9
|
+
validate_collision_within_inners,
|
|
10
|
+
validate_if_collision_with_owner_class,
|
|
11
|
+
)
|
|
12
|
+
# Annotations
|
|
13
|
+
if TYPE_CHECKING:
|
|
14
|
+
from ....protocols.classes import SimpleClassLike
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
def process_inners(
|
|
18
|
+
node_names_set: set,
|
|
19
|
+
name_snake: str,
|
|
20
|
+
owner_class: "SimpleClassLike",
|
|
21
|
+
) -> tuple[tuple["SimpleClassLike", ...], set]:
|
|
22
|
+
"""Validates and processes _inners for a composite class."""
|
|
23
|
+
|
|
24
|
+
# 1. Acquire attribute (Guaranteed to exist by SimpleMeta routing)
|
|
25
|
+
raw_inners = getattr(owner_class, "_inners")
|
|
26
|
+
|
|
27
|
+
# 2. Check if validations are needed (only for locally declared _inners)
|
|
28
|
+
need_validations = "_inners" in owner_class.__dict__
|
|
29
|
+
|
|
30
|
+
# 3. Base validations
|
|
31
|
+
if need_validations:
|
|
32
|
+
validate_inners_is_tuple(raw_inners, owner_class)
|
|
33
|
+
validate_inners_is_not_empty(raw_inners, owner_class)
|
|
34
|
+
|
|
35
|
+
from .....SimpleConstant import SimpleConstant
|
|
36
|
+
from .....SimpleObject import SimpleObject
|
|
37
|
+
|
|
38
|
+
# 4. Prepare namespace accumulator
|
|
39
|
+
new_node_names_set = node_names_set.copy()
|
|
40
|
+
|
|
41
|
+
# 5. Iterate inners
|
|
42
|
+
raw_inners: tuple["SimpleClassLike", ...]
|
|
43
|
+
for inner in raw_inners:
|
|
44
|
+
inner: type["SimpleClassLike"]
|
|
45
|
+
|
|
46
|
+
# 5.1 Type and hierarchy checks
|
|
47
|
+
if need_validations:
|
|
48
|
+
# noinspection PyUnboundLocalVariable
|
|
49
|
+
if (
|
|
50
|
+
not isinstance(inner, type)
|
|
51
|
+
or not issubclass(inner, SimpleConstant)
|
|
52
|
+
or inner is SimpleConstant
|
|
53
|
+
or inner is SimpleObject
|
|
54
|
+
):
|
|
55
|
+
validate_inner_is_class(inner, raw_inners, owner_class)
|
|
56
|
+
validate_inner_is_simple_subclass(inner, owner_class)
|
|
57
|
+
validate_inner_is_not_simple_class(inner, owner_class)
|
|
58
|
+
|
|
59
|
+
# 5.2 Name collision checks
|
|
60
|
+
node_name_collisions = new_node_names_set & inner.meta.node_names_set
|
|
61
|
+
if node_name_collisions:
|
|
62
|
+
collision_name = next(iter(node_name_collisions))
|
|
63
|
+
validate_if_collision_with_owner_class(
|
|
64
|
+
collision_name,
|
|
65
|
+
name_snake,
|
|
66
|
+
inner,
|
|
67
|
+
owner_class,
|
|
68
|
+
)
|
|
69
|
+
if need_validations:
|
|
70
|
+
validate_collision_within_inners(
|
|
71
|
+
collision_name,
|
|
72
|
+
name_snake,
|
|
73
|
+
raw_inners,
|
|
74
|
+
inner,
|
|
75
|
+
owner_class,
|
|
76
|
+
)
|
|
77
|
+
|
|
78
|
+
# 5.3 Register names
|
|
79
|
+
new_node_names_set.update(inner.meta.node_names_set)
|
|
80
|
+
|
|
81
|
+
# 6. Return results
|
|
82
|
+
return raw_inners, new_node_names_set
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
_DESIGN_NOTES = """
|
|
87
|
+
# process_inners
|
|
88
|
+
|
|
89
|
+
## Purpose
|
|
90
|
+
Validates and processes `_inners` for composite classes.
|
|
91
|
+
Ensures strict determinism, predictable structure, and globally unique naming across the entire tree.
|
|
92
|
+
|
|
93
|
+
## Architectural Context & Routing
|
|
94
|
+
`SimpleMeta.__new__` routes class creation strictly based on the presence of `_inners`:
|
|
95
|
+
- If `_inners` is present -> routed to `SimpleObjectMetadata` -> invokes `process_inners`.
|
|
96
|
+
- If `_inners` is absent -> routed to `SimpleConstantMetadata` -> treats class as atomic.
|
|
97
|
+
|
|
98
|
+
Because of this top-level meta routing, `process_inners` operates under the strict invariant
|
|
99
|
+
that `_inners` **always exists** on `owner_class` (it is never `UNSET`). Consequently, checking
|
|
100
|
+
for missing `_inners` or fallback sentinel handling is intentionally omitted as redundant.
|
|
101
|
+
|
|
102
|
+
## Why inners matter
|
|
103
|
+
Each inner must be a concrete class inheriting from `SimpleConstant` (which includes `SimpleObject`).
|
|
104
|
+
This guarantees:
|
|
105
|
+
- consistent metadata (`__metadata__`)
|
|
106
|
+
- defined type boundary (`_type`)
|
|
107
|
+
- default fallback (`_default`)
|
|
108
|
+
- unique nested identifier index (`node_names_set`)
|
|
109
|
+
|
|
110
|
+
## Control flow
|
|
111
|
+
|
|
112
|
+
### 1. Attribute extraction & validation
|
|
113
|
+
Extracts `_inners` and validates that local declarations:
|
|
114
|
+
- are structured as a `tuple`
|
|
115
|
+
- are not empty (an empty tuple `_inners = ()` is invalid; classes without inners omit `_inners`)
|
|
116
|
+
|
|
117
|
+
### 2. Namespace accumulator
|
|
118
|
+
`new_node_names_set` is a shallow copy of the parent namespace.
|
|
119
|
+
This prevents sibling pollution and ensures deterministic propagation of names.
|
|
120
|
+
|
|
121
|
+
### 3. Local base-class imports
|
|
122
|
+
`SimpleConstant` and `SimpleObject` are imported lazily to avoid circular dependencies.
|
|
123
|
+
|
|
124
|
+
### 4. Iteration over inners
|
|
125
|
+
|
|
126
|
+
#### 4.1 Structural type guards
|
|
127
|
+
Each inner must:
|
|
128
|
+
- be a class (`type`)
|
|
129
|
+
- inherit from `SimpleConstant`
|
|
130
|
+
- not be the raw base classes `SimpleConstant` or `SimpleObject`
|
|
131
|
+
|
|
132
|
+
#### 4.2 Name collision detection
|
|
133
|
+
Checks intersection between `new_node_names_set` and `inner.meta.node_names_set`.
|
|
134
|
+
Distinguishes between owner-class collisions and sibling collisions.
|
|
135
|
+
|
|
136
|
+
#### 4.3 Namespace registration
|
|
137
|
+
Updates `new_node_names_set` so all nested names are immediately visible to subsequent inners.
|
|
138
|
+
|
|
139
|
+
### 5. Return value
|
|
140
|
+
Returns:
|
|
141
|
+
- `raw_inners` — verified tuple of inner classes
|
|
142
|
+
- `new_node_names_set` — fully updated namespace for this subtree
|
|
143
|
+
"""
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
from .validate_inner_is_class import validate_inner_is_class
|
|
2
|
+
from .validate_inner_is_not_simple_class import validate_inner_is_not_simple_class
|
|
3
|
+
from .validate_inner_is_simple_subclass import validate_inner_is_simple_subclass
|
|
4
|
+
|
|
5
|
+
from .validate_inners_is_defined import validate_inners_is_defined
|
|
6
|
+
from .validate_inners_is_not_empty import validate_inners_is_not_empty
|
|
7
|
+
from .validate_inners_is_tuple import validate_inners_is_tuple
|
|
8
|
+
|
|
9
|
+
from .validate_collision_within_inners import validate_collision_within_inners
|
|
10
|
+
from .validate_if_collision_with_owner_class import validate_if_collision_with_owner_class
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
_DESIGN_NOTES = """
|
|
14
|
+
# Inners Validation Sub-Package
|
|
15
|
+
|
|
16
|
+
## Purpose
|
|
17
|
+
Provides all validation filters applied to `_inners` and its elements. Ensures
|
|
18
|
+
structural correctness, type lineage, and identifier uniqueness across the
|
|
19
|
+
composition tree.
|
|
20
|
+
|
|
21
|
+
## Internal Components Registry
|
|
22
|
+
|
|
23
|
+
| Component | Type | Description |
|
|
24
|
+
| :--------------------------------------- | :------- | :------------------------------------------------------------------------- |
|
|
25
|
+
| `validate_inner_is_class` | Function | Ensures each inner element is a class object. |
|
|
26
|
+
| `validate_inner_is_not_simple_class` | Function | Blocks using raw Simple framework base classes. |
|
|
27
|
+
| `validate_inner_is_simple_subclass` | Function | Verifies inheritance from Simple base classes. |
|
|
28
|
+
| `validate_inners_is_defined` | Function | Checks that `_inners` is present on the class. |
|
|
29
|
+
| `validate_inners_is_not_empty` | Function | Rejects empty `_inners` declarations. |
|
|
30
|
+
| `validate_inners_is_tuple` | Function | Ensures `_inners` is a tuple. |
|
|
31
|
+
| `validate_collision_within_inners` | Function | Detects name collisions among sibling inner elements. |
|
|
32
|
+
| `validate_if_collision_with_owner_class` | Function | Prevents inner elements from sharing the owner's identifier. |
|
|
33
|
+
"""
|
simplibs/object/_core/metadata/init_processors/inners/validations/_exception_info_for_inners.py
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Tuple
|
|
2
|
+
# Annotations
|
|
3
|
+
if TYPE_CHECKING:
|
|
4
|
+
from .....protocols.classes import SimpleClassLike
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def _exception_info_for_inners(
|
|
8
|
+
owner_class: "SimpleClassLike",
|
|
9
|
+
) -> Tuple[str, str, str, Tuple[str, ...]]:
|
|
10
|
+
"""Provides shared diagnostic info for inners validation."""
|
|
11
|
+
|
|
12
|
+
class_name = owner_class.__name__
|
|
13
|
+
error_name = "INVALID INNERS DEFINITION"
|
|
14
|
+
context = f"{class_name}._inners validation"
|
|
15
|
+
|
|
16
|
+
acceptable = (
|
|
17
|
+
"Acceptable definition:",
|
|
18
|
+
f"class {class_name}(SimpleObject):",
|
|
19
|
+
" _inners = (FirstElement, SecondElement)",
|
|
20
|
+
)
|
|
21
|
+
|
|
22
|
+
return class_name, error_name, context, acceptable
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
_DESIGN_NOTES = """
|
|
27
|
+
# _exception_info_for_inners
|
|
28
|
+
|
|
29
|
+
## Purpose
|
|
30
|
+
Provides shared diagnostic information for all inners‑validation functions:
|
|
31
|
+
- class name,
|
|
32
|
+
- error label,
|
|
33
|
+
- context string,
|
|
34
|
+
- example of acceptable definition.
|
|
35
|
+
|
|
36
|
+
## Behavior
|
|
37
|
+
Returns a 4‑tuple used by all validation functions to build consistent error
|
|
38
|
+
messages.
|
|
39
|
+
|
|
40
|
+
## Notes
|
|
41
|
+
This helper is internal to the inners‑validation pipeline and is not part of the
|
|
42
|
+
public API.
|
|
43
|
+
"""
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Annotations
|
|
3
|
+
if TYPE_CHECKING:
|
|
4
|
+
from .....protocols.classes import SimpleClassLike
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def _get_collision_path(
|
|
8
|
+
current_class: "SimpleClassLike",
|
|
9
|
+
collision_name: str,
|
|
10
|
+
) -> str | None:
|
|
11
|
+
"""Returns structural path to the class causing a name collision."""
|
|
12
|
+
|
|
13
|
+
# 1. Direct match
|
|
14
|
+
if current_class.meta.name_snake == collision_name:
|
|
15
|
+
return current_class.__name__
|
|
16
|
+
|
|
17
|
+
# 2. Scan inners
|
|
18
|
+
raw_inners = getattr(current_class, "_inners", ())
|
|
19
|
+
|
|
20
|
+
for inner in raw_inners:
|
|
21
|
+
if collision_name in inner.meta.node_names_set:
|
|
22
|
+
sub_path = _get_collision_path(inner, collision_name)
|
|
23
|
+
if sub_path:
|
|
24
|
+
return f"{current_class.__name__}/{sub_path}"
|
|
25
|
+
|
|
26
|
+
# 3. No match
|
|
27
|
+
return None
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
_DESIGN_NOTES = """
|
|
31
|
+
# _get_collision_path
|
|
32
|
+
|
|
33
|
+
## Purpose
|
|
34
|
+
Computes a structural breadcrumb path to the class where a name collision originates.
|
|
35
|
+
Used by name‑collision validators to produce clear diagnostic messages.
|
|
36
|
+
|
|
37
|
+
## Behavior
|
|
38
|
+
1. Checks whether the current class owns the name.
|
|
39
|
+
2. If not, scans `_inners` using `node_names_set` as a fast pre-filter.
|
|
40
|
+
3. Recursively descends only into branches guaranteed to contain the collision.
|
|
41
|
+
4. Returns a path like `Order/Delivery/Address` or `None` if not found.
|
|
42
|
+
|
|
43
|
+
## Notes
|
|
44
|
+
Internal helper; does not raise exceptions. Pure path computation.
|
|
45
|
+
"""
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_inners import _exception_info_for_inners
|
|
6
|
+
from ._get_collision_path import _get_collision_path
|
|
7
|
+
# Annotations
|
|
8
|
+
if TYPE_CHECKING:
|
|
9
|
+
from .....protocols.classes import SimpleClassLike
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def validate_collision_within_inners(
|
|
13
|
+
collision_name: str,
|
|
14
|
+
owner_snake_name: str,
|
|
15
|
+
raw_inners: tuple["SimpleClassLike", ...],
|
|
16
|
+
current_inner: "SimpleClassLike",
|
|
17
|
+
owner_class: "SimpleClassLike",
|
|
18
|
+
) -> None:
|
|
19
|
+
"""Validates sibling name collisions inside _inners."""
|
|
20
|
+
|
|
21
|
+
# 1. Check collision (ignore owner-class collisions)
|
|
22
|
+
if not collision_name or collision_name == owner_snake_name:
|
|
23
|
+
return
|
|
24
|
+
|
|
25
|
+
# 2. Diagnostic info
|
|
26
|
+
class_name, error_name, context, acceptable = _exception_info_for_inners(owner_class)
|
|
27
|
+
|
|
28
|
+
# 3. Find first culprit (the one that registered the name earlier)
|
|
29
|
+
first_path = None
|
|
30
|
+
for previous_inner in raw_inners:
|
|
31
|
+
if collision_name in previous_inner.meta.node_names_set:
|
|
32
|
+
first_path = _get_collision_path(previous_inner, collision_name)
|
|
33
|
+
break
|
|
34
|
+
|
|
35
|
+
first_full = f"{class_name} -> {first_path}"
|
|
36
|
+
|
|
37
|
+
# 4. Find second culprit (the current conflicting component)
|
|
38
|
+
second_path = _get_collision_path(current_inner, collision_name)
|
|
39
|
+
second_full = f"{class_name} -> {second_path}"
|
|
40
|
+
|
|
41
|
+
# 5. Raise error
|
|
42
|
+
raise SimpleDefinitionError(
|
|
43
|
+
error_name=error_name,
|
|
44
|
+
label="inner_name_collision",
|
|
45
|
+
expected="Unique name_snake across all inner components",
|
|
46
|
+
value=collision_name,
|
|
47
|
+
problem="Two inner components share the same identifier.",
|
|
48
|
+
context=context,
|
|
49
|
+
how_to_fix=(
|
|
50
|
+
f"Conflicting identifier: '{collision_name}'.",
|
|
51
|
+
f"Existing definition: {first_full}.",
|
|
52
|
+
f"Duplicate declaration: {second_full}.",
|
|
53
|
+
f"Rename one of the conflicting components inside '{class_name}'.",
|
|
54
|
+
"Ensure you did not accidentally register the same class twice.",
|
|
55
|
+
"name_snake must be globally unique within the composition tree.",
|
|
56
|
+
) + acceptable,
|
|
57
|
+
exception=NameError,
|
|
58
|
+
)
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
_DESIGN_NOTES = """
|
|
62
|
+
# validate_collision_within_inners
|
|
63
|
+
|
|
64
|
+
## Purpose
|
|
65
|
+
Detects naming collisions between sibling inner components.
|
|
66
|
+
This validator is triggered only after owner-class collisions have been ruled out.
|
|
67
|
+
|
|
68
|
+
## Behavior
|
|
69
|
+
1. Checks whether the collision is a sibling-level conflict.
|
|
70
|
+
2. Locates the first component that registered the name.
|
|
71
|
+
3. Locates the second component causing the duplicate.
|
|
72
|
+
4. Builds breadcrumb paths using `_get_collision_path`.
|
|
73
|
+
5. Raises a structured `SimpleDefinitionError`.
|
|
74
|
+
|
|
75
|
+
## Notes
|
|
76
|
+
This validator is a strict enforcement barrier.
|
|
77
|
+
If reached, a naming conflict is guaranteed and compilation must stop.
|
|
78
|
+
"""
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_inners import _exception_info_for_inners
|
|
6
|
+
from ._get_collision_path import _get_collision_path
|
|
7
|
+
# Annotations
|
|
8
|
+
if TYPE_CHECKING:
|
|
9
|
+
from .....protocols.classes import SimpleClassLike
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def validate_if_collision_with_owner_class(
|
|
13
|
+
collision_name: str,
|
|
14
|
+
owner_snake_name: str,
|
|
15
|
+
inner_culprit: "SimpleClassLike",
|
|
16
|
+
owner_class: "SimpleClassLike",
|
|
17
|
+
) -> None:
|
|
18
|
+
"""Validates collision between inner name and owner class name."""
|
|
19
|
+
|
|
20
|
+
# 1. Check collision
|
|
21
|
+
if collision_name != owner_snake_name:
|
|
22
|
+
return
|
|
23
|
+
|
|
24
|
+
# 2. Diagnostic info
|
|
25
|
+
class_name, error_name, context, acceptable = _exception_info_for_inners(owner_class)
|
|
26
|
+
|
|
27
|
+
# 3. Compute culprit path
|
|
28
|
+
culprit_path = _get_collision_path(inner_culprit, collision_name) or inner_culprit.__name__
|
|
29
|
+
full_path = f"{class_name} -> {culprit_path}"
|
|
30
|
+
leaf_name = culprit_path.split("/")[-1]
|
|
31
|
+
|
|
32
|
+
# 4. Raise error
|
|
33
|
+
raise SimpleDefinitionError(
|
|
34
|
+
error_name=error_name,
|
|
35
|
+
label="owner_class_name_collision",
|
|
36
|
+
expected="Unique name_snake across entire composition tree",
|
|
37
|
+
value=collision_name,
|
|
38
|
+
problem="Nested component uses the same identifier as its root owner class.",
|
|
39
|
+
context=context,
|
|
40
|
+
how_to_fix=(
|
|
41
|
+
f"Conflicting identifier: '{collision_name}'.",
|
|
42
|
+
f"Path to offending component: {full_path}.",
|
|
43
|
+
f"Rename class '{leaf_name}' or rename root class '{class_name}'.",
|
|
44
|
+
"Every class in the composition hierarchy must have a unique name_snake.",
|
|
45
|
+
) + acceptable,
|
|
46
|
+
exception=NameError,
|
|
47
|
+
)
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
_DESIGN_NOTES = """
|
|
52
|
+
# validate_if_collision_with_owner_class
|
|
53
|
+
|
|
54
|
+
## Purpose
|
|
55
|
+
Detects the most severe naming conflict: an inner element sharing the same
|
|
56
|
+
`name_snake` as the owner class. This would break the entire composition tree.
|
|
57
|
+
|
|
58
|
+
## Behavior
|
|
59
|
+
1. Compares `collision_name` with the owner’s `name_snake`.
|
|
60
|
+
2. If equal, computes a structural path to the culprit using `_get_collision_path`.
|
|
61
|
+
3. Raises a structured `SimpleDefinitionError` with precise remediation steps.
|
|
62
|
+
|
|
63
|
+
## Notes
|
|
64
|
+
This validator is separate from sibling-collision checks because collisions with
|
|
65
|
+
the owner class have different semantics and require different remediation.
|
|
66
|
+
"""
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_inners import _exception_info_for_inners
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_inner_is_class(
|
|
12
|
+
inner: "SimpleClassLike",
|
|
13
|
+
inners: tuple["SimpleClassLike", ...],
|
|
14
|
+
owner_class: "SimpleClassLike",
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Validates that an inner element is a class."""
|
|
17
|
+
|
|
18
|
+
# 1. Check type
|
|
19
|
+
if isinstance(inner, type):
|
|
20
|
+
return
|
|
21
|
+
|
|
22
|
+
# 2. Diagnostic info
|
|
23
|
+
class_name, error_name, context, acceptable = _exception_info_for_inners(owner_class)
|
|
24
|
+
|
|
25
|
+
# 3. Raise error
|
|
26
|
+
raise SimpleDefinitionError(
|
|
27
|
+
error_name=error_name,
|
|
28
|
+
label="inner_not_class",
|
|
29
|
+
expected="Class inheriting from SimpleConstant or SimpleObject",
|
|
30
|
+
value=inner,
|
|
31
|
+
problem=f"Inner element '{inner}' inside '{inners}' is not a class.",
|
|
32
|
+
context=context,
|
|
33
|
+
how_to_fix=(
|
|
34
|
+
"Use class references, not instances.",
|
|
35
|
+
"Example: MyElement, not MyElement().",
|
|
36
|
+
"Ensure the item is not a string or primitive value.",
|
|
37
|
+
) + acceptable,
|
|
38
|
+
exception=TypeError,
|
|
39
|
+
)
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
_DESIGN_NOTES = """
|
|
44
|
+
# validate_inner_is_class
|
|
45
|
+
|
|
46
|
+
## Purpose
|
|
47
|
+
Ensures that each element in `_inners` is a class, not an instance or primitive.
|
|
48
|
+
|
|
49
|
+
## Behavior
|
|
50
|
+
1. Checks whether the inner element is a `type`.
|
|
51
|
+
2. If invalid, retrieves shared diagnostic info.
|
|
52
|
+
3. Raises a structured `SimpleDefinitionError`.
|
|
53
|
+
|
|
54
|
+
## Notes
|
|
55
|
+
This validator prevents accidental instantiation in `_inners`, such as writing
|
|
56
|
+
`MyElement()` instead of `MyElement`.
|
|
57
|
+
|
|
58
|
+
"""
|