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,165 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from functools import reduce
|
|
3
|
+
from operator import or_
|
|
4
|
+
from simplibs.sentinels import EMPTY, UNSET
|
|
5
|
+
# Inners
|
|
6
|
+
from .SimpleConstantMetadata import SimpleConstantMetadata
|
|
7
|
+
from .init_processors.default import raise_default_is_defined_in_composition
|
|
8
|
+
from .init_processors.type import process_type
|
|
9
|
+
from .init_processors.inners import process_inners
|
|
10
|
+
from .init_processors.methods import process_classmethod
|
|
11
|
+
from .instance_builders.composite_class import make_composite_class
|
|
12
|
+
# Annotations
|
|
13
|
+
if TYPE_CHECKING:
|
|
14
|
+
from ..protocols.metadata import SimpleObjectMetadataProtocol
|
|
15
|
+
from ..protocols.instance.core_classes import CompositeInstanceProtocol
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
class SimpleObjectMetadata(SimpleConstantMetadata):
|
|
19
|
+
"""Metadata compiler for composite nodes."""
|
|
20
|
+
|
|
21
|
+
__slots__ = (
|
|
22
|
+
"inners",
|
|
23
|
+
"logic",
|
|
24
|
+
"decompose",
|
|
25
|
+
"inners_params_name",
|
|
26
|
+
"inners_map",
|
|
27
|
+
"is_decomposeable",
|
|
28
|
+
"_composite_class_mutable",
|
|
29
|
+
"_composite_class_immutable",
|
|
30
|
+
)
|
|
31
|
+
|
|
32
|
+
def _process_user_data(self: "SimpleObjectMetadataProtocol") -> None:
|
|
33
|
+
# 1. Mark as composite
|
|
34
|
+
self.is_constant = False
|
|
35
|
+
|
|
36
|
+
# 2. Composition cannot define _default
|
|
37
|
+
if "_default" in self.owner_class.__dict__:
|
|
38
|
+
raise_default_is_defined_in_composition(self.owner_class)
|
|
39
|
+
|
|
40
|
+
# 3. Process type
|
|
41
|
+
self.value_type, self.value_type_name = process_type(self.owner_class)
|
|
42
|
+
|
|
43
|
+
# 4. Process inners
|
|
44
|
+
inners, node_names_set = process_inners(
|
|
45
|
+
node_names_set=self.node_names_set,
|
|
46
|
+
name_snake=self.name_snake,
|
|
47
|
+
owner_class=self.owner_class,
|
|
48
|
+
)
|
|
49
|
+
self.inners = inners
|
|
50
|
+
self.node_names_set.update(node_names_set)
|
|
51
|
+
|
|
52
|
+
# 5. Build lookup maps
|
|
53
|
+
self.inners_map = {inner.meta.name_snake: inner for inner in self.inners}
|
|
54
|
+
self.inners_params_name = tuple(inner.meta.name_snake for inner in self.inners)
|
|
55
|
+
|
|
56
|
+
# 6. Prepare annotations/defaults
|
|
57
|
+
inners_default = tuple(inner.meta.default for inner in self.inners)
|
|
58
|
+
inners_annotations = {
|
|
59
|
+
inner.meta.name_snake: inner.meta.value_type
|
|
60
|
+
for inner in self.inners
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
# 7. Process _logic
|
|
64
|
+
self.logic, self.default = process_classmethod(
|
|
65
|
+
method_name="_logic",
|
|
66
|
+
expected_params=("cls", *self.inners_params_name),
|
|
67
|
+
expected_args_params_count=1 + len(self.inners_params_name),
|
|
68
|
+
expected_args_defaults=inners_default,
|
|
69
|
+
expected_kwargs_defaults={},
|
|
70
|
+
expected_param_types=inners_annotations,
|
|
71
|
+
expected_return_type=self.value_type,
|
|
72
|
+
owner_class=self.owner_class,
|
|
73
|
+
return_calculated_value=True,
|
|
74
|
+
)
|
|
75
|
+
|
|
76
|
+
# 8. Process _decompose
|
|
77
|
+
self.decompose = process_classmethod(
|
|
78
|
+
method_name="_decompose",
|
|
79
|
+
expected_params=("cls", "value"),
|
|
80
|
+
expected_args_params_count=2,
|
|
81
|
+
expected_args_defaults=(self.default,),
|
|
82
|
+
expected_kwargs_defaults={},
|
|
83
|
+
expected_param_types={"value": self.value_type},
|
|
84
|
+
expected_return_type=tuple,
|
|
85
|
+
owner_class=self.owner_class,
|
|
86
|
+
)
|
|
87
|
+
|
|
88
|
+
# 9. Determine decomposability
|
|
89
|
+
self.is_decomposeable = (
|
|
90
|
+
self.decompose is not UNSET
|
|
91
|
+
and all(
|
|
92
|
+
inner.meta.is_constant or inner.meta.is_decomposeable
|
|
93
|
+
for inner in self.inners
|
|
94
|
+
)
|
|
95
|
+
)
|
|
96
|
+
|
|
97
|
+
# 10. Process _validate
|
|
98
|
+
self.validate = process_classmethod(
|
|
99
|
+
method_name="_validate",
|
|
100
|
+
expected_params=("cls", "value", "return_bool"),
|
|
101
|
+
expected_args_params_count=2,
|
|
102
|
+
expected_args_defaults=(),
|
|
103
|
+
expected_kwargs_defaults={"return_bool": False},
|
|
104
|
+
expected_param_types={"value": Any, "return_bool": bool},
|
|
105
|
+
expected_return_type=bool | None,
|
|
106
|
+
test_value=(self.default,),
|
|
107
|
+
owner_class=self.owner_class,
|
|
108
|
+
)
|
|
109
|
+
|
|
110
|
+
# 11. Reset caches
|
|
111
|
+
self._atom_class_mutable = UNSET
|
|
112
|
+
self._atom_class_immutable = UNSET
|
|
113
|
+
self._composite_class_mutable = UNSET
|
|
114
|
+
self._composite_class_immutable = UNSET
|
|
115
|
+
|
|
116
|
+
@property
|
|
117
|
+
def composite_class_mutable(self: "SimpleObjectMetadataProtocol") -> "CompositeInstanceProtocol":
|
|
118
|
+
if self._composite_class_mutable is UNSET:
|
|
119
|
+
# noinspection PyAttributeOutsideInit
|
|
120
|
+
self._composite_class_mutable = make_composite_class(self.owner_class.__metadata__)
|
|
121
|
+
return self._composite_class_mutable
|
|
122
|
+
|
|
123
|
+
@property
|
|
124
|
+
def composite_class_immutable(self: "SimpleObjectMetadataProtocol") -> "CompositeInstanceProtocol":
|
|
125
|
+
if self._composite_class_immutable is UNSET:
|
|
126
|
+
# noinspection PyAttributeOutsideInit
|
|
127
|
+
self._composite_class_immutable = make_composite_class(
|
|
128
|
+
self.owner_class.__metadata__,
|
|
129
|
+
mutable=False,
|
|
130
|
+
)
|
|
131
|
+
return self._composite_class_immutable
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
_DESIGN_NOTES = """
|
|
135
|
+
# SimpleObjectMetadata
|
|
136
|
+
|
|
137
|
+
## Purpose
|
|
138
|
+
Compiles metadata for composite nodes.
|
|
139
|
+
Validates structure, processes inners, binds logic/decompose/validate methods, and
|
|
140
|
+
provides lazy access to compiled composite classes.
|
|
141
|
+
|
|
142
|
+
## Behavior
|
|
143
|
+
1. Marks the node as composite (`is_constant = False`).
|
|
144
|
+
2. Forbids `_default` on composite classes.
|
|
145
|
+
3. Processes type information.
|
|
146
|
+
4. Processes inners and updates the global name namespace.
|
|
147
|
+
5. Builds lookup maps (`inners_map`, `inners_params_name`).
|
|
148
|
+
6. Extracts defaults and annotations for method validation.
|
|
149
|
+
7. Validates and binds `_logic`.
|
|
150
|
+
8. Validates and binds `_decompose`.
|
|
151
|
+
9. Determines whether the node supports backward decomposition.
|
|
152
|
+
10. Validates and binds `_validate`.
|
|
153
|
+
11. Resets lazy caches for atom/composite classes.
|
|
154
|
+
|
|
155
|
+
## Lazy class synthesis
|
|
156
|
+
- `composite_class_mutable` and `composite_class_immutable` call `make_composite_class`
|
|
157
|
+
on first access.
|
|
158
|
+
- **Important:** cache uses `EMPTY` for checking but is initialized with `UNSET`.
|
|
159
|
+
This mismatch prevents caching and forces recompilation on every access.
|
|
160
|
+
|
|
161
|
+
## Notes
|
|
162
|
+
- Ensures deterministic structure for composite nodes.
|
|
163
|
+
- Guarantees strict signature alignment between inners and `_logic`.
|
|
164
|
+
- Provides full reactive capabilities via composite class builder.
|
|
165
|
+
"""
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
from .SimpleMeta import SimpleMeta
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Metadata Sub-Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Provides the core metaclass used to construct declarative Simple classes. Handles
|
|
9
|
+
metadata creation, write-once protection, and instance construction.
|
|
10
|
+
|
|
11
|
+
## Internal Components Registry
|
|
12
|
+
|
|
13
|
+
| Component | Type | Description |
|
|
14
|
+
| :------------ | :--------- | :----------------------------------------------- |
|
|
15
|
+
| `SimpleMeta` | Metaclass | Central metaclass orchestrating metadata and instance creation. |
|
|
16
|
+
"""
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
BASE_CLASS_NAMES = ("SimpleBase", "SimpleConstant", "SimpleObject")
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# BASE_CLASS_NAMES
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
- Serves as a **stable identifier set** for all foundational Simple system classes.
|
|
9
|
+
- Used to distinguish **system-level root classes** from **user-defined declarative blueprints**.
|
|
10
|
+
- Ensures that base classes:
|
|
11
|
+
- do **not** receive metadata,
|
|
12
|
+
- cannot be instantiated,
|
|
13
|
+
- are excluded from validation pipelines,
|
|
14
|
+
- act purely as architectural anchors.
|
|
15
|
+
|
|
16
|
+
- Referenced in:
|
|
17
|
+
- `calculate_blueprint_path.py` — base classes have no blueprint path.
|
|
18
|
+
- `validate_class_is_not_base_class.py` — prevents instantiation of base classes.
|
|
19
|
+
- `create_instance.py` — skips metadata and validation for base classes.
|
|
20
|
+
- `SimpleMeta.py` — decides whether metadata should be created for a class.
|
|
21
|
+
|
|
22
|
+
- This constant is intentionally **small, immutable, and stable**, because changing it would break the entire metadata lifecycle.
|
|
23
|
+
"""
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
from .BASE_CLASS_NAMES import BASE_CLASS_NAMES
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Metadata Constants Sub-Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Provides core metadata constants used across the Simple system to identify
|
|
9
|
+
framework base classes and control metadata creation and instantiation rules.
|
|
10
|
+
|
|
11
|
+
## Internal Components Registry
|
|
12
|
+
|
|
13
|
+
| Component | Type | Description |
|
|
14
|
+
| :------------------ | :------- | :------------------------------------------------ |
|
|
15
|
+
| `BASE_CLASS_NAMES` | Constant | Names of Simple framework base classes. |
|
|
16
|
+
"""
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
_DESIGN_NOTES = """
|
|
2
|
+
# Metadata Init Processors Package Overview
|
|
3
|
+
|
|
4
|
+
The `init_processors` package contains the modular initialization pipelines used
|
|
5
|
+
to construct metadata for declarative Simple classes. Each sub-package handles a
|
|
6
|
+
specific structural aspect of metadata creation: type processing, default value
|
|
7
|
+
handling, inner structure validation, method extraction, name generation, and
|
|
8
|
+
blueprint path computation.
|
|
9
|
+
|
|
10
|
+
This package does not re-export any components. All functionality is accessed
|
|
11
|
+
directly through the corresponding sub-packages.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Sub-Packages
|
|
16
|
+
|
|
17
|
+
### 1. blueprint_path
|
|
18
|
+
Computes deterministic class lineage identifiers used in metadata, diagnostics,
|
|
19
|
+
and technical representations.
|
|
20
|
+
|
|
21
|
+
### 2. default
|
|
22
|
+
Processes and validates default values for both constant and composite classes.
|
|
23
|
+
Enforces architectural rules and write-once semantics.
|
|
24
|
+
|
|
25
|
+
### 3. inners
|
|
26
|
+
Validates and processes the `_inners` attribute, ensuring structural correctness,
|
|
27
|
+
type lineage, and collision-free composition trees.
|
|
28
|
+
|
|
29
|
+
### 4. methods
|
|
30
|
+
Extracts, validates, and normalizes class methods (`_logic`, `_decompose`,
|
|
31
|
+
custom classmethods). Ensures deterministic method metadata.
|
|
32
|
+
|
|
33
|
+
### 5. names
|
|
34
|
+
Generates canonical class identifiers: readable names, snake_case tokens, and
|
|
35
|
+
private names used throughout the system.
|
|
36
|
+
|
|
37
|
+
### 6. type
|
|
38
|
+
Validates, normalizes, and transforms declared type boundaries into internal
|
|
39
|
+
UnionType representations.
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Notes
|
|
44
|
+
- This package is internal and not intended for direct user interaction.
|
|
45
|
+
- Each processor sub-package is self-contained and exposes its own public API.
|
|
46
|
+
- The structure is designed for clarity, modularity, and predictable metadata behavior.
|
|
47
|
+
"""
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from .calculate_blueprint_path import calculate_blueprint_path
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Class Blueprint Path Sub-Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Provides structural utilities for analyzing class inheritance hierarchies and deriving human-readable lineage indicators used in diagnostic reporting and technical representations.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
14
|
+
| `calculate_blueprint_path` | Function | Traverses the MRO to build a deterministic representation of a class's custom parents. |
|
|
15
|
+
"""
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ...constants import BASE_CLASS_NAMES
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ....protocols.classes import SimpleClassLike
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def calculate_blueprint_path(
|
|
10
|
+
cls: "SimpleClassLike"
|
|
11
|
+
) -> str:
|
|
12
|
+
"""Builds a readable inheritance path for the class."""
|
|
13
|
+
|
|
14
|
+
# 1. Local import to avoid circular dependencies
|
|
15
|
+
from .....SimpleBase import SimpleBase
|
|
16
|
+
|
|
17
|
+
# 2. Collect relevant parents from MRO
|
|
18
|
+
parents = [
|
|
19
|
+
base.__name__
|
|
20
|
+
for base in cls.__mro__
|
|
21
|
+
if issubclass(base, SimpleBase)
|
|
22
|
+
and base.__name__ not in BASE_CLASS_NAMES
|
|
23
|
+
and base is not cls
|
|
24
|
+
]
|
|
25
|
+
|
|
26
|
+
# 3. Construct path
|
|
27
|
+
return (
|
|
28
|
+
cls.__name__
|
|
29
|
+
if not parents else
|
|
30
|
+
f"{cls.__name__}({', '.join(parents)})"
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
_DESIGN_NOTES = """
|
|
36
|
+
# calculate_blueprint_path
|
|
37
|
+
|
|
38
|
+
## Purpose
|
|
39
|
+
Creates a readable inheritance path for a Simple class.
|
|
40
|
+
Used mainly in `__repr__` to show the blueprint structure of a class without
|
|
41
|
+
framework noise.
|
|
42
|
+
|
|
43
|
+
## How it works
|
|
44
|
+
The function inspects the class MRO and selects only meaningful ancestors:
|
|
45
|
+
|
|
46
|
+
1. **SimpleBase filter**
|
|
47
|
+
Only classes that inherit from `SimpleBase` are considered part of the
|
|
48
|
+
SimpleObject ecosystem.
|
|
49
|
+
|
|
50
|
+
2. **Framework root exclusion**
|
|
51
|
+
Classes listed in `BASE_CLASS_NAMES` (e.g., `SimpleBase`, `SimpleConstant`,
|
|
52
|
+
`SimpleObject`) are skipped. They are structural roots, not business-level
|
|
53
|
+
ancestors.
|
|
54
|
+
|
|
55
|
+
3. **Self exclusion**
|
|
56
|
+
The class itself is not included in the parent list.
|
|
57
|
+
|
|
58
|
+
## Output format
|
|
59
|
+
- **No custom parents**
|
|
60
|
+
Returns only the class name:
|
|
61
|
+
`"MyClass"`
|
|
62
|
+
|
|
63
|
+
- **With custom parents**
|
|
64
|
+
Returns a bracketed list:
|
|
65
|
+
`"MyClass(ParentA, ParentB)"`
|
|
66
|
+
|
|
67
|
+
The order follows the class MRO.
|
|
68
|
+
|
|
69
|
+
## Examples
|
|
70
|
+
|
|
71
|
+
| Class hierarchy | Output |
|
|
72
|
+
|-----------------------------------------|--------------------------------|
|
|
73
|
+
| `MyConstant(SimpleConstant)` | `"MyConstant"` |
|
|
74
|
+
| `MyObject(BaseObject, SimpleObject)` | `"MyObject(BaseObject)"` |
|
|
75
|
+
| `Child(ParentA, ParentB, SimpleObject)` | `"Child(ParentA, ParentB)"` |
|
|
76
|
+
|
|
77
|
+
## Notes
|
|
78
|
+
- The internal import of `SimpleBase` prevents circular imports during early
|
|
79
|
+
metadata initialization.
|
|
80
|
+
- Complexity is O(m), where m is the MRO depth (typically very small).
|
|
81
|
+
"""
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
from .process_default_for_constant import process_default_for_constant
|
|
2
|
+
from .validations import raise_default_is_defined_in_composition
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
_DESIGN_NOTES = """
|
|
6
|
+
# Attribute Default Processing Package
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Coordinates the metadata processing routines responsible for extracting, validating, and locking the fallback default boundaries for both constant leaf nodes and composite models.
|
|
10
|
+
|
|
11
|
+
## Internal Components Registry
|
|
12
|
+
|
|
13
|
+
| Component | Type | Description |
|
|
14
|
+
| :---------------------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
15
|
+
| `process_default_for_constant` | Function | The primary pipeline entrypoint that extracts and ensures type compliance of constant defaults. |
|
|
16
|
+
| `raise_default_is_defined_in_composition` | Function | Enforces architectural boundaries by rejecting explicit default attributes on compound objects. |
|
|
17
|
+
"""
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from types import UnionType
|
|
3
|
+
from simplibs.sentinels import UNSET
|
|
4
|
+
# Inners
|
|
5
|
+
from .validations import (
|
|
6
|
+
validate_default_matches_annotation,
|
|
7
|
+
validate_default_is_defined,
|
|
8
|
+
)
|
|
9
|
+
# Annotations
|
|
10
|
+
if TYPE_CHECKING:
|
|
11
|
+
from ....protocols.classes import SimpleClassLike
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def process_default_for_constant(
|
|
15
|
+
default_type: type | UnionType,
|
|
16
|
+
owner_class: "SimpleClassLike",
|
|
17
|
+
) -> Any:
|
|
18
|
+
"""Validates and returns the '_default' value for a constant."""
|
|
19
|
+
|
|
20
|
+
# 1. Fetch raw default
|
|
21
|
+
raw_default = getattr(owner_class, "_default", UNSET)
|
|
22
|
+
|
|
23
|
+
# 2. Validate presence and type
|
|
24
|
+
if raw_default is UNSET or not isinstance(raw_default, default_type):
|
|
25
|
+
validate_default_is_defined(raw_default, owner_class)
|
|
26
|
+
validate_default_matches_annotation(raw_default, default_type, owner_class)
|
|
27
|
+
|
|
28
|
+
# 3. Return validated default
|
|
29
|
+
return raw_default
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
_DESIGN_NOTES = """
|
|
34
|
+
# process_default_for_constant
|
|
35
|
+
|
|
36
|
+
## Purpose
|
|
37
|
+
Ensures that a constant (`SimpleConstant`) defines a valid `_default` value.
|
|
38
|
+
The default must:
|
|
39
|
+
|
|
40
|
+
- exist,
|
|
41
|
+
- and match the type declared in `_type`.
|
|
42
|
+
|
|
43
|
+
Constants have no inner structure, so the default value defines their runtime identity.
|
|
44
|
+
|
|
45
|
+
## Pipeline overview
|
|
46
|
+
|
|
47
|
+
1. **Fetch `_default`**
|
|
48
|
+
Uses `getattr(..., UNSET)` to detect absence reliably.
|
|
49
|
+
|
|
50
|
+
2. **Validate**
|
|
51
|
+
- `validate_default_is_defined` checks presence.
|
|
52
|
+
- `validate_default_matches_annotation` checks type.
|
|
53
|
+
|
|
54
|
+
3. **Return**
|
|
55
|
+
Returns the validated default value.
|
|
56
|
+
|
|
57
|
+
## Why this processor exists
|
|
58
|
+
Constants require a concrete baseline value.
|
|
59
|
+
Compositions (`SimpleObject`) compute their value dynamically via `_logic`, so they
|
|
60
|
+
must not define `_default`.
|
|
61
|
+
This processor enforces the constant‑only rule.
|
|
62
|
+
|
|
63
|
+
## Short‑circuit behavior
|
|
64
|
+
If `_default` exists and matches the type, the function returns immediately without
|
|
65
|
+
running any validation.
|
|
66
|
+
This keeps initialization fast for the common case.
|
|
67
|
+
|
|
68
|
+
## Upstream dependency
|
|
69
|
+
The `default_type` argument must come from `process_type`, which guarantees that
|
|
70
|
+
the type is safe for `isinstance` checks.
|
|
71
|
+
"""
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
from .validate_default_is_defined import validate_default_is_defined
|
|
2
|
+
from .validate_default_matches_annotation import validate_default_matches_annotation
|
|
3
|
+
from .raise_default_is_defined_in_composition import raise_default_is_defined_in_composition
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
_DESIGN_NOTES = """
|
|
7
|
+
# Default Processing Validations Package
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Aggregates and exposes the core structural and type-safety validation functions used during the initialization processing of default values.
|
|
11
|
+
|
|
12
|
+
## Internal Components Registry
|
|
13
|
+
|
|
14
|
+
| Component | Type | Description |
|
|
15
|
+
| :----------------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
16
|
+
| `validate_default_is_defined` | Function | Verifies that a constant leaf node explicitly declares its mandatory default value. |
|
|
17
|
+
| `validate_default_matches_annotation` | Function | Validates that the assigned default value strictly conforms to the compiled type. |
|
|
18
|
+
| `raise_default_is_defined_in_composition` | Function | Enforces architectural boundaries by rejecting explicit default attributes on compound objects. |
|
|
19
|
+
"""
|
simplibs/object/_core/metadata/init_processors/default/validations/_exception_info_for_default.py
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Annotations
|
|
3
|
+
if TYPE_CHECKING:
|
|
4
|
+
from .....protocols.classes import SimpleClassLike
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def _exception_info_for_default(
|
|
8
|
+
owner_class: "SimpleClassLike",
|
|
9
|
+
) -> tuple[str, str, str, str]:
|
|
10
|
+
"""Collects diagnostic data for default-value validation errors."""
|
|
11
|
+
|
|
12
|
+
attribute_name = "_default"
|
|
13
|
+
class_name = owner_class.__name__
|
|
14
|
+
|
|
15
|
+
class_parent = (
|
|
16
|
+
"SimpleObject"
|
|
17
|
+
if "SimpleObject" in owner_class.__mro__
|
|
18
|
+
else "SimpleConstant"
|
|
19
|
+
)
|
|
20
|
+
|
|
21
|
+
error_name = "INVALID DEFAULT DEFINITION"
|
|
22
|
+
context = f"Metadata validation for: {class_name}.{attribute_name}"
|
|
23
|
+
|
|
24
|
+
return (
|
|
25
|
+
class_name,
|
|
26
|
+
class_parent,
|
|
27
|
+
error_name,
|
|
28
|
+
context,
|
|
29
|
+
)
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
_DESIGN_NOTES = """
|
|
33
|
+
# _exception_info_for_default
|
|
34
|
+
|
|
35
|
+
## Purpose
|
|
36
|
+
Provides shared diagnostic values for all default‑related validation errors.
|
|
37
|
+
This keeps validation functions clean and prevents duplication of formatting logic.
|
|
38
|
+
|
|
39
|
+
## Returned values
|
|
40
|
+
The helper returns four items:
|
|
41
|
+
|
|
42
|
+
1. **class_name** — name of the class being validated
|
|
43
|
+
2. **class_parent** — `"SimpleObject"` or `"SimpleConstant"` depending on MRO
|
|
44
|
+
3. **error_name** — fixed label for default‑related errors
|
|
45
|
+
4. **context** — string describing where the error occurred
|
|
46
|
+
|
|
47
|
+
These values are injected directly into `SimpleDefinitionError`.
|
|
48
|
+
|
|
49
|
+
## Why this helper exists
|
|
50
|
+
Default validation appears in three places:
|
|
51
|
+
|
|
52
|
+
- constants: `_default` must exist
|
|
53
|
+
- constants: `_default` must match `_type`
|
|
54
|
+
- compositions: `_default` must NOT exist
|
|
55
|
+
|
|
56
|
+
All tyto validace potřebují stejné základní diagnostické údaje.
|
|
57
|
+
|
|
58
|
+
## Notes
|
|
59
|
+
The helper is intentionally minimal:
|
|
60
|
+
|
|
61
|
+
- no branching logic
|
|
62
|
+
- no dynamic formatting
|
|
63
|
+
- no heavy structures
|
|
64
|
+
|
|
65
|
+
It returns a fixed tuple because the data is used once and immediately unpacked.
|
|
66
|
+
"""
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
from typing import 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 raise_default_is_defined_in_composition(
|
|
12
|
+
owner_class: "SimpleClassLike"
|
|
13
|
+
) -> None:
|
|
14
|
+
"""Raises an error when a composite defines '_default'."""
|
|
15
|
+
|
|
16
|
+
(
|
|
17
|
+
class_name,
|
|
18
|
+
class_parent,
|
|
19
|
+
error_name,
|
|
20
|
+
context,
|
|
21
|
+
) = _exception_info_for_default(owner_class)
|
|
22
|
+
|
|
23
|
+
raise SimpleDefinitionError(
|
|
24
|
+
error_name=error_name,
|
|
25
|
+
label="_default",
|
|
26
|
+
problem=(
|
|
27
|
+
f"The composite class '{class_name}' defines '_default', which is forbidden.",
|
|
28
|
+
),
|
|
29
|
+
expected="A composite class without '_default'.",
|
|
30
|
+
how_to_fix=(
|
|
31
|
+
"Remove '_default' from the class definition.",
|
|
32
|
+
"Composite objects compute their value via '_inners' and '_logic'.",
|
|
33
|
+
"If this class is meant to be a constant, remove '_inners' and '_logic'.",
|
|
34
|
+
),
|
|
35
|
+
context=context,
|
|
36
|
+
exception=TypeError,
|
|
37
|
+
)
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
_DESIGN_NOTES = """
|
|
41
|
+
# raise_default_is_defined_in_composition
|
|
42
|
+
|
|
43
|
+
## Purpose
|
|
44
|
+
Blocks composite objects (`SimpleObject`) from defining `_default`.
|
|
45
|
+
Composites compute their value dynamically from:
|
|
46
|
+
|
|
47
|
+
- `_inners` (structure),
|
|
48
|
+
- `_logic` (aggregation).
|
|
49
|
+
|
|
50
|
+
A manual `_default` would bypass this mechanism and break determinism.
|
|
51
|
+
|
|
52
|
+
## Why this validation exists
|
|
53
|
+
Composite objects represent structured data.
|
|
54
|
+
Their default state is derived from the defaults of their inner components.
|
|
55
|
+
If a composite defined `_default`, it would create:
|
|
56
|
+
|
|
57
|
+
- two competing sources of truth,
|
|
58
|
+
- unpredictable initialization,
|
|
59
|
+
- broken metadata consistency.
|
|
60
|
+
|
|
61
|
+
Therefore `_default` is strictly forbidden.
|
|
62
|
+
|
|
63
|
+
## Pipeline position
|
|
64
|
+
This guard is executed inside `SimpleObjectMetadata._process_user_data`.
|
|
65
|
+
It runs before inner fields are processed, ensuring early detection.
|
|
66
|
+
|
|
67
|
+
## Developer experience
|
|
68
|
+
The error message clearly explains:
|
|
69
|
+
|
|
70
|
+
- why `_default` is forbidden,
|
|
71
|
+
- how to fix the class,
|
|
72
|
+
- how to convert the class into a constant if that was the intention.
|
|
73
|
+
|
|
74
|
+
## Notes
|
|
75
|
+
This validator is used only for compositions.
|
|
76
|
+
Constants use `process_default_for_constant` instead.
|
|
77
|
+
|
|
78
|
+
"""
|