simplibs-object 0.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- simplibs/object/SimpleBase.py +115 -0
- simplibs/object/SimpleConstant.py +271 -0
- simplibs/object/SimpleObject.py +293 -0
- simplibs/object/__init__.py +7 -0
- simplibs/object/_core/__init__.py +66 -0
- simplibs/object/_core/logic/__init__.py +0 -0
- simplibs/object/_core/logic/constant_methods/__init__.py +22 -0
- simplibs/object/_core/logic/constant_methods/bool_or_raise_validate_error.py +76 -0
- simplibs/object/_core/logic/constant_methods/normalize.py +92 -0
- simplibs/object/_core/logic/constant_methods/validate.py +99 -0
- simplibs/object/_core/logic/constant_methods/validate_type.py +48 -0
- simplibs/object/_core/logic/constant_methods/validations/__init__.py +22 -0
- simplibs/object/_core/logic/constant_methods/validations/_extract_clean_code_lines.py +86 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_missing_value_error.py +71 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_type_error.py +59 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_unexpected_validation_error.py +66 -0
- simplibs/object/_core/logic/constant_methods/validations/raise_validation_error.py +78 -0
- simplibs/object/_core/logic/object_methods/__init__.py +18 -0
- simplibs/object/_core/logic/object_methods/_process_calculate_value_params.py +108 -0
- simplibs/object/_core/logic/object_methods/calculate_value.py +81 -0
- simplibs/object/_core/logic/object_methods/decompose_value.py +91 -0
- simplibs/object/_core/logic/object_methods/validations/__init__.py +22 -0
- simplibs/object/_core/logic/object_methods/validations/raise_class_not_decomposeable.py +82 -0
- simplibs/object/_core/logic/object_methods/validations/raise_duplicate_argument_error.py +77 -0
- simplibs/object/_core/logic/object_methods/validations/raise_too_many_positional_args_error.py +81 -0
- simplibs/object/_core/logic/object_methods/validations/raise_unknown_parameter_error.py +77 -0
- simplibs/object/_core/logic/property_builders/__init__.py +20 -0
- simplibs/object/_core/logic/property_builders/create_instance_property.py +66 -0
- simplibs/object/_core/logic/property_builders/create_properties_for_inner.py +97 -0
- simplibs/object/_core/logic/property_builders/create_value_property.py +98 -0
- simplibs/object/_core/logic/property_builders/value_helpers/__init__.py +18 -0
- simplibs/object/_core/logic/property_builders/value_helpers/create_value_getter.py +52 -0
- simplibs/object/_core/logic/property_builders/value_helpers/create_value_setter.py +95 -0
- simplibs/object/_core/logic/property_builders/value_helpers/validations/__init__.py +16 -0
- simplibs/object/_core/logic/property_builders/value_helpers/validations/raise_locked_value_error.py +103 -0
- simplibs/object/_core/metadata/SimpleBaseMetadata.py +139 -0
- simplibs/object/_core/metadata/SimpleConstantMetadata.py +108 -0
- simplibs/object/_core/metadata/SimpleMeta.py +214 -0
- simplibs/object/_core/metadata/SimpleObjectMetadata.py +165 -0
- simplibs/object/_core/metadata/__init__.py +16 -0
- simplibs/object/_core/metadata/constants/BASE_CLASS_NAMES.py +23 -0
- simplibs/object/_core/metadata/constants/__init__.py +16 -0
- simplibs/object/_core/metadata/init_processors/__init__.py +47 -0
- simplibs/object/_core/metadata/init_processors/blueprint_path/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/blueprint_path/calculate_blueprint_path.py +81 -0
- simplibs/object/_core/metadata/init_processors/default/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/default/process_default_for_constant.py +71 -0
- simplibs/object/_core/metadata/init_processors/default/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/default/validations/_exception_info_for_default.py +66 -0
- simplibs/object/_core/metadata/init_processors/default/validations/raise_default_is_defined_in_composition.py +78 -0
- simplibs/object/_core/metadata/init_processors/default/validations/validate_default_is_defined.py +77 -0
- simplibs/object/_core/metadata/init_processors/default/validations/validate_default_matches_annotation.py +93 -0
- simplibs/object/_core/metadata/init_processors/inners/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/inners/process_inners.py +143 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/__init__.py +33 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/_exception_info_for_inners.py +43 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/_get_collision_path.py +45 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_collision_within_inners.py +78 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_if_collision_with_owner_class.py +66 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_class.py +58 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_not_simple_class.py +60 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inner_is_simple_subclass.py +61 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_defined.py +56 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_not_empty.py +57 -0
- simplibs/object/_core/metadata/init_processors/inners/validations/validate_inners_is_tuple.py +57 -0
- simplibs/object/_core/metadata/init_processors/methods/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/process_classmethod.py +130 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/__init__.py +16 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/exception_info_for_classmethod.py +52 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/_exceptions_helpers/expected_structure_for_classmethod.py +80 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/_convert_annotation_to_type_set.py +38 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_annotations.py +84 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_args_defaults.py +76 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/validations/validate_kwargs_defaults.py +74 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/annotations_and_defaults/verify_annotations_and_defaults.py +100 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/raise_decompose_unvalide_outcome_length.py +64 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_type.py +77 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/validations/validate_decompose_unvalide_item_value.py +72 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/decompose_method/verify_decompose_outcome.py +87 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/__init__.py +17 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_raised_exceptions.py +56 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/validations/raise_method_return_unvalide_outcome_type.py +80 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/calculation/verify_calculation.py +89 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/_clone_classmethod.py +81 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_callable.py +60 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_classmethod.py +60 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/validations/validate_method_is_defined.py +67 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/classmethod/verify_classmethod.py +117 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_has_exact_args_count.py +59 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_not_use_param_placeholders.py +66 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/validations/validate_method_param_match_expected.py +61 -0
- simplibs/object/_core/metadata/init_processors/methods/verifiers/params/verify_params.py +123 -0
- simplibs/object/_core/metadata/init_processors/names/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/names/_class_name_splitter.py +242 -0
- simplibs/object/_core/metadata/init_processors/names/create_names.py +119 -0
- simplibs/object/_core/metadata/init_processors/names/validations/__init__.py +19 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_has_no_underscores.py +94 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_ascii.py +95 -0
- simplibs/object/_core/metadata/init_processors/names/validations/validate_class_name_is_identifier.py +83 -0
- simplibs/object/_core/metadata/init_processors/type/__init__.py +15 -0
- simplibs/object/_core/metadata/init_processors/type/process_type.py +117 -0
- simplibs/object/_core/metadata/init_processors/type/validations/__init__.py +29 -0
- simplibs/object/_core/metadata/init_processors/type/validations/_exception_info_for_type.py +88 -0
- simplibs/object/_core/metadata/init_processors/type/validations/raise_union_type_contain_none.py +70 -0
- simplibs/object/_core/metadata/init_processors/type/validations/raise_validate_type_is_not_valid.py +92 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_from_tuple_is_not_none.py +94 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_defined.py +85 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_empty.py +93 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_is_not_none.py +87 -0
- simplibs/object/_core/metadata/init_processors/type/validations/validate_type_tuple_is_not_nested.py +92 -0
- simplibs/object/_core/metadata/instance_builders/__init__.py +55 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/InstanceBase.py +77 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/__init__.py +16 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/__init__.py +16 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_atom_init.py +51 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/helpers/create_root_value_setter.py +67 -0
- simplibs/object/_core/metadata/instance_builders/atom_class/make_atom_class.py +101 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/__init__.py +14 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/__init__.py +20 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/_get_inner_instance_class.py +51 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_composite_init.py +74 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_properties_for_inners.py +50 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_inners.py +57 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/helpers/create_recalculate_self.py +69 -0
- simplibs/object/_core/metadata/instance_builders/composite_class/make_composite_class.py +93 -0
- simplibs/object/_core/metadata/instance_builders/instance/__init__.py +17 -0
- simplibs/object/_core/metadata/instance_builders/instance/create_instance.py +107 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/__init__.py +25 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_combined_init_mixins.py +40 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_build_instance_class_dict.py +127 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_extend_instance_class.py +59 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_resolve_flat_mixins.py +74 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/_verify_mixin_compatibility.py +83 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/create_instance_class.py +76 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/get_base_class.py +53 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/__init__.py +20 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/__init__.py +29 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_composite.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_constant.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_immutable.py +61 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_allowed_for_mutable.py +60 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/raise_mixin_not_support_default_value_type.py +66 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_class.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/mixins_validations/validate_mixin_is_simple_base_subclass.py +60 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_invalide_extend_instance_class_definition.py +62 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/helpers/validations/raise_mixin_slot_collision_with_base_class.py +56 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/__init__.py +21 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_class_is_not_base_class.py +54 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_hashing_for_immutable_value.py +66 -0
- simplibs/object/_core/metadata/instance_builders/instance/validations/validate_param_is_bool.py +47 -0
- simplibs/object/_core/metadata/validations/__init__.py +18 -0
- simplibs/object/_core/metadata/validations/raise_attribut_allready_set.py +57 -0
- simplibs/object/_core/metadata/validations/raise_metadata_is_immutable.py +73 -0
- simplibs/object/_core/protocols/__init__.py +118 -0
- simplibs/object/_core/protocols/alias_typings/__init__.py +137 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangeTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangesDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/changes/ChangesTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/changes/__init__.py +18 -0
- simplibs/object/_core/protocols/alias_typings/history/HistoryDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/history/HistoryEntry.py +10 -0
- simplibs/object/_core/protocols/alias_typings/history/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/inners/InnersMap.py +8 -0
- simplibs/object/_core/protocols/alias_typings/inners/InnersTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/inners/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/mixins/MixinsTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/mixins/__init__.py +14 -0
- simplibs/object/_core/protocols/alias_typings/names/NamesSet.py +5 -0
- simplibs/object/_core/protocols/alias_typings/names/NamesTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/names/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodeItem.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesIndexMap.py +6 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesInstanceDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesPathDict.py +9 -0
- simplibs/object/_core/protocols/alias_typings/nodes/NodesTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/nodes/__init__.py +24 -0
- simplibs/object/_core/protocols/alias_typings/paths/PathDict.py +8 -0
- simplibs/object/_core/protocols/alias_typings/paths/PathTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/paths/__init__.py +16 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffItem.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotDiffTuple.py +8 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/SnapshotTuple.py +5 -0
- simplibs/object/_core/protocols/alias_typings/snapshots/__init__.py +20 -0
- simplibs/object/_core/protocols/alias_typings/state/StateDict.py +5 -0
- simplibs/object/_core/protocols/alias_typings/state/__init__.py +14 -0
- simplibs/object/_core/protocols/alias_typings/types/ValidTypes.py +6 -0
- simplibs/object/_core/protocols/alias_typings/types/__init__.py +14 -0
- simplibs/object/_core/protocols/classes/SimpleBaseProtocol.py +25 -0
- simplibs/object/_core/protocols/classes/SimpleConstantProtocol.py +54 -0
- simplibs/object/_core/protocols/classes/SimpleObjectProtocol.py +50 -0
- simplibs/object/_core/protocols/classes/__init__.py +26 -0
- simplibs/object/_core/protocols/instance/SimpleConstantInstanceProtocol.py +13 -0
- simplibs/object/_core/protocols/instance/SimpleInstanceBaseProtocol.py +24 -0
- simplibs/object/_core/protocols/instance/SimpleObjectInstanceProtocol.py +13 -0
- simplibs/object/_core/protocols/instance/__init__.py +29 -0
- simplibs/object/_core/protocols/instance/core_classes/AtomInstanceProtocol.py +46 -0
- simplibs/object/_core/protocols/instance/core_classes/CompositeInstanceProtocol.py +37 -0
- simplibs/object/_core/protocols/instance/core_classes/InstanceBaseProtocol.py +28 -0
- simplibs/object/_core/protocols/instance/core_classes/__init__.py +19 -0
- simplibs/object/_core/protocols/metadata/SimpleBaseMetadataProtocol.py +37 -0
- simplibs/object/_core/protocols/metadata/SimpleConstantMetadataProtocol.py +45 -0
- simplibs/object/_core/protocols/metadata/SimpleMetaProtocol.py +39 -0
- simplibs/object/_core/protocols/metadata/SimpleObjectMetadataProtocol.py +49 -0
- simplibs/object/_core/protocols/metadata/__init__.py +28 -0
- simplibs/object/_core/protocols/methods/ClassMethodProtocol.py +29 -0
- simplibs/object/_core/protocols/methods/LogicSignature.py +20 -0
- simplibs/object/_core/protocols/methods/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/__init__.py +120 -0
- simplibs/object/_core/protocols/mixins/base_class/SimpleMixinProtocol.py +46 -0
- simplibs/object/_core/protocols/mixins/base_class/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/core_mixins/InfrastructureProtocol.py +16 -0
- simplibs/object/_core/protocols/mixins/core_mixins/NodesDictsProtocol.py +38 -0
- simplibs/object/_core/protocols/mixins/core_mixins/NodesTupleProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/core_mixins/SerializationProtocol.py +55 -0
- simplibs/object/_core/protocols/mixins/core_mixins/SnapshotProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/core_mixins/__init__.py +27 -0
- simplibs/object/_core/protocols/mixins/dunders/__init__.py +123 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/CollectionBaseProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/CollectionProtocol.py +20 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/IterableProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/MappingProtocol.py +52 -0
- simplibs/object/_core/protocols/mixins/dunders/collections/__init__.py +21 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/EqualityProtocol.py +31 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/OrderingProtocol.py +32 -0
- simplibs/object/_core/protocols/mixins/dunders/comparison/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/generics/ClassGetItemProtocol.py +23 -0
- simplibs/object/_core/protocols/mixins/dunders/generics/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/CallProtocol.py +26 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/ContextProtocol.py +38 -0
- simplibs/object/_core/protocols/mixins/dunders/interfaces/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/CopyableProtocol.py +33 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/LifecycleProtocol.py +21 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleReduceProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/PickleStateProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/__init__.py +20 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/PicklePlan.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/lifecycles/internal_types/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/ArithmeticProtocol.py +95 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/BitwiseProtocol.py +79 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/ConversionProtocol.py +57 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/InplaceProtocol.py +66 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/UnaryProtocol.py +35 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/__init__.py +22 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/Operator.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/UnaryOperator.py +5 -0
- simplibs/object/_core/protocols/mixins/dunders/numeric/internal_types/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/ValueDisplayProtocol.py +30 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/ValueFormattingProtocol.py +42 -0
- simplibs/object/_core/protocols/mixins/dunders/representation/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsProtocol.py +69 -0
- simplibs/object/_core/protocols/mixins/immutable/ImmutableMethodsWithInnersProtocol.py +27 -0
- simplibs/object/_core/protocols/mixins/immutable/__init__.py +18 -0
- simplibs/object/_core/protocols/mixins/numerical/EqualizerProtocol.py +37 -0
- simplibs/object/_core/protocols/mixins/numerical/VolumeProtocol.py +32 -0
- simplibs/object/_core/protocols/mixins/numerical/__init__.py +17 -0
- simplibs/object/_core/protocols/mixins/numerical/internal_types/SteppersMap.py +8 -0
- simplibs/object/_core/protocols/mixins/numerical/internal_types/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/StepperProtocol.py +95 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/__init__.py +14 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/LimitAction.py +5 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/StepValue.py +6 -0
- simplibs/object/_core/protocols/mixins/numerical/stepper/internal_types/__init__.py +16 -0
- simplibs/object/_core/protocols/mixins/properties/InnersPropertyProtocol.py +31 -0
- simplibs/object/_core/protocols/mixins/properties/MetaShortcutsProtocol.py +49 -0
- simplibs/object/_core/protocols/mixins/properties/__init__.py +17 -0
- simplibs/object/_core/protocols/mixins/state/DefaultStateProtocol.py +41 -0
- simplibs/object/_core/protocols/mixins/state/DirtyTrackingProtocol.py +61 -0
- simplibs/object/_core/protocols/mixins/state/HistoryProtocol.py +112 -0
- simplibs/object/_core/protocols/mixins/state/PermissionProtocol.py +35 -0
- simplibs/object/_core/protocols/mixins/state/__init__.py +22 -0
- simplibs/object/exceptions/SimpleDefinitionError.py +45 -0
- simplibs/object/exceptions/SimpleInitializationError.py +43 -0
- simplibs/object/exceptions/SimpleRuntimeError.py +50 -0
- simplibs/object/exceptions/__init__.py +62 -0
- simplibs/object/exceptions/base_exception/SimpleObjectError.py +107 -0
- simplibs/object/exceptions/base_exception/__init__.py +19 -0
- simplibs/object/mixins/__init__.py +99 -0
- simplibs/object/mixins/_common_logic/__init__.py +41 -0
- simplibs/object/mixins/_common_logic/constants/__init__.py +27 -0
- simplibs/object/mixins/_common_logic/constants/names/HISTORY.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/OWNER_CLASS.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/STEPPER.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/VALUE.py +14 -0
- simplibs/object/mixins/_common_logic/constants/names/__init__.py +28 -0
- simplibs/object/mixins/_common_logic/constants/sets/FORBIDDEN_NAMES.py +27 -0
- simplibs/object/mixins/_common_logic/constants/sets/RESTRICTION_FLAGS.py +18 -0
- simplibs/object/mixins/_common_logic/constants/sets/__init__.py +22 -0
- simplibs/object/mixins/_common_logic/immutability/__init__.py +28 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/__init__.py +22 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/get_top_composite_paths.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/process_single_change.py +143 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_changes.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths.py +147 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/split_constants_paths2.py +142 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/__init__.py +23 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_split_changes_unknown_name.py +107 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/utils/validations/raise_with_any_unknown_name.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/__init__.py +24 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_changes_is_not_tuple.py +65 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_child_composite_mismatch.py +68 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/vaidations/raise_with_any_contained_constant_mismatch.py +67 -0
- simplibs/object/mixins/_common_logic/immutability/with_any/with_any.py +238 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/utils/__init__.py +15 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/utils/reacalculate_inners.py +112 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/__init__.py +21 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_is_decomposeable.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/vaidations/validate_composite_name_exists.py +71 -0
- simplibs/object/mixins/_common_logic/immutability/with_composite/with_composite.py +176 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/__init__.py +20 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_new_instance.py +130 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/create_snapshot_dict.py +83 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/utils/reacalculate_owner_value.py +131 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/__init__.py +16 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/vaidations/raise_immutability_constant_not_found.py +93 -0
- simplibs/object/mixins/_common_logic/immutability/with_constant/with_constant.py +147 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/__init__.py +17 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/utils/__init__.py +15 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/utils/find_longest_keys.py +112 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/__init__.py +25 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_batch_constant_not_found.py +94 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/raise_immutability_constants_changes_not_tuple.py +94 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_has_length_two.py +91 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_is_tuple.py +99 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/vaidations/validate_inner_tuple_name_is_str.py +90 -0
- simplibs/object/mixins/_common_logic/immutability/with_constants/with_constants.py +193 -0
- simplibs/object/mixins/base_class/SimpleMixin.py +118 -0
- simplibs/object/mixins/base_class/__init__.py +17 -0
- simplibs/object/mixins/base_class/_meta/SimpleMixinMeta.py +59 -0
- simplibs/object/mixins/base_class/_meta/__init__.py +21 -0
- simplibs/object/mixins/base_class/_meta/_verify_mixin_definition.py +161 -0
- simplibs/object/mixins/base_class/_meta/validations/__init__.py +34 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_dict_contains_forbidden_attributes.py +101 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_flag_is_not_bool.py +122 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_init_mixins_contains_super_call.py +75 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_only_types_invalid.py +107 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contain_unvalid_type.py +85 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_contains_forbidden_slot_names.py +102 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_is_not_defined.py +79 -0
- simplibs/object/mixins/base_class/_meta/validations/raise_mixin_slots_unsuport_type.py +88 -0
- simplibs/object/mixins/core_mixins/Infrastructure.py +49 -0
- simplibs/object/mixins/core_mixins/NodesDicts.py +104 -0
- simplibs/object/mixins/core_mixins/NodesTuple.py +86 -0
- simplibs/object/mixins/core_mixins/Serialization.py +120 -0
- simplibs/object/mixins/core_mixins/Snapshot.py +104 -0
- simplibs/object/mixins/core_mixins/__init__.py +32 -0
- simplibs/object/mixins/core_mixins/_utils/__init__.py +49 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/__init__.py +17 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/_collect_nodes_data.py +131 -0
- simplibs/object/mixins/core_mixins/_utils/nodes_tuple/build_nodes_tuple.py +104 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/__init__.py +20 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/from_dict.py +190 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/from_dict_constants.py +151 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/to_dict.py +158 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/__init__.py +30 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_invalid_composite_structure.py +65 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_composite_key.py +64 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_missing_value_key.py +66 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_owner_class_mismatch_for_state_dict.py +77 -0
- simplibs/object/mixins/core_mixins/_utils/serialization/validations/raise_unvalid_state_dict_input.py +67 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/__init__.py +15 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/compare_snapshots.py +102 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/validations/__init__.py +16 -0
- simplibs/object/mixins/core_mixins/_utils/snapshot/validations/raise_snapshot_incompatible_error.py +101 -0
- simplibs/object/mixins/dunders/__init__.py +61 -0
- simplibs/object/mixins/dunders/collections/CollectionBase.py +129 -0
- simplibs/object/mixins/dunders/collections/Iterable.py +81 -0
- simplibs/object/mixins/dunders/collections/Mapping.py +131 -0
- simplibs/object/mixins/dunders/collections/__init__.py +29 -0
- simplibs/object/mixins/dunders/collections/main/Collection.py +47 -0
- simplibs/object/mixins/dunders/collections/main/__init__.py +20 -0
- simplibs/object/mixins/dunders/comparison/Equality.py +128 -0
- simplibs/object/mixins/dunders/comparison/Ordering.py +130 -0
- simplibs/object/mixins/dunders/comparison/__init__.py +25 -0
- simplibs/object/mixins/dunders/generics/ClassGetItem.py +105 -0
- simplibs/object/mixins/dunders/generics/__init__.py +20 -0
- simplibs/object/mixins/dunders/interfaces/Call.py +101 -0
- simplibs/object/mixins/dunders/interfaces/Context.py +100 -0
- simplibs/object/mixins/dunders/interfaces/__init__.py +23 -0
- simplibs/object/mixins/dunders/lifecycles/Copyable.py +103 -0
- simplibs/object/mixins/dunders/lifecycles/PickleReduce.py +88 -0
- simplibs/object/mixins/dunders/lifecycles/PickleState.py +104 -0
- simplibs/object/mixins/dunders/lifecycles/__init__.py +29 -0
- simplibs/object/mixins/dunders/lifecycles/_utils/__init__.py +20 -0
- simplibs/object/mixins/dunders/lifecycles/_utils/rebuild_simple_instance.py +51 -0
- simplibs/object/mixins/dunders/lifecycles/main/Lifecycle.py +45 -0
- simplibs/object/mixins/dunders/lifecycles/main/__init__.py +20 -0
- simplibs/object/mixins/dunders/numeric/Arithmetic.py +195 -0
- simplibs/object/mixins/dunders/numeric/Bitwise.py +172 -0
- simplibs/object/mixins/dunders/numeric/Conversion.py +149 -0
- simplibs/object/mixins/dunders/numeric/Inplace.py +124 -0
- simplibs/object/mixins/dunders/numeric/Unary.py +89 -0
- simplibs/object/mixins/dunders/numeric/__init__.py +31 -0
- simplibs/object/mixins/dunders/numeric/_utils/__init__.py +41 -0
- simplibs/object/mixins/dunders/numeric/_utils/_align_operand_type.py +111 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_arithmetic_op.py +157 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_bitwise_op.py +116 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_conversion.py +107 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_inplace_op.py +139 -0
- simplibs/object/mixins/dunders/numeric/_utils/execute_unary_op.py +121 -0
- simplibs/object/mixins/dunders/representation/ValueDisplay.py +96 -0
- simplibs/object/mixins/dunders/representation/ValueFormatting.py +144 -0
- simplibs/object/mixins/dunders/representation/__init__.py +24 -0
- simplibs/object/mixins/others/__init__.py +48 -0
- simplibs/object/mixins/others/immutable/ImmutableMethods.py +142 -0
- simplibs/object/mixins/others/immutable/ImmutableMethodsWithInners.py +111 -0
- simplibs/object/mixins/others/immutable/__init__.py +24 -0
- simplibs/object/mixins/others/immutable/_validations/__init__.py +19 -0
- simplibs/object/mixins/others/immutable/_validations/raise_with_changes_input_not_dict.py +60 -0
- simplibs/object/mixins/others/numerical/Equalizer.py +129 -0
- simplibs/object/mixins/others/numerical/Volume.py +100 -0
- simplibs/object/mixins/others/numerical/__init__.py +25 -0
- simplibs/object/mixins/others/numerical/_stepper_class/Stepper.py +227 -0
- simplibs/object/mixins/others/numerical/_stepper_class/__init__.py +31 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/__init__.py +35 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/__init__.py +33 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/process_step_value.py +114 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/__init__.py +29 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_down_limit_reached.py +115 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/validations/raise_stepper_up_limit_reached.py +110 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_down_limit.py +141 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/processors/verify_up_limit.py +141 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/set_value.py +163 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/step_down.py +154 -0
- simplibs/object/mixins/others/numerical/_stepper_class/methods/step_up.py +154 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/__init__.py +38 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_down_limit_value.py +143 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_limit_action.py +118 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_up_limit_value.py +143 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/process_value.py +142 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validate_instance.py +138 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/__init__.py +39 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_action.py +118 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_down_limit.py +125 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_instance.py +117 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_invalid_up_limit.py +125 -0
- simplibs/object/mixins/others/numerical/_stepper_class/processors/validations/raise_stepper_non_numeric_value.py +122 -0
- simplibs/object/mixins/others/properties/InnersProperty.py +91 -0
- simplibs/object/mixins/others/properties/MetaShortcuts.py +113 -0
- simplibs/object/mixins/others/properties/__init__.py +24 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/__init__.py +23 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/_collect_nested_inner_properties.py +134 -0
- simplibs/object/mixins/others/properties/_inners_property_utils/collect_all_nested_properties.py +132 -0
- simplibs/object/mixins/others/state/DefaultState.py +119 -0
- simplibs/object/mixins/others/state/DirtyTracking.py +144 -0
- simplibs/object/mixins/others/state/History.py +248 -0
- simplibs/object/mixins/others/state/Permission.py +102 -0
- simplibs/object/mixins/others/state/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/__init__.py +50 -0
- simplibs/object/mixins/others/state/_history_utils/core/__init__.py +32 -0
- simplibs/object/mixins/others/state/_history_utils/core/find_snapshot.py +142 -0
- simplibs/object/mixins/others/state/_history_utils/core/record_state.py +130 -0
- simplibs/object/mixins/others/state/_history_utils/core/set_history_limit.py +114 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_history_limit_not_positive_integer.py +65 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snapshot_index.py +67 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_reference.py +67 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_snopshot_timestamp.py +66 -0
- simplibs/object/mixins/others/state/_history_utils/core/validations/raise_unvalide_timestamp.py +63 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/__init__.py +38 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_index.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_history_on_timestamp.py +115 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/go_to_last_history.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/history_redo.py +103 -0
- simplibs/object/mixins/others/state/_history_utils/navigations/history_undo.py +104 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/__init__.py +31 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/export_history_to_dict.py +110 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/import_history_from_dict.py +169 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/__init__.py +24 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_history_import_file.py +66 -0
- simplibs/object/mixins/others/state/_history_utils/transfer/validations/raise_unvalide_owner_class_mismatch.py +69 -0
- simplibs/object/settings/__init__.py +90 -0
- simplibs/object/settings/logging.py +138 -0
- simplibs/object/testing/__init__.py +90 -0
- simplibs/object/testing/assert_simple_mixin.py +150 -0
- simplibs/object/testing/assert_simple_object.py +219 -0
- simplibs/object/testing/asserts/__init__.py +53 -0
- simplibs/object/testing/asserts/base/__init__.py +22 -0
- simplibs/object/testing/asserts/base/assert_class_inheritance.py +75 -0
- simplibs/object/testing/asserts/base/assert_instance_creation.py +119 -0
- simplibs/object/testing/asserts/base/assert_user_instance_creation.py +97 -0
- simplibs/object/testing/asserts/base/assert_value_change.py +142 -0
- simplibs/object/testing/asserts/methods/__init__.py +20 -0
- simplibs/object/testing/asserts/methods/assert_calculate_value_method.py +113 -0
- simplibs/object/testing/asserts/methods/assert_decompose_value_method.py +109 -0
- simplibs/object/testing/asserts/methods/assert_validate_method.py +111 -0
- simplibs/object/testing/asserts/mixins/__init__.py +22 -0
- simplibs/object/testing/asserts/mixins/assert_instance_hasattr.py +94 -0
- simplibs/object/testing/asserts/mixins/assert_mixin_inheritance.py +72 -0
- simplibs/object/testing/asserts/mixins/assert_mixin_instance_creation.py +142 -0
- simplibs/object/testing/asserts/mixins/assert_mixins_slots_values.py +126 -0
- simplibs/object/testing/asserts/mutability/__init__.py +18 -0
- simplibs/object/testing/asserts/mutability/assert_immutable_behavior.py +118 -0
- simplibs/object/testing/asserts/mutability/assert_mutable_behavior.py +108 -0
- simplibs/object/testing/asserts/reactivity/__init__.py +17 -0
- simplibs/object/testing/asserts/reactivity/assert_reactivity_downward.py +141 -0
- simplibs/object/testing/asserts/reactivity/assert_reactivity_upward.py +109 -0
- simplibs/object/testing/bulk_test.py +150 -0
- simplibs/object/testing/containers/InnerValue.py +102 -0
- simplibs/object/testing/containers/MixinCase.py +89 -0
- simplibs/object/testing/containers/ObjectCase.py +101 -0
- simplibs/object/testing/containers/TestMixin.py +122 -0
- simplibs/object/testing/containers/__init__.py +20 -0
- simplibs/object/testing/containers/_validations/__init__.py +18 -0
- simplibs/object/testing/containers/_validations/raise_inner_value_empty_path.py +39 -0
- simplibs/object/testing/containers/_validations/raise_inner_value_invalid_path_type.py +44 -0
- simplibs/object/tools/__init__.py +0 -0
- simplibs/object/tools/automate_creators/__init__.py +0 -0
- simplibs/object/tools/automate_creators/_helpers/__init__.py +5 -0
- simplibs/object/tools/automate_creators/_helpers/_is_lambda.py +34 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/__init__.py +3 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_calculate_default_failed.py +51 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_inner_is_not_simple_constant_subclass.py +44 -0
- simplibs/object/tools/automate_creators/_helpers/_validations/raise_inners_is_not_tuple.py +41 -0
- simplibs/object/tools/automate_creators/_helpers/calculate_default.py +51 -0
- simplibs/object/tools/automate_creators/_helpers/load_parameters_from_inners.py +72 -0
- simplibs/object/tools/automate_creators/_helpers/process_decompose.py +47 -0
- simplibs/object/tools/automate_creators/_helpers/process_logic.py +57 -0
- simplibs/object/tools/automate_creators/_helpers/process_validate.py +48 -0
- simplibs/object/tools/automate_creators/_validations/__init__.py +7 -0
- simplibs/object/tools/automate_creators/_validations/validate_class_name_is_str.py +36 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_inners.py +43 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_logic.py +44 -0
- simplibs/object/tools/automate_creators/_validations/validate_composite_has_not_default.py +37 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_default.py +48 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_decompose.py +37 -0
- simplibs/object/tools/automate_creators/_validations/validate_constant_has_not_logic.py +37 -0
- simplibs/object/tools/automate_creators/bulk/BulkCase.py +100 -0
- simplibs/object/tools/automate_creators/bulk/__init__.py +0 -0
- simplibs/object/tools/automate_creators/bulk/create_simple_object_bulk.py +77 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/__init__.py +0 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/__init__.py +8 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_csv_callable_not_supported.py +26 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_data_not_list.py +28 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_decode_failed.py +29 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_sequence.py +27 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_str.py +28 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_item_is_not_bulk_dict.py +39 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_table_row_not_sequence.py +26 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_yaml_import_failed.py +22 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_bulk_case_class.py +57 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_csv.py +68 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_dicts.py +19 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_json.py +24 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_table.py +43 -0
- simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_yaml.py +29 -0
- simplibs/object/tools/automate_creators/create_constant_class.py +84 -0
- simplibs/object/tools/automate_creators/create_object_class.py +110 -0
- simplibs/object/tools/automate_creators/create_simple_object.py +97 -0
- simplibs/object/tools/randomize/__init__.py +18 -0
- simplibs/object/tools/randomize/_validations/__init__.py +28 -0
- simplibs/object/tools/randomize/_validations/raise_random_data_filler_exhausted.py +55 -0
- simplibs/object/tools/randomize/_validations/validate_instance_is_simple_constant_base.py +52 -0
- simplibs/object/tools/randomize/_validations/validate_registry_is_randomize_registry_base.py +51 -0
- simplibs/object/tools/randomize/_validations/validate_retries_is_greater_than_zero.py +48 -0
- simplibs/object/tools/randomize/_validations/validate_retries_is_int.py +49 -0
- simplibs/object/tools/randomize/_validations/validate_skip_immutable_is_bool.py +43 -0
- simplibs/object/tools/randomize/_validations/validate_skip_unregistered_is_bool.py +44 -0
- simplibs/object/tools/randomize/random_data_filler.py +133 -0
- simplibs/object/tools/randomize/randomize_value.py +122 -0
- simplibs_object-0.1.0.dist-info/METADATA +590 -0
- simplibs_object-0.1.0.dist-info/RECORD +580 -0
- simplibs_object-0.1.0.dist-info/WHEEL +5 -0
- simplibs_object-0.1.0.dist-info/licenses/LICENSE +21 -0
- simplibs_object-0.1.0.dist-info/top_level.txt +1 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
from .CollectionBaseProtocol import CollectionBaseProtocol
|
|
2
|
+
from .CollectionProtocol import CollectionProtocol
|
|
3
|
+
from .IterableProtocol import IterableProtocol
|
|
4
|
+
from .MappingProtocol import MappingProtocol
|
|
5
|
+
|
|
6
|
+
_DESIGN_NOTES = """
|
|
7
|
+
# Collections Dunder Protocols Sub-Package
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Provides protocols defining container, mapping, and sequence behavior via standard Python dunder methods,
|
|
11
|
+
enabling clean container operations, iteration, and element accessing.
|
|
12
|
+
|
|
13
|
+
## Internal Components Registry
|
|
14
|
+
|
|
15
|
+
| Component | Type | Description |
|
|
16
|
+
| :----------------------- | :------- | :--------------------------------------------------------------------------- |
|
|
17
|
+
| `CollectionBaseProtocol` | Protocol | Structural anchor for collection mixins with size and containment support. |
|
|
18
|
+
| `CollectionProtocol` | Protocol | Complete container interface combining sizing, containment, and iteration. |
|
|
19
|
+
| `IterableProtocol` | Protocol | Interface guaranteeing element iteration capability via `__iter__`. |
|
|
20
|
+
| `MappingProtocol` | Protocol | Key-value mapping interface with item retrieval, assignment, and deletion. |
|
|
21
|
+
"""
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ...base_class import SimpleMixinProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class EqualityProtocol(
|
|
8
|
+
SimpleMixinProtocol,
|
|
9
|
+
Protocol
|
|
10
|
+
):
|
|
11
|
+
"""
|
|
12
|
+
Protocol for the Equality mixin.
|
|
13
|
+
|
|
14
|
+
Guarantees the ability to compare instances for equality (value and object identity)
|
|
15
|
+
and provides a safe, dynamic hashing strategy responsive to mutability state.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
def __eq__(self, other: Any) -> bool:
|
|
19
|
+
"""
|
|
20
|
+
Compares the instance with another object for equality.
|
|
21
|
+
Returns True if values (and potentially blueprints) match, False otherwise.
|
|
22
|
+
"""
|
|
23
|
+
...
|
|
24
|
+
|
|
25
|
+
def __hash__(self) -> int:
|
|
26
|
+
"""
|
|
27
|
+
Returns a unique numerical hash for the instance.
|
|
28
|
+
For mutable objects, generates a hash from identity id(self);
|
|
29
|
+
for immutable objects, from the value hash(self.value).
|
|
30
|
+
"""
|
|
31
|
+
...
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ...base_class import SimpleMixinProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class OrderingProtocol(
|
|
8
|
+
SimpleMixinProtocol,
|
|
9
|
+
Protocol
|
|
10
|
+
):
|
|
11
|
+
"""
|
|
12
|
+
Protocol for the Ordering mixin.
|
|
13
|
+
|
|
14
|
+
Guarantees a complete set of comparison operators (ordering)
|
|
15
|
+
between instances or between an instance and a raw value.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
def __lt__(self, other: Any) -> bool:
|
|
19
|
+
"""Less than operator (<). Compares based on internal value."""
|
|
20
|
+
...
|
|
21
|
+
|
|
22
|
+
def __le__(self, other: Any) -> bool:
|
|
23
|
+
"""Less than or equal operator (<=). Compares based on internal value."""
|
|
24
|
+
...
|
|
25
|
+
|
|
26
|
+
def __gt__(self, other: Any) -> bool:
|
|
27
|
+
"""Greater than operator (>). Compares based on internal value."""
|
|
28
|
+
...
|
|
29
|
+
|
|
30
|
+
def __ge__(self, other: Any) -> bool:
|
|
31
|
+
"""Greater than or equal operator (>=). Compares based on internal value."""
|
|
32
|
+
...
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
from .EqualityProtocol import EqualityProtocol
|
|
2
|
+
from .OrderingProtocol import OrderingProtocol
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Comparison Dunder Protocols Sub-Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Defines protocols for object equality checks, hashing, and ordering comparisons across the object hierarchy.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :----------------- | :------- | :--------------------------------------------------------------------------- |
|
|
14
|
+
| `EqualityProtocol` | Protocol | Interface for equality (`__eq__`, `__ne__`) and hashing (`__hash__`). |
|
|
15
|
+
| `OrderingProtocol` | Protocol | Interface for rich comparison operators (`<`, `<=`, `>`, `>=`). |
|
|
16
|
+
"""
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ...base_class import SimpleMixinProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class ClassGetItemProtocol(
|
|
8
|
+
SimpleMixinProtocol,
|
|
9
|
+
Protocol
|
|
10
|
+
):
|
|
11
|
+
"""
|
|
12
|
+
Protocol for the ClassGetItem mixin.
|
|
13
|
+
|
|
14
|
+
Guarantees support for class-level generic indexing (e.g., MyClass[int]),
|
|
15
|
+
enabling clean usage of advanced type hints without runtime penalties.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
def __class_getitem__(cls, item: Any) -> type:
|
|
19
|
+
"""
|
|
20
|
+
Special dunder method supporting generic syntax on the class.
|
|
21
|
+
Returns either the superclass result or the class object (type) itself.
|
|
22
|
+
"""
|
|
23
|
+
...
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
from .ClassGetItemProtocol import ClassGetItemProtocol
|
|
2
|
+
|
|
3
|
+
_DESIGN_NOTES = """
|
|
4
|
+
# Generics Dunder Protocols Sub-Package
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
Provides protocols enabling class-level indexing and generic type hints support without runtime performance penalties.
|
|
8
|
+
|
|
9
|
+
## Internal Components Registry
|
|
10
|
+
|
|
11
|
+
| Component | Type | Description |
|
|
12
|
+
| :--------------------- | :------- | :--------------------------------------------------------------------------- |
|
|
13
|
+
| `ClassGetItemProtocol` | Protocol | Interface guaranteeing class-level generic subscripting via `__class_getitem__`.|
|
|
14
|
+
"""
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any, Self
|
|
2
|
+
# Outers
|
|
3
|
+
from ...core_mixins import InfrastructureProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class CallProtocol(
|
|
8
|
+
InfrastructureProtocol,
|
|
9
|
+
Protocol
|
|
10
|
+
):
|
|
11
|
+
"""
|
|
12
|
+
Protocol for the Call mixin.
|
|
13
|
+
|
|
14
|
+
Guarantees the ability to call an instance like a function (obj(...)) for
|
|
15
|
+
bulk updates and internal state transformations. Returns a modified version
|
|
16
|
+
of the same type (Self).
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
def __call__(self, *changes: Any, **kwargs: Any) -> Self:
|
|
20
|
+
"""
|
|
21
|
+
Allows calling the instance as a function and applying changes to it.
|
|
22
|
+
|
|
23
|
+
Supports both positional arguments (tuples, variations of tuples) and
|
|
24
|
+
keyword arguments (kwargs). Delegates all execution logic to the with_any engine.
|
|
25
|
+
"""
|
|
26
|
+
...
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Self, Literal, Type
|
|
2
|
+
from types import TracebackType
|
|
3
|
+
# Outers
|
|
4
|
+
from ...base_class import SimpleMixinProtocol
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
@runtime_checkable
|
|
8
|
+
class ContextProtocol(
|
|
9
|
+
SimpleMixinProtocol,
|
|
10
|
+
Protocol
|
|
11
|
+
):
|
|
12
|
+
"""
|
|
13
|
+
Protocol for the Context mixin.
|
|
14
|
+
|
|
15
|
+
Guarantees support for context management (with obj:), enabling safe code
|
|
16
|
+
scoping. Entering the context returns the instance itself (Self).
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
def __enter__(self) -> Self:
|
|
20
|
+
"""
|
|
21
|
+
Enters the 'with' context block.
|
|
22
|
+
Returns the object instance itself for assignment (with obj as x:).
|
|
23
|
+
"""
|
|
24
|
+
...
|
|
25
|
+
|
|
26
|
+
def __exit__(
|
|
27
|
+
self,
|
|
28
|
+
exc_type: Type[BaseException] | None,
|
|
29
|
+
exc_val: BaseException | None,
|
|
30
|
+
exc_tb: TracebackType | None
|
|
31
|
+
) -> Literal[False]:
|
|
32
|
+
"""
|
|
33
|
+
Exits the 'with' context block.
|
|
34
|
+
|
|
35
|
+
Receives potential exception details. Always returns False, ensuring
|
|
36
|
+
exceptions are never swallowed and propagate normally.
|
|
37
|
+
"""
|
|
38
|
+
...
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
from .CallProtocol import CallProtocol
|
|
2
|
+
from .ContextProtocol import ContextProtocol
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Interfaces Dunder Protocols Sub-Package
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Defines protocols for callable instances and context management scoping within Python execution blocks.
|
|
9
|
+
|
|
10
|
+
## Internal Components Registry
|
|
11
|
+
|
|
12
|
+
| Component | Type | Description |
|
|
13
|
+
| :---------------- | :------- | :--------------------------------------------------------------------------- |
|
|
14
|
+
| `CallProtocol` | Protocol | Interface enabling instance invocation as a function for state updates. |
|
|
15
|
+
| `ContextProtocol` | Protocol | Interface for context manager protocol (`__enter__` and `__exit__`). |
|
|
16
|
+
"""
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Self, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ...core_mixins import NodesDictsProtocol, SnapshotProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class CopyableProtocol(
|
|
8
|
+
NodesDictsProtocol,
|
|
9
|
+
SnapshotProtocol,
|
|
10
|
+
Protocol
|
|
11
|
+
):
|
|
12
|
+
"""
|
|
13
|
+
Protocol for the Copyable mixin.
|
|
14
|
+
|
|
15
|
+
Guarantees support for standard shallow and deep copying of objects
|
|
16
|
+
within the Python ecosystem (integration with the copy module). The strategy
|
|
17
|
+
adapts internally to the mutability state while consistently returning the identical type (Self).
|
|
18
|
+
"""
|
|
19
|
+
|
|
20
|
+
def __copy__(self) -> Self:
|
|
21
|
+
"""
|
|
22
|
+
Creates and returns a shallow copy of this instance.
|
|
23
|
+
Safely responds to the object's mutable/immutable mode.
|
|
24
|
+
"""
|
|
25
|
+
...
|
|
26
|
+
|
|
27
|
+
def __deepcopy__(self, memo: dict[int, Any]) -> Self:
|
|
28
|
+
"""
|
|
29
|
+
Creates and returns a deep copy of this instance.
|
|
30
|
+
The `memo` dictionary serves to internally track already visited
|
|
31
|
+
objects to prevent recursion cycles.
|
|
32
|
+
"""
|
|
33
|
+
...
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable
|
|
2
|
+
# Inners
|
|
3
|
+
from .CopyableProtocol import CopyableProtocol
|
|
4
|
+
from .PickleReduceProtocol import PickleReduceProtocol
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
@runtime_checkable
|
|
8
|
+
class LifecycleProtocol(
|
|
9
|
+
CopyableProtocol,
|
|
10
|
+
PickleReduceProtocol,
|
|
11
|
+
Protocol
|
|
12
|
+
):
|
|
13
|
+
"""
|
|
14
|
+
Protocol for the master Lifecycle mixin.
|
|
15
|
+
|
|
16
|
+
Encompasses the complete Python lifecycle of an instance. Fully combines
|
|
17
|
+
safe replication capabilities (shallow and deep copying) with low-level
|
|
18
|
+
support for state persistence, restoration, and reduction (pickle protocol).
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
# The master mixin itself acts solely as a structural aggregator, declaring no additional slots or methods.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, TYPE_CHECKING
|
|
2
|
+
# Inners
|
|
3
|
+
from .PickleStateProtocol import PickleStateProtocol
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from .internal_types import PicklePlan
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
@runtime_checkable
|
|
10
|
+
class PickleReduceProtocol(
|
|
11
|
+
PickleStateProtocol,
|
|
12
|
+
Protocol
|
|
13
|
+
):
|
|
14
|
+
"""
|
|
15
|
+
Protocol for the PickleReduce mixin.
|
|
16
|
+
|
|
17
|
+
Guarantees integration with the low-level pickle protocol via the
|
|
18
|
+
__reduce__ method, defining the factory reconstruction plan for the object.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
def __reduce__(self) -> "PicklePlan":
|
|
22
|
+
"""
|
|
23
|
+
Native Python pickle protocol.
|
|
24
|
+
|
|
25
|
+
Returns a triplet containing:
|
|
26
|
+
1. Class object for instance recreation (self.__class__)
|
|
27
|
+
2. Empty tuple of positional constructor arguments
|
|
28
|
+
3. State dictionary retrieved via __getstate__()
|
|
29
|
+
"""
|
|
30
|
+
...
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ...core_mixins import SerializationProtocol
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ....alias_typings import StateDict
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
@runtime_checkable
|
|
10
|
+
class PickleStateProtocol(
|
|
11
|
+
SerializationProtocol,
|
|
12
|
+
Protocol
|
|
13
|
+
):
|
|
14
|
+
"""
|
|
15
|
+
Protocol for the PickleState mixin.
|
|
16
|
+
|
|
17
|
+
Guarantees support for object state persistence and restoration (freezing/thawing)
|
|
18
|
+
using the standard Python pickle protocol via dictionary representation.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
def __getstate__(self) -> "StateDict":
|
|
22
|
+
"""
|
|
23
|
+
Exports the complete current state of the instance as a clean dictionary.
|
|
24
|
+
Internally leverages the to_dict() method to perform this operation.
|
|
25
|
+
"""
|
|
26
|
+
...
|
|
27
|
+
|
|
28
|
+
def __setstate__(self, state: "StateDict") -> None:
|
|
29
|
+
"""
|
|
30
|
+
Restores the internal state of the instance from the provided dictionary.
|
|
31
|
+
Requires and invokes the from_dict() method, otherwise raises a TypeError.
|
|
32
|
+
"""
|
|
33
|
+
...
|
|
34
|
+
|
|
35
|
+
# --- REQUIRED INTERFACE FOR PROPER MIXIN FUNCTIONALITY ---
|
|
36
|
+
|
|
37
|
+
def from_dict(self, user_dict: "StateDict") -> Any:
|
|
38
|
+
"""
|
|
39
|
+
Method that this mixin strictly requires on the target class
|
|
40
|
+
for proper operation (implemented via Mutable/ImmutableSerialization).
|
|
41
|
+
"""
|
|
42
|
+
...
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
from .CopyableProtocol import CopyableProtocol
|
|
2
|
+
from .LifecycleProtocol import LifecycleProtocol
|
|
3
|
+
from .PickleReduceProtocol import PickleReduceProtocol
|
|
4
|
+
from .PickleStateProtocol import PickleStateProtocol
|
|
5
|
+
|
|
6
|
+
_DESIGN_NOTES = """
|
|
7
|
+
# Lifecycles Dunder Protocols Sub-Package
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
Provides protocols governing object replication, state freezing, restoration, and serialization hooks.
|
|
11
|
+
|
|
12
|
+
## Internal Components Registry
|
|
13
|
+
|
|
14
|
+
| Component | Type | Description |
|
|
15
|
+
| :--------------------- | :------- | :--------------------------------------------------------------------------- |
|
|
16
|
+
| `CopyableProtocol` | Protocol | Interface for shallow (`__copy__`) and deep (`__deepcopy__`) copying. |
|
|
17
|
+
| `LifecycleProtocol` | Protocol | Master structural aggregator combining copying and pickle protocols. |
|
|
18
|
+
| `PickleReduceProtocol` | Protocol | Low-level pickle protocol interface via factory reconstruction (`__reduce__`).|
|
|
19
|
+
| `PickleStateProtocol` | Protocol | State persistence interface using `__getstate__` and `__setstate__`. |
|
|
20
|
+
"""
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
from .PicklePlan import PicklePlan
|
|
2
|
+
|
|
3
|
+
_DESIGN_NOTES = """
|
|
4
|
+
# Lifecycles Internal Types Sub-Package
|
|
5
|
+
|
|
6
|
+
## Purpose
|
|
7
|
+
Provides type definitions for object lifecycle operations, specifically pickle reconstruction tuples.
|
|
8
|
+
|
|
9
|
+
## Internal Components Registry
|
|
10
|
+
|
|
11
|
+
| Component | Type | Description |
|
|
12
|
+
| :----------- | :-------- | :--------------------------------------------------------------------------- |
|
|
13
|
+
| `PicklePlan` | TypeAlias | Tuple structure defining class, empty arguments, and state dictionary for pickle.|
|
|
14
|
+
"""
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any, Self
|
|
2
|
+
# Outers
|
|
3
|
+
from ...core_mixins import NodesDictsProtocol, SnapshotProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class ArithmeticProtocol(
|
|
8
|
+
NodesDictsProtocol,
|
|
9
|
+
SnapshotProtocol,
|
|
10
|
+
Protocol
|
|
11
|
+
):
|
|
12
|
+
"""
|
|
13
|
+
Protocol for the Arithmetic mixin.
|
|
14
|
+
|
|
15
|
+
Guarantees a complete set of standard and right-hand arithmetic
|
|
16
|
+
operators (+, -, *, /, //, %, **) with integrated safe type conversion.
|
|
17
|
+
All operations are pure and return a new instance of the same type (Self).
|
|
18
|
+
"""
|
|
19
|
+
|
|
20
|
+
# ----------------------------------------
|
|
21
|
+
# Addition (+)
|
|
22
|
+
# ----------------------------------------
|
|
23
|
+
def __add__(self, other: Any) -> Self:
|
|
24
|
+
"""Returns a new instance with value (self.value + other)."""
|
|
25
|
+
...
|
|
26
|
+
|
|
27
|
+
def __radd__(self, other: Any) -> Self:
|
|
28
|
+
"""Right-hand addition. Returns a new instance with value (other + self.value)."""
|
|
29
|
+
...
|
|
30
|
+
|
|
31
|
+
# ----------------------------------------
|
|
32
|
+
# Subtraction (-)
|
|
33
|
+
# ----------------------------------------
|
|
34
|
+
def __sub__(self, other: Any) -> Self:
|
|
35
|
+
"""Returns a new instance with value (self.value - other)."""
|
|
36
|
+
...
|
|
37
|
+
|
|
38
|
+
def __rsub__(self, other: Any) -> Self:
|
|
39
|
+
"""Right-hand subtraction. Returns a new instance with value (other - self.value)."""
|
|
40
|
+
...
|
|
41
|
+
|
|
42
|
+
# ----------------------------------------
|
|
43
|
+
# Multiplication (*)
|
|
44
|
+
# ----------------------------------------
|
|
45
|
+
def __mul__(self, other: Any) -> Self:
|
|
46
|
+
"""Returns a new instance with value (self.value * other)."""
|
|
47
|
+
...
|
|
48
|
+
|
|
49
|
+
def __rmul__(self, other: Any) -> Self:
|
|
50
|
+
"""Right-hand multiplication. Returns a new instance with value (other * self.value)."""
|
|
51
|
+
...
|
|
52
|
+
|
|
53
|
+
# ----------------------------------------
|
|
54
|
+
# True Division (/)
|
|
55
|
+
# ----------------------------------------
|
|
56
|
+
def __truediv__(self, other: Any) -> Self:
|
|
57
|
+
"""Returns a new instance with value (self.value / other)."""
|
|
58
|
+
...
|
|
59
|
+
|
|
60
|
+
def __rtruediv__(self, other: Any) -> Self:
|
|
61
|
+
"""Right-hand true division. Returns a new instance with value (other / self.value)."""
|
|
62
|
+
...
|
|
63
|
+
|
|
64
|
+
# ----------------------------------------
|
|
65
|
+
# Floor Division (//)
|
|
66
|
+
# ----------------------------------------
|
|
67
|
+
def __floordiv__(self, other: Any) -> Self:
|
|
68
|
+
"""Returns a new instance with value (self.value // other)."""
|
|
69
|
+
...
|
|
70
|
+
|
|
71
|
+
def __rfloordiv__(self, other: Any) -> Self:
|
|
72
|
+
"""Right-hand floor division. Returns a new instance with value (other // self.value)."""
|
|
73
|
+
...
|
|
74
|
+
|
|
75
|
+
# ----------------------------------------
|
|
76
|
+
# Modulo (%)
|
|
77
|
+
# ----------------------------------------
|
|
78
|
+
def __mod__(self, other: Any) -> Self:
|
|
79
|
+
"""Returns a new instance with value (self.value % other)."""
|
|
80
|
+
...
|
|
81
|
+
|
|
82
|
+
def __rmod__(self, other: Any) -> Self:
|
|
83
|
+
"""Right-hand modulo. Returns a new instance with value (other % self.value)."""
|
|
84
|
+
...
|
|
85
|
+
|
|
86
|
+
# ----------------------------------------
|
|
87
|
+
# Power (**)
|
|
88
|
+
# ----------------------------------------
|
|
89
|
+
def __pow__(self, other: Any) -> Self:
|
|
90
|
+
"""Returns a new instance with value (self.value ** other)."""
|
|
91
|
+
...
|
|
92
|
+
|
|
93
|
+
def __rpow__(self, other: Any) -> Self:
|
|
94
|
+
"""Right-hand exponentiation. Returns a new instance with value (other ** self.value)."""
|
|
95
|
+
...
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any, Self
|
|
2
|
+
# Outers
|
|
3
|
+
from ...core_mixins import NodesDictsProtocol, SnapshotProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class BitwiseProtocol(
|
|
8
|
+
NodesDictsProtocol,
|
|
9
|
+
SnapshotProtocol,
|
|
10
|
+
Protocol
|
|
11
|
+
):
|
|
12
|
+
"""
|
|
13
|
+
Protocol for the Bitwise mixin.
|
|
14
|
+
|
|
15
|
+
Guarantees a complete set of bitwise operators (&, |, ^, <<, >>, ~).
|
|
16
|
+
All operations are pure and return a new instance of the same type (Self).
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
# ----------------------------------------
|
|
20
|
+
# AND Operator (&)
|
|
21
|
+
# ----------------------------------------
|
|
22
|
+
def __and__(self, other: Any) -> Self:
|
|
23
|
+
"""Returns a new instance with value (self.value & other)."""
|
|
24
|
+
...
|
|
25
|
+
|
|
26
|
+
def __rand__(self, other: Any) -> Self:
|
|
27
|
+
"""Right-hand AND. Returns a new instance with value (other & self.value)."""
|
|
28
|
+
...
|
|
29
|
+
|
|
30
|
+
# ----------------------------------------
|
|
31
|
+
# OR Operator (|)
|
|
32
|
+
# ----------------------------------------
|
|
33
|
+
def __or__(self, other: Any) -> Self:
|
|
34
|
+
"""Returns a new instance with value (self.value | other)."""
|
|
35
|
+
...
|
|
36
|
+
|
|
37
|
+
def __ror__(self, other: Any) -> Self:
|
|
38
|
+
"""Right-hand OR. Returns a new instance with value (other | self.value)."""
|
|
39
|
+
...
|
|
40
|
+
|
|
41
|
+
# ----------------------------------------
|
|
42
|
+
# XOR Operator (^)
|
|
43
|
+
# ----------------------------------------
|
|
44
|
+
def __xor__(self, other: Any) -> Self:
|
|
45
|
+
"""Returns a new instance with value (self.value ^ other)."""
|
|
46
|
+
...
|
|
47
|
+
|
|
48
|
+
def __rxor__(self, other: Any) -> Self:
|
|
49
|
+
"""Right-hand XOR. Returns a new instance with value (other ^ self.value)."""
|
|
50
|
+
...
|
|
51
|
+
|
|
52
|
+
# ----------------------------------------
|
|
53
|
+
# LSHIFT Operator (<<)
|
|
54
|
+
# ----------------------------------------
|
|
55
|
+
def __lshift__(self, other: Any) -> Self:
|
|
56
|
+
"""Bitwise left shift. Returns a new instance with value (self.value << other)."""
|
|
57
|
+
...
|
|
58
|
+
|
|
59
|
+
def __rlshift__(self, other: Any) -> Self:
|
|
60
|
+
"""Right-hand left shift. Returns a new instance with value (other << self.value)."""
|
|
61
|
+
...
|
|
62
|
+
|
|
63
|
+
# ----------------------------------------
|
|
64
|
+
# RSHIFT Operator (>>)
|
|
65
|
+
# ----------------------------------------
|
|
66
|
+
def __rshift__(self, other: Any) -> Self:
|
|
67
|
+
"""Bitwise right shift. Returns a new instance with value (self.value >> other)."""
|
|
68
|
+
...
|
|
69
|
+
|
|
70
|
+
def __rrshift__(self, other: Any) -> Self:
|
|
71
|
+
"""Right-hand right shift. Returns a new instance with value (other >> self.value)."""
|
|
72
|
+
...
|
|
73
|
+
|
|
74
|
+
# ----------------------------------------
|
|
75
|
+
# INVERT Operator (~)
|
|
76
|
+
# ----------------------------------------
|
|
77
|
+
def __invert__(self) -> Self:
|
|
78
|
+
"""Unary bitwise inversion. Returns a new instance with value (~self.value)."""
|
|
79
|
+
...
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
from typing import Protocol, runtime_checkable, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ...base_class import SimpleMixinProtocol
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
@runtime_checkable
|
|
7
|
+
class ConversionProtocol(
|
|
8
|
+
SimpleMixinProtocol,
|
|
9
|
+
Protocol
|
|
10
|
+
):
|
|
11
|
+
"""
|
|
12
|
+
Protocol for the Conversion mixin.
|
|
13
|
+
|
|
14
|
+
Guarantees a set of standard conversion and mathematical methods
|
|
15
|
+
that convert the object's internal value into native Python types.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
# ----------------------------------------
|
|
19
|
+
# Basic Type Conversions
|
|
20
|
+
# ----------------------------------------
|
|
21
|
+
def __int__(self) -> int:
|
|
22
|
+
"""Returns a native int derived from the object's value."""
|
|
23
|
+
...
|
|
24
|
+
|
|
25
|
+
def __float__(self) -> float:
|
|
26
|
+
"""Returns a native float derived from the object's value."""
|
|
27
|
+
...
|
|
28
|
+
|
|
29
|
+
def __complex__(self) -> complex:
|
|
30
|
+
"""Returns a native complex derived from the object's value."""
|
|
31
|
+
...
|
|
32
|
+
|
|
33
|
+
def __index__(self) -> int:
|
|
34
|
+
"""
|
|
35
|
+
Returns a pure int for using the object as an index (slice, range, etc.).
|
|
36
|
+
Must return a strict int, otherwise Python raises a TypeError.
|
|
37
|
+
"""
|
|
38
|
+
...
|
|
39
|
+
|
|
40
|
+
# ----------------------------------------
|
|
41
|
+
# Mathematical Truncation and Rounding
|
|
42
|
+
# ----------------------------------------
|
|
43
|
+
def __round__(self, n: int | None = None) -> int | float:
|
|
44
|
+
"""Returns a native rounded value to 'n' decimal places."""
|
|
45
|
+
...
|
|
46
|
+
|
|
47
|
+
def __floor__(self) -> int:
|
|
48
|
+
"""Returns a native integer rounded down (math.floor)."""
|
|
49
|
+
...
|
|
50
|
+
|
|
51
|
+
def __ceil__(self) -> int:
|
|
52
|
+
"""Returns a native integer rounded up (math.ceil)."""
|
|
53
|
+
...
|
|
54
|
+
|
|
55
|
+
def __trunc__(self) -> int:
|
|
56
|
+
"""Returns a native integer truncated toward zero (math.trunc)."""
|
|
57
|
+
...
|