simplibs-object 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- simplibs/object/SimpleBase.py +115 -0
- simplibs/object/SimpleConstant.py +271 -0
- simplibs/object/SimpleObject.py +293 -0
- simplibs/object/__init__.py +7 -0
- simplibs/object/_core/__init__.py +66 -0
- simplibs/object/_core/logic/__init__.py +0 -0
- simplibs/object/_core/logic/constant_methods/__init__.py +22 -0
- simplibs/object/_core/logic/constant_methods/bool_or_raise_validate_error.py +76 -0
- simplibs/object/_core/logic/constant_methods/normalize.py +92 -0
- simplibs/object/_core/logic/constant_methods/validate.py +99 -0
- simplibs/object/_core/logic/constant_methods/validate_type.py +48 -0
- simplibs/object/_core/logic/constant_methods/validations/__init__.py +22 -0
- simplibs/object/_core/logic/constant_methods/validations/_extract_clean_code_lines.py +86 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_missing_value_error.py +71 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_type_error.py +59 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_unexpected_validation_error.py +66 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_validation_error.py +78 -0
- simplibs/object/_core/logic/object_methods/__init__.py +18 -0
- simplibs/object/_core/logic/object_methods/_process_calculate_value_params.py +108 -0
- simplibs/object/_core/logic/object_methods/calculate_value.py +81 -0
- simplibs/object/_core/logic/object_methods/decompose_value.py +91 -0
- simplibs/object/_core/logic/object_methods/validations/__init__.py +22 -0
- simplibs/object/_core/logic/object_methods/validations/raise_class_not_decomposeable.py +82 -0
- simplibs/object/_core/logic/object_methods/validations/raise_duplicate_argument_error.py +77 -0
- simplibs/object/_core/logic/object_methods/validations/raise_too_many_positional_args_error.py +81 -0
- simplibs/object/_core/logic/object_methods/validations/raise_unknown_parameter_error.py +77 -0
- simplibs/object/_core/logic/property_builders/__init__.py +20 -0
- simplibs/object/_core/logic/property_builders/create_instance_property.py +66 -0
- simplibs/object/_core/logic/property_builders/create_properties_for_inner.py +97 -0
- simplibs/object/_core/logic/property_builders/create_value_property.py +98 -0
- simplibs/object/_core/logic/property_builders/value_helpers/__init__.py +18 -0
- simplibs/object/_core/logic/property_builders/value_helpers/create_value_getter.py +52 -0
- simplibs/object/_core/logic/property_builders/value_helpers/create_value_setter.py +95 -0
- simplibs/object/_core/logic/property_builders/value_helpers/validations/__init__.py +16 -0
- simplibs/object/_core/logic/property_builders/value_helpers/validations/raise_locked_value_error.py +103 -0
- simplibs/object/_core/metadata/SimpleBaseMetadata.py +139 -0
- simplibs/object/_core/metadata/SimpleConstantMetadata.py +108 -0
- simplibs/object/_core/metadata/SimpleMeta.py +214 -0
- simplibs/object/_core/metadata/SimpleObjectMetadata.py +165 -0
- simplibs/object/_core/metadata/__init__.py +16 -0
- simplibs/object/_core/metadata/constants/BASE_CLASS_NAMES.py +23 -0
- simplibs/object/_core/metadata/constants/__init__.py +16 -0
- simplibs/object/_core/metadata/init_processors/__init__.py +47 -0
- simplibs/object/_core/metadata/init_processors/blueprint_path/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/blueprint_path/calculate_blueprint_path.py +81 -0
- simplibs/object/_core/metadata/init_processors/default/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/default/process_default_for_constant.py +71 -0
- simplibs/object/_core/metadata/init_processors/default/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/default/validations/_exception_info_for_default.py +66 -0
- simplibs/object/_core/metadata/init_processors/default/validations/raise_default_is_defined_in_composition.py +78 -0
- simplibs/object/_core/metadata/init_processors/default/validations/validate_default_is_defined.py +77 -0
- simplibs/object/_core/metadata/init_processors/default/validations/validate_default_matches_annotation.py +93 -0
- simplibs/object/_core/metadata/init_processors/inners/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/inners/process_inners.py +143 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/__init__.py +33 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/_exception_info_for_inners.py +43 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/_get_collision_path.py +45 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_collision_within_inners.py +78 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_if_collision_with_owner_class.py +66 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_class.py +58 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_not_simple_class.py +60 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_simple_subclass.py +61 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_defined.py +56 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_not_empty.py +57 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_tuple.py +57 -0
- simplibs/object/_core/metadata/init_processors/methods/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/process_classmethod.py +130 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/__init__.py +16 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/exception_info_for_classmethod.py +52 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/expected_structure_for_classmethod.py +80 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/_convert_annotation_to_type_set.py +38 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_annotations.py +84 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_args_defaults.py +76 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_kwargs_defaults.py +74 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/verify_annotations_and_defaults.py +100 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/raise_decompose_unvalide_outcome_length.py +64 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_type.py +77 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_value.py +72 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/verify_decompose_outcome.py +87 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_raised_exceptions.py +56 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_return_unvalide_outcome_type.py +80 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/verify_calculation.py +89 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/_clone_classmethod.py +81 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_callable.py +60 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_classmethod.py +60 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_defined.py +67 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/verify_classmethod.py +117 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_has_exact_args_count.py +59 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_not_use_param_placeholders.py +66 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_param_match_expected.py +61 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/verify_params.py +123 -0
- simplibs/object/_core/metadata/init_processors/names/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/names/_class_name_splitter.py +242 -0
- simplibs/object/_core/metadata/init_processors/names/create_names.py +119 -0
- simplibs/object/_core/metadata/init_processors/names/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_has_no_underscores.py +94 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_ascii.py +95 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_identifier.py +83 -0
- simplibs/object/_core/metadata/init_processors/type/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/type/process_type.py +117 -0
- simplibs/object/_core/metadata/init_processors/type/validations/__init__.py +29 -0
- simplibs/object/_core/metadata/init_processors/type/validations/_exception_info_for_type.py +88 -0
- simplibs/object/_core/metadata/init_processors/type/validations/raise_union_type_contain_none.py +70 -0
- simplibs/object/_core/metadata/init_processors/type/validations/raise_validate_type_is_not_valid.py +92 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_from_tuple_is_not_none.py +94 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_defined.py +85 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_empty.py +93 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_none.py +87 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_tuple_is_not_nested.py +92 -0
- simplibs/object/_core/metadata/instance_builders/__init__.py +55 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/InstanceBase.py +77 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/__init__.py +16 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/__init__.py +16 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_atom_init.py +51 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_root_value_setter.py +67 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/make_atom_class.py +101 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/__init__.py +14 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/__init__.py +20 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/_get_inner_instance_class.py +51 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_composite_init.py +74 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_properties_for_inners.py +50 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_inners.py +57 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_self.py +69 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/make_composite_class.py +93 -0
- simplibs/object/_core/metadata/instance_builders/instance/__init__.py +17 -0
- simplibs/object/_core/metadata/instance_builders/instance/create_instance.py +107 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/__init__.py +25 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_combined_init_mixins.py +40 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_instance_class_dict.py +127 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_extend_instance_class.py +59 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_resolve_flat_mixins.py +74 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_verify_mixin_compatibility.py +83 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/create_instance_class.py +76 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/get_base_class.py +53 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/__init__.py +20 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/__init__.py +29 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_composite.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_constant.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_immutable.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_mutable.py +60 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_support_default_value_type.py +66 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_class.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_simple_base_subclass.py +60 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_invalide_extend_instance_class_definition.py +62 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision_with_base_class.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/__init__.py +21 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_class_is_not_base_class.py +54 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_hashing_for_immutable_value.py +66 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_param_is_bool.py +47 -0
- simplibs/object/_core/metadata/validations/__init__.py +18 -0
- simplibs/object/_core/metadata/validations/raise_attribut_allready_set.py +57 -0
- simplibs/object/_core/metadata/validations/raise_metadata_is_immutable.py +73 -0
- simplibs/object/_core/protocols/__init__.py +118 -0
- simplibs/object/_core/protocols/alias_typings/__init__.py +137 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangeTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangesDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangesTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/changes/__init__.py +18 -0
- simplibs/object/_core/protocols/alias_typings/history/HistoryDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/history/HistoryEntry.py +10 -0
- simplibs/object/_core/protocols/alias_typings/history/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/inners/InnersMap.py +8 -0
- simplibs/object/_core/protocols/alias_typings/inners/InnersTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/inners/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/mixins/MixinsTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/mixins/__init__.py +14 -0
- simplibs/object/_core/protocols/alias_typings/names/NamesSet.py +5 -0
- simplibs/object/_core/protocols/alias_typings/names/NamesTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/names/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodeItem.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesIndexMap.py +6 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesInstanceDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesPathDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/nodes/__init__.py +24 -0
- simplibs/object/_core/protocols/alias_typings/paths/PathDict.py +8 -0
- simplibs/object/_core/protocols/alias_typings/paths/PathTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/paths/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffItem.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/__init__.py +20 -0
- simplibs/object/_core/protocols/alias_typings/state/StateDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/state/__init__.py +14 -0
- simplibs/object/_core/protocols/alias_typings/types/ValidTypes.py +6 -0
- simplibs/object/_core/protocols/alias_typings/types/__init__.py +14 -0
- simplibs/object/_core/protocols/classes/SimpleBaseProtocol.py +25 -0
- simplibs/object/_core/protocols/classes/SimpleConstantProtocol.py +54 -0
- simplibs/object/_core/protocols/classes/SimpleObjectProtocol.py +50 -0
- simplibs/object/_core/protocols/classes/__init__.py +26 -0
- simplibs/object/_core/protocols/instance/SimpleConstantInstanceProtocol.py +13 -0
- simplibs/object/_core/protocols/instance/SimpleInstanceBaseProtocol.py +24 -0
- simplibs/object/_core/protocols/instance/SimpleObjectInstanceProtocol.py +13 -0
- simplibs/object/_core/protocols/instance/__init__.py +29 -0
- simplibs/object/_core/protocols/instance/core_classes/AtomInstanceProtocol.py +46 -0
- simplibs/object/_core/protocols/instance/core_classes/CompositeInstanceProtocol.py +37 -0
- simplibs/object/_core/protocols/instance/core_classes/InstanceBaseProtocol.py +28 -0
- simplibs/object/_core/protocols/instance/core_classes/__init__.py +19 -0
- simplibs/object/_core/protocols/metadata/SimpleBaseMetadataProtocol.py +37 -0
- simplibs/object/_core/protocols/metadata/SimpleConstantMetadataProtocol.py +45 -0
- simplibs/object/_core/protocols/metadata/SimpleMetaProtocol.py +39 -0
- simplibs/object/_core/protocols/metadata/SimpleObjectMetadataProtocol.py +49 -0
- simplibs/object/_core/protocols/metadata/__init__.py +28 -0
- simplibs/object/_core/protocols/methods/ClassMethodProtocol.py +29 -0
- simplibs/object/_core/protocols/methods/LogicSignature.py +20 -0
- simplibs/object/_core/protocols/methods/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/__init__.py +120 -0
- simplibs/object/_core/protocols/mixins/base_class/SimpleMixinProtocol.py +46 -0
- simplibs/object/_core/protocols/mixins/base_class/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/core_mixins/InfrastructureProtocol.py +16 -0
- simplibs/object/_core/protocols/mixins/core_mixins/NodesDictsProtocol.py +38 -0
- simplibs/object/_core/protocols/mixins/core_mixins/NodesTupleProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/core_mixins/SerializationProtocol.py +55 -0
- simplibs/object/_core/protocols/mixins/core_mixins/SnapshotProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/core_mixins/__init__.py +27 -0
- simplibs/object/_core/protocols/mixins/dunders/__init__.py +123 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/CollectionBaseProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/CollectionProtocol.py +20 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/IterableProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/MappingProtocol.py +52 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/__init__.py +21 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/EqualityProtocol.py +31 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/OrderingProtocol.py +32 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/generics/ClassGetItemProtocol.py +23 -0
- simplibs/object/_core/protocols/mixins/dunders/generics/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/CallProtocol.py +26 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/ContextProtocol.py +38 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/CopyableProtocol.py +33 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/LifecycleProtocol.py +21 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleReduceProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleStateProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/__init__.py +20 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/PicklePlan.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/ArithmeticProtocol.py +95 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/BitwiseProtocol.py +79 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/ConversionProtocol.py +57 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/InplaceProtocol.py +66 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/UnaryProtocol.py +35 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/__init__.py +22 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/Operator.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/UnaryOperator.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/ValueDisplayProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/ValueFormattingProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsProtocol.py +69 -0
- simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsWithInnersProtocol.py +27 -0
- simplibs/object/_core/protocols/mixins/immutable/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/numerical/EqualizerProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/numerical/VolumeProtocol.py +32 -0
- simplibs/object/_core/protocols/mixins/numerical/__init__.py +17 -0
- simplibs/object/_core/protocols/mixins/numerical/internal_types/SteppersMap.py +8 -0
- simplibs/object/_core/protocols/mixins/numerical/internal_types/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/StepperProtocol.py +95 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/LimitAction.py +5 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/StepValue.py +6 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/properties/InnersPropertyProtocol.py +31 -0
- simplibs/object/_core/protocols/mixins/properties/MetaShortcutsProtocol.py +49 -0
- simplibs/object/_core/protocols/mixins/properties/__init__.py +17 -0
- simplibs/object/_core/protocols/mixins/state/DefaultStateProtocol.py +41 -0
- simplibs/object/_core/protocols/mixins/state/DirtyTrackingProtocol.py +61 -0
- simplibs/object/_core/protocols/mixins/state/HistoryProtocol.py +112 -0
- simplibs/object/_core/protocols/mixins/state/PermissionProtocol.py +35 -0
- simplibs/object/_core/protocols/mixins/state/__init__.py +22 -0
- simplibs/object/exceptions/SimpleDefinitionError.py +45 -0
- simplibs/object/exceptions/SimpleInitializationError.py +43 -0
- simplibs/object/exceptions/SimpleRuntimeError.py +50 -0
- simplibs/object/exceptions/__init__.py +62 -0
- simplibs/object/exceptions/base_exception/SimpleObjectError.py +107 -0
- simplibs/object/exceptions/base_exception/__init__.py +19 -0
- simplibs/object/mixins/__init__.py +99 -0
- simplibs/object/mixins/_common_logic/__init__.py +41 -0
- simplibs/object/mixins/_common_logic/constants/__init__.py +27 -0
- simplibs/object/mixins/_common_logic/constants/names/HISTORY.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/OWNER_CLASS.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/STEPPER.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/VALUE.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/__init__.py +28 -0
- simplibs/object/mixins/_common_logic/constants/sets/FORBIDDEN_NAMES.py +27 -0
- simplibs/object/mixins/_common_logic/constants/sets/RESTRICTION_FLAGS.py +18 -0
- simplibs/object/mixins/_common_logic/constants/sets/__init__.py +22 -0
- simplibs/object/mixins/_common_logic/immutability/__init__.py +28 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/__init__.py +22 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/get_top_composite_paths.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/process_single_change.py +143 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_changes.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths.py +147 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths2.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/__init__.py +23 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_split_changes_unknown_name.py +107 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_with_any_unknown_name.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/__init__.py +24 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_changes_is_not_tuple.py +65 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_child_composite_mismatch.py +68 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_contained_constant_mismatch.py +67 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/with_any.py +238 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/utils/__init__.py +15 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/utils/reacalculate_inners.py +112 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/__init__.py +21 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_is_decomposeable.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_name_exists.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/with_composite.py +176 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/__init__.py +20 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_new_instance.py +130 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_snapshot_dict.py +83 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/reacalculate_owner_value.py +131 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/__init__.py +16 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/raise_immutability_constant_not_found.py +93 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/with_constant.py +147 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/utils/__init__.py +15 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/utils/find_longest_keys.py +112 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/__init__.py +25 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_batch_constant_not_found.py +94 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_constants_changes_not_tuple.py +94 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_has_length_two.py +91 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_is_tuple.py +99 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_name_is_str.py +90 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/with_constants.py +193 -0
- simplibs/object/mixins/base_class/SimpleMixin.py +118 -0
- simplibs/object/mixins/base_class/__init__.py +17 -0
- simplibs/object/mixins/base_class/_meta/SimpleMixinMeta.py +59 -0
- simplibs/object/mixins/base_class/_meta/__init__.py +21 -0
- simplibs/object/mixins/base_class/_meta/_verify_mixin_definition.py +161 -0
- simplibs/object/mixins/base_class/_meta/validations/__init__.py +34 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_dict_contains_forbidden_attributes.py +101 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_flag_is_not_bool.py +122 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_init_mixins_contains_super_call.py +75 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_only_types_invalid.py +107 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contain_unvalid_type.py +85 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contains_forbidden_slot_names.py +102 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_is_not_defined.py +79 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_unsuport_type.py +88 -0
- simplibs/object/mixins/core_mixins/Infrastructure.py +49 -0
- simplibs/object/mixins/core_mixins/NodesDicts.py +104 -0
- simplibs/object/mixins/core_mixins/NodesTuple.py +86 -0
- simplibs/object/mixins/core_mixins/Serialization.py +120 -0
- simplibs/object/mixins/core_mixins/Snapshot.py +104 -0
- simplibs/object/mixins/core_mixins/__init__.py +32 -0
- simplibs/object/mixins/core_mixins/_utils/__init__.py +49 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/__init__.py +17 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/_collect_nodes_data.py +131 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/build_nodes_tuple.py +104 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/__init__.py +20 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/from_dict.py +190 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/from_dict_constants.py +151 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/to_dict.py +158 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/__init__.py +30 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_invalid_composite_structure.py +65 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_composite_key.py +64 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_value_key.py +66 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_owner_class_mismatch_for_state_dict.py +77 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_state_dict_input.py +67 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/__init__.py +15 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/compare_snapshots.py +102 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/validations/__init__.py +16 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/validations/raise_snapshot_incompatible_error.py +101 -0
- simplibs/object/mixins/dunders/__init__.py +61 -0
- simplibs/object/mixins/dunders/collections/CollectionBase.py +129 -0
- simplibs/object/mixins/dunders/collections/Iterable.py +81 -0
- simplibs/object/mixins/dunders/collections/Mapping.py +131 -0
- simplibs/object/mixins/dunders/collections/__init__.py +29 -0
- simplibs/object/mixins/dunders/collections/main/Collection.py +47 -0
- simplibs/object/mixins/dunders/collections/main/__init__.py +20 -0
- simplibs/object/mixins/dunders/comparison/Equality.py +128 -0
- simplibs/object/mixins/dunders/comparison/Ordering.py +130 -0
- simplibs/object/mixins/dunders/comparison/__init__.py +25 -0
- simplibs/object/mixins/dunders/generics/ClassGetItem.py +105 -0
- simplibs/object/mixins/dunders/generics/__init__.py +20 -0
- simplibs/object/mixins/dunders/interfaces/Call.py +101 -0
- simplibs/object/mixins/dunders/interfaces/Context.py +100 -0
- simplibs/object/mixins/dunders/interfaces/__init__.py +23 -0
- simplibs/object/mixins/dunders/lifecycles/Copyable.py +103 -0
- simplibs/object/mixins/dunders/lifecycles/PickleReduce.py +88 -0
- simplibs/object/mixins/dunders/lifecycles/PickleState.py +104 -0
- simplibs/object/mixins/dunders/lifecycles/__init__.py +29 -0
- simplibs/object/mixins/dunders/lifecycles/_utils/__init__.py +20 -0
- simplibs/object/mixins/dunders/lifecycles/_utils/rebuild_simple_instance.py +51 -0
- simplibs/object/mixins/dunders/lifecycles/main/Lifecycle.py +45 -0
- simplibs/object/mixins/dunders/lifecycles/main/__init__.py +20 -0
- simplibs/object/mixins/dunders/numeric/Arithmetic.py +195 -0
- simplibs/object/mixins/dunders/numeric/Bitwise.py +172 -0
- simplibs/object/mixins/dunders/numeric/Conversion.py +149 -0
- simplibs/object/mixins/dunders/numeric/Inplace.py +124 -0
- simplibs/object/mixins/dunders/numeric/Unary.py +89 -0
- simplibs/object/mixins/dunders/numeric/__init__.py +31 -0
- simplibs/object/mixins/dunders/numeric/_utils/__init__.py +41 -0
- simplibs/object/mixins/dunders/numeric/_utils/_align_operand_type.py +111 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_arithmetic_op.py +157 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_bitwise_op.py +116 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_conversion.py +107 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_inplace_op.py +139 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_unary_op.py +121 -0
- simplibs/object/mixins/dunders/representation/ValueDisplay.py +96 -0
- simplibs/object/mixins/dunders/representation/ValueFormatting.py +144 -0
- simplibs/object/mixins/dunders/representation/__init__.py +24 -0
- simplibs/object/mixins/others/__init__.py +48 -0
- simplibs/object/mixins/others/immutable/ImmutableMethods.py +142 -0
- simplibs/object/mixins/others/immutable/ImmutableMethodsWithInners.py +111 -0
- simplibs/object/mixins/others/immutable/__init__.py +24 -0
- simplibs/object/mixins/others/immutable/_validations/__init__.py +19 -0
- simplibs/object/mixins/others/immutable/_validations/raise_with_changes_input_not_dict.py +60 -0
- simplibs/object/mixins/others/numerical/Equalizer.py +129 -0
- simplibs/object/mixins/others/numerical/Volume.py +100 -0
- simplibs/object/mixins/others/numerical/__init__.py +25 -0
- simplibs/object/mixins/others/numerical/_stepper_class/Stepper.py +227 -0
- simplibs/object/mixins/others/numerical/_stepper_class/__init__.py +31 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/__init__.py +35 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/__init__.py +33 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/process_step_value.py +114 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/__init__.py +29 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_down_limit_reached.py +115 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_up_limit_reached.py +110 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_down_limit.py +141 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_up_limit.py +141 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/set_value.py +163 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/step_down.py +154 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/step_up.py +154 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/__init__.py +38 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_down_limit_value.py +143 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_limit_action.py +118 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_up_limit_value.py +143 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_value.py +142 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validate_instance.py +138 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/__init__.py +39 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_action.py +118 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_down_limit.py +125 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_instance.py +117 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_up_limit.py +125 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_non_numeric_value.py +122 -0
- simplibs/object/mixins/others/properties/InnersProperty.py +91 -0
- simplibs/object/mixins/others/properties/MetaShortcuts.py +113 -0
- simplibs/object/mixins/others/properties/__init__.py +24 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/__init__.py +23 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/_collect_nested_inner_properties.py +134 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/collect_all_nested_properties.py +132 -0
- simplibs/object/mixins/others/state/DefaultState.py +119 -0
- simplibs/object/mixins/others/state/DirtyTracking.py +144 -0
- simplibs/object/mixins/others/state/History.py +248 -0
- simplibs/object/mixins/others/state/Permission.py +102 -0
- simplibs/object/mixins/others/state/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/__init__.py +50 -0
- simplibs/object/mixins/others/state/_history_utils/core/__init__.py +32 -0
- simplibs/object/mixins/others/state/_history_utils/core/find_snapshot.py +142 -0
- simplibs/object/mixins/others/state/_history_utils/core/record_state.py +130 -0
- simplibs/object/mixins/others/state/_history_utils/core/set_history_limit.py +114 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_history_limit_not_positive_integer.py +65 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snapshot_index.py +67 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_reference.py +67 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_timestamp.py +66 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_timestamp.py +63 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/__init__.py +38 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_index.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_timestamp.py +115 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_last_history.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/history_redo.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/history_undo.py +104 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/export_history_to_dict.py +110 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/import_history_from_dict.py +169 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/__init__.py +24 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_history_import_file.py +66 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_owner_class_mismatch.py +69 -0
- simplibs/object/settings/__init__.py +90 -0
- simplibs/object/settings/logging.py +138 -0
- simplibs/object/testing/__init__.py +90 -0
- simplibs/object/testing/assert_simple_mixin.py +150 -0
- simplibs/object/testing/assert_simple_object.py +219 -0
- simplibs/object/testing/asserts/__init__.py +53 -0
- simplibs/object/testing/asserts/base/__init__.py +22 -0
- simplibs/object/testing/asserts/base/assert_class_inheritance.py +75 -0
- simplibs/object/testing/asserts/base/assert_instance_creation.py +119 -0
- simplibs/object/testing/asserts/base/assert_user_instance_creation.py +97 -0
- simplibs/object/testing/asserts/base/assert_value_change.py +142 -0
- simplibs/object/testing/asserts/methods/__init__.py +20 -0
- simplibs/object/testing/asserts/methods/assert_calculate_value_method.py +113 -0
- simplibs/object/testing/asserts/methods/assert_decompose_value_method.py +109 -0
- simplibs/object/testing/asserts/methods/assert_validate_method.py +111 -0
- simplibs/object/testing/asserts/mixins/__init__.py +22 -0
- simplibs/object/testing/asserts/mixins/assert_instance_hasattr.py +94 -0
- simplibs/object/testing/asserts/mixins/assert_mixin_inheritance.py +72 -0
- simplibs/object/testing/asserts/mixins/assert_mixin_instance_creation.py +142 -0
- simplibs/object/testing/asserts/mixins/assert_mixins_slots_values.py +126 -0
- simplibs/object/testing/asserts/mutability/__init__.py +18 -0
- simplibs/object/testing/asserts/mutability/assert_immutable_behavior.py +118 -0
- simplibs/object/testing/asserts/mutability/assert_mutable_behavior.py +108 -0
- simplibs/object/testing/asserts/reactivity/__init__.py +17 -0
- simplibs/object/testing/asserts/reactivity/assert_reactivity_downward.py +141 -0
- simplibs/object/testing/asserts/reactivity/assert_reactivity_upward.py +109 -0
- simplibs/object/testing/bulk_test.py +150 -0
- simplibs/object/testing/containers/InnerValue.py +102 -0
- simplibs/object/testing/containers/MixinCase.py +89 -0
- simplibs/object/testing/containers/ObjectCase.py +101 -0
- simplibs/object/testing/containers/TestMixin.py +122 -0
- simplibs/object/testing/containers/__init__.py +20 -0
- simplibs/object/testing/containers/_validations/__init__.py +18 -0
- simplibs/object/testing/containers/_validations/raise_inner_value_empty_path.py +39 -0
- simplibs/object/testing/containers/_validations/raise_inner_value_invalid_path_type.py +44 -0
- simplibs/object/tools/__init__.py +0 -0
- simplibs/object/tools/automate_creators/__init__.py +0 -0
- simplibs/object/tools/automate_creators/_helpers/__init__.py +5 -0
- simplibs/object/tools/automate_creators/_helpers/_is_lambda.py +34 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/__init__.py +3 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_calculate_default_failed.py +51 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_inner_is_not_simple_constant_subclass.py +44 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_inners_is_not_tuple.py +41 -0
- simplibs/object/tools/automate_creators/_helpers/calculate_default.py +51 -0
- simplibs/object/tools/automate_creators/_helpers/load_parameters_from_inners.py +72 -0
- simplibs/object/tools/automate_creators/_helpers/process_decompose.py +47 -0
- simplibs/object/tools/automate_creators/_helpers/process_logic.py +57 -0
- simplibs/object/tools/automate_creators/_helpers/process_validate.py +48 -0
- simplibs/object/tools/automate_creators/_validations/__init__.py +7 -0
- simplibs/object/tools/automate_creators/_validations/validate_class_name_is_str.py +36 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_inners.py +43 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_logic.py +44 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_not_default.py +37 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_default.py +48 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_decompose.py +37 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_logic.py +37 -0
- simplibs/object/tools/automate_creators/bulk/BulkCase.py +100 -0
- simplibs/object/tools/automate_creators/bulk/__init__.py +0 -0
- simplibs/object/tools/automate_creators/bulk/create_simple_object_bulk.py +77 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/__init__.py +0 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/__init__.py +8 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_csv_callable_not_supported.py +26 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_data_not_list.py +28 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_decode_failed.py +29 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_sequence.py +27 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_str.py +28 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_item_is_not_bulk_dict.py +39 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_table_row_not_sequence.py +26 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_yaml_import_failed.py +22 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_bulk_case_class.py +57 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_csv.py +68 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_dicts.py +19 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_json.py +24 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_table.py +43 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_yaml.py +29 -0
- simplibs/object/tools/automate_creators/create_constant_class.py +84 -0
- simplibs/object/tools/automate_creators/create_object_class.py +110 -0
- simplibs/object/tools/automate_creators/create_simple_object.py +97 -0
- simplibs/object/tools/randomize/__init__.py +18 -0
- simplibs/object/tools/randomize/_validations/__init__.py +28 -0
- simplibs/object/tools/randomize/_validations/raise_random_data_filler_exhausted.py +55 -0
- simplibs/object/tools/randomize/_validations/validate_instance_is_simple_constant_base.py +52 -0
- simplibs/object/tools/randomize/_validations/validate_registry_is_randomize_registry_base.py +51 -0
- simplibs/object/tools/randomize/_validations/validate_retries_is_greater_than_zero.py +48 -0
- simplibs/object/tools/randomize/_validations/validate_retries_is_int.py +49 -0
- simplibs/object/tools/randomize/_validations/validate_skip_immutable_is_bool.py +43 -0
- simplibs/object/tools/randomize/_validations/validate_skip_unregistered_is_bool.py +44 -0
- simplibs/object/tools/randomize/random_data_filler.py +133 -0
- simplibs/object/tools/randomize/randomize_value.py +122 -0
- simplibs_object-0.1.0.dist-info/METADATA +590 -0
- simplibs_object-0.1.0.dist-info/RECORD +580 -0
- simplibs_object-0.1.0.dist-info/WHEEL +5 -0
- simplibs_object-0.1.0.dist-info/licenses/LICENSE +21 -0
- simplibs_object-0.1.0.dist-info/top_level.txt +1 -0
simplibs/object/_core/metadata/init_processors/type/validations/raise_union_type_contain_none.py
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
from typing import NoReturn, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_type import _exception_info_for_type
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def raise_union_type_contain_none(
|
|
13
|
+
owner_class: "SimpleClassLike"
|
|
14
|
+
) -> NoReturn:
|
|
15
|
+
"""Raises an error when a UnionType contains NoneType."""
|
|
16
|
+
|
|
17
|
+
(
|
|
18
|
+
class_name,
|
|
19
|
+
class_parent,
|
|
20
|
+
error_name,
|
|
21
|
+
context,
|
|
22
|
+
acceptable_definitions,
|
|
23
|
+
) = _exception_info_for_type(owner_class)
|
|
24
|
+
|
|
25
|
+
raise SimpleDefinitionError(
|
|
26
|
+
error_name=error_name,
|
|
27
|
+
label="_type",
|
|
28
|
+
problem=(
|
|
29
|
+
f"The UnionType definition for class '{class_name}' contains NoneType.",
|
|
30
|
+
),
|
|
31
|
+
expected="A UnionType without NoneType or literal None.",
|
|
32
|
+
how_to_fix=(
|
|
33
|
+
"Remove NoneType or literal None from the union expression.",
|
|
34
|
+
"Use only real, concrete types in the union.",
|
|
35
|
+
) + acceptable_definitions,
|
|
36
|
+
context=context,
|
|
37
|
+
exception=TypeError,
|
|
38
|
+
)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
_DESIGN_NOTES = """
|
|
42
|
+
# raise_union_type_contain_none
|
|
43
|
+
|
|
44
|
+
## Purpose
|
|
45
|
+
Raises a structured error when a modern Python UnionType used in `_type`
|
|
46
|
+
contains `NoneType` (e.g. `_type = int | None`).
|
|
47
|
+
Optional or absent states are not allowed inside the core type registry.
|
|
48
|
+
|
|
49
|
+
## Pipeline context
|
|
50
|
+
This function is called from the `UnionType` branch of `process_type` when:
|
|
51
|
+
|
|
52
|
+
- `NoneType in raw_type.__args__` evaluates to `True`.
|
|
53
|
+
|
|
54
|
+
It does not perform any checks itself; it only formats and raises the error.
|
|
55
|
+
|
|
56
|
+
## Architectural reasoning
|
|
57
|
+
The metadata type system must describe concrete, fully initialized value domains.
|
|
58
|
+
Embedding `NoneType` inside union definitions would:
|
|
59
|
+
|
|
60
|
+
- blur the boundary between “no value” and “valid value”,
|
|
61
|
+
- complicate validation and normalization,
|
|
62
|
+
- break deterministic assumptions in internal mapping routines.
|
|
63
|
+
|
|
64
|
+
Optionality is handled at a different level, not inside `_type`.
|
|
65
|
+
|
|
66
|
+
## Notes
|
|
67
|
+
If absence of value is part of the business logic, it should be modeled explicitly
|
|
68
|
+
in higher-level structures, not by mixing `NoneType` into the core type constraint.
|
|
69
|
+
|
|
70
|
+
"""
|
simplibs/object/_core/metadata/init_processors/type/validations/raise_validate_type_is_not_valid.py
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
from typing import Any, NoReturn, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_type import _exception_info_for_type
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def raise_validate_type_is_not_valid(
|
|
12
|
+
value_type: Any,
|
|
13
|
+
owner_class: "SimpleClassLike"
|
|
14
|
+
) -> NoReturn:
|
|
15
|
+
"""Raises an error for completely invalid '_type' definitions."""
|
|
16
|
+
|
|
17
|
+
(
|
|
18
|
+
class_name,
|
|
19
|
+
class_parent,
|
|
20
|
+
error_name,
|
|
21
|
+
context,
|
|
22
|
+
acceptable_definitions,
|
|
23
|
+
) = _exception_info_for_type(owner_class)
|
|
24
|
+
|
|
25
|
+
raise SimpleDefinitionError(
|
|
26
|
+
error_name=error_name,
|
|
27
|
+
label="_type",
|
|
28
|
+
value=value_type,
|
|
29
|
+
problem=(
|
|
30
|
+
"The '_type' attribute contains an unrecognized value.",
|
|
31
|
+
),
|
|
32
|
+
expected="A type, UnionType, or flat tuple of types.",
|
|
33
|
+
how_to_fix=(
|
|
34
|
+
"Replace the value with a real type or a tuple of types.",
|
|
35
|
+
"Do not use strings, instances, or nested containers.",
|
|
36
|
+
"Ensure the definition matches the actual value structure.",
|
|
37
|
+
) + acceptable_definitions,
|
|
38
|
+
context=context,
|
|
39
|
+
exception=TypeError,
|
|
40
|
+
)
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
_DESIGN_NOTES = """
|
|
44
|
+
# raise_validate_type_is_not_valid
|
|
45
|
+
|
|
46
|
+
## Purpose
|
|
47
|
+
Serves as the final fallback guard in the `process_type` pipeline.
|
|
48
|
+
It is triggered when `_type` does not match **any** supported structural form:
|
|
49
|
+
|
|
50
|
+
- atomic type (`int`, `str`, `MyClass`)
|
|
51
|
+
- modern UnionType (`int | str`)
|
|
52
|
+
- flat tuple of types (`(int, str)`)
|
|
53
|
+
|
|
54
|
+
Anything else is considered invalid.
|
|
55
|
+
|
|
56
|
+
## Pipeline position
|
|
57
|
+
This function is called at the very end of `process_type`.
|
|
58
|
+
All earlier validators have already checked:
|
|
59
|
+
|
|
60
|
+
- missing `_type`,
|
|
61
|
+
- `_type` is None,
|
|
62
|
+
- `_type` is empty,
|
|
63
|
+
- nested tuples,
|
|
64
|
+
- literal None inside tuples,
|
|
65
|
+
- NoneType inside UnionType.
|
|
66
|
+
|
|
67
|
+
If the value still does not match a valid form, control falls through to this
|
|
68
|
+
error factory.
|
|
69
|
+
|
|
70
|
+
## Why this validation exists
|
|
71
|
+
Developers sometimes mistakenly assign:
|
|
72
|
+
|
|
73
|
+
- strings (`"int"`)
|
|
74
|
+
- instances (`MyClass()`)
|
|
75
|
+
- lists (`[int, str]`)
|
|
76
|
+
- dicts (`{"a": 1}`)
|
|
77
|
+
- arbitrary objects
|
|
78
|
+
|
|
79
|
+
These cannot be interpreted as type constraints and would break the metadata
|
|
80
|
+
pipeline.
|
|
81
|
+
|
|
82
|
+
## Diagnostic value
|
|
83
|
+
The error includes:
|
|
84
|
+
|
|
85
|
+
- the invalid value,
|
|
86
|
+
- the class name,
|
|
87
|
+
- contextual information,
|
|
88
|
+
- examples of valid definitions.
|
|
89
|
+
|
|
90
|
+
This makes debugging straightforward and prevents cryptic runtime failures.
|
|
91
|
+
|
|
92
|
+
"""
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_type import _exception_info_for_type
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_type_from_tuple_is_not_none(
|
|
12
|
+
inner_type: Any,
|
|
13
|
+
type_tuple: tuple[Any, ...],
|
|
14
|
+
owner_class: "SimpleClassLike"
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Validates that a tuple element is not literal None."""
|
|
17
|
+
|
|
18
|
+
# 1. Literal None detected
|
|
19
|
+
if inner_type is None:
|
|
20
|
+
(
|
|
21
|
+
class_name,
|
|
22
|
+
class_parent,
|
|
23
|
+
error_name,
|
|
24
|
+
context,
|
|
25
|
+
acceptable_definitions,
|
|
26
|
+
) = _exception_info_for_type(owner_class)
|
|
27
|
+
|
|
28
|
+
# 2. Raise structured error
|
|
29
|
+
raise SimpleDefinitionError(
|
|
30
|
+
error_name=error_name,
|
|
31
|
+
label="_type",
|
|
32
|
+
value=type_tuple,
|
|
33
|
+
problem=(
|
|
34
|
+
"The '_type' tuple contains a literal None value.",
|
|
35
|
+
),
|
|
36
|
+
expected="A real type or class reference.",
|
|
37
|
+
how_to_fix=(
|
|
38
|
+
"Replace literal None with a real type.",
|
|
39
|
+
"If absence of value is intended, use NoneType instead.",
|
|
40
|
+
"Literal None cannot be part of a type tuple.",
|
|
41
|
+
) + acceptable_definitions,
|
|
42
|
+
context=context,
|
|
43
|
+
exception=TypeError,
|
|
44
|
+
)
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
_DESIGN_NOTES = """
|
|
48
|
+
# validate_type_from_tuple_is_not_none
|
|
49
|
+
|
|
50
|
+
## Purpose
|
|
51
|
+
Prevents developers from placing literal `None` inside a tuple of types, such as:
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
_type = (int, None)
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Literal `None` is not a type and cannot be used with `isinstance`.
|
|
58
|
+
|
|
59
|
+
## Why this validation exists
|
|
60
|
+
The tuple form of `_type` is later converted into a UnionType.
|
|
61
|
+
If the tuple contains literal `None`, the conversion would produce an invalid
|
|
62
|
+
UnionType and break the type system.
|
|
63
|
+
|
|
64
|
+
Correct form:
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
_type = (int, NoneType)
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
Incorrect form:
|
|
71
|
+
|
|
72
|
+
```
|
|
73
|
+
_type = (int, None)
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
## Pipeline position
|
|
77
|
+
This check runs inside the tuple‑processing branch of `process_type`.
|
|
78
|
+
It is triggered for each element of the tuple.
|
|
79
|
+
|
|
80
|
+
## Developer experience
|
|
81
|
+
Literal `None` often appears due to:
|
|
82
|
+
|
|
83
|
+
- misunderstanding the difference between `None` and `NoneType`,
|
|
84
|
+
- copy‑paste errors,
|
|
85
|
+
- attempts to express optionality inside `_type`.
|
|
86
|
+
|
|
87
|
+
The error message explains the correct approach.
|
|
88
|
+
|
|
89
|
+
## Notes
|
|
90
|
+
Optionality must be modeled at a higher level.
|
|
91
|
+
The core type registry must contain only real types.
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
"""
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ......exceptions import SimpleDefinitionError
|
|
5
|
+
# Inners
|
|
6
|
+
from ._exception_info_for_type import _exception_info_for_type
|
|
7
|
+
# Annotations
|
|
8
|
+
if TYPE_CHECKING:
|
|
9
|
+
from .....protocols.classes import SimpleClassLike
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def validate_type_is_defined(
|
|
13
|
+
attribute_value: Any,
|
|
14
|
+
owner_class: "SimpleClassLike"
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Validates that the '_type' attribute is explicitly defined."""
|
|
17
|
+
|
|
18
|
+
# 1. Missing definition
|
|
19
|
+
if attribute_value is UNSET:
|
|
20
|
+
(
|
|
21
|
+
class_name,
|
|
22
|
+
class_parent,
|
|
23
|
+
error_name,
|
|
24
|
+
context,
|
|
25
|
+
acceptable_definitions,
|
|
26
|
+
) = _exception_info_for_type(owner_class)
|
|
27
|
+
|
|
28
|
+
# 2. Raise structured error
|
|
29
|
+
raise SimpleDefinitionError(
|
|
30
|
+
error_name=error_name,
|
|
31
|
+
label="_type",
|
|
32
|
+
value=attribute_value,
|
|
33
|
+
problem=(
|
|
34
|
+
f"The class '{class_name}' does not define the required '_type' attribute.",
|
|
35
|
+
),
|
|
36
|
+
expected="A concrete type definition.",
|
|
37
|
+
how_to_fix=(
|
|
38
|
+
f"Define '_type' inside class '{class_name}'.",
|
|
39
|
+
"The type must match the value structure represented by the class.",
|
|
40
|
+
) + acceptable_definitions,
|
|
41
|
+
context=context,
|
|
42
|
+
exception=AttributeError,
|
|
43
|
+
)
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
_DESIGN_NOTES = """
|
|
48
|
+
# validate_type_is_defined
|
|
49
|
+
|
|
50
|
+
## Purpose
|
|
51
|
+
Ensures that every Simple class explicitly declares its `_type` attribute.
|
|
52
|
+
Without this definition, the class cannot participate in the metadata pipeline.
|
|
53
|
+
|
|
54
|
+
## Why this validation exists
|
|
55
|
+
The `_type` attribute is the core schema declaration for both constants and
|
|
56
|
+
composite objects. It defines the allowed value structure and is required for:
|
|
57
|
+
|
|
58
|
+
- validation,
|
|
59
|
+
- normalization,
|
|
60
|
+
- instance creation,
|
|
61
|
+
- static analysis.
|
|
62
|
+
|
|
63
|
+
If `_type` is missing, the class has no structural identity.
|
|
64
|
+
|
|
65
|
+
## Sentinel logic
|
|
66
|
+
The check uses the `UNSET` sentinel rather than `None` or truthiness.
|
|
67
|
+
This prevents false positives when a user accidentally assigns a falsy value
|
|
68
|
+
(e.g., `0`, `False`, `""`) to `_type`.
|
|
69
|
+
|
|
70
|
+
## Error structure
|
|
71
|
+
The helper `_exception_info_for_type` provides:
|
|
72
|
+
|
|
73
|
+
- class name,
|
|
74
|
+
- parent type (constant vs object),
|
|
75
|
+
- error name,
|
|
76
|
+
- context string,
|
|
77
|
+
- example definitions.
|
|
78
|
+
|
|
79
|
+
These values are injected directly into the exception for clarity.
|
|
80
|
+
|
|
81
|
+
## Notes
|
|
82
|
+
This validation is the first step in `process_type`.
|
|
83
|
+
If `_type` is missing, no further checks are executed.
|
|
84
|
+
|
|
85
|
+
"""
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_type import _exception_info_for_type
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_type_is_not_empty(
|
|
12
|
+
processed_type: Any,
|
|
13
|
+
owner_class: "SimpleClassLike"
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Validates that '_type' is not an empty container."""
|
|
16
|
+
|
|
17
|
+
# 1. Empty container or falsy value
|
|
18
|
+
if not processed_type:
|
|
19
|
+
(
|
|
20
|
+
class_name,
|
|
21
|
+
class_parent,
|
|
22
|
+
error_name,
|
|
23
|
+
context,
|
|
24
|
+
acceptable_definitions,
|
|
25
|
+
) = _exception_info_for_type(owner_class)
|
|
26
|
+
|
|
27
|
+
# 2. Raise structured error
|
|
28
|
+
raise SimpleDefinitionError(
|
|
29
|
+
error_name=error_name,
|
|
30
|
+
label="_type",
|
|
31
|
+
value=processed_type,
|
|
32
|
+
problem=(
|
|
33
|
+
"The '_type' attribute evaluates to an empty value.",
|
|
34
|
+
),
|
|
35
|
+
expected="A non-empty type, UnionType, or tuple of types.",
|
|
36
|
+
how_to_fix=(
|
|
37
|
+
"Define '_type' as a real type or a non-empty collection of types.",
|
|
38
|
+
"Empty definitions cannot be validated or mapped.",
|
|
39
|
+
"Update '_type' to reflect the actual allowed value structure.",
|
|
40
|
+
) + acceptable_definitions,
|
|
41
|
+
context=context,
|
|
42
|
+
exception=ValueError,
|
|
43
|
+
)
|
|
44
|
+
|
|
45
|
+
_DESIGN_NOTES = """
|
|
46
|
+
# validate_type_is_not_empty
|
|
47
|
+
|
|
48
|
+
## Purpose
|
|
49
|
+
Prevents `_type` from being defined as an empty container or any falsy value.
|
|
50
|
+
Examples of invalid definitions:
|
|
51
|
+
|
|
52
|
+
- `_type = ()`
|
|
53
|
+
- `_type = []`
|
|
54
|
+
- `_type = {}`
|
|
55
|
+
- `_type = ""`
|
|
56
|
+
|
|
57
|
+
Empty definitions cannot be validated and provide no structural information.
|
|
58
|
+
|
|
59
|
+
## Why this validation exists
|
|
60
|
+
The type system requires a concrete type matrix.
|
|
61
|
+
If `_type` is empty, downstream logic such as:
|
|
62
|
+
|
|
63
|
+
- UnionType casting,
|
|
64
|
+
- tuple flattening,
|
|
65
|
+
- validation,
|
|
66
|
+
- instance creation,
|
|
67
|
+
|
|
68
|
+
cannot operate.
|
|
69
|
+
|
|
70
|
+
## Pipeline position
|
|
71
|
+
This check runs immediately after:
|
|
72
|
+
|
|
73
|
+
- `validate_type_is_defined`
|
|
74
|
+
- `validate_type_is_not_none`
|
|
75
|
+
|
|
76
|
+
It ensures that `_type` is not missing, not `None`, and not empty.
|
|
77
|
+
|
|
78
|
+
## Error structure
|
|
79
|
+
The helper `_exception_info_for_type` provides:
|
|
80
|
+
|
|
81
|
+
- class name,
|
|
82
|
+
- parent type (constant vs object),
|
|
83
|
+
- error name,
|
|
84
|
+
- context string,
|
|
85
|
+
- example definitions.
|
|
86
|
+
|
|
87
|
+
These are injected directly into the exception.
|
|
88
|
+
|
|
89
|
+
## Notes
|
|
90
|
+
This validator uses truthiness (`if not processed_type:`) intentionally.
|
|
91
|
+
It catches all empty containers without needing explicit type checks.
|
|
92
|
+
|
|
93
|
+
"""
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_type import _exception_info_for_type
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_type_is_not_none(
|
|
12
|
+
value_type: Any,
|
|
13
|
+
owner_class: "SimpleClassLike"
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Validates that '_type' is not set to literal None."""
|
|
16
|
+
|
|
17
|
+
# 1. Literal None is invalid
|
|
18
|
+
if value_type is None:
|
|
19
|
+
(
|
|
20
|
+
class_name,
|
|
21
|
+
class_parent,
|
|
22
|
+
error_name,
|
|
23
|
+
context,
|
|
24
|
+
acceptable_definitions,
|
|
25
|
+
) = _exception_info_for_type(owner_class)
|
|
26
|
+
|
|
27
|
+
# 2. Raise structured error
|
|
28
|
+
raise SimpleDefinitionError(
|
|
29
|
+
error_name=error_name,
|
|
30
|
+
label="_type",
|
|
31
|
+
value=value_type,
|
|
32
|
+
problem=(
|
|
33
|
+
"The '_type' attribute is set to literal None.",
|
|
34
|
+
),
|
|
35
|
+
expected="A concrete type or a UnionType.",
|
|
36
|
+
how_to_fix=(
|
|
37
|
+
"Replace literal None with a real type.",
|
|
38
|
+
"If you intended to allow absence of value, use NoneType instead.",
|
|
39
|
+
"Literal None cannot serve as a structural type definition.",
|
|
40
|
+
) + acceptable_definitions,
|
|
41
|
+
context=context,
|
|
42
|
+
exception=TypeError,
|
|
43
|
+
)
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
_DESIGN_NOTES = """
|
|
48
|
+
# validate_type_is_not_none
|
|
49
|
+
|
|
50
|
+
## Purpose
|
|
51
|
+
Prevents developers from assigning literal `None` to the `_type` attribute.
|
|
52
|
+
Literal `None` cannot represent a structural type and would break validation,
|
|
53
|
+
normalization, and instance creation.
|
|
54
|
+
|
|
55
|
+
## Why this validation exists
|
|
56
|
+
The `_type` attribute must always point to:
|
|
57
|
+
|
|
58
|
+
- a concrete Python type (e.g., `int`, `str`, `MyClass`),
|
|
59
|
+
- a UnionType (e.g., `int | str`),
|
|
60
|
+
- or a tuple of types (later converted to a UnionType).
|
|
61
|
+
|
|
62
|
+
Literal `None` is not a type and cannot be used with `isinstance`.
|
|
63
|
+
|
|
64
|
+
## Pipeline position
|
|
65
|
+
This check runs immediately after:
|
|
66
|
+
|
|
67
|
+
- `validate_type_is_defined`
|
|
68
|
+
- and before deeper structural checks.
|
|
69
|
+
|
|
70
|
+
It ensures that `_type` is not missing and not `None`.
|
|
71
|
+
|
|
72
|
+
## Error structure
|
|
73
|
+
The helper `_exception_info_for_type` provides contextual data:
|
|
74
|
+
|
|
75
|
+
- class name,
|
|
76
|
+
- parent type (constant vs object),
|
|
77
|
+
- error name,
|
|
78
|
+
- context string,
|
|
79
|
+
- example definitions.
|
|
80
|
+
|
|
81
|
+
These are injected directly into the exception.
|
|
82
|
+
|
|
83
|
+
## Notes
|
|
84
|
+
If the developer wants to allow `None` as a valid value, they must use
|
|
85
|
+
`NoneType` from the `types` module, not literal `None`.
|
|
86
|
+
|
|
87
|
+
"""
|
simplibs/object/_core/metadata/init_processors/type/validations/validate_type_tuple_is_not_nested.py
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_type import _exception_info_for_type
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_type_tuple_is_not_nested(
|
|
12
|
+
inner_type: Any,
|
|
13
|
+
type_tuple: tuple[Any, ...],
|
|
14
|
+
owner_class: "SimpleClassLike"
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Validates that a tuple of types is flat."""
|
|
17
|
+
|
|
18
|
+
# 1. Nested tuple detected
|
|
19
|
+
if isinstance(inner_type, tuple):
|
|
20
|
+
(
|
|
21
|
+
class_name,
|
|
22
|
+
class_parent,
|
|
23
|
+
error_name,
|
|
24
|
+
context,
|
|
25
|
+
acceptable_definitions,
|
|
26
|
+
) = _exception_info_for_type(owner_class)
|
|
27
|
+
|
|
28
|
+
# 2. Raise structured error
|
|
29
|
+
raise SimpleDefinitionError(
|
|
30
|
+
error_name=error_name,
|
|
31
|
+
label="_type",
|
|
32
|
+
value=type_tuple,
|
|
33
|
+
problem=(
|
|
34
|
+
"The '_type' tuple contains a nested tuple.",
|
|
35
|
+
),
|
|
36
|
+
expected="A flat tuple of types.",
|
|
37
|
+
how_to_fix=(
|
|
38
|
+
"Flatten the tuple into a single sequence.",
|
|
39
|
+
"Nested tuples cannot be processed.",
|
|
40
|
+
"Example: (int, (str, float)) → (int, str, float).",
|
|
41
|
+
) + acceptable_definitions,
|
|
42
|
+
context=context,
|
|
43
|
+
exception=TypeError,
|
|
44
|
+
)
|
|
45
|
+
|
|
46
|
+
_DESIGN_NOTES = """
|
|
47
|
+
# validate_type_tuple_is_not_nested
|
|
48
|
+
|
|
49
|
+
## Purpose
|
|
50
|
+
Ensures that `_type` defined as a tuple is completely flat.
|
|
51
|
+
Nested tuples cannot be converted into a valid UnionType and would break the
|
|
52
|
+
type‑processing pipeline.
|
|
53
|
+
|
|
54
|
+
## Why this validation exists
|
|
55
|
+
The tuple form of `_type` is a legacy syntax:
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+
_type = (int, str)
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
It is later converted into:
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
int | str
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
If the tuple contains nested tuples, such as:
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
_type = (int, (str, float))
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
the flattening logic cannot operate.
|
|
74
|
+
|
|
75
|
+
## Pipeline position
|
|
76
|
+
This check runs inside the tuple‑processing branch of `process_type`.
|
|
77
|
+
It is triggered for each element of the tuple.
|
|
78
|
+
|
|
79
|
+
## Developer experience
|
|
80
|
+
Nested tuples often appear due to:
|
|
81
|
+
|
|
82
|
+
- accidental double‑wrapping,
|
|
83
|
+
- copy‑paste errors,
|
|
84
|
+
- refactoring mistakes.
|
|
85
|
+
|
|
86
|
+
The error message includes a clear example of how to flatten the tuple.
|
|
87
|
+
|
|
88
|
+
## Notes
|
|
89
|
+
The validator checks only the current element (`inner_type`).
|
|
90
|
+
The full tuple is included in the error for clarity.
|
|
91
|
+
```
|
|
92
|
+
"""
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
_DESIGN_NOTES = """
|
|
2
|
+
# Instance Builders Package Overview
|
|
3
|
+
|
|
4
|
+
The `instance_builders` package contains the internal construction pipelines
|
|
5
|
+
responsible for generating all runtime instance classes used by the Simple
|
|
6
|
+
system. Each sub-package focuses on a specific structural mode: atomic,
|
|
7
|
+
composite, or fully compiled instance types.
|
|
8
|
+
|
|
9
|
+
This package does not re-export any components. All functionality is accessed
|
|
10
|
+
directly through the corresponding sub-packages.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Sub-Packages
|
|
15
|
+
|
|
16
|
+
### 1. atom_class
|
|
17
|
+
Provides the builders for atomic instance classes:
|
|
18
|
+
- atomic initializer generation,
|
|
19
|
+
- root value setter creation,
|
|
20
|
+
- atomic base class definition,
|
|
21
|
+
- dynamic atomic class compilation.
|
|
22
|
+
|
|
23
|
+
Atomic classes represent leaf nodes with a single value.
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
### 2. composite_class
|
|
28
|
+
Provides the builders for composite instance classes:
|
|
29
|
+
- composite initializer generation,
|
|
30
|
+
- inner property creation,
|
|
31
|
+
- recalculation pipelines,
|
|
32
|
+
- dynamic composite class compilation.
|
|
33
|
+
|
|
34
|
+
Composite classes represent structured multi-node objects.
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
### 3. instance
|
|
39
|
+
Provides the unified instance factory:
|
|
40
|
+
- validation of class identity and mixins,
|
|
41
|
+
- structural mode resolution,
|
|
42
|
+
- base-class selection,
|
|
43
|
+
- dynamic class synthesis,
|
|
44
|
+
- mixin extension hooks,
|
|
45
|
+
- instance allocation and initialization.
|
|
46
|
+
|
|
47
|
+
This is the main entry point for creating runtime instances.
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Notes
|
|
52
|
+
- This package is internal and not intended for direct user interaction.
|
|
53
|
+
- Each builder sub-package is self-contained and exposes its own public API.
|
|
54
|
+
- The structure is designed for clarity, modularity, and predictable behavior.
|
|
55
|
+
"""
|