simplibs-object 0.1.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- simplibs/object/SimpleBase.py +115 -0
- simplibs/object/SimpleConstant.py +271 -0
- simplibs/object/SimpleObject.py +293 -0
- simplibs/object/__init__.py +7 -0
- simplibs/object/_core/__init__.py +66 -0
- simplibs/object/_core/logic/__init__.py +0 -0
- simplibs/object/_core/logic/constant_methods/__init__.py +22 -0
- simplibs/object/_core/logic/constant_methods/bool_or_raise_validate_error.py +76 -0
- simplibs/object/_core/logic/constant_methods/normalize.py +92 -0
- simplibs/object/_core/logic/constant_methods/validate.py +99 -0
- simplibs/object/_core/logic/constant_methods/validate_type.py +48 -0
- simplibs/object/_core/logic/constant_methods/validations/__init__.py +22 -0
- simplibs/object/_core/logic/constant_methods/validations/_extract_clean_code_lines.py +86 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_missing_value_error.py +71 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_type_error.py +59 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_unexpected_validation_error.py +66 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_validation_error.py +78 -0
- simplibs/object/_core/logic/object_methods/__init__.py +18 -0
- simplibs/object/_core/logic/object_methods/_process_calculate_value_params.py +108 -0
- simplibs/object/_core/logic/object_methods/calculate_value.py +81 -0
- simplibs/object/_core/logic/object_methods/decompose_value.py +91 -0
- simplibs/object/_core/logic/object_methods/validations/__init__.py +22 -0
- simplibs/object/_core/logic/object_methods/validations/raise_class_not_decomposeable.py +82 -0
- simplibs/object/_core/logic/object_methods/validations/raise_duplicate_argument_error.py +77 -0
- simplibs/object/_core/logic/object_methods/validations/raise_too_many_positional_args_error.py +81 -0
- simplibs/object/_core/logic/object_methods/validations/raise_unknown_parameter_error.py +77 -0
- simplibs/object/_core/logic/property_builders/__init__.py +20 -0
- simplibs/object/_core/logic/property_builders/create_instance_property.py +66 -0
- simplibs/object/_core/logic/property_builders/create_properties_for_inner.py +97 -0
- simplibs/object/_core/logic/property_builders/create_value_property.py +98 -0
- simplibs/object/_core/logic/property_builders/value_helpers/__init__.py +18 -0
- simplibs/object/_core/logic/property_builders/value_helpers/create_value_getter.py +52 -0
- simplibs/object/_core/logic/property_builders/value_helpers/create_value_setter.py +95 -0
- simplibs/object/_core/logic/property_builders/value_helpers/validations/__init__.py +16 -0
- simplibs/object/_core/logic/property_builders/value_helpers/validations/raise_locked_value_error.py +103 -0
- simplibs/object/_core/metadata/SimpleBaseMetadata.py +139 -0
- simplibs/object/_core/metadata/SimpleConstantMetadata.py +108 -0
- simplibs/object/_core/metadata/SimpleMeta.py +214 -0
- simplibs/object/_core/metadata/SimpleObjectMetadata.py +165 -0
- simplibs/object/_core/metadata/__init__.py +16 -0
- simplibs/object/_core/metadata/constants/BASE_CLASS_NAMES.py +23 -0
- simplibs/object/_core/metadata/constants/__init__.py +16 -0
- simplibs/object/_core/metadata/init_processors/__init__.py +47 -0
- simplibs/object/_core/metadata/init_processors/blueprint_path/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/blueprint_path/calculate_blueprint_path.py +81 -0
- simplibs/object/_core/metadata/init_processors/default/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/default/process_default_for_constant.py +71 -0
- simplibs/object/_core/metadata/init_processors/default/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/default/validations/_exception_info_for_default.py +66 -0
- simplibs/object/_core/metadata/init_processors/default/validations/raise_default_is_defined_in_composition.py +78 -0
- simplibs/object/_core/metadata/init_processors/default/validations/validate_default_is_defined.py +77 -0
- simplibs/object/_core/metadata/init_processors/default/validations/validate_default_matches_annotation.py +93 -0
- simplibs/object/_core/metadata/init_processors/inners/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/inners/process_inners.py +143 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/__init__.py +33 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/_exception_info_for_inners.py +43 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/_get_collision_path.py +45 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_collision_within_inners.py +78 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_if_collision_with_owner_class.py +66 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_class.py +58 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_not_simple_class.py +60 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_simple_subclass.py +61 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_defined.py +56 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_not_empty.py +57 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_tuple.py +57 -0
- simplibs/object/_core/metadata/init_processors/methods/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/process_classmethod.py +130 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/__init__.py +16 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/exception_info_for_classmethod.py +52 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/expected_structure_for_classmethod.py +80 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/_convert_annotation_to_type_set.py +38 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_annotations.py +84 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_args_defaults.py +76 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_kwargs_defaults.py +74 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/verify_annotations_and_defaults.py +100 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/raise_decompose_unvalide_outcome_length.py +64 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_type.py +77 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_value.py +72 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/verify_decompose_outcome.py +87 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_raised_exceptions.py +56 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_return_unvalide_outcome_type.py +80 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/verify_calculation.py +89 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/_clone_classmethod.py +81 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_callable.py +60 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_classmethod.py +60 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_defined.py +67 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/verify_classmethod.py +117 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_has_exact_args_count.py +59 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_not_use_param_placeholders.py +66 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_param_match_expected.py +61 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/verify_params.py +123 -0
- simplibs/object/_core/metadata/init_processors/names/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/names/_class_name_splitter.py +242 -0
- simplibs/object/_core/metadata/init_processors/names/create_names.py +119 -0
- simplibs/object/_core/metadata/init_processors/names/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_has_no_underscores.py +94 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_ascii.py +95 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_identifier.py +83 -0
- simplibs/object/_core/metadata/init_processors/type/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/type/process_type.py +117 -0
- simplibs/object/_core/metadata/init_processors/type/validations/__init__.py +29 -0
- simplibs/object/_core/metadata/init_processors/type/validations/_exception_info_for_type.py +88 -0
- simplibs/object/_core/metadata/init_processors/type/validations/raise_union_type_contain_none.py +70 -0
- simplibs/object/_core/metadata/init_processors/type/validations/raise_validate_type_is_not_valid.py +92 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_from_tuple_is_not_none.py +94 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_defined.py +85 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_empty.py +93 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_none.py +87 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_tuple_is_not_nested.py +92 -0
- simplibs/object/_core/metadata/instance_builders/__init__.py +55 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/InstanceBase.py +77 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/__init__.py +16 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/__init__.py +16 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_atom_init.py +51 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_root_value_setter.py +67 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/make_atom_class.py +101 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/__init__.py +14 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/__init__.py +20 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/_get_inner_instance_class.py +51 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_composite_init.py +74 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_properties_for_inners.py +50 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_inners.py +57 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_self.py +69 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/make_composite_class.py +93 -0
- simplibs/object/_core/metadata/instance_builders/instance/__init__.py +17 -0
- simplibs/object/_core/metadata/instance_builders/instance/create_instance.py +107 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/__init__.py +25 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_combined_init_mixins.py +40 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_instance_class_dict.py +127 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_extend_instance_class.py +59 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_resolve_flat_mixins.py +74 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_verify_mixin_compatibility.py +83 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/create_instance_class.py +76 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/get_base_class.py +53 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/__init__.py +20 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/__init__.py +29 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_composite.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_constant.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_immutable.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_mutable.py +60 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_support_default_value_type.py +66 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_class.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_simple_base_subclass.py +60 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_invalide_extend_instance_class_definition.py +62 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision_with_base_class.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/__init__.py +21 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_class_is_not_base_class.py +54 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_hashing_for_immutable_value.py +66 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_param_is_bool.py +47 -0
- simplibs/object/_core/metadata/validations/__init__.py +18 -0
- simplibs/object/_core/metadata/validations/raise_attribut_allready_set.py +57 -0
- simplibs/object/_core/metadata/validations/raise_metadata_is_immutable.py +73 -0
- simplibs/object/_core/protocols/__init__.py +118 -0
- simplibs/object/_core/protocols/alias_typings/__init__.py +137 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangeTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangesDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangesTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/changes/__init__.py +18 -0
- simplibs/object/_core/protocols/alias_typings/history/HistoryDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/history/HistoryEntry.py +10 -0
- simplibs/object/_core/protocols/alias_typings/history/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/inners/InnersMap.py +8 -0
- simplibs/object/_core/protocols/alias_typings/inners/InnersTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/inners/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/mixins/MixinsTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/mixins/__init__.py +14 -0
- simplibs/object/_core/protocols/alias_typings/names/NamesSet.py +5 -0
- simplibs/object/_core/protocols/alias_typings/names/NamesTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/names/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodeItem.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesIndexMap.py +6 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesInstanceDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesPathDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/nodes/__init__.py +24 -0
- simplibs/object/_core/protocols/alias_typings/paths/PathDict.py +8 -0
- simplibs/object/_core/protocols/alias_typings/paths/PathTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/paths/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffItem.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/__init__.py +20 -0
- simplibs/object/_core/protocols/alias_typings/state/StateDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/state/__init__.py +14 -0
- simplibs/object/_core/protocols/alias_typings/types/ValidTypes.py +6 -0
- simplibs/object/_core/protocols/alias_typings/types/__init__.py +14 -0
- simplibs/object/_core/protocols/classes/SimpleBaseProtocol.py +25 -0
- simplibs/object/_core/protocols/classes/SimpleConstantProtocol.py +54 -0
- simplibs/object/_core/protocols/classes/SimpleObjectProtocol.py +50 -0
- simplibs/object/_core/protocols/classes/__init__.py +26 -0
- simplibs/object/_core/protocols/instance/SimpleConstantInstanceProtocol.py +13 -0
- simplibs/object/_core/protocols/instance/SimpleInstanceBaseProtocol.py +24 -0
- simplibs/object/_core/protocols/instance/SimpleObjectInstanceProtocol.py +13 -0
- simplibs/object/_core/protocols/instance/__init__.py +29 -0
- simplibs/object/_core/protocols/instance/core_classes/AtomInstanceProtocol.py +46 -0
- simplibs/object/_core/protocols/instance/core_classes/CompositeInstanceProtocol.py +37 -0
- simplibs/object/_core/protocols/instance/core_classes/InstanceBaseProtocol.py +28 -0
- simplibs/object/_core/protocols/instance/core_classes/__init__.py +19 -0
- simplibs/object/_core/protocols/metadata/SimpleBaseMetadataProtocol.py +37 -0
- simplibs/object/_core/protocols/metadata/SimpleConstantMetadataProtocol.py +45 -0
- simplibs/object/_core/protocols/metadata/SimpleMetaProtocol.py +39 -0
- simplibs/object/_core/protocols/metadata/SimpleObjectMetadataProtocol.py +49 -0
- simplibs/object/_core/protocols/metadata/__init__.py +28 -0
- simplibs/object/_core/protocols/methods/ClassMethodProtocol.py +29 -0
- simplibs/object/_core/protocols/methods/LogicSignature.py +20 -0
- simplibs/object/_core/protocols/methods/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/__init__.py +120 -0
- simplibs/object/_core/protocols/mixins/base_class/SimpleMixinProtocol.py +46 -0
- simplibs/object/_core/protocols/mixins/base_class/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/core_mixins/InfrastructureProtocol.py +16 -0
- simplibs/object/_core/protocols/mixins/core_mixins/NodesDictsProtocol.py +38 -0
- simplibs/object/_core/protocols/mixins/core_mixins/NodesTupleProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/core_mixins/SerializationProtocol.py +55 -0
- simplibs/object/_core/protocols/mixins/core_mixins/SnapshotProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/core_mixins/__init__.py +27 -0
- simplibs/object/_core/protocols/mixins/dunders/__init__.py +123 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/CollectionBaseProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/CollectionProtocol.py +20 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/IterableProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/MappingProtocol.py +52 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/__init__.py +21 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/EqualityProtocol.py +31 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/OrderingProtocol.py +32 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/generics/ClassGetItemProtocol.py +23 -0
- simplibs/object/_core/protocols/mixins/dunders/generics/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/CallProtocol.py +26 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/ContextProtocol.py +38 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/CopyableProtocol.py +33 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/LifecycleProtocol.py +21 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleReduceProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleStateProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/__init__.py +20 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/PicklePlan.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/ArithmeticProtocol.py +95 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/BitwiseProtocol.py +79 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/ConversionProtocol.py +57 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/InplaceProtocol.py +66 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/UnaryProtocol.py +35 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/__init__.py +22 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/Operator.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/UnaryOperator.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/ValueDisplayProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/ValueFormattingProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsProtocol.py +69 -0
- simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsWithInnersProtocol.py +27 -0
- simplibs/object/_core/protocols/mixins/immutable/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/numerical/EqualizerProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/numerical/VolumeProtocol.py +32 -0
- simplibs/object/_core/protocols/mixins/numerical/__init__.py +17 -0
- simplibs/object/_core/protocols/mixins/numerical/internal_types/SteppersMap.py +8 -0
- simplibs/object/_core/protocols/mixins/numerical/internal_types/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/StepperProtocol.py +95 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/LimitAction.py +5 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/StepValue.py +6 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/properties/InnersPropertyProtocol.py +31 -0
- simplibs/object/_core/protocols/mixins/properties/MetaShortcutsProtocol.py +49 -0
- simplibs/object/_core/protocols/mixins/properties/__init__.py +17 -0
- simplibs/object/_core/protocols/mixins/state/DefaultStateProtocol.py +41 -0
- simplibs/object/_core/protocols/mixins/state/DirtyTrackingProtocol.py +61 -0
- simplibs/object/_core/protocols/mixins/state/HistoryProtocol.py +112 -0
- simplibs/object/_core/protocols/mixins/state/PermissionProtocol.py +35 -0
- simplibs/object/_core/protocols/mixins/state/__init__.py +22 -0
- simplibs/object/exceptions/SimpleDefinitionError.py +45 -0
- simplibs/object/exceptions/SimpleInitializationError.py +43 -0
- simplibs/object/exceptions/SimpleRuntimeError.py +50 -0
- simplibs/object/exceptions/__init__.py +62 -0
- simplibs/object/exceptions/base_exception/SimpleObjectError.py +107 -0
- simplibs/object/exceptions/base_exception/__init__.py +19 -0
- simplibs/object/mixins/__init__.py +99 -0
- simplibs/object/mixins/_common_logic/__init__.py +41 -0
- simplibs/object/mixins/_common_logic/constants/__init__.py +27 -0
- simplibs/object/mixins/_common_logic/constants/names/HISTORY.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/OWNER_CLASS.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/STEPPER.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/VALUE.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/__init__.py +28 -0
- simplibs/object/mixins/_common_logic/constants/sets/FORBIDDEN_NAMES.py +27 -0
- simplibs/object/mixins/_common_logic/constants/sets/RESTRICTION_FLAGS.py +18 -0
- simplibs/object/mixins/_common_logic/constants/sets/__init__.py +22 -0
- simplibs/object/mixins/_common_logic/immutability/__init__.py +28 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/__init__.py +22 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/get_top_composite_paths.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/process_single_change.py +143 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_changes.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths.py +147 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths2.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/__init__.py +23 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_split_changes_unknown_name.py +107 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_with_any_unknown_name.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/__init__.py +24 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_changes_is_not_tuple.py +65 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_child_composite_mismatch.py +68 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_contained_constant_mismatch.py +67 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/with_any.py +238 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/utils/__init__.py +15 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/utils/reacalculate_inners.py +112 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/__init__.py +21 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_is_decomposeable.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_name_exists.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/with_composite.py +176 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/__init__.py +20 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_new_instance.py +130 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_snapshot_dict.py +83 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/reacalculate_owner_value.py +131 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/__init__.py +16 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/raise_immutability_constant_not_found.py +93 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/with_constant.py +147 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/utils/__init__.py +15 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/utils/find_longest_keys.py +112 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/__init__.py +25 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_batch_constant_not_found.py +94 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_constants_changes_not_tuple.py +94 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_has_length_two.py +91 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_is_tuple.py +99 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_name_is_str.py +90 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/with_constants.py +193 -0
- simplibs/object/mixins/base_class/SimpleMixin.py +118 -0
- simplibs/object/mixins/base_class/__init__.py +17 -0
- simplibs/object/mixins/base_class/_meta/SimpleMixinMeta.py +59 -0
- simplibs/object/mixins/base_class/_meta/__init__.py +21 -0
- simplibs/object/mixins/base_class/_meta/_verify_mixin_definition.py +161 -0
- simplibs/object/mixins/base_class/_meta/validations/__init__.py +34 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_dict_contains_forbidden_attributes.py +101 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_flag_is_not_bool.py +122 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_init_mixins_contains_super_call.py +75 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_only_types_invalid.py +107 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contain_unvalid_type.py +85 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contains_forbidden_slot_names.py +102 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_is_not_defined.py +79 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_unsuport_type.py +88 -0
- simplibs/object/mixins/core_mixins/Infrastructure.py +49 -0
- simplibs/object/mixins/core_mixins/NodesDicts.py +104 -0
- simplibs/object/mixins/core_mixins/NodesTuple.py +86 -0
- simplibs/object/mixins/core_mixins/Serialization.py +120 -0
- simplibs/object/mixins/core_mixins/Snapshot.py +104 -0
- simplibs/object/mixins/core_mixins/__init__.py +32 -0
- simplibs/object/mixins/core_mixins/_utils/__init__.py +49 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/__init__.py +17 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/_collect_nodes_data.py +131 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/build_nodes_tuple.py +104 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/__init__.py +20 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/from_dict.py +190 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/from_dict_constants.py +151 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/to_dict.py +158 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/__init__.py +30 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_invalid_composite_structure.py +65 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_composite_key.py +64 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_value_key.py +66 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_owner_class_mismatch_for_state_dict.py +77 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_state_dict_input.py +67 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/__init__.py +15 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/compare_snapshots.py +102 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/validations/__init__.py +16 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/validations/raise_snapshot_incompatible_error.py +101 -0
- simplibs/object/mixins/dunders/__init__.py +61 -0
- simplibs/object/mixins/dunders/collections/CollectionBase.py +129 -0
- simplibs/object/mixins/dunders/collections/Iterable.py +81 -0
- simplibs/object/mixins/dunders/collections/Mapping.py +131 -0
- simplibs/object/mixins/dunders/collections/__init__.py +29 -0
- simplibs/object/mixins/dunders/collections/main/Collection.py +47 -0
- simplibs/object/mixins/dunders/collections/main/__init__.py +20 -0
- simplibs/object/mixins/dunders/comparison/Equality.py +128 -0
- simplibs/object/mixins/dunders/comparison/Ordering.py +130 -0
- simplibs/object/mixins/dunders/comparison/__init__.py +25 -0
- simplibs/object/mixins/dunders/generics/ClassGetItem.py +105 -0
- simplibs/object/mixins/dunders/generics/__init__.py +20 -0
- simplibs/object/mixins/dunders/interfaces/Call.py +101 -0
- simplibs/object/mixins/dunders/interfaces/Context.py +100 -0
- simplibs/object/mixins/dunders/interfaces/__init__.py +23 -0
- simplibs/object/mixins/dunders/lifecycles/Copyable.py +103 -0
- simplibs/object/mixins/dunders/lifecycles/PickleReduce.py +88 -0
- simplibs/object/mixins/dunders/lifecycles/PickleState.py +104 -0
- simplibs/object/mixins/dunders/lifecycles/__init__.py +29 -0
- simplibs/object/mixins/dunders/lifecycles/_utils/__init__.py +20 -0
- simplibs/object/mixins/dunders/lifecycles/_utils/rebuild_simple_instance.py +51 -0
- simplibs/object/mixins/dunders/lifecycles/main/Lifecycle.py +45 -0
- simplibs/object/mixins/dunders/lifecycles/main/__init__.py +20 -0
- simplibs/object/mixins/dunders/numeric/Arithmetic.py +195 -0
- simplibs/object/mixins/dunders/numeric/Bitwise.py +172 -0
- simplibs/object/mixins/dunders/numeric/Conversion.py +149 -0
- simplibs/object/mixins/dunders/numeric/Inplace.py +124 -0
- simplibs/object/mixins/dunders/numeric/Unary.py +89 -0
- simplibs/object/mixins/dunders/numeric/__init__.py +31 -0
- simplibs/object/mixins/dunders/numeric/_utils/__init__.py +41 -0
- simplibs/object/mixins/dunders/numeric/_utils/_align_operand_type.py +111 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_arithmetic_op.py +157 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_bitwise_op.py +116 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_conversion.py +107 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_inplace_op.py +139 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_unary_op.py +121 -0
- simplibs/object/mixins/dunders/representation/ValueDisplay.py +96 -0
- simplibs/object/mixins/dunders/representation/ValueFormatting.py +144 -0
- simplibs/object/mixins/dunders/representation/__init__.py +24 -0
- simplibs/object/mixins/others/__init__.py +48 -0
- simplibs/object/mixins/others/immutable/ImmutableMethods.py +142 -0
- simplibs/object/mixins/others/immutable/ImmutableMethodsWithInners.py +111 -0
- simplibs/object/mixins/others/immutable/__init__.py +24 -0
- simplibs/object/mixins/others/immutable/_validations/__init__.py +19 -0
- simplibs/object/mixins/others/immutable/_validations/raise_with_changes_input_not_dict.py +60 -0
- simplibs/object/mixins/others/numerical/Equalizer.py +129 -0
- simplibs/object/mixins/others/numerical/Volume.py +100 -0
- simplibs/object/mixins/others/numerical/__init__.py +25 -0
- simplibs/object/mixins/others/numerical/_stepper_class/Stepper.py +227 -0
- simplibs/object/mixins/others/numerical/_stepper_class/__init__.py +31 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/__init__.py +35 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/__init__.py +33 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/process_step_value.py +114 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/__init__.py +29 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_down_limit_reached.py +115 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_up_limit_reached.py +110 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_down_limit.py +141 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_up_limit.py +141 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/set_value.py +163 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/step_down.py +154 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/step_up.py +154 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/__init__.py +38 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_down_limit_value.py +143 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_limit_action.py +118 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_up_limit_value.py +143 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_value.py +142 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validate_instance.py +138 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/__init__.py +39 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_action.py +118 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_down_limit.py +125 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_instance.py +117 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_up_limit.py +125 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_non_numeric_value.py +122 -0
- simplibs/object/mixins/others/properties/InnersProperty.py +91 -0
- simplibs/object/mixins/others/properties/MetaShortcuts.py +113 -0
- simplibs/object/mixins/others/properties/__init__.py +24 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/__init__.py +23 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/_collect_nested_inner_properties.py +134 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/collect_all_nested_properties.py +132 -0
- simplibs/object/mixins/others/state/DefaultState.py +119 -0
- simplibs/object/mixins/others/state/DirtyTracking.py +144 -0
- simplibs/object/mixins/others/state/History.py +248 -0
- simplibs/object/mixins/others/state/Permission.py +102 -0
- simplibs/object/mixins/others/state/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/__init__.py +50 -0
- simplibs/object/mixins/others/state/_history_utils/core/__init__.py +32 -0
- simplibs/object/mixins/others/state/_history_utils/core/find_snapshot.py +142 -0
- simplibs/object/mixins/others/state/_history_utils/core/record_state.py +130 -0
- simplibs/object/mixins/others/state/_history_utils/core/set_history_limit.py +114 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_history_limit_not_positive_integer.py +65 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snapshot_index.py +67 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_reference.py +67 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_timestamp.py +66 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_timestamp.py +63 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/__init__.py +38 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_index.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_timestamp.py +115 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_last_history.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/history_redo.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/history_undo.py +104 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/export_history_to_dict.py +110 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/import_history_from_dict.py +169 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/__init__.py +24 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_history_import_file.py +66 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_owner_class_mismatch.py +69 -0
- simplibs/object/settings/__init__.py +90 -0
- simplibs/object/settings/logging.py +138 -0
- simplibs/object/testing/__init__.py +90 -0
- simplibs/object/testing/assert_simple_mixin.py +150 -0
- simplibs/object/testing/assert_simple_object.py +219 -0
- simplibs/object/testing/asserts/__init__.py +53 -0
- simplibs/object/testing/asserts/base/__init__.py +22 -0
- simplibs/object/testing/asserts/base/assert_class_inheritance.py +75 -0
- simplibs/object/testing/asserts/base/assert_instance_creation.py +119 -0
- simplibs/object/testing/asserts/base/assert_user_instance_creation.py +97 -0
- simplibs/object/testing/asserts/base/assert_value_change.py +142 -0
- simplibs/object/testing/asserts/methods/__init__.py +20 -0
- simplibs/object/testing/asserts/methods/assert_calculate_value_method.py +113 -0
- simplibs/object/testing/asserts/methods/assert_decompose_value_method.py +109 -0
- simplibs/object/testing/asserts/methods/assert_validate_method.py +111 -0
- simplibs/object/testing/asserts/mixins/__init__.py +22 -0
- simplibs/object/testing/asserts/mixins/assert_instance_hasattr.py +94 -0
- simplibs/object/testing/asserts/mixins/assert_mixin_inheritance.py +72 -0
- simplibs/object/testing/asserts/mixins/assert_mixin_instance_creation.py +142 -0
- simplibs/object/testing/asserts/mixins/assert_mixins_slots_values.py +126 -0
- simplibs/object/testing/asserts/mutability/__init__.py +18 -0
- simplibs/object/testing/asserts/mutability/assert_immutable_behavior.py +118 -0
- simplibs/object/testing/asserts/mutability/assert_mutable_behavior.py +108 -0
- simplibs/object/testing/asserts/reactivity/__init__.py +17 -0
- simplibs/object/testing/asserts/reactivity/assert_reactivity_downward.py +141 -0
- simplibs/object/testing/asserts/reactivity/assert_reactivity_upward.py +109 -0
- simplibs/object/testing/bulk_test.py +150 -0
- simplibs/object/testing/containers/InnerValue.py +102 -0
- simplibs/object/testing/containers/MixinCase.py +89 -0
- simplibs/object/testing/containers/ObjectCase.py +101 -0
- simplibs/object/testing/containers/TestMixin.py +122 -0
- simplibs/object/testing/containers/__init__.py +20 -0
- simplibs/object/testing/containers/_validations/__init__.py +18 -0
- simplibs/object/testing/containers/_validations/raise_inner_value_empty_path.py +39 -0
- simplibs/object/testing/containers/_validations/raise_inner_value_invalid_path_type.py +44 -0
- simplibs/object/tools/__init__.py +0 -0
- simplibs/object/tools/automate_creators/__init__.py +0 -0
- simplibs/object/tools/automate_creators/_helpers/__init__.py +5 -0
- simplibs/object/tools/automate_creators/_helpers/_is_lambda.py +34 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/__init__.py +3 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_calculate_default_failed.py +51 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_inner_is_not_simple_constant_subclass.py +44 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_inners_is_not_tuple.py +41 -0
- simplibs/object/tools/automate_creators/_helpers/calculate_default.py +51 -0
- simplibs/object/tools/automate_creators/_helpers/load_parameters_from_inners.py +72 -0
- simplibs/object/tools/automate_creators/_helpers/process_decompose.py +47 -0
- simplibs/object/tools/automate_creators/_helpers/process_logic.py +57 -0
- simplibs/object/tools/automate_creators/_helpers/process_validate.py +48 -0
- simplibs/object/tools/automate_creators/_validations/__init__.py +7 -0
- simplibs/object/tools/automate_creators/_validations/validate_class_name_is_str.py +36 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_inners.py +43 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_logic.py +44 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_not_default.py +37 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_default.py +48 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_decompose.py +37 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_logic.py +37 -0
- simplibs/object/tools/automate_creators/bulk/BulkCase.py +100 -0
- simplibs/object/tools/automate_creators/bulk/__init__.py +0 -0
- simplibs/object/tools/automate_creators/bulk/create_simple_object_bulk.py +77 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/__init__.py +0 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/__init__.py +8 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_csv_callable_not_supported.py +26 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_data_not_list.py +28 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_decode_failed.py +29 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_sequence.py +27 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_str.py +28 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_item_is_not_bulk_dict.py +39 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_table_row_not_sequence.py +26 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_yaml_import_failed.py +22 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_bulk_case_class.py +57 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_csv.py +68 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_dicts.py +19 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_json.py +24 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_table.py +43 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_yaml.py +29 -0
- simplibs/object/tools/automate_creators/create_constant_class.py +84 -0
- simplibs/object/tools/automate_creators/create_object_class.py +110 -0
- simplibs/object/tools/automate_creators/create_simple_object.py +97 -0
- simplibs/object/tools/randomize/__init__.py +18 -0
- simplibs/object/tools/randomize/_validations/__init__.py +28 -0
- simplibs/object/tools/randomize/_validations/raise_random_data_filler_exhausted.py +55 -0
- simplibs/object/tools/randomize/_validations/validate_instance_is_simple_constant_base.py +52 -0
- simplibs/object/tools/randomize/_validations/validate_registry_is_randomize_registry_base.py +51 -0
- simplibs/object/tools/randomize/_validations/validate_retries_is_greater_than_zero.py +48 -0
- simplibs/object/tools/randomize/_validations/validate_retries_is_int.py +49 -0
- simplibs/object/tools/randomize/_validations/validate_skip_immutable_is_bool.py +43 -0
- simplibs/object/tools/randomize/_validations/validate_skip_unregistered_is_bool.py +44 -0
- simplibs/object/tools/randomize/random_data_filler.py +133 -0
- simplibs/object/tools/randomize/randomize_value.py +122 -0
- simplibs_object-0.1.1.dist-info/METADATA +590 -0
- simplibs_object-0.1.1.dist-info/RECORD +580 -0
- simplibs_object-0.1.1.dist-info/WHEEL +5 -0
- simplibs_object-0.1.1.dist-info/licenses/LICENSE +21 -0
- simplibs_object-0.1.1.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_inners import _exception_info_for_inners
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_inner_is_not_simple_class(
|
|
12
|
+
inner: "SimpleClassLike",
|
|
13
|
+
owner_class: "SimpleClassLike",
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Validates that inner is not SimpleConstant or SimpleObject."""
|
|
16
|
+
|
|
17
|
+
# Lazy imports to avoid circular dependencies
|
|
18
|
+
from ......SimpleConstant import SimpleConstant
|
|
19
|
+
from ......SimpleObject import SimpleObject
|
|
20
|
+
|
|
21
|
+
# 1. Check identity
|
|
22
|
+
if inner is not SimpleConstant and inner is not SimpleObject:
|
|
23
|
+
return
|
|
24
|
+
|
|
25
|
+
# 2. Diagnostic info
|
|
26
|
+
class_name, error_name, context, acceptable = _exception_info_for_inners(owner_class)
|
|
27
|
+
|
|
28
|
+
# 3. Raise error
|
|
29
|
+
raise SimpleDefinitionError(
|
|
30
|
+
error_name=error_name,
|
|
31
|
+
label="inner_is_base_class",
|
|
32
|
+
expected="Concrete subclass of SimpleConstant or SimpleObject",
|
|
33
|
+
value=inner,
|
|
34
|
+
problem=f"Class '{class_name}' declares base class '{inner.__name__}' inside _inners.",
|
|
35
|
+
context=context,
|
|
36
|
+
how_to_fix=(
|
|
37
|
+
"Use concrete subclasses, not the base framework classes.",
|
|
38
|
+
"SimpleObject and SimpleConstant serve only as inheritance roots.",
|
|
39
|
+
"Replace this reference with a specific subclass representing actual data.",
|
|
40
|
+
) + acceptable,
|
|
41
|
+
exception=TypeError,
|
|
42
|
+
)
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
_DESIGN_NOTES = """
|
|
46
|
+
# validate_inner_is_not_simple_class
|
|
47
|
+
|
|
48
|
+
## Purpose
|
|
49
|
+
Ensures that `_inners` does not contain the raw base classes `SimpleObject`
|
|
50
|
+
or `SimpleConstant`. Only concrete subclasses are allowed.
|
|
51
|
+
|
|
52
|
+
## Behavior
|
|
53
|
+
1. Compares the inner element using identity (`is`) with the base classes.
|
|
54
|
+
2. If invalid, retrieves shared diagnostic info.
|
|
55
|
+
3. Raises a structured `SimpleDefinitionError`.
|
|
56
|
+
|
|
57
|
+
## Notes
|
|
58
|
+
This validator complements `validate_inner_is_simple_subclass`.
|
|
59
|
+
The first checks inheritance; this one checks that the class is not the root itself.
|
|
60
|
+
"""
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_inners import _exception_info_for_inners
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_inner_is_simple_subclass(
|
|
12
|
+
inner: "SimpleClassLike",
|
|
13
|
+
owner_class: "SimpleClassLike",
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Validates that an inner element inherits from SimpleConstant."""
|
|
16
|
+
|
|
17
|
+
# Lazy import to avoid circular dependencies
|
|
18
|
+
from ......SimpleConstant import SimpleConstant
|
|
19
|
+
|
|
20
|
+
# 1. Check subclass relationship
|
|
21
|
+
inner: type
|
|
22
|
+
if issubclass(inner, SimpleConstant):
|
|
23
|
+
return
|
|
24
|
+
|
|
25
|
+
# 2. Diagnostic info
|
|
26
|
+
class_name, error_name, context, acceptable = _exception_info_for_inners(owner_class)
|
|
27
|
+
|
|
28
|
+
# 3. Raise error
|
|
29
|
+
raise SimpleDefinitionError(
|
|
30
|
+
error_name=error_name,
|
|
31
|
+
label="inner_not_simple_subclass",
|
|
32
|
+
expected="Subclass of SimpleConstant or SimpleObject",
|
|
33
|
+
value=inner,
|
|
34
|
+
problem=f"Inner element '{inner}' does not inherit from SimpleConstant.",
|
|
35
|
+
context=context,
|
|
36
|
+
how_to_fix=(
|
|
37
|
+
"Ensure the class inherits from SimpleConstant or SimpleObject.",
|
|
38
|
+
"Verify the inheritance tree of the failing class.",
|
|
39
|
+
"Check that you imported the correct class definition.",
|
|
40
|
+
) + acceptable,
|
|
41
|
+
exception=TypeError,
|
|
42
|
+
)
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
_DESIGN_NOTES = """
|
|
47
|
+
# validate_inner_is_simple_subclass
|
|
48
|
+
|
|
49
|
+
## Purpose
|
|
50
|
+
Ensures that each inner element inherits from the framework’s base classes
|
|
51
|
+
(SimpleConstant or SimpleObject).
|
|
52
|
+
|
|
53
|
+
## Behavior
|
|
54
|
+
1. Checks `issubclass(inner, SimpleConstant)`.
|
|
55
|
+
2. If invalid, retrieves shared diagnostic info.
|
|
56
|
+
3. Raises a structured `SimpleDefinitionError`.
|
|
57
|
+
|
|
58
|
+
## Notes
|
|
59
|
+
This validator assumes the inner element has already passed `validate_inner_is_class`.
|
|
60
|
+
It focuses exclusively on inheritance correctness.
|
|
61
|
+
"""
|
simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_defined.py
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ......exceptions import SimpleDefinitionError
|
|
5
|
+
# Inners
|
|
6
|
+
from ._exception_info_for_inners import _exception_info_for_inners
|
|
7
|
+
# Annotations
|
|
8
|
+
if TYPE_CHECKING:
|
|
9
|
+
from .....protocols.classes import SimpleClassLike
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
def validate_inners_is_defined(
|
|
13
|
+
attribute_value: Any,
|
|
14
|
+
owner_class: "SimpleClassLike",
|
|
15
|
+
) -> None:
|
|
16
|
+
"""Validates that '_inners' is explicitly defined."""
|
|
17
|
+
|
|
18
|
+
# 1. Check definition
|
|
19
|
+
if attribute_value is not UNSET:
|
|
20
|
+
return
|
|
21
|
+
|
|
22
|
+
# 2. Diagnostic info
|
|
23
|
+
class_name, error_name, context, acceptable = _exception_info_for_inners(owner_class)
|
|
24
|
+
|
|
25
|
+
# 3. Raise error
|
|
26
|
+
raise SimpleDefinitionError(
|
|
27
|
+
error_name=error_name,
|
|
28
|
+
label="_inners_missing",
|
|
29
|
+
expected="Explicit '_inners' tuple",
|
|
30
|
+
value=attribute_value,
|
|
31
|
+
problem=f"Class '{class_name}' does not define '_inners'.",
|
|
32
|
+
context=context,
|
|
33
|
+
how_to_fix=(
|
|
34
|
+
f"Define '_inners' inside class '{class_name}'.",
|
|
35
|
+
"Example:",
|
|
36
|
+
) + acceptable,
|
|
37
|
+
exception=AttributeError,
|
|
38
|
+
)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
_DESIGN_NOTES = """
|
|
43
|
+
# validate_inners_is_defined
|
|
44
|
+
|
|
45
|
+
## Purpose
|
|
46
|
+
Ensures that a composite class explicitly defines the `_inners` attribute.
|
|
47
|
+
|
|
48
|
+
## Behavior
|
|
49
|
+
1. Checks whether `_inners` is UNSET.
|
|
50
|
+
2. If missing, retrieves shared diagnostic info from `_exception_info_for_inners`.
|
|
51
|
+
3. Raises a structured `SimpleDefinitionError`.
|
|
52
|
+
|
|
53
|
+
## Notes
|
|
54
|
+
This validator is used only when `_inners` is expected to exist. It prevents
|
|
55
|
+
composite metadata from being processed without structural definitions.
|
|
56
|
+
"""
|
simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_not_empty.py
ADDED
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_inners import _exception_info_for_inners
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_inners_is_not_empty(
|
|
12
|
+
inners: Any,
|
|
13
|
+
owner_class: "SimpleClassLike",
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Validates that '_inners' is not an empty tuple."""
|
|
16
|
+
|
|
17
|
+
# 1. Check emptiness
|
|
18
|
+
if not (isinstance(inners, tuple) and not inners):
|
|
19
|
+
return
|
|
20
|
+
|
|
21
|
+
# 2. Diagnostic info
|
|
22
|
+
class_name, error_name, context, acceptable = _exception_info_for_inners(owner_class)
|
|
23
|
+
|
|
24
|
+
# 3. Raise error
|
|
25
|
+
raise SimpleDefinitionError(
|
|
26
|
+
error_name=error_name,
|
|
27
|
+
label="_inners_empty",
|
|
28
|
+
expected="Non-empty tuple of SimpleConstant / SimpleObject subclasses",
|
|
29
|
+
value=inners,
|
|
30
|
+
problem=f"Class '{class_name}' defines '_inners' as an empty tuple.",
|
|
31
|
+
context=context,
|
|
32
|
+
how_to_fix=(
|
|
33
|
+
"Remove '_inners' entirely if the class has no inner components.",
|
|
34
|
+
"If this is a composition, define at least one inner element.",
|
|
35
|
+
) + acceptable,
|
|
36
|
+
exception=ValueError,
|
|
37
|
+
)
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
_DESIGN_NOTES = """
|
|
41
|
+
# validate_inners_is_not_empty
|
|
42
|
+
|
|
43
|
+
## Purpose
|
|
44
|
+
Ensures that `_inners` is not an empty tuple.
|
|
45
|
+
If a class declares `_inners`, it must contain at least one inner element.
|
|
46
|
+
|
|
47
|
+
## Behavior
|
|
48
|
+
1. Checks whether `_inners` is an empty tuple.
|
|
49
|
+
2. If empty, retrieves shared diagnostic info.
|
|
50
|
+
3. Raises a structured `SimpleDefinitionError`.
|
|
51
|
+
|
|
52
|
+
## Notes
|
|
53
|
+
An empty `_inners` is semantically invalid:
|
|
54
|
+
- a class with no inners should behave as a constant,
|
|
55
|
+
- a composition must declare at least one inner.
|
|
56
|
+
|
|
57
|
+
"""
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleDefinitionError
|
|
4
|
+
# Inners
|
|
5
|
+
from ._exception_info_for_inners import _exception_info_for_inners
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from .....protocols.classes import SimpleClassLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def validate_inners_is_tuple(
|
|
12
|
+
inners: Any,
|
|
13
|
+
owner_class: "SimpleClassLike",
|
|
14
|
+
) -> None:
|
|
15
|
+
"""Validates that '_inners' is a tuple."""
|
|
16
|
+
|
|
17
|
+
# 1. Check type
|
|
18
|
+
if isinstance(inners, tuple):
|
|
19
|
+
return
|
|
20
|
+
|
|
21
|
+
# 2. Diagnostic info
|
|
22
|
+
class_name, error_name, context, acceptable = _exception_info_for_inners(owner_class)
|
|
23
|
+
|
|
24
|
+
# 3. Raise error
|
|
25
|
+
raise SimpleDefinitionError(
|
|
26
|
+
error_name=error_name,
|
|
27
|
+
label="_inners_not_tuple",
|
|
28
|
+
expected="Tuple of SimpleConstant / SimpleObject subclasses",
|
|
29
|
+
value=inners,
|
|
30
|
+
problem=f"Class '{class_name}' defines '_inners' using an invalid type.",
|
|
31
|
+
context=context,
|
|
32
|
+
how_to_fix=(
|
|
33
|
+
"Define '_inners' as a tuple.",
|
|
34
|
+
"Example: _inners = (ElementA, ElementB)",
|
|
35
|
+
"Single element requires a trailing comma: (ElementA,)",
|
|
36
|
+
) + acceptable,
|
|
37
|
+
exception=TypeError,
|
|
38
|
+
)
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
_DESIGN_NOTES = """
|
|
43
|
+
# validate_inners_is_tuple
|
|
44
|
+
|
|
45
|
+
## Purpose
|
|
46
|
+
Ensures that `_inners` is declared as a tuple. Tuples provide immutability and
|
|
47
|
+
preserve positional order, which is required for `_logic` signature generation.
|
|
48
|
+
|
|
49
|
+
## Behavior
|
|
50
|
+
1. Checks whether `_inners` is a tuple.
|
|
51
|
+
2. If invalid, retrieves shared diagnostic info.
|
|
52
|
+
3. Raises a structured `SimpleDefinitionError`.
|
|
53
|
+
|
|
54
|
+
## Notes
|
|
55
|
+
This validator prevents accidental use of lists, sets, or missing trailing commas
|
|
56
|
+
in single-element tuple declarations.
|
|
57
|
+
"""
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from .process_classmethod import process_classmethod
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Methods Processors Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Exposes high-level execution entry points handling the extraction, parsing, and pipeline verification of class method metadata components during class system initialization.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :-------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
14
|
+
| `process_classmethod` | Function | Main orchestrator ingestion entry-point executing all verifications on class methods. |
|
|
15
|
+
"""
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
from typing import Any, TYPE_CHECKING
|
|
2
|
+
from types import UnionType
|
|
3
|
+
from simplibs.sentinels import UNSET
|
|
4
|
+
# Inners
|
|
5
|
+
from .verifiers.classmethod import verify_classmethod
|
|
6
|
+
from .verifiers.params import verify_params
|
|
7
|
+
from .verifiers.calculation import verify_calculation
|
|
8
|
+
from .verifiers.annotations_and_defaults import verify_annotations_and_defaults
|
|
9
|
+
# Annotations
|
|
10
|
+
if TYPE_CHECKING:
|
|
11
|
+
from ....protocols.classes import SimpleClassLike
|
|
12
|
+
from ....protocols.methods import ClassMethodProtocol
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
def process_classmethod(
|
|
16
|
+
method_name: str,
|
|
17
|
+
expected_params: tuple[str, ...],
|
|
18
|
+
expected_args_params_count: int,
|
|
19
|
+
expected_args_defaults: tuple[Any, ...],
|
|
20
|
+
expected_kwargs_defaults: dict[str, Any],
|
|
21
|
+
expected_param_types: dict[str, type | UnionType],
|
|
22
|
+
expected_return_type: type | UnionType,
|
|
23
|
+
owner_class: "SimpleClassLike",
|
|
24
|
+
test_value: tuple = (),
|
|
25
|
+
return_calculated_value: bool = False,
|
|
26
|
+
) -> Any:
|
|
27
|
+
"""Runs full verification, normalization, and dry-run execution of a classmethod."""
|
|
28
|
+
|
|
29
|
+
# 1. Resolve method descriptor and inheritance validation gate
|
|
30
|
+
need_validations, bound_method = verify_classmethod(
|
|
31
|
+
method_name=method_name,
|
|
32
|
+
owner_class=owner_class,
|
|
33
|
+
expected_params=expected_params,
|
|
34
|
+
expected_args_params_count=expected_args_params_count,
|
|
35
|
+
)
|
|
36
|
+
|
|
37
|
+
# 2. Pokud je metoda volitelná a není na třídě přítomna, vrací se UNSET bez spouštění dry-runu
|
|
38
|
+
if bound_method is UNSET:
|
|
39
|
+
return (UNSET, UNSET) if return_calculated_value else UNSET
|
|
40
|
+
bound_method: "ClassMethodProtocol"
|
|
41
|
+
|
|
42
|
+
# 3. Perform signature and annotation validations if needed
|
|
43
|
+
if need_validations:
|
|
44
|
+
|
|
45
|
+
# 3.1 Validate parameters
|
|
46
|
+
verify_params(
|
|
47
|
+
expected_params=expected_params,
|
|
48
|
+
expected_args_params_count=expected_args_params_count,
|
|
49
|
+
bound_method=bound_method,
|
|
50
|
+
)
|
|
51
|
+
|
|
52
|
+
# 3.2 Build unified annotation map
|
|
53
|
+
bound_method_annotations = {
|
|
54
|
+
**expected_param_types,
|
|
55
|
+
"return": expected_return_type,
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
# 3.3 Validate developer overrides (annotations/defaults)
|
|
59
|
+
func = bound_method.__func__
|
|
60
|
+
if func.__annotations__ or func.__defaults__ or func.__kwdefaults__:
|
|
61
|
+
verify_annotations_and_defaults(
|
|
62
|
+
bound_method=bound_method,
|
|
63
|
+
expected_params=expected_params,
|
|
64
|
+
expected_args_params_count=expected_args_params_count,
|
|
65
|
+
bound_method_annotations=bound_method_annotations,
|
|
66
|
+
expected_args_defaults=expected_args_defaults,
|
|
67
|
+
expected_kwargs_defaults=expected_kwargs_defaults,
|
|
68
|
+
)
|
|
69
|
+
|
|
70
|
+
# 3.4 Inject normalized defaults and annotations
|
|
71
|
+
func.__defaults__ = expected_args_defaults
|
|
72
|
+
func.__kwdefaults__ = expected_kwargs_defaults
|
|
73
|
+
func.__annotations__ = bound_method_annotations
|
|
74
|
+
|
|
75
|
+
# 4. Execute deterministic dry-run calculation
|
|
76
|
+
calculated_value = verify_calculation(
|
|
77
|
+
bound_method=bound_method,
|
|
78
|
+
test_value=test_value,
|
|
79
|
+
expected_return_type=expected_return_type,
|
|
80
|
+
owner_class=owner_class,
|
|
81
|
+
)
|
|
82
|
+
|
|
83
|
+
# 5. Return method or (method, calculated_value)
|
|
84
|
+
if return_calculated_value:
|
|
85
|
+
return bound_method, calculated_value
|
|
86
|
+
|
|
87
|
+
return bound_method
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
_DESIGN_NOTES = """
|
|
92
|
+
# process_classmethod
|
|
93
|
+
|
|
94
|
+
## Purpose
|
|
95
|
+
Coordinates the entire method validation pipeline:
|
|
96
|
+
- descriptor resolution,
|
|
97
|
+
- signature validation,
|
|
98
|
+
- annotation/default normalization,
|
|
99
|
+
- and deterministic dry-run execution.
|
|
100
|
+
|
|
101
|
+
## Behavior
|
|
102
|
+
|
|
103
|
+
### 1. Descriptor resolution
|
|
104
|
+
`verify_classmethod` determines whether the method is newly defined or inherited.
|
|
105
|
+
If inherited and already validated, the pipeline skips structural checks.
|
|
106
|
+
|
|
107
|
+
### 2. Structural validation
|
|
108
|
+
If validation is required:
|
|
109
|
+
- `verify_params` enforces parameter names and counts.
|
|
110
|
+
- A unified annotation map is constructed.
|
|
111
|
+
- If the developer declared annotations/defaults, `verify_annotations_and_defaults`
|
|
112
|
+
validates them.
|
|
113
|
+
|
|
114
|
+
### 3. Signature normalization
|
|
115
|
+
The function frame is updated with:
|
|
116
|
+
- positional defaults,
|
|
117
|
+
- keyword-only defaults,
|
|
118
|
+
- normalized annotations.
|
|
119
|
+
|
|
120
|
+
### 4. Operational validation
|
|
121
|
+
`verify_calculation` performs a controlled dry-run:
|
|
122
|
+
- catches runtime exceptions,
|
|
123
|
+
- validates return type,
|
|
124
|
+
- validates `_decompose` structure.
|
|
125
|
+
|
|
126
|
+
### 5. Output
|
|
127
|
+
Returns either:
|
|
128
|
+
- the validated classmethod, or
|
|
129
|
+
- the classmethod and its dry-run result.
|
|
130
|
+
"""
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# Packages are intended to be consumed via deep discrete imports or internal orchestration.
|
|
2
|
+
# Public top-level components are exposed explicitly below.
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Methods Verifiers Core Sub-Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Serves as the main operational domain cluster for deep structural checks, layout evaluations, and data type enforcement blocks across framework-bound class methods.
|
|
9
|
+
|
|
10
|
+
## Architecture & Topology
|
|
11
|
+
This package acts as an asymmetric validation hub divided into specialized functional verification vectors:
|
|
12
|
+
1. **Structural Integrity Gateway (`classmethod`)**: Confirms standard python class bindings and callable status.
|
|
13
|
+
2. **Layout Blueprint Enforcement (`params`)**: Verifies matching nomenclature configurations and strict counts.
|
|
14
|
+
3. **Variance Security (`annotations_and_defaults`)**: Guarantees deterministic static hint behaviors.
|
|
15
|
+
4. **Runtime Pipeline Tracking (`calculation`)**: Tracks execution states and decomposes complex tuple payloads.
|
|
16
|
+
"""
|
simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/__init__.py
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
from .exception_info_for_classmethod import exception_info_for_classmethod
|
|
2
|
+
from .expected_structure_for_classmethod import expected_structure_for_classmethod
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
_DESIGN_NOTES = """
|
|
6
|
+
# Exception Helpers Sub-Package
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Provides structural exception payload definitions and contextual reflection extraction helpers tailored for diagnostic reporting inside method signature verifiers.
|
|
10
|
+
|
|
11
|
+
## Internal Components Registry
|
|
12
|
+
|
|
13
|
+
| Component | Type | Description |
|
|
14
|
+
| :----------------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
15
|
+
| `exception_info_for_classmethod` | Function | Low-level extraction utility mapping raw method attributes to basic error context. |
|
|
16
|
+
| `expected_structure_for_classmethod` | Function | High-level diagnostic text and structural blueprint formatter for exception errors. |
|
|
17
|
+
"""
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
def exception_info_for_classmethod(
|
|
5
|
+
bound_method: Any,
|
|
6
|
+
) -> tuple[str, str, str]:
|
|
7
|
+
"""Extracts class name, method name, and diagnostic context safely."""
|
|
8
|
+
|
|
9
|
+
# 1. Class name recovery (fallback to <UnknownClass>)
|
|
10
|
+
owner = getattr(bound_method, "__self__", None)
|
|
11
|
+
class_name = owner.__name__ if owner is not None else "<UnknownClass>"
|
|
12
|
+
|
|
13
|
+
# 2. Method name recovery (fallback to standard string/attribute inspection)
|
|
14
|
+
func = getattr(bound_method, "__func__", bound_method)
|
|
15
|
+
method_name = getattr(func, "__name__", str(bound_method))
|
|
16
|
+
|
|
17
|
+
# 3. Build diagnostic context
|
|
18
|
+
context = f"Metadata validation for: {class_name}.{method_name}"
|
|
19
|
+
|
|
20
|
+
return (
|
|
21
|
+
class_name,
|
|
22
|
+
method_name,
|
|
23
|
+
context,
|
|
24
|
+
)
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
_DESIGN_NOTES = """
|
|
28
|
+
# exception_info_for_classmethod
|
|
29
|
+
|
|
30
|
+
## Purpose
|
|
31
|
+
Provides minimal diagnostic metadata (class name, method name, diagnostic context)
|
|
32
|
+
for classmethod validation exceptions.
|
|
33
|
+
|
|
34
|
+
## Defensive Behavior
|
|
35
|
+
The function handles invalid user-provided inputs safely:
|
|
36
|
+
- Extracts class name via `__self__`, falling back to `<UnknownClass>` if `bound_method`
|
|
37
|
+
is not a bound classmethod (e.g., plain string, lambda, or un-bound function).
|
|
38
|
+
- Extracts method name via `__func__.__name__`, falling back to `str(bound_method)`.
|
|
39
|
+
|
|
40
|
+
## Why tuple
|
|
41
|
+
The returned values are:
|
|
42
|
+
- fixed in structure,
|
|
43
|
+
- used immediately,
|
|
44
|
+
- immutable,
|
|
45
|
+
- not stored or exposed externally.
|
|
46
|
+
|
|
47
|
+
A tuple is the fastest and cleanest option.
|
|
48
|
+
|
|
49
|
+
## Separation of concerns
|
|
50
|
+
This helper is intentionally small and focused only on identity metadata.
|
|
51
|
+
The full structural code blueprint is delegated to `expected_structure_for_classmethod`.
|
|
52
|
+
"""
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
# Annotations
|
|
3
|
+
if TYPE_CHECKING:
|
|
4
|
+
from ......protocols.methods import ClassMethodProtocol
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def expected_structure_for_classmethod(
|
|
8
|
+
bound_method: "ClassMethodProtocol",
|
|
9
|
+
expected_params: tuple[str, ...],
|
|
10
|
+
expected_args_params_count: int,
|
|
11
|
+
) -> tuple[str, ...]:
|
|
12
|
+
"""Generates a copy‑paste ready expected method structure."""
|
|
13
|
+
|
|
14
|
+
# 1. Class name recovery (fallback to <UnknownClass>)
|
|
15
|
+
owner = getattr(bound_method, "__self__", None)
|
|
16
|
+
class_name = owner.__name__ if owner is not None else "<UnknownClass>"
|
|
17
|
+
|
|
18
|
+
# 2. Method name recovery (fallback to standard string/attribute inspection)
|
|
19
|
+
func = getattr(bound_method, "__func__", bound_method)
|
|
20
|
+
method_name = getattr(func, "__name__", str(bound_method))
|
|
21
|
+
|
|
22
|
+
# 3. Safe parent recovery via already resolved owner
|
|
23
|
+
if owner is None:
|
|
24
|
+
class_parent = "<UnknownClass>"
|
|
25
|
+
else:
|
|
26
|
+
mro_names = [c.__name__ for c in getattr(owner, "__mro__", ())]
|
|
27
|
+
class_parent = "SimpleObject" if "SimpleObject" in mro_names else "SimpleConstant"
|
|
28
|
+
|
|
29
|
+
# 4. Build signature parameters
|
|
30
|
+
args_params = ", ".join(expected_params[:expected_args_params_count])
|
|
31
|
+
kwargs_params = ", ".join(expected_params[expected_args_params_count:])
|
|
32
|
+
|
|
33
|
+
params_signature = (
|
|
34
|
+
f"{args_params}"
|
|
35
|
+
+ (f", *, {kwargs_params}" if kwargs_params else "")
|
|
36
|
+
)
|
|
37
|
+
|
|
38
|
+
# 5. Build blueprint structure
|
|
39
|
+
expected_structure = (
|
|
40
|
+
"Expected structure:",
|
|
41
|
+
f"class {class_name}({class_parent}):",
|
|
42
|
+
" ...",
|
|
43
|
+
" @classmethod",
|
|
44
|
+
f" def {method_name}({params_signature}):",
|
|
45
|
+
" ...",
|
|
46
|
+
)
|
|
47
|
+
|
|
48
|
+
return expected_structure
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
_DESIGN_NOTES = """
|
|
53
|
+
# expected_structure_for_classmethod
|
|
54
|
+
|
|
55
|
+
## Purpose
|
|
56
|
+
Generates a copy-paste ready code blueprint showing how a required `@classmethod`
|
|
57
|
+
should be declared. Used when signature validation fails.
|
|
58
|
+
|
|
59
|
+
## Defensive Behavior & Parent Discovery
|
|
60
|
+
- Safely extracts class name via `bound_method.__self__`, falling back to `<UnknownClass>`.
|
|
61
|
+
- Dynamically discovers the parent class (`SimpleObject` vs `SimpleConstant`) by inspecting
|
|
62
|
+
the `owner.__mro__`.
|
|
63
|
+
- Formats positional and keyword-only arguments separated by `*, ` according to strict protocol specs.
|
|
64
|
+
|
|
65
|
+
## What it returns
|
|
66
|
+
- `expected_structure` — a tuple of strings forming a readable multi-line code snippet.
|
|
67
|
+
|
|
68
|
+
## Why this separation exists
|
|
69
|
+
The method-validation pipeline uses two distinct helpers:
|
|
70
|
+
- **exception_info_for_classmethod**: Provides identity metadata (class name, method name, context).
|
|
71
|
+
- **expected_structure_for_classmethod**: Generates the structural blueprint code snippet.
|
|
72
|
+
|
|
73
|
+
Each helper maintains a single responsibility and operates independently.
|
|
74
|
+
|
|
75
|
+
## Why tuple
|
|
76
|
+
The expected structure:
|
|
77
|
+
- has a fixed layout,
|
|
78
|
+
- is immutable,
|
|
79
|
+
- is consumed immediately for error formatting.
|
|
80
|
+
"""
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
from .verify_annotations_and_defaults import verify_annotations_and_defaults
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Annotations and Defaults Verification Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Orchestrates the entire signature hint and structural default assignment validation layer. It guarantees that any custom metadata hints declared by user methods conform to strict internal blueprint models, preventing configuration drift across systems.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :---------------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
14
|
+
| `verify_annotations_and_defaults` | Function | Main coordinator executing sub-validation gates across all positional and keyword hints.|
|
|
15
|
+
"""
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
from .validate_annotations import validate_annotations
|
|
2
|
+
from .validate_args_defaults import validate_args_defaults
|
|
3
|
+
from .validate_kwargs_defaults import validate_kwargs_defaults
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
_DESIGN_NOTES = """
|
|
7
|
+
# Annotations and Defaults Validation Sub-Package
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Enforces rigid value and structural type synchronization boundaries directly against user-declared method signatures.
|
|
11
|
+
|
|
12
|
+
## Internal Components Registry
|
|
13
|
+
|
|
14
|
+
| Component | Type | Description |
|
|
15
|
+
| :------------------------- | :------- | :----------------------------------------------------------------------------------- |
|
|
16
|
+
| `validate_annotations` | Function | Confirms user parameter and return value type hints match framework schema expectations.|
|
|
17
|
+
| `validate_args_defaults` | Function | Validates that explicit positional argument defaults strictly mirror internal schemas. |
|
|
18
|
+
| `validate_kwargs_defaults` | Function | Validates that explicit keyword-only argument defaults strictly mirror internal schemas.|
|
|
19
|
+
"""
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
from typing import get_args, Union, get_origin, Any
|
|
2
|
+
from types import UnionType
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
def _convert_annotation_to_type_set(
|
|
6
|
+
annotation: type | None | UnionType,
|
|
7
|
+
) -> set[type]:
|
|
8
|
+
"""Converts annotation or union into a flat set of types."""
|
|
9
|
+
|
|
10
|
+
# 1. Single type
|
|
11
|
+
if isinstance(annotation, type):
|
|
12
|
+
return {annotation}
|
|
13
|
+
|
|
14
|
+
# 2. Union or PEP 604 pipe union
|
|
15
|
+
if isinstance(annotation, UnionType) or get_origin(annotation) is Union:
|
|
16
|
+
return set(get_args(annotation))
|
|
17
|
+
|
|
18
|
+
# 3. Fallback
|
|
19
|
+
return {Any}
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
_DESIGN_NOTES = """
|
|
24
|
+
# _convert_annotation_to_type_set
|
|
25
|
+
|
|
26
|
+
## Purpose
|
|
27
|
+
Normalizes Python type annotations into a flat `set[type]` so that
|
|
28
|
+
`validate_annotations` can perform simple subset checks.
|
|
29
|
+
|
|
30
|
+
## Behavior
|
|
31
|
+
1. Single types → `{type}`
|
|
32
|
+
2. `Union` or PEP 604 unions → `{t1, t2, ...}`
|
|
33
|
+
3. Anything else → `{Any}` as a safe fallback
|
|
34
|
+
|
|
35
|
+
## Why separate
|
|
36
|
+
This function is a pure utility.
|
|
37
|
+
Keeping it isolated makes `validate_annotations` smaller, cleaner, and easier to test.
|
|
38
|
+
"""
|