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,172 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
import operator
|
|
3
|
+
from numbers import Integral
|
|
4
|
+
# Outers
|
|
5
|
+
from ...core_mixins import NodesDicts, Snapshot
|
|
6
|
+
from ..._common_logic.immutability import with_constant
|
|
7
|
+
# Inners
|
|
8
|
+
from ._utils import execute_bitwise_op
|
|
9
|
+
# Annotations
|
|
10
|
+
if TYPE_CHECKING:
|
|
11
|
+
from ...._core.protocols.mixins.dunders.numeric import BitwiseProtocol
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
class Bitwise(NodesDicts, Snapshot):
|
|
15
|
+
"""
|
|
16
|
+
Provides bitwise operations (&, |, ^, <<, >>, ~) for SimpleObject
|
|
17
|
+
atoms.
|
|
18
|
+
|
|
19
|
+
Properties:
|
|
20
|
+
- works only for atoms (constants)
|
|
21
|
+
- works only for integral types (int, custom integer-like types)
|
|
22
|
+
- operations are pure -> return a new instance via the with_constant
|
|
23
|
+
pipeline
|
|
24
|
+
"""
|
|
25
|
+
|
|
26
|
+
# ----------------------------------------
|
|
27
|
+
# Basic interface
|
|
28
|
+
# ----------------------------------------
|
|
29
|
+
|
|
30
|
+
# Compatibility declaration
|
|
31
|
+
_constant_only = True
|
|
32
|
+
_only_types = Integral
|
|
33
|
+
|
|
34
|
+
# Slot definition
|
|
35
|
+
__slots__ = ()
|
|
36
|
+
|
|
37
|
+
# ----------------------------------------
|
|
38
|
+
# Methods - & (Bitwise AND)
|
|
39
|
+
# ----------------------------------------
|
|
40
|
+
def __and__(
|
|
41
|
+
self: "BitwiseProtocol",
|
|
42
|
+
other: Any
|
|
43
|
+
) -> "BitwiseProtocol":
|
|
44
|
+
"""Returns a new instance with the value self.value & other."""
|
|
45
|
+
return execute_bitwise_op(self, operator.and_, other)
|
|
46
|
+
|
|
47
|
+
def __rand__(
|
|
48
|
+
self: "BitwiseProtocol",
|
|
49
|
+
other: Any
|
|
50
|
+
) -> "BitwiseProtocol":
|
|
51
|
+
"""Returns a new instance with the value other & self.value."""
|
|
52
|
+
return execute_bitwise_op(self, operator.and_, other, is_reversed=True)
|
|
53
|
+
|
|
54
|
+
# ----------------------------------------
|
|
55
|
+
# Methods - | (Bitwise OR)
|
|
56
|
+
# ----------------------------------------
|
|
57
|
+
def __or__(
|
|
58
|
+
self: "BitwiseProtocol",
|
|
59
|
+
other: Any
|
|
60
|
+
) -> "BitwiseProtocol":
|
|
61
|
+
"""Returns a new instance with the value self.value | other."""
|
|
62
|
+
return execute_bitwise_op(self, operator.or_, other)
|
|
63
|
+
|
|
64
|
+
def __ror__(
|
|
65
|
+
self: "BitwiseProtocol",
|
|
66
|
+
other: Any
|
|
67
|
+
) -> "BitwiseProtocol":
|
|
68
|
+
"""Returns a new instance with the value other | self.value."""
|
|
69
|
+
return execute_bitwise_op(self, operator.or_, other, is_reversed=True)
|
|
70
|
+
|
|
71
|
+
# ----------------------------------------
|
|
72
|
+
# Methods - ^ (Bitwise XOR)
|
|
73
|
+
# ----------------------------------------
|
|
74
|
+
def __xor__(
|
|
75
|
+
self: "BitwiseProtocol",
|
|
76
|
+
other: Any
|
|
77
|
+
) -> "BitwiseProtocol":
|
|
78
|
+
"""Returns a new instance with the value self.value ^ other."""
|
|
79
|
+
return execute_bitwise_op(self, operator.xor, other)
|
|
80
|
+
|
|
81
|
+
def __rxor__(
|
|
82
|
+
self: "BitwiseProtocol",
|
|
83
|
+
other: Any
|
|
84
|
+
) -> "BitwiseProtocol":
|
|
85
|
+
"""Returns a new instance with the value other ^ self.value."""
|
|
86
|
+
return execute_bitwise_op(self, operator.xor, other, is_reversed=True)
|
|
87
|
+
|
|
88
|
+
# ----------------------------------------
|
|
89
|
+
# Methods - << (Bitwise Left Shift)
|
|
90
|
+
# ----------------------------------------
|
|
91
|
+
def __lshift__(
|
|
92
|
+
self: "BitwiseProtocol",
|
|
93
|
+
other: Any
|
|
94
|
+
) -> "BitwiseProtocol":
|
|
95
|
+
"""Returns a new instance with the value self.value << other."""
|
|
96
|
+
return execute_bitwise_op(self, operator.lshift, other)
|
|
97
|
+
|
|
98
|
+
def __rlshift__(
|
|
99
|
+
self: "BitwiseProtocol",
|
|
100
|
+
other: Any
|
|
101
|
+
) -> "BitwiseProtocol":
|
|
102
|
+
"""Returns a new instance with the value other << self.value."""
|
|
103
|
+
return execute_bitwise_op(self, operator.lshift, other, is_reversed=True)
|
|
104
|
+
|
|
105
|
+
# ----------------------------------------
|
|
106
|
+
# Methods - >> (Bitwise Right Shift)
|
|
107
|
+
# ----------------------------------------
|
|
108
|
+
def __rshift__(
|
|
109
|
+
self: "BitwiseProtocol",
|
|
110
|
+
other: Any
|
|
111
|
+
) -> "BitwiseProtocol":
|
|
112
|
+
"""Returns a new instance with the value self.value >> other."""
|
|
113
|
+
return execute_bitwise_op(self, operator.rshift, other)
|
|
114
|
+
|
|
115
|
+
def __rrshift__(
|
|
116
|
+
self: "BitwiseProtocol",
|
|
117
|
+
other: Any
|
|
118
|
+
) -> "BitwiseProtocol":
|
|
119
|
+
"""Returns a new instance with the value other >> self.value."""
|
|
120
|
+
return execute_bitwise_op(self, operator.rshift, other, is_reversed=True)
|
|
121
|
+
|
|
122
|
+
# ----------------------------------------
|
|
123
|
+
# Methods - ~x (Bitwise Invert / Unary operator)
|
|
124
|
+
# ----------------------------------------
|
|
125
|
+
def __invert__(
|
|
126
|
+
self: "BitwiseProtocol",
|
|
127
|
+
) -> Any:
|
|
128
|
+
"""Returns a new instance with the value ~self.value."""
|
|
129
|
+
try:
|
|
130
|
+
value = ~self.value
|
|
131
|
+
return with_constant(self, self.meta.name_snake, value)
|
|
132
|
+
except TypeError:
|
|
133
|
+
return NotImplemented
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
_DESIGN_NOTES = """
|
|
137
|
+
# Bitwise
|
|
138
|
+
|
|
139
|
+
## Purpose
|
|
140
|
+
Gives a SimpleObject atom the standard bitwise operators (`&`, `|`, `^`,
|
|
141
|
+
`<<`, `>>`, `~`), including reflected forms, so integer-valued constants
|
|
142
|
+
behave like plain `int` in bit-manipulation code — flags, masks, bit
|
|
143
|
+
shifting, etc.
|
|
144
|
+
|
|
145
|
+
## Compatibility
|
|
146
|
+
- `_constant_only = True` — bitwise operations only make sense on a
|
|
147
|
+
single scalar value, not on a composite's tree of inners, so this
|
|
148
|
+
mixin is restricted to atoms.
|
|
149
|
+
- `_only_types = Integral` — narrower than `Arithmetic`'s `Number`: bit
|
|
150
|
+
operations are only meaningful on integral types (`int` and
|
|
151
|
+
integer-like custom types), not on floats.
|
|
152
|
+
|
|
153
|
+
## Logic
|
|
154
|
+
`&`, `|`, `^`, `<<`, `>>` all follow the same pattern as `Arithmetic`:
|
|
155
|
+
delegate to `execute_bitwise_op` with the matching `operator.*` function,
|
|
156
|
+
using `is_reversed=True` for the reflected variants.
|
|
157
|
+
|
|
158
|
+
`__invert__` (`~x`) is handled separately since it's unary and has no
|
|
159
|
+
reflected counterpart: it computes `~self.value` directly and wraps the
|
|
160
|
+
result via `with_constant`, catching `TypeError` and returning
|
|
161
|
+
`NotImplemented` if the value doesn't support inversion.
|
|
162
|
+
|
|
163
|
+
## Notes
|
|
164
|
+
- "Operations are pure" — every operator returns a **new** instance via
|
|
165
|
+
the `with_constant` pipeline rather than mutating in place, consistent
|
|
166
|
+
with `Arithmetic`.
|
|
167
|
+
- Deliberately narrower than `Arithmetic` in two ways at once
|
|
168
|
+
(`_constant_only` + `Integral`) — this is what distinguishes "a
|
|
169
|
+
constant that behaves like an int with bit ops" from "a value that
|
|
170
|
+
supports general math," which composites and floats can still get via
|
|
171
|
+
`Arithmetic` alone.
|
|
172
|
+
"""
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
import math
|
|
3
|
+
from numbers import Number
|
|
4
|
+
# Outers
|
|
5
|
+
from ...base_class import SimpleMixin
|
|
6
|
+
#Inners
|
|
7
|
+
from ._utils import execute_conversion
|
|
8
|
+
# Annotations
|
|
9
|
+
if TYPE_CHECKING:
|
|
10
|
+
from ...._core.protocols.mixins.dunders.numeric import ConversionProtocol
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
class Conversion(SimpleMixin):
|
|
14
|
+
"""
|
|
15
|
+
Provides conversion dunders (int, float, complex, index, round,
|
|
16
|
+
floor, ceil, trunc) for SimpleObject atoms and composites.
|
|
17
|
+
|
|
18
|
+
These methods:
|
|
19
|
+
- return native Python types (int, float, complex, ...)
|
|
20
|
+
- do not return a SimpleObject
|
|
21
|
+
- raise TypeError on an invalid conversion
|
|
22
|
+
"""
|
|
23
|
+
|
|
24
|
+
# ----------------------------------------
|
|
25
|
+
# Basic interface
|
|
26
|
+
# ----------------------------------------
|
|
27
|
+
|
|
28
|
+
# Compatibility declaration
|
|
29
|
+
_only_types = Number
|
|
30
|
+
|
|
31
|
+
# Slot definition
|
|
32
|
+
__slots__ = ()
|
|
33
|
+
|
|
34
|
+
# ----------------------------------------
|
|
35
|
+
# Methods - INT / FLOAT / COMPLEX
|
|
36
|
+
# ----------------------------------------
|
|
37
|
+
def __int__(
|
|
38
|
+
self: "ConversionProtocol"
|
|
39
|
+
) -> int:
|
|
40
|
+
"""Returns the native int(self.value)."""
|
|
41
|
+
return execute_conversion(self, int)
|
|
42
|
+
|
|
43
|
+
def __float__(
|
|
44
|
+
self: "ConversionProtocol"
|
|
45
|
+
) -> float:
|
|
46
|
+
"""Returns the native float(self.value)."""
|
|
47
|
+
return execute_conversion(self, float)
|
|
48
|
+
|
|
49
|
+
def __complex__(
|
|
50
|
+
self: "ConversionProtocol"
|
|
51
|
+
) -> complex:
|
|
52
|
+
"""Returns the native complex(self.value)."""
|
|
53
|
+
return execute_conversion(self, complex)
|
|
54
|
+
|
|
55
|
+
# ----------------------------------------
|
|
56
|
+
# Methods - INDEX (for use in slice, range, etc.)
|
|
57
|
+
# ----------------------------------------
|
|
58
|
+
def __index__(
|
|
59
|
+
self: "ConversionProtocol"
|
|
60
|
+
) -> int:
|
|
61
|
+
"""
|
|
62
|
+
Returns the native int(self.value) for use in range(), slice,
|
|
63
|
+
etc. Must return an exact int, otherwise Python raises TypeError.
|
|
64
|
+
"""
|
|
65
|
+
value = self.value
|
|
66
|
+
if not isinstance(value, int):
|
|
67
|
+
raise TypeError(
|
|
68
|
+
f"{self.meta.class_name} cannot be used as an index — "
|
|
69
|
+
f"value must be int, not {type(value).__name__}."
|
|
70
|
+
)
|
|
71
|
+
return value
|
|
72
|
+
|
|
73
|
+
# ----------------------------------------
|
|
74
|
+
# Methods - ROUND
|
|
75
|
+
# ----------------------------------------
|
|
76
|
+
def __round__(
|
|
77
|
+
self: "ConversionProtocol",
|
|
78
|
+
n: int | None = None
|
|
79
|
+
) -> int | float:
|
|
80
|
+
"""Returns the native round(self.value, n)."""
|
|
81
|
+
return (
|
|
82
|
+
execute_conversion(self, round, n)
|
|
83
|
+
if n is not None
|
|
84
|
+
else execute_conversion(self, round)
|
|
85
|
+
)
|
|
86
|
+
|
|
87
|
+
# ----------------------------------------
|
|
88
|
+
# Methods - FLOOR / CEIL / TRUNC
|
|
89
|
+
# ----------------------------------------
|
|
90
|
+
def __floor__(
|
|
91
|
+
self: "ConversionProtocol"
|
|
92
|
+
) -> int:
|
|
93
|
+
"""Returns the native math.floor(self.value)."""
|
|
94
|
+
return execute_conversion(self, math.floor)
|
|
95
|
+
|
|
96
|
+
def __ceil__(
|
|
97
|
+
self: "ConversionProtocol"
|
|
98
|
+
) -> int:
|
|
99
|
+
"""Returns the native math.ceil(self.value)."""
|
|
100
|
+
return execute_conversion(self, math.ceil)
|
|
101
|
+
|
|
102
|
+
def __trunc__(
|
|
103
|
+
self: "ConversionProtocol"
|
|
104
|
+
) -> int:
|
|
105
|
+
"""Returns the native math.trunc(self.value)."""
|
|
106
|
+
return execute_conversion(self, math.trunc)
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
_DESIGN_NOTES = """
|
|
110
|
+
# Conversion
|
|
111
|
+
|
|
112
|
+
## Purpose
|
|
113
|
+
Lets a SimpleObject be converted to native Python numeric types —
|
|
114
|
+
`int(obj)`, `float(obj)`, `complex(obj)`, `round(obj)`, `math.floor(obj)`,
|
|
115
|
+
etc. — and be used anywhere Python expects one of those, such as
|
|
116
|
+
`range(obj)` or slicing via `__index__`.
|
|
117
|
+
|
|
118
|
+
> For newcomers: unlike the other numeric mixins here, this one never
|
|
119
|
+
> returns a SimpleObject — every method returns a plain `int`/`float`/
|
|
120
|
+
> `complex`. That's the whole point: it's the "exit door" from the Simple
|
|
121
|
+
> ecosystem back into raw Python numbers.
|
|
122
|
+
|
|
123
|
+
## Compatibility
|
|
124
|
+
- `_only_types = Number` — every conversion assumes `self.value` is
|
|
125
|
+
already numeric; a non-numeric value would fail these conversions
|
|
126
|
+
anyway.
|
|
127
|
+
- Works for both atoms and composites — a composite with a well-defined
|
|
128
|
+
numeric `.value` can be converted the same way an atom can.
|
|
129
|
+
|
|
130
|
+
## Logic
|
|
131
|
+
`__int__`, `__float__`, `__complex__`, `__round__`, `__floor__`,
|
|
132
|
+
`__ceil__`, `__trunc__` all delegate to the shared `execute_conversion`
|
|
133
|
+
helper, passing the matching native callable (`int`, `float`, `round`,
|
|
134
|
+
`math.floor`, ...).
|
|
135
|
+
|
|
136
|
+
`__index__` is the exception — implemented directly rather than through
|
|
137
|
+
`execute_conversion`, because Python's `__index__` protocol has a strict
|
|
138
|
+
requirement: it must return an *exact* `int`, or Python itself raises a
|
|
139
|
+
`TypeError`. This method enforces that up front with an explicit
|
|
140
|
+
`isinstance` check and a descriptive error, rather than letting a vague
|
|
141
|
+
failure surface later inside `range()` or a slice.
|
|
142
|
+
|
|
143
|
+
## Notes
|
|
144
|
+
- All conversions raise `TypeError` on failure — by design, never a
|
|
145
|
+
silent `None` or a wrapped SimpleObject.
|
|
146
|
+
- `__round__`'s two call shapes (`round(obj)` vs `round(obj, n)`) are
|
|
147
|
+
both explicitly forwarded, since Python calls `__round__` differently
|
|
148
|
+
depending on whether `ndigits` was passed.
|
|
149
|
+
"""
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
import operator
|
|
2
|
+
from typing import TYPE_CHECKING, Any
|
|
3
|
+
from numbers import Number
|
|
4
|
+
# Outers
|
|
5
|
+
from ...base_class import SimpleMixin
|
|
6
|
+
#Inners
|
|
7
|
+
from ._utils import execute_inplace_op
|
|
8
|
+
# Annotations
|
|
9
|
+
if TYPE_CHECKING:
|
|
10
|
+
from ...._core.protocols.mixins.dunders.numeric import InplaceProtocol
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
class Inplace(SimpleMixin):
|
|
14
|
+
"""
|
|
15
|
+
Provides in-place arithmetic operations (+=, -=, *=, /=, //=, %=, **=)
|
|
16
|
+
for SimpleObject atoms and mutable instances.
|
|
17
|
+
|
|
18
|
+
Operations:
|
|
19
|
+
- change the instance's value via self.value = ...
|
|
20
|
+
- trigger validation and reactivity
|
|
21
|
+
- return self
|
|
22
|
+
"""
|
|
23
|
+
|
|
24
|
+
# ----------------------------------------
|
|
25
|
+
# Basic interface
|
|
26
|
+
# ----------------------------------------
|
|
27
|
+
|
|
28
|
+
# Compatibility declaration
|
|
29
|
+
_mutable_only = True
|
|
30
|
+
_only_types = Number
|
|
31
|
+
|
|
32
|
+
# Slot definition
|
|
33
|
+
__slots__ = ()
|
|
34
|
+
|
|
35
|
+
# ----------------------------------------
|
|
36
|
+
# Methods - Operators (+=, -=, *=, /=, //=, %=, **=)
|
|
37
|
+
# ----------------------------------------
|
|
38
|
+
def __iadd__(
|
|
39
|
+
self: "InplaceProtocol",
|
|
40
|
+
other: Any
|
|
41
|
+
) -> "InplaceProtocol":
|
|
42
|
+
"""In-place: self.value += other."""
|
|
43
|
+
return execute_inplace_op(self, operator.add, other)
|
|
44
|
+
|
|
45
|
+
def __isub__(
|
|
46
|
+
self: "InplaceProtocol",
|
|
47
|
+
other: Any
|
|
48
|
+
) -> "InplaceProtocol":
|
|
49
|
+
"""In-place: self.value -= other."""
|
|
50
|
+
return execute_inplace_op(self, operator.sub, other)
|
|
51
|
+
|
|
52
|
+
def __imul__(
|
|
53
|
+
self: "InplaceProtocol",
|
|
54
|
+
other: Any
|
|
55
|
+
) -> "InplaceProtocol":
|
|
56
|
+
"""In-place: self.value *= other."""
|
|
57
|
+
return execute_inplace_op(self, operator.mul, other)
|
|
58
|
+
|
|
59
|
+
def __itruediv__(
|
|
60
|
+
self: "InplaceProtocol",
|
|
61
|
+
other: Any
|
|
62
|
+
) -> "InplaceProtocol":
|
|
63
|
+
"""In-place: self.value /= other."""
|
|
64
|
+
return execute_inplace_op(self, operator.truediv, other)
|
|
65
|
+
|
|
66
|
+
def __ifloordiv__(
|
|
67
|
+
self: "InplaceProtocol",
|
|
68
|
+
other: Any
|
|
69
|
+
) -> "InplaceProtocol":
|
|
70
|
+
"""In-place: self.value //= other."""
|
|
71
|
+
return execute_inplace_op(self, operator.floordiv, other)
|
|
72
|
+
|
|
73
|
+
def __imod__(
|
|
74
|
+
self: "InplaceProtocol",
|
|
75
|
+
other: Any
|
|
76
|
+
) -> "InplaceProtocol":
|
|
77
|
+
"""In-place: self.value %= other."""
|
|
78
|
+
return execute_inplace_op(self, operator.mod, other)
|
|
79
|
+
|
|
80
|
+
def __ipow__(
|
|
81
|
+
self: "InplaceProtocol",
|
|
82
|
+
other: Any
|
|
83
|
+
) -> "InplaceProtocol":
|
|
84
|
+
"""In-place: self.value **= other."""
|
|
85
|
+
return execute_inplace_op(self, operator.pow, other)
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
_DESIGN_NOTES = """
|
|
89
|
+
# Inplace
|
|
90
|
+
|
|
91
|
+
## Purpose
|
|
92
|
+
Gives a mutable SimpleObject the in-place arithmetic operators (`+=`,
|
|
93
|
+
`-=`, `*=`, `/=`, `//=`, `%=`, `**=`), so a variable holding a mutable
|
|
94
|
+
instance can be updated in place, the same way plain numbers are.
|
|
95
|
+
|
|
96
|
+
## Compatibility
|
|
97
|
+
- `_mutable_only = True` — this is the key difference from `Arithmetic`.
|
|
98
|
+
Where `+` always returns a new instance, `+=` here genuinely mutates
|
|
99
|
+
`self.value`, which is only a coherent operation on a mutable instance.
|
|
100
|
+
On an immutable instance, `+=` would need to rebind the variable to a
|
|
101
|
+
new object anyway, which is exactly what `Arithmetic.__add__` already
|
|
102
|
+
provides — so `Inplace` doesn't need to (and must not) apply there.
|
|
103
|
+
- `_only_types = Number` — same reasoning as `Arithmetic`: the operators
|
|
104
|
+
only make sense on numeric values.
|
|
105
|
+
|
|
106
|
+
## Logic
|
|
107
|
+
Each operator delegates to the shared `execute_inplace_op` helper with
|
|
108
|
+
the matching `operator.*` function. Unlike `Arithmetic`'s helper, this
|
|
109
|
+
one is expected to:
|
|
110
|
+
1. Compute the new value.
|
|
111
|
+
2. Assign it via `self.value = ...`, which routes through the normal
|
|
112
|
+
validation and reactivity pipeline (so a bad in-place update is
|
|
113
|
+
rejected the same way a bad direct assignment would be).
|
|
114
|
+
3. Return `self`, satisfying Python's expectation that `__iadd__` etc.
|
|
115
|
+
return the (possibly same) object to rebind the name to.
|
|
116
|
+
|
|
117
|
+
## Notes
|
|
118
|
+
- No reflected variants exist for in-place operators in Python (there's
|
|
119
|
+
no `__riadd__`) — this mixin only needs the forward set.
|
|
120
|
+
- Choosing between `Arithmetic` and `Inplace` mixins on a class is really
|
|
121
|
+
choosing between "always get a new instance" and "mutate the existing
|
|
122
|
+
one" — a class can have both, since `+` and `+=` are independent
|
|
123
|
+
protocols, but `Inplace` alone would leave plain `+` undefined.
|
|
124
|
+
"""
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING
|
|
2
|
+
import operator
|
|
3
|
+
from numbers import Number
|
|
4
|
+
# Outers
|
|
5
|
+
from ...core_mixins import NodesDicts, Snapshot
|
|
6
|
+
# Inners
|
|
7
|
+
from ._utils import execute_unary_op
|
|
8
|
+
# Annotations
|
|
9
|
+
if TYPE_CHECKING:
|
|
10
|
+
from ...._core.protocols.mixins.dunders.numeric import UnaryProtocol
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
class Unary(NodesDicts, Snapshot):
|
|
14
|
+
"""
|
|
15
|
+
Provides unary numeric operations (-x, +x, abs(x)) for SimpleObject.
|
|
16
|
+
|
|
17
|
+
Supports:
|
|
18
|
+
- atoms (constants)
|
|
19
|
+
- composites (recomputes inner inners and owner values)
|
|
20
|
+
|
|
21
|
+
Includes a lazy fallback type conversion:
|
|
22
|
+
- if the operation fails, it attempts to convert the value to the
|
|
23
|
+
type of the default value
|
|
24
|
+
- the conversion is only performed if it is safe (e.g. int ->
|
|
25
|
+
float/Decimal/Fraction)
|
|
26
|
+
"""
|
|
27
|
+
|
|
28
|
+
# ----------------------------------------
|
|
29
|
+
# Basic interface
|
|
30
|
+
# ----------------------------------------
|
|
31
|
+
|
|
32
|
+
# Compatibility declaration
|
|
33
|
+
_only_types = Number
|
|
34
|
+
|
|
35
|
+
# Slot definition
|
|
36
|
+
__slots__ = ()
|
|
37
|
+
|
|
38
|
+
# ----------------------------------------
|
|
39
|
+
# Methods - Unary operators (-x, +x, abs(x))
|
|
40
|
+
# ----------------------------------------
|
|
41
|
+
def __neg__(
|
|
42
|
+
self: "UnaryProtocol"
|
|
43
|
+
) -> "UnaryProtocol":
|
|
44
|
+
"""Returns a new instance with the value -self.value."""
|
|
45
|
+
return execute_unary_op(self, operator.neg)
|
|
46
|
+
|
|
47
|
+
def __pos__(
|
|
48
|
+
self: "UnaryProtocol"
|
|
49
|
+
) -> "UnaryProtocol":
|
|
50
|
+
"""Returns a new instance with the value +self.value."""
|
|
51
|
+
return execute_unary_op(self, operator.pos)
|
|
52
|
+
|
|
53
|
+
def __abs__(
|
|
54
|
+
self: "UnaryProtocol"
|
|
55
|
+
) -> "UnaryProtocol":
|
|
56
|
+
"""Returns a new instance with the value abs(self.value)."""
|
|
57
|
+
return execute_unary_op(self, abs)
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
_DESIGN_NOTES = """
|
|
61
|
+
# Unary
|
|
62
|
+
|
|
63
|
+
## Purpose
|
|
64
|
+
Gives a SimpleObject the unary numeric operators — `-x`, `+x`, `abs(x)` —
|
|
65
|
+
so numeric-valued instances support the same single-operand math Python
|
|
66
|
+
numbers do.
|
|
67
|
+
|
|
68
|
+
## Compatibility
|
|
69
|
+
- `_only_types = Number` — same reasoning as `Arithmetic`: every
|
|
70
|
+
operation is delegated to Python's own math on `self.value`.
|
|
71
|
+
- Works for both atoms and composites, recomputing inners and owner
|
|
72
|
+
values on composites the same way `Arithmetic` does.
|
|
73
|
+
|
|
74
|
+
## Logic
|
|
75
|
+
All three operators are one-line calls into the shared
|
|
76
|
+
`execute_unary_op` helper, passing `operator.neg`, `operator.pos`, or the
|
|
77
|
+
`abs` builtin. As with `Arithmetic`, the lazy fallback type conversion
|
|
78
|
+
(trying a safe type conversion if the raw operation fails) lives inside
|
|
79
|
+
that shared helper, not in this file.
|
|
80
|
+
|
|
81
|
+
## Notes
|
|
82
|
+
- Every operator returns a **new instance**, consistent with
|
|
83
|
+
`Arithmetic` — there's no in-place unary form since `-x` and `+x`
|
|
84
|
+
don't have in-place equivalents in Python to begin with.
|
|
85
|
+
- Deliberately separate from `Arithmetic` even though both share the
|
|
86
|
+
same `_utils` module and `Number` restriction — unary and binary
|
|
87
|
+
operators are independent Python protocols, so a class could in
|
|
88
|
+
principle mix in one without the other.
|
|
89
|
+
"""
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
from .Arithmetic import Arithmetic
|
|
2
|
+
from .Bitwise import Bitwise
|
|
3
|
+
from .Conversion import Conversion
|
|
4
|
+
from .Inplace import Inplace
|
|
5
|
+
from .Unary import Unary
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
_DESIGN_NOTES = """
|
|
9
|
+
# Numeric Dunders
|
|
10
|
+
|
|
11
|
+
## Purpose
|
|
12
|
+
Gives Simple instances the full range of Python numeric protocols —
|
|
13
|
+
binary and unary arithmetic, bitwise operations, in-place arithmetic, and
|
|
14
|
+
conversion to native Python numeric types.
|
|
15
|
+
|
|
16
|
+
## Components
|
|
17
|
+
|
|
18
|
+
| Component | Type | Description |
|
|
19
|
+
| :----------------- | :---- | :------------------------------------------------------------------------ |
|
|
20
|
+
| `Arithmetic` | Mixin | `+ - * / // % **` and reflected forms, returns new instances. |
|
|
21
|
+
| `Unary` | Mixin | `-x`, `+x`, `abs(x)`, returns new instances. |
|
|
22
|
+
| `Bitwise` | Mixin | `& \\| ^ << >> ~` for integral atoms only. |
|
|
23
|
+
| `Inplace` | Mixin | `+= -= *= /= //= %= **=`, mutates in place, `_mutable_only`. |
|
|
24
|
+
| `Conversion` | Mixin | `int()`, `float()`, `complex()`, `round()`, `__index__`, floor/ceil/trunc.|
|
|
25
|
+
|
|
26
|
+
## Notes
|
|
27
|
+
- `Arithmetic`, `Unary`, `Conversion` restrict to `_only_types = Number`.
|
|
28
|
+
- `Bitwise` further restricts to `_constant_only` + `_only_types = Integral`.
|
|
29
|
+
- `Inplace` is `_mutable_only`; every other mixin here returns a new
|
|
30
|
+
instance rather than mutating `self`.
|
|
31
|
+
"""
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
from .execute_arithmetic_op import execute_arithmetic_op
|
|
2
|
+
from .execute_bitwise_op import execute_bitwise_op
|
|
3
|
+
from .execute_conversion import execute_conversion
|
|
4
|
+
from .execute_inplace_op import execute_inplace_op
|
|
5
|
+
from .execute_unary_op import execute_unary_op
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
_DESIGN_NOTES = """
|
|
9
|
+
# Numeric Dunder Utilities
|
|
10
|
+
|
|
11
|
+
## Purpose
|
|
12
|
+
Provides the internal helper functions used by all numeric dunder mixins.
|
|
13
|
+
These utilities implement the core mechanics of:
|
|
14
|
+
|
|
15
|
+
- safe operand type alignment,
|
|
16
|
+
- arithmetic operations (standard & reversed),
|
|
17
|
+
- bitwise operations,
|
|
18
|
+
- unary operations,
|
|
19
|
+
- in-place arithmetic operations,
|
|
20
|
+
- native numeric conversions.
|
|
21
|
+
|
|
22
|
+
They form the computational backbone of the numeric subsystem and ensure
|
|
23
|
+
consistent behavior across Arithmetic, Bitwise, Conversion, Inplace, and Unary
|
|
24
|
+
mixins.
|
|
25
|
+
|
|
26
|
+
## Components
|
|
27
|
+
|
|
28
|
+
| Component | Type | Description |
|
|
29
|
+
| :------------------------ | :--------| :----------------------------------------------------------------- |
|
|
30
|
+
| `execute_arithmetic_op` | Function | Executes arithmetic operations with fallback type alignment. |
|
|
31
|
+
| `execute_bitwise_op` | Function | Executes bitwise operations with strict operand handling. |
|
|
32
|
+
| `execute_conversion` | Function | Executes native numeric conversions with unified error formatting. |
|
|
33
|
+
| `execute_inplace_op` | Function | Executes in-place arithmetic operations with safe mutation. |
|
|
34
|
+
| `execute_unary_op` | Function | Executes unary operations with fallback type alignment. |
|
|
35
|
+
|
|
36
|
+
## Notes
|
|
37
|
+
- These utilities are internal and not part of the public API.
|
|
38
|
+
- They are used exclusively by numeric dunder mixins.
|
|
39
|
+
- All structural logic is delegated to the mixins; utilities remain minimal.
|
|
40
|
+
- Errors follow unified diagnostic formatting for consistent developer experience.
|
|
41
|
+
"""
|