simplibs-object 0.1.1__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.1.dist-info/METADATA +590 -0
- simplibs_object-0.1.1.dist-info/RECORD +580 -0
- simplibs_object-0.1.1.dist-info/WHEEL +5 -0
- simplibs_object-0.1.1.dist-info/licenses/LICENSE +21 -0
- simplibs_object-0.1.1.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Inners
|
|
4
|
+
from ._core.metadata import SimpleMeta
|
|
5
|
+
# Annotations
|
|
6
|
+
if TYPE_CHECKING:
|
|
7
|
+
from ._core.protocols.metadata import SimpleMetadataLike
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
class SimpleBase(metaclass=SimpleMeta):
|
|
11
|
+
"""
|
|
12
|
+
Root base class for all Simple system declarative classes.
|
|
13
|
+
|
|
14
|
+
This class provides a unified identity for both constants and composite
|
|
15
|
+
objects. It establishes the connection to the `SimpleMeta` metaclass and
|
|
16
|
+
exposes the shared metadata interface used throughout the system.
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
# ----------------------------------------------------------------------
|
|
20
|
+
# 1) Structural foundation
|
|
21
|
+
# ----------------------------------------------------------------------
|
|
22
|
+
|
|
23
|
+
# Slots improve memory layout and runtime performance.
|
|
24
|
+
# All subclasses must define their own slots to preserve this benefit.
|
|
25
|
+
__slots__ = ()
|
|
26
|
+
|
|
27
|
+
# Metadata placeholder for system base classes.
|
|
28
|
+
# Declarative user classes receive computed metadata via SimpleMeta.
|
|
29
|
+
__metadata__: "SimpleMetadataLike" = UNSET
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
_DESIGN_NOTES = """
|
|
33
|
+
# SimpleBase — System Root Class
|
|
34
|
+
|
|
35
|
+
## Purpose
|
|
36
|
+
`SimpleBase` is the foundational class for the entire Simple object system.
|
|
37
|
+
Every declarative class—whether a constant (`SimpleConstant`) or a composite
|
|
38
|
+
(`SimpleObject`)—inherits from this base. It provides:
|
|
39
|
+
|
|
40
|
+
- a unified identity,
|
|
41
|
+
- a stable connection to the `SimpleMeta` metaclass,
|
|
42
|
+
- a shared metadata interface,
|
|
43
|
+
- structural guarantees for all descendants.
|
|
44
|
+
|
|
45
|
+
This class is intentionally minimal. Its role is architectural, not functional.
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## 1. Metaclass Integration
|
|
50
|
+
`SimpleBase` uses `SimpleMeta` as its metaclass. This ensures that all subclasses
|
|
51
|
+
automatically receive:
|
|
52
|
+
|
|
53
|
+
- metadata computation,
|
|
54
|
+
- write-once attribute protection,
|
|
55
|
+
- instance creation pipeline,
|
|
56
|
+
- technical and user-facing representations.
|
|
57
|
+
|
|
58
|
+
The metaclass is responsible for the entire lifecycle of declarative classes.
|
|
59
|
+
`SimpleBase` simply establishes the connection.
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## 2. Structural Slots
|
|
64
|
+
The class defines:
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
__slots__ = ()
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
This provides:
|
|
71
|
+
|
|
72
|
+
- reduced memory footprint,
|
|
73
|
+
- faster attribute access,
|
|
74
|
+
- predictable instance layout.
|
|
75
|
+
|
|
76
|
+
All subclasses must define their own `__slots__` to preserve these benefits.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## 3. Metadata Placeholder
|
|
81
|
+
The attribute:
|
|
82
|
+
|
|
83
|
+
```
|
|
84
|
+
__metadata__ = UNSET
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
serves as a placeholder for system base classes. Declarative user classes receive
|
|
88
|
+
their actual metadata during class creation via `SimpleMeta.__new__`.
|
|
89
|
+
|
|
90
|
+
This ensures:
|
|
91
|
+
|
|
92
|
+
- metadata always exists on every Simple class,
|
|
93
|
+
- metadata is never overwritten,
|
|
94
|
+
- metadata access is uniform across the system.
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## 4. Architectural Role
|
|
99
|
+
`SimpleBase` is not intended for direct use. It exists to:
|
|
100
|
+
|
|
101
|
+
- unify the inheritance hierarchy,
|
|
102
|
+
- provide a stable anchor for metaclass behavior,
|
|
103
|
+
- guarantee that all Simple classes share the same structural foundation.
|
|
104
|
+
|
|
105
|
+
It is the “root node” of the Simple ecosystem.
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Notes
|
|
110
|
+
- `SimpleBase` contains no public methods; all behavior is inherited from
|
|
111
|
+
`SimpleConstant`, `SimpleObject`, and the metaclass.
|
|
112
|
+
- This class is intentionally minimal to avoid polluting the public API.
|
|
113
|
+
- All future Simple system extensions will inherit from this base.
|
|
114
|
+
```
|
|
115
|
+
"""
|
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Inners
|
|
4
|
+
from .SimpleBase import SimpleBase
|
|
5
|
+
from ._core.logic.constant_methods import validate_type as _validate_type
|
|
6
|
+
from ._core.logic.constant_methods import validate as _validate
|
|
7
|
+
from ._core.logic.constant_methods import normalize as _normalize
|
|
8
|
+
from ._core.logic.constant_methods import bool_or_raise_validate_error as _bool_or_raise_validate_error
|
|
9
|
+
# Annotations
|
|
10
|
+
if TYPE_CHECKING:
|
|
11
|
+
from ._core.protocols.classes import SimpleConstantProtocol
|
|
12
|
+
from ._core.protocols.alias_typings import ValidTypes
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
class SimpleConstant(SimpleBase):
|
|
16
|
+
"""
|
|
17
|
+
Declarative base class for defining constant nodes in the Simple system.
|
|
18
|
+
|
|
19
|
+
A SimpleConstant represents a single typed value with:
|
|
20
|
+
- a declared type,
|
|
21
|
+
- a default value,
|
|
22
|
+
- optional extended validation logic.
|
|
23
|
+
|
|
24
|
+
Constants serve as the foundational building blocks for composite objects
|
|
25
|
+
(`SimpleObject`). They can also be used independently in other libraries
|
|
26
|
+
(e.g., validation frameworks) where typed, self-validating values are needed.
|
|
27
|
+
"""
|
|
28
|
+
|
|
29
|
+
# ----------------------------------------------------------------------
|
|
30
|
+
# 1) Declarative interface (user-defined)
|
|
31
|
+
# ----------------------------------------------------------------------
|
|
32
|
+
|
|
33
|
+
# Required type annotation for the constant's value.
|
|
34
|
+
# Must be provided by the user and must pass type validation.
|
|
35
|
+
_type: "ValidTypes" = UNSET
|
|
36
|
+
|
|
37
|
+
# Default value for the constant.
|
|
38
|
+
# Must be provided by the user and must pass type validation.
|
|
39
|
+
_default: Any = UNSET
|
|
40
|
+
|
|
41
|
+
@classmethod
|
|
42
|
+
def _validate(
|
|
43
|
+
cls,
|
|
44
|
+
value: Any,
|
|
45
|
+
*,
|
|
46
|
+
return_bool: bool = False,
|
|
47
|
+
) -> bool | Exception:
|
|
48
|
+
"""
|
|
49
|
+
Optional extended validation hook.
|
|
50
|
+
|
|
51
|
+
Users may override this method to provide additional validation beyond
|
|
52
|
+
basic type checking. The method may:
|
|
53
|
+
|
|
54
|
+
- return True/False,
|
|
55
|
+
- raise a custom exception,
|
|
56
|
+
- or use `bool_or_raise_validate_error` for structured error reporting.
|
|
57
|
+
|
|
58
|
+
If not overridden, the method defaults to accepting all values that
|
|
59
|
+
pass type validation.
|
|
60
|
+
"""
|
|
61
|
+
return True
|
|
62
|
+
|
|
63
|
+
# ----------------------------------------------------------------------
|
|
64
|
+
# 2) Public class-level API (deterministic, metadata-driven)
|
|
65
|
+
# ----------------------------------------------------------------------
|
|
66
|
+
|
|
67
|
+
@classmethod
|
|
68
|
+
def validate_type(
|
|
69
|
+
cls: "SimpleConstantProtocol",
|
|
70
|
+
value: Any,
|
|
71
|
+
*,
|
|
72
|
+
return_bool: bool = False,
|
|
73
|
+
) -> bool | None:
|
|
74
|
+
"""Perform deterministic type validation based on class metadata.
|
|
75
|
+
|
|
76
|
+
Args:
|
|
77
|
+
value: The value to validate against the constant's declared type.
|
|
78
|
+
return_bool: If True, return a boolean instead of raising errors.
|
|
79
|
+
|
|
80
|
+
Returns:
|
|
81
|
+
True if the value matches the declared type.
|
|
82
|
+
False if `return_bool=True` and the value is invalid.
|
|
83
|
+
None if `return_bool=False` and validation succeeds.
|
|
84
|
+
|
|
85
|
+
Raises:
|
|
86
|
+
SimpleRuntimeError: If `return_bool=False` and the value does not match the type.
|
|
87
|
+
"""
|
|
88
|
+
return _validate_type(cls, value, return_bool=return_bool)
|
|
89
|
+
|
|
90
|
+
@classmethod
|
|
91
|
+
def validate(
|
|
92
|
+
cls: "SimpleConstantProtocol",
|
|
93
|
+
value: Any,
|
|
94
|
+
*,
|
|
95
|
+
return_bool: bool = False,
|
|
96
|
+
) -> bool | None:
|
|
97
|
+
"""Perform full validation of the value.
|
|
98
|
+
|
|
99
|
+
Full validation includes:
|
|
100
|
+
- deterministic type validation,
|
|
101
|
+
- extended validation via `_validate`.
|
|
102
|
+
|
|
103
|
+
Args:
|
|
104
|
+
value: The value to validate.
|
|
105
|
+
return_bool: If True, return a boolean instead of raising errors.
|
|
106
|
+
|
|
107
|
+
Returns:
|
|
108
|
+
True if the value passes full validation.
|
|
109
|
+
False if `return_bool=True` and validation fails.
|
|
110
|
+
None if `return_bool=False` and validation succeeds.
|
|
111
|
+
|
|
112
|
+
Raises:
|
|
113
|
+
SimpleRuntimeError: If `return_bool=False` and validation fails.
|
|
114
|
+
"""
|
|
115
|
+
return _validate(cls, value, return_bool=return_bool)
|
|
116
|
+
|
|
117
|
+
@classmethod
|
|
118
|
+
def is_valid(
|
|
119
|
+
cls: "SimpleConstantProtocol",
|
|
120
|
+
value: Any,
|
|
121
|
+
) -> bool | None:
|
|
122
|
+
"""Check whether the value passes full validation.
|
|
123
|
+
|
|
124
|
+
This is a convenience wrapper around `validate(..., return_bool=True)`.
|
|
125
|
+
|
|
126
|
+
Args:
|
|
127
|
+
value: The value to validate.
|
|
128
|
+
|
|
129
|
+
Returns:
|
|
130
|
+
True if the value is valid, otherwise False.
|
|
131
|
+
"""
|
|
132
|
+
return cls.validate(value, return_bool=True)
|
|
133
|
+
|
|
134
|
+
@classmethod
|
|
135
|
+
def normalize(
|
|
136
|
+
cls: "SimpleConstantProtocol",
|
|
137
|
+
value: Any,
|
|
138
|
+
*,
|
|
139
|
+
process_none: bool = False,
|
|
140
|
+
) -> Any:
|
|
141
|
+
"""Normalize the value according to class metadata.
|
|
142
|
+
|
|
143
|
+
Normalization may include:
|
|
144
|
+
- default substitution,
|
|
145
|
+
- type enforcement,
|
|
146
|
+
- extended validation,
|
|
147
|
+
- optional handling of None values.
|
|
148
|
+
|
|
149
|
+
Args:
|
|
150
|
+
value: The value to normalize.
|
|
151
|
+
process_none: If True, None may be replaced by the default value.
|
|
152
|
+
|
|
153
|
+
Returns:
|
|
154
|
+
The normalized value.
|
|
155
|
+
|
|
156
|
+
Raises:
|
|
157
|
+
SimpleRuntimeError: If the value cannot be normalized or fails validation.
|
|
158
|
+
"""
|
|
159
|
+
return _normalize(cls, value, process_none=process_none)
|
|
160
|
+
|
|
161
|
+
@classmethod
|
|
162
|
+
def bool_or_raise_validate_error(
|
|
163
|
+
cls: "SimpleConstantProtocol",
|
|
164
|
+
value: Any,
|
|
165
|
+
problem: str,
|
|
166
|
+
*,
|
|
167
|
+
return_bool: bool = False,
|
|
168
|
+
) -> bool:
|
|
169
|
+
"""Helper for user-defined `_validate` methods.
|
|
170
|
+
|
|
171
|
+
This method allows concise validation logic while still providing structured
|
|
172
|
+
error reporting.
|
|
173
|
+
|
|
174
|
+
Args:
|
|
175
|
+
value: The value being validated.
|
|
176
|
+
problem: Human-readable description of the validation failure.
|
|
177
|
+
return_bool: If True, return False instead of raising an error.
|
|
178
|
+
|
|
179
|
+
Returns:
|
|
180
|
+
False if `return_bool=True`.
|
|
181
|
+
|
|
182
|
+
Raises:
|
|
183
|
+
SimpleRuntimeError: If `return_bool=False` and validation fails.
|
|
184
|
+
"""
|
|
185
|
+
return _bool_or_raise_validate_error(cls, value, problem, return_bool=return_bool)
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
_DESIGN_NOTES = """
|
|
189
|
+
# SimpleConstant — Declarative Constant Node
|
|
190
|
+
|
|
191
|
+
## Purpose
|
|
192
|
+
`SimpleConstant` defines the declarative interface for constant nodes in the
|
|
193
|
+
Simple system. A constant represents a single typed value with:
|
|
194
|
+
|
|
195
|
+
- a required type annotation (`_type`),
|
|
196
|
+
- a required default value (`_default`),
|
|
197
|
+
- optional extended validation logic (`_validate`).
|
|
198
|
+
|
|
199
|
+
Constants are used both independently and as inner elements of composite objects
|
|
200
|
+
(`SimpleObject`). They form the atomic building blocks of the Simple ecosystem.
|
|
201
|
+
|
|
202
|
+
---
|
|
203
|
+
|
|
204
|
+
## 1. Declarative Interface
|
|
205
|
+
|
|
206
|
+
### `_type`
|
|
207
|
+
A required type annotation describing the value the constant represents.
|
|
208
|
+
This type is enforced at runtime through deterministic type validation.
|
|
209
|
+
|
|
210
|
+
### `_default`
|
|
211
|
+
A required default value. The default must pass type validation and serves as the
|
|
212
|
+
fallback value during normalization.
|
|
213
|
+
|
|
214
|
+
### `_validate`
|
|
215
|
+
An optional user-defined validation method. It allows developers to extend
|
|
216
|
+
validation beyond basic type checking. The method may:
|
|
217
|
+
|
|
218
|
+
- return `True` or `False`,
|
|
219
|
+
- raise a custom exception,
|
|
220
|
+
- or use `bool_or_raise_validate_error` for structured error reporting.
|
|
221
|
+
|
|
222
|
+
This hook is especially useful when type validation alone is insufficient.
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
|
|
226
|
+
## 2. Public Class-Level API
|
|
227
|
+
|
|
228
|
+
The following methods are automatically attached to every `SimpleConstant`
|
|
229
|
+
through metadata processing:
|
|
230
|
+
|
|
231
|
+
### `validate_type`
|
|
232
|
+
Performs deterministic type validation based solely on metadata.
|
|
233
|
+
|
|
234
|
+
### `validate`
|
|
235
|
+
Performs full validation:
|
|
236
|
+
- type validation,
|
|
237
|
+
- extended validation via `_validate`.
|
|
238
|
+
|
|
239
|
+
### `is_valid`
|
|
240
|
+
Convenience wrapper returning a boolean result.
|
|
241
|
+
|
|
242
|
+
### `normalize`
|
|
243
|
+
Normalizes values according to metadata rules:
|
|
244
|
+
- default substitution,
|
|
245
|
+
- type enforcement,
|
|
246
|
+
- structured error reporting.
|
|
247
|
+
|
|
248
|
+
### `bool_or_raise_validate_error`
|
|
249
|
+
A helper for writing clean, structured validation logic inside `_validate`.
|
|
250
|
+
|
|
251
|
+
---
|
|
252
|
+
|
|
253
|
+
## 3. Architectural Role
|
|
254
|
+
|
|
255
|
+
`SimpleConstant` is the foundation of the Simple system:
|
|
256
|
+
|
|
257
|
+
- It provides typed, self-validating values.
|
|
258
|
+
- It forms the inner elements of composite objects.
|
|
259
|
+
- It ensures deterministic behavior through metadata.
|
|
260
|
+
- It exposes a stable, public API for validation and normalization.
|
|
261
|
+
|
|
262
|
+
Composite objects (`SimpleObject`) inherit from `SimpleConstant`, extending the
|
|
263
|
+
model with inner elements and composite logic.
|
|
264
|
+
|
|
265
|
+
---
|
|
266
|
+
|
|
267
|
+
## Notes
|
|
268
|
+
- `SimpleConstant` is declarative; it defines structure, not behavior.
|
|
269
|
+
- All runtime behavior is delegated to metadata and core logic functions.
|
|
270
|
+
- Constants are immutable by design and serve as stable building blocks.
|
|
271
|
+
"""
|
|
@@ -0,0 +1,293 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Inners
|
|
4
|
+
from .SimpleConstant import SimpleConstant
|
|
5
|
+
from ._core.protocols.methods import LogicSignature, P, R
|
|
6
|
+
from ._core.logic.object_methods import calculate_value as _calculate_value
|
|
7
|
+
from ._core.logic.object_methods import decompose_value as _decompose_value
|
|
8
|
+
# Annotations
|
|
9
|
+
if TYPE_CHECKING:
|
|
10
|
+
from ._core.protocols.classes import SimpleObjectProtocol
|
|
11
|
+
from ._core.protocols.alias_typings import ValidTypes, InnersTuple
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
class SimpleObject(SimpleConstant):
|
|
15
|
+
"""
|
|
16
|
+
Declarative base class for defining composite objects in the Simple system.
|
|
17
|
+
|
|
18
|
+
A composite object represents a structured value computed from inner
|
|
19
|
+
constant or composite nodes. It extends `SimpleConstant` with:
|
|
20
|
+
|
|
21
|
+
- a required `_inners` declaration,
|
|
22
|
+
- a required `_logic` method for computing the composite value,
|
|
23
|
+
- an optional `_decompose` method for reverse decomposition,
|
|
24
|
+
- an optional `_validate` method for extended validation.
|
|
25
|
+
|
|
26
|
+
Composite objects form the core of the Simple system and enable declarative,
|
|
27
|
+
type-safe, and metadata-driven computation.
|
|
28
|
+
"""
|
|
29
|
+
|
|
30
|
+
# ----------------------------------------------------------------------
|
|
31
|
+
# 1) Declarative interface (user-defined)
|
|
32
|
+
# ----------------------------------------------------------------------
|
|
33
|
+
|
|
34
|
+
# Required type annotation for the composite's computed value.
|
|
35
|
+
_type: "ValidTypes" = UNSET
|
|
36
|
+
|
|
37
|
+
# Required tuple of inner elements (constants or composite nodes).
|
|
38
|
+
_inners: "InnersTuple" = UNSET
|
|
39
|
+
|
|
40
|
+
@classmethod
|
|
41
|
+
def _logic(
|
|
42
|
+
cls,
|
|
43
|
+
*args,
|
|
44
|
+
**kwargs
|
|
45
|
+
) -> Any:
|
|
46
|
+
"""
|
|
47
|
+
Required computation hook for composite objects.
|
|
48
|
+
|
|
49
|
+
Users must override this method to define how the composite value is
|
|
50
|
+
computed from its inner elements. The method receives parameters
|
|
51
|
+
corresponding to `_inners` and must return a value that passes full
|
|
52
|
+
validation.
|
|
53
|
+
|
|
54
|
+
If not overridden, the method returns UNSET and metadata validation
|
|
55
|
+
will raise an error.
|
|
56
|
+
"""
|
|
57
|
+
return UNSET
|
|
58
|
+
|
|
59
|
+
@classmethod
|
|
60
|
+
def _decompose(
|
|
61
|
+
cls,
|
|
62
|
+
value: Any
|
|
63
|
+
) -> Any:
|
|
64
|
+
"""
|
|
65
|
+
Optional reverse-decomposition hook.
|
|
66
|
+
|
|
67
|
+
Users may override this method to support two-way composite behavior:
|
|
68
|
+
converting a composite value back into values for its inner elements.
|
|
69
|
+
|
|
70
|
+
This is useful for bidirectional models, but not required. If not
|
|
71
|
+
overridden, the method returns UNSET and the composite is treated as
|
|
72
|
+
non-decomposable.
|
|
73
|
+
"""
|
|
74
|
+
return UNSET
|
|
75
|
+
|
|
76
|
+
@classmethod
|
|
77
|
+
def _validate(
|
|
78
|
+
cls,
|
|
79
|
+
value: Any,
|
|
80
|
+
*,
|
|
81
|
+
return_bool: bool = False
|
|
82
|
+
) -> bool | Exception:
|
|
83
|
+
"""
|
|
84
|
+
Optional extended validation hook.
|
|
85
|
+
|
|
86
|
+
Users may override this method to provide additional validation beyond
|
|
87
|
+
basic type checking. The method may:
|
|
88
|
+
|
|
89
|
+
- return True/False,
|
|
90
|
+
- raise a custom exception,
|
|
91
|
+
- or use `bool_or_raise_validate_error` for structured error reporting.
|
|
92
|
+
|
|
93
|
+
If not overridden, the method defaults to accepting all values that
|
|
94
|
+
pass type validation.
|
|
95
|
+
"""
|
|
96
|
+
return True
|
|
97
|
+
|
|
98
|
+
# ----------------------------------------------------------------------
|
|
99
|
+
# 2) Public class-level API (metadata-driven)
|
|
100
|
+
# ----------------------------------------------------------------------
|
|
101
|
+
|
|
102
|
+
@classmethod
|
|
103
|
+
def calculate_value(
|
|
104
|
+
cls: LogicSignature[P, R],
|
|
105
|
+
*args: P.args,
|
|
106
|
+
**kwargs: P.kwargs
|
|
107
|
+
) -> R:
|
|
108
|
+
"""Compute the composite value using the class's `_logic` method.
|
|
109
|
+
|
|
110
|
+
This method:
|
|
111
|
+
- processes parameters according to metadata,
|
|
112
|
+
- validates inner values,
|
|
113
|
+
- invokes the user-defined `_logic`,
|
|
114
|
+
- returns the computed composite value.
|
|
115
|
+
|
|
116
|
+
Thanks to ParamSpec, IDEs (including PyCharm) provide autocompletion
|
|
117
|
+
for the parameters of `_logic`.
|
|
118
|
+
|
|
119
|
+
Args:
|
|
120
|
+
*args: Positional arguments mapped to inner elements.
|
|
121
|
+
**kwargs: Keyword arguments mapped to inner elements.
|
|
122
|
+
|
|
123
|
+
Returns:
|
|
124
|
+
The computed composite value.
|
|
125
|
+
|
|
126
|
+
Raises:
|
|
127
|
+
SimpleRuntimeError: If parameter processing or validation fails.
|
|
128
|
+
"""
|
|
129
|
+
return _calculate_value(cls, *args, **kwargs)
|
|
130
|
+
|
|
131
|
+
@classmethod
|
|
132
|
+
def decompose_value(
|
|
133
|
+
cls: "SimpleObjectProtocol",
|
|
134
|
+
value: Any
|
|
135
|
+
) -> Any:
|
|
136
|
+
"""Decompose a composite value into its inner components.
|
|
137
|
+
|
|
138
|
+
This method:
|
|
139
|
+
- validates the provided value,
|
|
140
|
+
- checks whether the composite supports decomposition,
|
|
141
|
+
- invokes the user-defined `_decompose` method,
|
|
142
|
+
- returns the decomposed representation.
|
|
143
|
+
|
|
144
|
+
Args:
|
|
145
|
+
value: The composite value to decompose.
|
|
146
|
+
|
|
147
|
+
Returns:
|
|
148
|
+
The decomposed representation of the value.
|
|
149
|
+
|
|
150
|
+
Raises:
|
|
151
|
+
SimpleRuntimeError: If the composite is not decomposable or
|
|
152
|
+
if validation fails.
|
|
153
|
+
"""
|
|
154
|
+
return _decompose_value(cls, value)
|
|
155
|
+
|
|
156
|
+
|
|
157
|
+
_DESIGN_NOTES = """
|
|
158
|
+
# SimpleObject — Declarative Composite Node
|
|
159
|
+
|
|
160
|
+
## Purpose
|
|
161
|
+
`SimpleObject` is the core declarative class for defining composite structures in
|
|
162
|
+
the Simple system. A composite object represents a value computed from multiple
|
|
163
|
+
inner elements (`_inners`) using a user-defined `_logic` method. It extends
|
|
164
|
+
`SimpleConstant` with structural composition, metadata-driven computation, and
|
|
165
|
+
optional bidirectional behavior.
|
|
166
|
+
|
|
167
|
+
Composite objects form the backbone of the Simple ecosystem, enabling declarative,
|
|
168
|
+
type-safe, and deterministic modeling of structured values.
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## 1. Declarative Interface
|
|
173
|
+
|
|
174
|
+
### `_type`
|
|
175
|
+
Required type annotation describing the composite's computed value. The result of
|
|
176
|
+
`_logic` must pass full validation against this type.
|
|
177
|
+
|
|
178
|
+
### `_inners`
|
|
179
|
+
Required tuple of inner elements. Each inner element is a `SimpleConstant` or
|
|
180
|
+
another `SimpleObject`. The structure of `_inners` determines:
|
|
181
|
+
|
|
182
|
+
- the parameters expected by `_logic`,
|
|
183
|
+
- the default value of the composite,
|
|
184
|
+
- the decomposition behavior (if supported),
|
|
185
|
+
- the metadata layout of the composite.
|
|
186
|
+
|
|
187
|
+
### `_logic`
|
|
188
|
+
Required computation hook. This method defines how the composite value is
|
|
189
|
+
computed from its inner elements. It receives parameters corresponding to
|
|
190
|
+
`_inners` and must return a value that passes full validation.
|
|
191
|
+
|
|
192
|
+
The default value of the composite is computed by invoking `_logic` with the
|
|
193
|
+
default values of all inner elements.
|
|
194
|
+
|
|
195
|
+
### `_decompose`
|
|
196
|
+
Optional reverse-decomposition hook. When implemented, this method converts a
|
|
197
|
+
composite value back into values for its inner elements. This enables
|
|
198
|
+
bidirectional models where both upward (inner → composite) and downward
|
|
199
|
+
(composite → inner) computation is supported.
|
|
200
|
+
|
|
201
|
+
If not implemented, the composite is treated as non-decomposable.
|
|
202
|
+
|
|
203
|
+
### `_validate`
|
|
204
|
+
Optional extended validation hook. Allows users to enforce additional validation
|
|
205
|
+
rules beyond basic type checking. The method may:
|
|
206
|
+
|
|
207
|
+
- return True/False,
|
|
208
|
+
- raise a custom exception,
|
|
209
|
+
- or use `bool_or_raise_validate_error` for structured error reporting.
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## 2. Metadata Behavior
|
|
214
|
+
|
|
215
|
+
Composite metadata differs from constant metadata in several key ways:
|
|
216
|
+
|
|
217
|
+
### Default Value
|
|
218
|
+
Unlike `SimpleConstant`, composite classes **must not** define `_default`.
|
|
219
|
+
If a user attempts to define `_default`, metadata processing raises a structured
|
|
220
|
+
error. The default value is always computed automatically using:
|
|
221
|
+
|
|
222
|
+
```
|
|
223
|
+
_logic(defaults_of_inners)
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
This ensures deterministic and consistent default propagation across composite
|
|
227
|
+
structures.
|
|
228
|
+
|
|
229
|
+
### Decomposability
|
|
230
|
+
Metadata determines whether the composite supports decomposition:
|
|
231
|
+
|
|
232
|
+
- If `_decompose` is implemented → `is_decomposeable = True`
|
|
233
|
+
- If `_decompose` is not implemented → `is_decomposeable = False`
|
|
234
|
+
|
|
235
|
+
This flag is used by `decompose_value` to enforce correct behavior.
|
|
236
|
+
|
|
237
|
+
### Inner Structure
|
|
238
|
+
Metadata validates:
|
|
239
|
+
|
|
240
|
+
- the structure of `_inners`,
|
|
241
|
+
- the compatibility of `_logic` parameters,
|
|
242
|
+
- the types of inner elements,
|
|
243
|
+
- the default propagation rules.
|
|
244
|
+
|
|
245
|
+
---
|
|
246
|
+
|
|
247
|
+
## 3. Public API
|
|
248
|
+
|
|
249
|
+
### `calculate_value`
|
|
250
|
+
Computes the composite value using:
|
|
251
|
+
|
|
252
|
+
1. parameter processing,
|
|
253
|
+
2. validation,
|
|
254
|
+
3. invocation of `_logic`.
|
|
255
|
+
|
|
256
|
+
This method is fully metadata-driven and provides IDE autocompletion for
|
|
257
|
+
`_logic` parameters via `ParamSpec`.
|
|
258
|
+
|
|
259
|
+
### `decompose_value`
|
|
260
|
+
Decomposes a composite value into its inner components. This method:
|
|
261
|
+
|
|
262
|
+
1. validates the provided value,
|
|
263
|
+
2. checks decomposability,
|
|
264
|
+
3. invokes `_decompose` if supported.
|
|
265
|
+
|
|
266
|
+
If the composite is not decomposable, a structured error is raised.
|
|
267
|
+
|
|
268
|
+
---
|
|
269
|
+
|
|
270
|
+
## 4. Architectural Role
|
|
271
|
+
|
|
272
|
+
`SimpleObject` is the flagship class of the Simple system. It provides:
|
|
273
|
+
|
|
274
|
+
- declarative composite modeling,
|
|
275
|
+
- deterministic default propagation,
|
|
276
|
+
- metadata-driven computation,
|
|
277
|
+
- optional bidirectional behavior,
|
|
278
|
+
- type-safe structured values,
|
|
279
|
+
- seamless integration with `SimpleConstant`.
|
|
280
|
+
|
|
281
|
+
Composite objects allow developers to define complex structures using simple,
|
|
282
|
+
readable, declarative Python classes.
|
|
283
|
+
|
|
284
|
+
---
|
|
285
|
+
|
|
286
|
+
## Notes
|
|
287
|
+
- Composite objects inherit all validation and normalization behavior from
|
|
288
|
+
`SimpleConstant`.
|
|
289
|
+
- `_logic` is always required; `_decompose` and `_validate` are optional.
|
|
290
|
+
- `_default` must never be defined on composite classes.
|
|
291
|
+
- All runtime behavior is delegated to metadata and core logic functions.
|
|
292
|
+
```
|
|
293
|
+
"""
|