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/methods/verifiers/calculation/validations/__init__.py
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
from .raise_method_raised_exceptions import raise_method_raised_exceptions
|
|
2
|
+
from .raise_method_return_unvalide_outcome_type import raise_method_return_unvalide_outcome_type
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
_DESIGN_NOTES = """
|
|
6
|
+
# Calculation Validation Sub-Package
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Isolates diagnostic panic routines responsible for catching and handling evaluations that violate runtime execution schemas.
|
|
10
|
+
|
|
11
|
+
## Internal Components Registry
|
|
12
|
+
|
|
13
|
+
| Component | Type | Description |
|
|
14
|
+
| :-------------------------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
15
|
+
| `raise_method_raised_exceptions` | Function | Standardized wrapper converting unexpected computation errors into domain exceptions. |
|
|
16
|
+
| `raise_method_return_unvalide_outcome_type` | Function | Panics when a method computation yields an object mismatching schema expectations. |
|
|
17
|
+
"""
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ........exceptions import SimpleDefinitionError
|
|
4
|
+
from ..._exceptions_helpers import exception_info_for_classmethod
|
|
5
|
+
# Annotations
|
|
6
|
+
if TYPE_CHECKING:
|
|
7
|
+
from .......protocols.methods import ClassMethodProtocol
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def raise_method_raised_exceptions(
|
|
11
|
+
intercepted_exception: Exception,
|
|
12
|
+
bound_method: "ClassMethodProtocol",
|
|
13
|
+
) -> None:
|
|
14
|
+
"""Raises a structured metadata exception when a dry-run execution fails."""
|
|
15
|
+
|
|
16
|
+
# 1. Extract diagnostic context
|
|
17
|
+
class_name, method_name, context = exception_info_for_classmethod(bound_method)
|
|
18
|
+
|
|
19
|
+
# 2. Raise domain exception with packaged underlying error
|
|
20
|
+
raise SimpleDefinitionError(
|
|
21
|
+
error_name="METHOD LOGIC ERROR",
|
|
22
|
+
label="_exception",
|
|
23
|
+
expected="Method execution without raising exceptions.",
|
|
24
|
+
problem="An unexpected error occurred during dry-run execution.",
|
|
25
|
+
context=context,
|
|
26
|
+
how_to_fix=(
|
|
27
|
+
f"Inspect the internal logic of '{method_name}'.",
|
|
28
|
+
"Verify correct handling of default values and input parameters.",
|
|
29
|
+
"See the intercepted exception below for the exact root cause.",
|
|
30
|
+
),
|
|
31
|
+
exception=intercepted_exception,
|
|
32
|
+
)
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
_DESIGN_NOTES = """
|
|
37
|
+
# raise_method_raised_exceptions
|
|
38
|
+
|
|
39
|
+
## Purpose
|
|
40
|
+
Captures any exception thrown during a dry-run execution of a classmethod and
|
|
41
|
+
repackages it into a structured `SimpleDefinitionError`.
|
|
42
|
+
This prevents raw runtime crashes from leaking into the metadata pipeline.
|
|
43
|
+
|
|
44
|
+
## Behavior
|
|
45
|
+
1. Extracts diagnostic context using `exception_context_for_classmethod`.
|
|
46
|
+
2. Raises a structured domain error containing:
|
|
47
|
+
- class name
|
|
48
|
+
- method name
|
|
49
|
+
- execution context
|
|
50
|
+
- remediation instructions
|
|
51
|
+
- the original intercepted exception
|
|
52
|
+
|
|
53
|
+
## Notes
|
|
54
|
+
This validator is used exclusively inside `verify_calculation` and is the first
|
|
55
|
+
line of defense against runtime failures in method hooks.
|
|
56
|
+
"""
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from types import UnionType
|
|
3
|
+
# Outers
|
|
4
|
+
from ........exceptions import SimpleDefinitionError
|
|
5
|
+
from ..._exceptions_helpers import exception_info_for_classmethod
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .......protocols.methods import ClassMethodProtocol
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def raise_method_return_unvalide_outcome_type(
|
|
12
|
+
calculated_value: Any,
|
|
13
|
+
expected_return_type: type | UnionType,
|
|
14
|
+
bound_method: "ClassMethodProtocol",
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Raises a structured exception when a method returns an invalid type."""
|
|
17
|
+
|
|
18
|
+
# 1. Extract diagnostic context
|
|
19
|
+
class_name, method_name, context = exception_info_for_classmethod(bound_method)
|
|
20
|
+
|
|
21
|
+
expected_type_name = (
|
|
22
|
+
expected_return_type.__name__
|
|
23
|
+
if hasattr(expected_return_type, "__name__")
|
|
24
|
+
else str(expected_return_type)
|
|
25
|
+
)
|
|
26
|
+
calculated_type_name = type(calculated_value).__name__
|
|
27
|
+
|
|
28
|
+
# 2. Select method-specific remediation hint
|
|
29
|
+
if method_name == "_logic":
|
|
30
|
+
hint = f"Return value must match '{class_name}._type'."
|
|
31
|
+
elif method_name == "_decompose":
|
|
32
|
+
hint = f"Return value must be a tuple matching '{class_name}._inners'."
|
|
33
|
+
elif method_name == "_validate":
|
|
34
|
+
hint = "Return value must be 'bool', 'None', or 'bool | None'."
|
|
35
|
+
else:
|
|
36
|
+
hint = ""
|
|
37
|
+
|
|
38
|
+
# 3. Raise domain exception
|
|
39
|
+
raise SimpleDefinitionError(
|
|
40
|
+
error_name="METHOD LOGIC ERROR",
|
|
41
|
+
label="_return_type",
|
|
42
|
+
value=calculated_value,
|
|
43
|
+
expected=expected_type_name,
|
|
44
|
+
problem=f"Method '{method_name}' returned an invalid type '{calculated_type_name}'.",
|
|
45
|
+
context=context,
|
|
46
|
+
how_to_fix=(
|
|
47
|
+
"Inspect the method logic and ensure the returned value matches the expected type.",
|
|
48
|
+
hint,
|
|
49
|
+
f"Modify the method so that it returns an instance of '{expected_type_name}'.",
|
|
50
|
+
f"Or update the type definition to allow '{calculated_type_name}'.",
|
|
51
|
+
"Example:",
|
|
52
|
+
" @classmethod",
|
|
53
|
+
f" def {method_name}(cls, ...) -> {expected_type_name}:",
|
|
54
|
+
f" return ... # Must be an instance of {expected_type_name}",
|
|
55
|
+
),
|
|
56
|
+
exception=TypeError,
|
|
57
|
+
)
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
_DESIGN_NOTES = """
|
|
61
|
+
# raise_method_return_unvalide_outcome_type
|
|
62
|
+
|
|
63
|
+
## Purpose
|
|
64
|
+
Ensures that the return value of `_logic`, `_decompose`, or `_validate` matches
|
|
65
|
+
the expected type defined by the metadata pipeline.
|
|
66
|
+
|
|
67
|
+
## Behavior
|
|
68
|
+
1. Extracts diagnostic context using `exception_context_for_classmethod`.
|
|
69
|
+
2. Determines the expected type name and the actual returned type.
|
|
70
|
+
3. Selects a method-specific remediation hint:
|
|
71
|
+
- `_logic` → must match `_type`
|
|
72
|
+
- `_decompose` → must match `_inners`
|
|
73
|
+
- `_validate` → must be `bool | None`
|
|
74
|
+
4. Raises a structured `SimpleDefinitionError` with a clear explanation and
|
|
75
|
+
copy‑paste ready remediation instructions.
|
|
76
|
+
|
|
77
|
+
## Notes
|
|
78
|
+
This validator is used inside `verify_calculation` immediately after the dry-run
|
|
79
|
+
execution of the method.
|
|
80
|
+
"""
|
simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/verify_calculation.py
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from types import UnionType
|
|
3
|
+
from simplibs.sentinels import UNSET
|
|
4
|
+
# Inners
|
|
5
|
+
from .decompose_method import verify_decompose_outcome
|
|
6
|
+
from .validations import (
|
|
7
|
+
raise_method_raised_exceptions,
|
|
8
|
+
raise_method_return_unvalide_outcome_type,
|
|
9
|
+
)
|
|
10
|
+
# Annotations
|
|
11
|
+
if TYPE_CHECKING:
|
|
12
|
+
from ......protocols.classes import SimpleClassLike
|
|
13
|
+
from ......protocols.methods import ClassMethodProtocol
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def verify_calculation(
|
|
17
|
+
bound_method: "ClassMethodProtocol",
|
|
18
|
+
test_value: Any,
|
|
19
|
+
expected_return_type: type | UnionType,
|
|
20
|
+
owner_class: "SimpleClassLike",
|
|
21
|
+
) -> Any:
|
|
22
|
+
"""Executes a dry-run of the method and validates its return type and structure."""
|
|
23
|
+
|
|
24
|
+
if bound_method is UNSET:
|
|
25
|
+
return UNSET
|
|
26
|
+
|
|
27
|
+
# 1. Initialize result placeholder
|
|
28
|
+
calculate_result = UNSET
|
|
29
|
+
|
|
30
|
+
# 2. Execute dry-run and intercept exceptions
|
|
31
|
+
try:
|
|
32
|
+
calculate_result = bound_method(*test_value)
|
|
33
|
+
except Exception as e:
|
|
34
|
+
raise_method_raised_exceptions(e, bound_method)
|
|
35
|
+
|
|
36
|
+
# 3. Validate return type
|
|
37
|
+
if not isinstance(calculate_result, expected_return_type):
|
|
38
|
+
raise_method_return_unvalide_outcome_type(
|
|
39
|
+
calculate_result,
|
|
40
|
+
expected_return_type,
|
|
41
|
+
bound_method,
|
|
42
|
+
)
|
|
43
|
+
|
|
44
|
+
# 4. Special validation for '_decompose'
|
|
45
|
+
if bound_method.__func__.__name__ == "_decompose":
|
|
46
|
+
# noinspection PyTypeChecker
|
|
47
|
+
verify_decompose_outcome(
|
|
48
|
+
calculate_result,
|
|
49
|
+
owner_class,
|
|
50
|
+
bound_method,
|
|
51
|
+
)
|
|
52
|
+
|
|
53
|
+
# 5. Return verified result
|
|
54
|
+
return calculate_result
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
_DESIGN_NOTES = """
|
|
59
|
+
# verify_calculation
|
|
60
|
+
|
|
61
|
+
## Purpose
|
|
62
|
+
Runs a controlled dry-run of a classmethod to ensure:
|
|
63
|
+
- it executes without raising exceptions,
|
|
64
|
+
- it returns a value of the expected type,
|
|
65
|
+
- and for `_decompose`, the returned tuple matches the structural metadata.
|
|
66
|
+
|
|
67
|
+
## Behavior
|
|
68
|
+
|
|
69
|
+
### 1. Dry-run execution
|
|
70
|
+
The method is invoked with `*test_value`.
|
|
71
|
+
Any exception is intercepted and repackaged via `raise_method_raised_exceptions`.
|
|
72
|
+
|
|
73
|
+
### 2. Type validation
|
|
74
|
+
The result is checked using `isinstance` against the expected return type.
|
|
75
|
+
If invalid, `raise_method_return_unvalide_outcome_type` is triggered.
|
|
76
|
+
|
|
77
|
+
### 3. Decompose-specific validation
|
|
78
|
+
If the method is `_decompose`, the result is passed to `verify_decompose_outcome`,
|
|
79
|
+
which validates:
|
|
80
|
+
- tuple length,
|
|
81
|
+
- item types,
|
|
82
|
+
- item default values.
|
|
83
|
+
|
|
84
|
+
### 4. Verified output
|
|
85
|
+
If all checks pass, the result is returned unchanged.
|
|
86
|
+
|
|
87
|
+
## Notes
|
|
88
|
+
This orchestrator is the final operational validation step in the method pipeline.
|
|
89
|
+
"""
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from .verify_classmethod import verify_classmethod
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Classmethod Verification Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Acts as the front gate interface verifier for class-bound procedures. It runs structural environment assessments to verify that object methods are properly declared, bounded, and ready for internal execution flow pipelines.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
14
|
+
| `verify_classmethod` | Function | Orchestration coordinator enforcing early definition and class-binding validations. |
|
|
15
|
+
"""
|
simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/_clone_classmethod.py
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Callable
|
|
2
|
+
from types import FunctionType
|
|
3
|
+
# Annotations
|
|
4
|
+
if TYPE_CHECKING:
|
|
5
|
+
from ......protocols.methods import ClassMethodProtocol
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
def _clone_classmethod(
|
|
9
|
+
cm: "ClassMethodProtocol",
|
|
10
|
+
) -> classmethod:
|
|
11
|
+
"""Creates a fully isolated clone of a classmethod."""
|
|
12
|
+
|
|
13
|
+
# 1. Extract underlying function
|
|
14
|
+
func = cm.__func__
|
|
15
|
+
|
|
16
|
+
# 2. Rebuild a new function object
|
|
17
|
+
new_func: Callable = FunctionType(
|
|
18
|
+
func.__code__,
|
|
19
|
+
func.__globals__,
|
|
20
|
+
name=func.__name__,
|
|
21
|
+
argdefs=func.__defaults__,
|
|
22
|
+
closure=func.__closure__,
|
|
23
|
+
)
|
|
24
|
+
|
|
25
|
+
# 3. Copy annotations
|
|
26
|
+
new_func.__annotations__ = dict(func.__annotations__)
|
|
27
|
+
|
|
28
|
+
# 4. Copy keyword-only defaults
|
|
29
|
+
new_func.__kwdefaults__ = (
|
|
30
|
+
dict(func.__kwdefaults__) if func.__kwdefaults__ else None
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
# 5. Copy custom attributes
|
|
34
|
+
if func.__dict__:
|
|
35
|
+
new_func.__dict__.update(func.__dict__)
|
|
36
|
+
|
|
37
|
+
# 6. Wrap into a fresh classmethod descriptor
|
|
38
|
+
return classmethod(new_func)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
_DESIGN_NOTES = """
|
|
43
|
+
# _clone_classmethod
|
|
44
|
+
|
|
45
|
+
## Purpose
|
|
46
|
+
Creates a fully isolated clone of a classmethod.
|
|
47
|
+
Used when a subclass inherits a method but needs its own independent copy so that
|
|
48
|
+
metadata injection does not modify the parent class.
|
|
49
|
+
|
|
50
|
+
## Why cloning is required
|
|
51
|
+
Python's `classmethod` wraps a single underlying function object.
|
|
52
|
+
If a subclass modifies that function (annotations, defaults, attributes), the
|
|
53
|
+
changes propagate upward to the parent class.
|
|
54
|
+
This breaks isolation and causes shared‑state bugs.
|
|
55
|
+
|
|
56
|
+
Cloning prevents this by reconstructing a new function object.
|
|
57
|
+
|
|
58
|
+
## How cloning works
|
|
59
|
+
1. **Extract the underlying function**
|
|
60
|
+
`cm.__func__` gives the raw function object.
|
|
61
|
+
|
|
62
|
+
2. **Rebuild a new function**
|
|
63
|
+
A new `FunctionType` is created using:
|
|
64
|
+
- bytecode (`__code__`)
|
|
65
|
+
- globals (`__globals__`)
|
|
66
|
+
- name (`__name__`)
|
|
67
|
+
- defaults (`__defaults__`)
|
|
68
|
+
- closure (`__closure__`)
|
|
69
|
+
|
|
70
|
+
3. **Copy metadata safely**
|
|
71
|
+
- annotations → copied into a new dict
|
|
72
|
+
- keyword defaults → copied or set to None
|
|
73
|
+
- custom attributes → copied via `.update()`
|
|
74
|
+
|
|
75
|
+
4. **Wrap back into classmethod**
|
|
76
|
+
The new function is wrapped in a fresh `classmethod` descriptor.
|
|
77
|
+
|
|
78
|
+
## Notes
|
|
79
|
+
This helper is used only inside the method‑verification pipeline.
|
|
80
|
+
It is intentionally minimal and does not perform validation.
|
|
81
|
+
"""
|
simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/__init__.py
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
from .validate_method_is_callable import validate_method_is_callable
|
|
2
|
+
from .validate_method_is_classmethod import validate_method_is_classmethod
|
|
3
|
+
from .validate_method_is_defined import validate_method_is_defined
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
_DESIGN_NOTES = """
|
|
7
|
+
# Classmethod Base Validation Sub-Package
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Houses fundamental object nature, existence, and signature layout validation rules before deeper runtime metadata verification.
|
|
11
|
+
|
|
12
|
+
## Internal Components Registry
|
|
13
|
+
|
|
14
|
+
| Component | Type | Description |
|
|
15
|
+
| :------------------------------ | :------- | :----------------------------------------------------------------------------------- |
|
|
16
|
+
| `validate_method_is_callable` | Function | Assures that the captured signature target can be actively invoked as a routine. |
|
|
17
|
+
| `validate_method_is_classmethod`| Function | Assures the target is bounded as a true classmethod type descriptor inside the class. |
|
|
18
|
+
| `validate_method_is_defined` | Function | Checks for target object presence within the target operational namespace context. |
|
|
19
|
+
"""
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ........exceptions import SimpleDefinitionError
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
def validate_method_is_callable(
|
|
7
|
+
raw_method: Any,
|
|
8
|
+
exception_info: tuple[str, str, str],
|
|
9
|
+
expected_structure: tuple[str, ...],
|
|
10
|
+
) -> None:
|
|
11
|
+
"""Validates that the reflected method is callable."""
|
|
12
|
+
|
|
13
|
+
if not callable(raw_method):
|
|
14
|
+
class_name, method_name, context = exception_info
|
|
15
|
+
|
|
16
|
+
raise SimpleDefinitionError(
|
|
17
|
+
error_name="METHOD LOGIC ERROR",
|
|
18
|
+
label="_method",
|
|
19
|
+
value=raw_method,
|
|
20
|
+
problem=f"'{class_name}.{method_name}' is not callable.",
|
|
21
|
+
expected="A callable classmethod.",
|
|
22
|
+
how_to_fix=(
|
|
23
|
+
f"Ensure '{method_name}' is defined as a function.",
|
|
24
|
+
"Verify it was not overwritten by a data attribute.",
|
|
25
|
+
) + expected_structure,
|
|
26
|
+
context=context,
|
|
27
|
+
exception=TypeError,
|
|
28
|
+
)
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
_DESIGN_NOTES = """
|
|
32
|
+
# validate_method_is_callable
|
|
33
|
+
|
|
34
|
+
## Purpose
|
|
35
|
+
Ensures that the reflected class attribute is a callable object.
|
|
36
|
+
This prevents signature validation from running on non‑callable values such as
|
|
37
|
+
strings, integers, or accidental data attributes.
|
|
38
|
+
|
|
39
|
+
## Why tuple inputs
|
|
40
|
+
The function receives:
|
|
41
|
+
- `exception_info` — (class_name, method_name, context)
|
|
42
|
+
- `expected_structure` — code blueprint
|
|
43
|
+
|
|
44
|
+
This keeps the validator consistent with all other method‑validation helpers.
|
|
45
|
+
|
|
46
|
+
## Behavior
|
|
47
|
+
If `callable(raw_method)` is false, the validator raises a structured
|
|
48
|
+
`SimpleDefinitionError` containing:
|
|
49
|
+
- the class and method name,
|
|
50
|
+
- a clear explanation of the issue,
|
|
51
|
+
- a copy‑paste ready blueprint showing the correct method layout.
|
|
52
|
+
|
|
53
|
+
## Notes
|
|
54
|
+
This validator is used for all three method types:
|
|
55
|
+
- `_validate`
|
|
56
|
+
- `_logic`
|
|
57
|
+
- `_decompose`
|
|
58
|
+
|
|
59
|
+
It is the second guard in the classmethod verification chain.
|
|
60
|
+
"""
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ........exceptions import SimpleDefinitionError
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
def validate_method_is_classmethod(
|
|
7
|
+
raw_method: Any,
|
|
8
|
+
exception_info: tuple[str, str, str],
|
|
9
|
+
expected_structure: tuple[str, ...],
|
|
10
|
+
) -> None:
|
|
11
|
+
"""Validates that the method is decorated with @classmethod."""
|
|
12
|
+
|
|
13
|
+
if not isinstance(raw_method, classmethod):
|
|
14
|
+
class_name, method_name, context = exception_info
|
|
15
|
+
|
|
16
|
+
raise SimpleDefinitionError(
|
|
17
|
+
error_name="METHOD LOGIC ERROR",
|
|
18
|
+
label="_method",
|
|
19
|
+
value=raw_method,
|
|
20
|
+
problem=f"'{class_name}.{method_name}' is not a classmethod.",
|
|
21
|
+
expected="A method decorated with '@classmethod'.",
|
|
22
|
+
how_to_fix=(
|
|
23
|
+
f"Add '@classmethod' to '{method_name}'.",
|
|
24
|
+
"Without this decorator, the system cannot bind the method correctly.",
|
|
25
|
+
) + expected_structure,
|
|
26
|
+
context=context,
|
|
27
|
+
exception=TypeError,
|
|
28
|
+
)
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
_DESIGN_NOTES = """
|
|
32
|
+
# validate_method_is_classmethod
|
|
33
|
+
|
|
34
|
+
## Purpose
|
|
35
|
+
Ensures that the reflected method is explicitly decorated with `@classmethod`.
|
|
36
|
+
The metadata pipeline relies on class‑bound semantics, so instance methods or
|
|
37
|
+
plain attributes cannot be used.
|
|
38
|
+
|
|
39
|
+
## Why tuple inputs
|
|
40
|
+
The validator receives:
|
|
41
|
+
- `exception_info` — (class_name, method_name, context)
|
|
42
|
+
- `expected_structure` — code blueprint
|
|
43
|
+
|
|
44
|
+
This keeps the function consistent with all other method‑validation helpers.
|
|
45
|
+
|
|
46
|
+
## Behavior
|
|
47
|
+
If the raw attribute is not a `classmethod` instance, the validator raises a
|
|
48
|
+
structured `SimpleDefinitionError` containing:
|
|
49
|
+
- the class and method name,
|
|
50
|
+
- a clear explanation of the issue,
|
|
51
|
+
- a copy‑paste ready blueprint showing the correct method layout.
|
|
52
|
+
|
|
53
|
+
## Notes
|
|
54
|
+
This validator is used for all three method types:
|
|
55
|
+
- `_validate`
|
|
56
|
+
- `_logic`
|
|
57
|
+
- `_decompose`
|
|
58
|
+
|
|
59
|
+
It is the third guard in the classmethod verification chain.
|
|
60
|
+
"""
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ........exceptions import SimpleDefinitionError
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from .......protocols.classes import SimpleClassLike
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def validate_method_is_defined(
|
|
10
|
+
method_name: str,
|
|
11
|
+
owner_class: "SimpleClassLike",
|
|
12
|
+
exception_info: tuple[str, str, str],
|
|
13
|
+
expected_structure: tuple[str, ...],
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Validates that the method is defined directly on the class."""
|
|
16
|
+
|
|
17
|
+
if method_name not in owner_class.__dict__:
|
|
18
|
+
class_name, _, context = exception_info
|
|
19
|
+
|
|
20
|
+
raise SimpleDefinitionError(
|
|
21
|
+
error_name="METHOD LOGIC ERROR",
|
|
22
|
+
label="_method",
|
|
23
|
+
value=method_name,
|
|
24
|
+
problem=f"Class '{class_name}' does not define this method.",
|
|
25
|
+
expected=f"Method '{method_name}' must be declared in class '{class_name}'.",
|
|
26
|
+
how_to_fix=(
|
|
27
|
+
f"Add '{method_name}' directly to the class definition.",
|
|
28
|
+
"Decorate it with '@classmethod'.",
|
|
29
|
+
"Ensure its parameters match the expected signature.",
|
|
30
|
+
) + expected_structure,
|
|
31
|
+
context=context,
|
|
32
|
+
exception=AttributeError,
|
|
33
|
+
)
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
_DESIGN_NOTES = """
|
|
37
|
+
# validate_method_is_defined
|
|
38
|
+
|
|
39
|
+
## Purpose
|
|
40
|
+
Ensures that the class explicitly defines the method in its own namespace.
|
|
41
|
+
The check uses `owner_class.__dict__` to avoid inherited methods and detect
|
|
42
|
+
missing overrides reliably.
|
|
43
|
+
|
|
44
|
+
## Why tuple inputs
|
|
45
|
+
The validation receives:
|
|
46
|
+
- `exception_info` — (class_name, method_name, context)
|
|
47
|
+
- `expected_structure` — code blueprint
|
|
48
|
+
|
|
49
|
+
This keeps the function simple, fast, and consistent with all other
|
|
50
|
+
exception‑helpers in the metadata pipeline.
|
|
51
|
+
|
|
52
|
+
## Behavior
|
|
53
|
+
If the method is not found in `__dict__`, the validator raises a structured
|
|
54
|
+
`SimpleDefinitionError` containing:
|
|
55
|
+
- the missing method name,
|
|
56
|
+
- the class name,
|
|
57
|
+
- a clear explanation,
|
|
58
|
+
- a copy‑paste ready blueprint showing the correct method layout.
|
|
59
|
+
|
|
60
|
+
## Notes
|
|
61
|
+
This validator is used for all three method types:
|
|
62
|
+
- `_validate`
|
|
63
|
+
- `_logic`
|
|
64
|
+
- `_decompose`
|
|
65
|
+
|
|
66
|
+
It is the first guard in the classmethod verification chain.
|
|
67
|
+
"""
|
simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/verify_classmethod.py
ADDED
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from .._exceptions_helpers import (
|
|
5
|
+
exception_info_for_classmethod,
|
|
6
|
+
expected_structure_for_classmethod,
|
|
7
|
+
)
|
|
8
|
+
# Inners
|
|
9
|
+
from ._clone_classmethod import _clone_classmethod
|
|
10
|
+
from .validations import (
|
|
11
|
+
validate_method_is_defined,
|
|
12
|
+
validate_method_is_callable,
|
|
13
|
+
validate_method_is_classmethod,
|
|
14
|
+
)
|
|
15
|
+
# Annotations
|
|
16
|
+
if TYPE_CHECKING:
|
|
17
|
+
from ......protocols.classes import SimpleClassLike
|
|
18
|
+
from ......protocols.methods import ClassMethodProtocol
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def verify_classmethod(
|
|
22
|
+
method_name: str,
|
|
23
|
+
owner_class: "SimpleClassLike",
|
|
24
|
+
expected_params: tuple[str, ...],
|
|
25
|
+
expected_args_params_count: int,
|
|
26
|
+
) -> tuple[bool, "classmethod | ClassMethodProtocol"]:
|
|
27
|
+
"""Verifies classmethod existence, inheritance boundaries, and isolation rules."""
|
|
28
|
+
from .......SimpleObject import SimpleObject
|
|
29
|
+
|
|
30
|
+
# 1. Prepare raw layout metadata
|
|
31
|
+
raw_method = owner_class.__dict__.get(method_name, UNSET)
|
|
32
|
+
bound_method = getattr(owner_class, method_name)
|
|
33
|
+
|
|
34
|
+
# 2. Early exit for default/undefined _decompose
|
|
35
|
+
if (
|
|
36
|
+
method_name == "_decompose"
|
|
37
|
+
and raw_method is UNSET
|
|
38
|
+
and getattr(bound_method, "__func__", None) is SimpleObject._decompose.__func__
|
|
39
|
+
):
|
|
40
|
+
return False, UNSET
|
|
41
|
+
|
|
42
|
+
# 3. Check if the attribute is a classmethod descriptor
|
|
43
|
+
if (
|
|
44
|
+
raw_method is not UNSET
|
|
45
|
+
and isinstance(raw_method, classmethod)
|
|
46
|
+
) or raw_method is UNSET:
|
|
47
|
+
bound_method: ClassMethodProtocol
|
|
48
|
+
|
|
49
|
+
# 3.1 Local override → validate
|
|
50
|
+
if raw_method is not UNSET:
|
|
51
|
+
return True, bound_method
|
|
52
|
+
|
|
53
|
+
# 3.2 Inherited _validate → never re-validate
|
|
54
|
+
if method_name == "_validate":
|
|
55
|
+
return False, bound_method
|
|
56
|
+
|
|
57
|
+
# 3.3 Check direct inheritance from SimpleObject
|
|
58
|
+
is_direct_descendant = SimpleObject in owner_class.__bases__
|
|
59
|
+
|
|
60
|
+
# 3.4 Deep subclass → clone if structural keys exist
|
|
61
|
+
if not is_direct_descendant:
|
|
62
|
+
need_validations = bool(owner_class.__dict__.keys() & {"_inners", "_type", "_logic"})
|
|
63
|
+
output = _clone_classmethod(bound_method) if need_validations else bound_method
|
|
64
|
+
return need_validations, output
|
|
65
|
+
|
|
66
|
+
# 4. Build exception metadata
|
|
67
|
+
exception_info = exception_info_for_classmethod(bound_method)
|
|
68
|
+
expected_structure = expected_structure_for_classmethod(
|
|
69
|
+
bound_method,
|
|
70
|
+
expected_params,
|
|
71
|
+
expected_args_params_count,
|
|
72
|
+
)
|
|
73
|
+
|
|
74
|
+
# 5. Run micro-validations
|
|
75
|
+
validate_method_is_defined(method_name, owner_class, exception_info, expected_structure)
|
|
76
|
+
validate_method_is_callable(raw_method, exception_info, expected_structure)
|
|
77
|
+
validate_method_is_classmethod(raw_method, exception_info, expected_structure)
|
|
78
|
+
return False, UNSET
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
_DESIGN_NOTES = """
|
|
83
|
+
# verify_classmethod
|
|
84
|
+
|
|
85
|
+
## Purpose
|
|
86
|
+
Acts as the central gatekeeper for classmethod validation (`_validate`, `_logic`, `_decompose`).
|
|
87
|
+
It determines whether a method should be validated, cloned, inherited, or rejected before dry-run execution.
|
|
88
|
+
|
|
89
|
+
## Step-by-step behavior
|
|
90
|
+
|
|
91
|
+
### 1. Namespace extraction
|
|
92
|
+
Two views of the method are captured:
|
|
93
|
+
- `raw_method` → local class namespace (`owner_class.__dict__`). Checked to determine local override.
|
|
94
|
+
- `bound_method` → resolved through full MRO (`getattr(owner_class, method_name)`). Unset fallback is intentionally omitted because all supported lifecycle methods (_validate, _logic, _decompose) are guaranteed to exist in MRO contracts.
|
|
95
|
+
|
|
96
|
+
### 2. Early-exit for default `_decompose`
|
|
97
|
+
Decomposition is optional. `SimpleObject` defines a default fallback `@classmethod def _decompose` that returns `UNSET`.
|
|
98
|
+
To avoid triggering unnecessary validation pipelines or dry-run evaluation failures on nested subclasses:
|
|
99
|
+
- If `method_name == "_decompose"` AND `raw_method is UNSET` (not overridden locally) AND `bound_method.__func__` points to `SimpleObject._decompose.__func__` (memory identity check via `is`), the process immediately short-circuits returning `(False, UNSET)`.
|
|
100
|
+
- If an intermediate ancestor defines a custom `_decompose`, memory pointers won't match `SimpleObject._decompose.__func__`, allowing proper inheritance and re-validation down the hierarchy.
|
|
101
|
+
|
|
102
|
+
### 3. Descriptor routing & isolation rules
|
|
103
|
+
If the method is a valid `classmethod` or inherited descriptor:
|
|
104
|
+
- **Local override (`raw_method is not UNSET`)**: Always requires full signature and dry-run validation (`return True, bound_method`).
|
|
105
|
+
- **Inherited `_validate`**: Validation rules belong to the declaring class; inherited `_validate` methods are never re-validated (`return False, bound_method`).
|
|
106
|
+
- **Deep subclassing (non-direct descendants)**: Inherited methods are cloned using `_clone_classmethod` if the subclass alters structural keys (`_inners`, `_type`, `_logic`) to isolate method state and prevent side-effects.
|
|
107
|
+
|
|
108
|
+
### 4. Exception metadata & Micro-validations
|
|
109
|
+
If a method fails structural descriptor checks (e.g. defined as standard function instead of `@classmethod`), descriptive diagnostics are compiled (`exception_info`, `expected_structure`) and dispatched to targeted micro-validators:
|
|
110
|
+
- `validate_method_is_defined`
|
|
111
|
+
- `validate_method_is_callable`
|
|
112
|
+
- `validate_method_is_classmethod`
|
|
113
|
+
|
|
114
|
+
## Notes
|
|
115
|
+
- `is` comparison on `.__func__` operates at CPython pointer level (O(1) efficiency) without requiring expensive MRO traversals.
|
|
116
|
+
- Early exit guarantees that unhandled `_decompose` hooks will not leak `UNSET` outcomes into dry-run validators.
|
|
117
|
+
"""
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from .verify_params import verify_params
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Params Verification Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Orchestrates structural footprint audits across method inputs. It aligns physical method signatures directly with metadata naming registries, preventing illegal positional layouts, missing parameters, or forbidden variable arguments.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :-------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
14
|
+
| `verify_params` | Function | High-level coordinator validating complete argument naming layouts and signature counts. |
|
|
15
|
+
"""
|