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,47 @@
|
|
|
1
|
+
# Inners
|
|
2
|
+
from ..Iterable import Iterable
|
|
3
|
+
from ..Mapping import Mapping
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
class Collection(Iterable, Mapping):
|
|
7
|
+
"""
|
|
8
|
+
Complete collection behavior for composite instances.
|
|
9
|
+
Combines both iteration and dict-like API.
|
|
10
|
+
"""
|
|
11
|
+
|
|
12
|
+
# ----------------------------------------
|
|
13
|
+
# Basic interface
|
|
14
|
+
# ----------------------------------------
|
|
15
|
+
|
|
16
|
+
# Compatibility declaration
|
|
17
|
+
_composite_only = True
|
|
18
|
+
|
|
19
|
+
# Slot definition
|
|
20
|
+
__slots__ = ()
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
_DESIGN_NOTES = """
|
|
24
|
+
# Collection
|
|
25
|
+
|
|
26
|
+
## Purpose
|
|
27
|
+
Convenience "bundle" mixin — combines `Iterable` and `Mapping` into a
|
|
28
|
+
single mixin so a composite instance can behave like a full read-mostly
|
|
29
|
+
mapping (iteration, `len()`, `in`, `obj[key]`, `keys()`/`values()`/
|
|
30
|
+
`items()`) without listing both mixins separately every time.
|
|
31
|
+
|
|
32
|
+
## Compatibility
|
|
33
|
+
- `_composite_only = True` — inherited requirement from both parents;
|
|
34
|
+
restated here for visibility.
|
|
35
|
+
|
|
36
|
+
## Composition
|
|
37
|
+
Adds no logic of its own. Its only job is the MRO: `Iterable` and
|
|
38
|
+
`Mapping` both build on `CollectionBase`, so combining them here gives one
|
|
39
|
+
shared `_inners_name_tuple` / `_inners_name_set` pair instead of two.
|
|
40
|
+
|
|
41
|
+
## Notes
|
|
42
|
+
- Use this instead of `Iterable` + `Mapping` whenever a composite needs
|
|
43
|
+
the full dict-like surface; use the individual mixins when only part of
|
|
44
|
+
that surface makes sense (e.g. iteration without item assignment).
|
|
45
|
+
- Mirrors the `Lifecycle` mixin's "main/" composition pattern used
|
|
46
|
+
elsewhere in `dunders/`.
|
|
47
|
+
"""
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
from .Collection import Collection
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Collection Main
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Bundles the individual collection-related dunder mixins into one
|
|
9
|
+
ready-to-use combined mixin.
|
|
10
|
+
|
|
11
|
+
## Components
|
|
12
|
+
|
|
13
|
+
| Component | Type | Description |
|
|
14
|
+
| :------------ | :---- | :------------------------------------------------------- |
|
|
15
|
+
| `Collection` | Mixin | Combines `Iterable` + `Mapping` into full dict-like API. |
|
|
16
|
+
|
|
17
|
+
## Notes
|
|
18
|
+
- Use `Collection` when a composite needs the complete iteration + item
|
|
19
|
+
access surface; use `Iterable` or `Mapping` alone for a partial subset.
|
|
20
|
+
"""
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ...base_class import SimpleMixin
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ...._core.protocols.mixins.dunders.comparison import EqualityProtocol
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
class Equality(SimpleMixin):
|
|
10
|
+
"""
|
|
11
|
+
Equality and hashing for Simple instances.
|
|
12
|
+
|
|
13
|
+
Equality (__eq__) is value-based:
|
|
14
|
+
- If the other operand is a Simple instance of the same blueprint,
|
|
15
|
+
their values are compared.
|
|
16
|
+
- If the other operand is a raw value, it is compared directly.
|
|
17
|
+
|
|
18
|
+
Hashing (__hash__) is driven by instance mutability:
|
|
19
|
+
- For mutable instances (__is_mutable__ = True), identity-based hash
|
|
20
|
+
(id(self)) is used, to guarantee stability even when the value
|
|
21
|
+
changes.
|
|
22
|
+
- For immutable instances (__is_mutable__ = False), value-based hash
|
|
23
|
+
(hash(self.value)) is used, because the value is guaranteed to be
|
|
24
|
+
immutable and hashable.
|
|
25
|
+
|
|
26
|
+
This mixin is universal — it can be used for both mutable and
|
|
27
|
+
immutable instances, since the hashing strategy is chosen dynamically
|
|
28
|
+
based on the __is_mutable__ flag.
|
|
29
|
+
"""
|
|
30
|
+
|
|
31
|
+
# ----------------------------------------
|
|
32
|
+
# Basic interface
|
|
33
|
+
# ----------------------------------------
|
|
34
|
+
|
|
35
|
+
# Slot definition
|
|
36
|
+
__slots__ = ()
|
|
37
|
+
|
|
38
|
+
# ----------------------------------------
|
|
39
|
+
# Methods - EQ / HASH
|
|
40
|
+
# ----------------------------------------
|
|
41
|
+
|
|
42
|
+
def __eq__(
|
|
43
|
+
self: "EqualityProtocol",
|
|
44
|
+
other: Any
|
|
45
|
+
) -> bool:
|
|
46
|
+
"""
|
|
47
|
+
Value-based equality.
|
|
48
|
+
- If the other operand is a Simple instance of the same
|
|
49
|
+
blueprint, their values are compared.
|
|
50
|
+
- If the other operand is a raw value, it is compared directly.
|
|
51
|
+
"""
|
|
52
|
+
# 1. Comparing two Simple instances
|
|
53
|
+
if hasattr(other, "meta") and hasattr(other, "value"):
|
|
54
|
+
if self.meta.blueprint_path == other.meta.blueprint_path:
|
|
55
|
+
return self.value == other.value
|
|
56
|
+
return False
|
|
57
|
+
|
|
58
|
+
# 2. Comparing against a raw value
|
|
59
|
+
return self.value == other
|
|
60
|
+
|
|
61
|
+
def __hash__(
|
|
62
|
+
self: "EqualityProtocol"
|
|
63
|
+
) -> int:
|
|
64
|
+
"""
|
|
65
|
+
Returns a hash based on the instance's mutability.
|
|
66
|
+
|
|
67
|
+
- For mutable instances (__is_mutable__ = True), returns a hash
|
|
68
|
+
based on object identity (id(self)), to guarantee stability even
|
|
69
|
+
when the value changes.
|
|
70
|
+
|
|
71
|
+
- For immutable instances (__is_mutable__ = False), returns a
|
|
72
|
+
value-based hash (hash(self.value)), because the value is
|
|
73
|
+
guaranteed to be immutable and hashable.
|
|
74
|
+
|
|
75
|
+
This method thus unifies hashing for both mutable and immutable
|
|
76
|
+
mode within a single mixin.
|
|
77
|
+
"""
|
|
78
|
+
return (
|
|
79
|
+
id(self)
|
|
80
|
+
if self.__is_mutable__ else
|
|
81
|
+
hash(self.value)
|
|
82
|
+
)
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
_DESIGN_NOTES = """
|
|
86
|
+
# Equality
|
|
87
|
+
|
|
88
|
+
## Purpose
|
|
89
|
+
Gives a Simple instance sensible `==` and `hash()` behavior, so instances
|
|
90
|
+
can be compared to each other, compared to raw values, and used as dict
|
|
91
|
+
keys or set members.
|
|
92
|
+
|
|
93
|
+
> For newcomers: Python requires that if two objects compare equal, their
|
|
94
|
+
> hashes must also match (otherwise `dict`/`set` break). This mixin's job
|
|
95
|
+
> is to keep that contract true for both mutable and immutable instances,
|
|
96
|
+
> which need very different hashing strategies.
|
|
97
|
+
|
|
98
|
+
## Compatibility
|
|
99
|
+
- No compatibility flags — works for atoms and composites, mutable and
|
|
100
|
+
immutable alike. The logic branches internally on `__is_mutable__`
|
|
101
|
+
instead of being restricted to one variant.
|
|
102
|
+
|
|
103
|
+
## Logic
|
|
104
|
+
`__eq__`:
|
|
105
|
+
- Comparing two Simple instances checks they share the same
|
|
106
|
+
`meta.blueprint_path` (same definition) before comparing `.value` —
|
|
107
|
+
two unrelated classes with an equal value are *not* equal.
|
|
108
|
+
- Comparing against a raw value compares `.value` directly, so
|
|
109
|
+
`age == 20` works without unwrapping.
|
|
110
|
+
|
|
111
|
+
`__hash__` branches on `__is_mutable__`:
|
|
112
|
+
- **Mutable** → `id(self)` (identity hash). A mutable instance's value can
|
|
113
|
+
change after being hashed; if the hash also changed, it would silently
|
|
114
|
+
break in `dict`/`set`. Identity hash sidesteps that at the cost of
|
|
115
|
+
`obj == obj_with_same_value` not implying `hash()` equality for two
|
|
116
|
+
*different* mutable instances — which is expected, standard Python
|
|
117
|
+
behavior for mutable objects.
|
|
118
|
+
- **Immutable** → `hash(self.value)`. The value can never change again,
|
|
119
|
+
so it's safe and gives the intuitive result: two immutable instances
|
|
120
|
+
with equal values hash equally too.
|
|
121
|
+
|
|
122
|
+
## Notes
|
|
123
|
+
- Defining `__eq__` without `__hash__` would make instances unhashable by
|
|
124
|
+
default in Python — this mixin deliberately pairs both together.
|
|
125
|
+
- `blueprint_path` equality (not just type equality) means two instances
|
|
126
|
+
built from structurally identical but differently-named blueprints are
|
|
127
|
+
still treated as unequal.
|
|
128
|
+
"""
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ...base_class import SimpleMixin
|
|
4
|
+
# Annotations
|
|
5
|
+
if TYPE_CHECKING:
|
|
6
|
+
from ...._core.protocols.mixins.dunders.comparison import OrderingProtocol
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
# noinspection PyUnresolvedReferences
|
|
10
|
+
class Ordering(SimpleMixin):
|
|
11
|
+
"""
|
|
12
|
+
Magnitude comparison for Simple instances.
|
|
13
|
+
Compares by value (self.value).
|
|
14
|
+
Works for comparing an instance against another instance or against
|
|
15
|
+
a raw value.
|
|
16
|
+
"""
|
|
17
|
+
|
|
18
|
+
# ----------------------------------------
|
|
19
|
+
# Basic interface
|
|
20
|
+
# ----------------------------------------
|
|
21
|
+
|
|
22
|
+
# Slot definition
|
|
23
|
+
__slots__ = ()
|
|
24
|
+
|
|
25
|
+
# ----------------------------------------
|
|
26
|
+
# Methods - LT / LE / GT / GE
|
|
27
|
+
# ----------------------------------------
|
|
28
|
+
|
|
29
|
+
def __lt__(
|
|
30
|
+
self: "OrderingProtocol",
|
|
31
|
+
other: Any
|
|
32
|
+
) -> bool:
|
|
33
|
+
"""
|
|
34
|
+
Returns True if this instance's value is less than the other
|
|
35
|
+
operand's value. If the operand is a Simple instance, its .value
|
|
36
|
+
is used; otherwise it is compared directly against the operand's
|
|
37
|
+
value. Returns NotImplemented for incompatible types.
|
|
38
|
+
"""
|
|
39
|
+
other_value = getattr(other, "value", other)
|
|
40
|
+
try:
|
|
41
|
+
return self.value < other_value
|
|
42
|
+
except TypeError:
|
|
43
|
+
return NotImplemented
|
|
44
|
+
|
|
45
|
+
def __le__(
|
|
46
|
+
self: "OrderingProtocol",
|
|
47
|
+
other: Any
|
|
48
|
+
) -> bool:
|
|
49
|
+
"""
|
|
50
|
+
Returns True if this instance's value is less than or equal to
|
|
51
|
+
the other operand's value. If the operand is a Simple instance,
|
|
52
|
+
its .value is used; otherwise it is compared directly against the
|
|
53
|
+
operand's value. Returns NotImplemented for incompatible types.
|
|
54
|
+
"""
|
|
55
|
+
other_value = getattr(other, "value", other)
|
|
56
|
+
try:
|
|
57
|
+
return self.value <= other_value
|
|
58
|
+
except TypeError:
|
|
59
|
+
return NotImplemented
|
|
60
|
+
|
|
61
|
+
def __gt__(
|
|
62
|
+
self: "OrderingProtocol",
|
|
63
|
+
other: Any
|
|
64
|
+
) -> bool:
|
|
65
|
+
"""
|
|
66
|
+
Returns True if this instance's value is greater than the other
|
|
67
|
+
operand's value. If the operand is a Simple instance, its .value
|
|
68
|
+
is used; otherwise it is compared directly against the operand's
|
|
69
|
+
value. Returns NotImplemented for incompatible types.
|
|
70
|
+
"""
|
|
71
|
+
other_value = getattr(other, "value", other)
|
|
72
|
+
try:
|
|
73
|
+
return self.value > other_value
|
|
74
|
+
except TypeError:
|
|
75
|
+
return NotImplemented
|
|
76
|
+
|
|
77
|
+
def __ge__(
|
|
78
|
+
self: "OrderingProtocol",
|
|
79
|
+
other: Any
|
|
80
|
+
) -> bool:
|
|
81
|
+
"""
|
|
82
|
+
Returns True if this instance's value is greater than or equal to
|
|
83
|
+
the other operand's value. If the operand is a Simple instance,
|
|
84
|
+
its .value is used; otherwise it is compared directly against the
|
|
85
|
+
operand's value. Returns NotImplemented for incompatible types.
|
|
86
|
+
"""
|
|
87
|
+
other_value = getattr(other, "value", other)
|
|
88
|
+
try:
|
|
89
|
+
return self.value >= other_value
|
|
90
|
+
except TypeError:
|
|
91
|
+
return NotImplemented
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
_DESIGN_NOTES = """
|
|
95
|
+
# Ordering
|
|
96
|
+
|
|
97
|
+
## Purpose
|
|
98
|
+
Adds `<`, `<=`, `>`, `>=` to a Simple instance, so instances can be
|
|
99
|
+
sorted, compared, and used with `min()`/`max()` the same way as the raw
|
|
100
|
+
values they wrap.
|
|
101
|
+
|
|
102
|
+
> Note this is a separate mixin from `Equality` — Python treats ordering
|
|
103
|
+
> and equality as independent concerns (a class can be equality-only, or
|
|
104
|
+
> support both). Splitting them lets a mixin combo opt into ordering only
|
|
105
|
+
> where it actually makes sense (e.g. numbers, dates) without forcing it
|
|
106
|
+
> onto every type (e.g. it rarely makes sense to order arbitrary
|
|
107
|
+
> composites).
|
|
108
|
+
|
|
109
|
+
## Compatibility
|
|
110
|
+
- No compatibility flags — the mixin itself doesn't restrict which
|
|
111
|
+
instances can use it. Suitability instead depends on whether
|
|
112
|
+
`self.value` supports ordering at runtime (comparing two incompatible
|
|
113
|
+
types simply falls through to `NotImplemented`).
|
|
114
|
+
|
|
115
|
+
## Logic
|
|
116
|
+
All four operators share the same shape:
|
|
117
|
+
1. Unwrap the other operand's `.value` if it's a Simple instance,
|
|
118
|
+
otherwise use it as-is.
|
|
119
|
+
2. Compare `self.value` against that.
|
|
120
|
+
3. On `TypeError` (values that can't be ordered against each other),
|
|
121
|
+
return `NotImplemented` rather than raising — this lets Python fall
|
|
122
|
+
back to the other operand's comparison method, or raise its own
|
|
123
|
+
standard `TypeError` if neither side can handle it.
|
|
124
|
+
|
|
125
|
+
## Notes
|
|
126
|
+
- `__eq__` is intentionally not defined here — see `Equality` for that;
|
|
127
|
+
combine both when full comparison support is needed.
|
|
128
|
+
- Comparing against a raw value doesn't require it to also be a Simple
|
|
129
|
+
instance — `age < 30` works directly.
|
|
130
|
+
"""
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
from .Equality import Equality
|
|
2
|
+
from .Ordering import Ordering
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
_DESIGN_NOTES = """
|
|
6
|
+
# Comparison Dunders
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Gives Simple instances value-based equality, hashing, and magnitude
|
|
10
|
+
ordering — the two independent comparison protocols Python distinguishes
|
|
11
|
+
between.
|
|
12
|
+
|
|
13
|
+
## Components
|
|
14
|
+
|
|
15
|
+
| Component | Type | Description |
|
|
16
|
+
| :---------- | :---- | :----------------------------------------------------------- |
|
|
17
|
+
| `Equality` | Mixin | `__eq__` and `__hash__`, mutability-aware hashing strategy. |
|
|
18
|
+
| `Ordering` | Mixin | `__lt__`, `__le__`, `__gt__`, `__ge__` via `self.value`. |
|
|
19
|
+
|
|
20
|
+
## Notes
|
|
21
|
+
- The two mixins are independent — a class may combine both, or use only
|
|
22
|
+
one, depending on whether ordering makes sense for its value type.
|
|
23
|
+
- `Equality`'s hashing strategy branches on `__is_mutable__`: identity
|
|
24
|
+
hash for mutable instances, value hash for immutable ones.
|
|
25
|
+
"""
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
from typing import Any, Self
|
|
2
|
+
# Outers
|
|
3
|
+
from ...base_class import SimpleMixin
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
class ClassGetItem(SimpleMixin):
|
|
7
|
+
"""
|
|
8
|
+
Mixin providing support for generic-style subscript syntax:
|
|
9
|
+
|
|
10
|
+
MyClass[int]
|
|
11
|
+
MyClass[str]
|
|
12
|
+
MyClass[tuple[int, str]]
|
|
13
|
+
|
|
14
|
+
This method is purely a syntactic aid for type hints, IDEs, and
|
|
15
|
+
static analysis. It has no effect on the instance's runtime behavior
|
|
16
|
+
or on the construction of the instance class.
|
|
17
|
+
|
|
18
|
+
Logic:
|
|
19
|
+
- If a parent class already implements __class_getitem__, that
|
|
20
|
+
implementation is used.
|
|
21
|
+
- If it doesn't exist (the common case for plain classes), or if
|
|
22
|
+
the MRO traversal raises TypeError on dynamically generated classes,
|
|
23
|
+
the class itself is returned.
|
|
24
|
+
"""
|
|
25
|
+
|
|
26
|
+
# ----------------------------------------
|
|
27
|
+
# Basic interface
|
|
28
|
+
# ----------------------------------------
|
|
29
|
+
|
|
30
|
+
# Slot definition
|
|
31
|
+
__slots__ = ()
|
|
32
|
+
|
|
33
|
+
# ----------------------------------------
|
|
34
|
+
# Classmethods - CLASS GETITEM
|
|
35
|
+
# ----------------------------------------
|
|
36
|
+
|
|
37
|
+
@classmethod
|
|
38
|
+
def __class_getitem__(
|
|
39
|
+
cls: type[Self],
|
|
40
|
+
item: Any
|
|
41
|
+
) -> type[Self] | Any:
|
|
42
|
+
"""
|
|
43
|
+
Enables the MyClass[T] syntax without having to inherit from
|
|
44
|
+
typing.Generic.
|
|
45
|
+
|
|
46
|
+
If the parent class implements __class_getitem__, its
|
|
47
|
+
implementation is used. Otherwise the class itself is returned,
|
|
48
|
+
which is the standard fallback Python uses for simple generic
|
|
49
|
+
subscript syntax.
|
|
50
|
+
"""
|
|
51
|
+
try:
|
|
52
|
+
# Look up method on the parent via standard super() inside classmethod
|
|
53
|
+
super_method = getattr(super(), "__class_getitem__", None)
|
|
54
|
+
if super_method is not None:
|
|
55
|
+
return super_method(item)
|
|
56
|
+
except (TypeError, AttributeError):
|
|
57
|
+
# Fallback for dynamic class hierarchies or missing parent implementations
|
|
58
|
+
pass
|
|
59
|
+
|
|
60
|
+
return cls
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
_DESIGN_NOTES = """
|
|
64
|
+
# ClassGetItem
|
|
65
|
+
|
|
66
|
+
## Purpose
|
|
67
|
+
Lets a Simple class be subscripted like `MyClass[int]` without having to
|
|
68
|
+
inherit from `typing.Generic`. Purely cosmetic/typing sugar — it doesn't
|
|
69
|
+
change what the class does at runtime.
|
|
70
|
+
|
|
71
|
+
> For newcomers: `__class_getitem__` is what makes `list[int]` or
|
|
72
|
+
> `dict[str, int]` work in modern Python type hints. Adding it here means
|
|
73
|
+
> a Simple blueprint can be written or annotated the same familiar way,
|
|
74
|
+
> even though it isn't a generic class in the `typing.Generic` sense.
|
|
75
|
+
|
|
76
|
+
## Compatibility
|
|
77
|
+
- No compatibility flags — purely additive, has no interaction with
|
|
78
|
+
value, mutability, or composite/atom distinctions.
|
|
79
|
+
|
|
80
|
+
## Architecture & Logic
|
|
81
|
+
- **`super()` resolution in `@classmethod`:**
|
|
82
|
+
The implementation relies on zero-argument `super().__class_getitem__` inside
|
|
83
|
+
a defensive `try...except (TypeError, AttributeError)` block.
|
|
84
|
+
- **Why avoid explicit `super(ClassGetItem, cls)`:**
|
|
85
|
+
In dynamic metaclass architectures, `cls` is an instance class created
|
|
86
|
+
at runtime whose Method Resolution Order (MRO) may not explicitly expose
|
|
87
|
+
`ClassGetItem` as a direct parent or subtype in the exact manner CPython's
|
|
88
|
+
type checker expects at runtime. Explicit 2-argument `super(Type, obj)` enforces
|
|
89
|
+
`isinstance(obj, Type)` or `issubclass(obj, Type)`, which raises
|
|
90
|
+
`TypeError: super(type, obj): obj must be an instance or subtype of type`
|
|
91
|
+
when called on dynamically synthesized leaf classes.
|
|
92
|
+
- **Fallback Mechanism:**
|
|
93
|
+
If a parent class defines `__class_getitem__` (e.g., inheriting from `Generic`
|
|
94
|
+
or another specialized container), that parent method takes precedence. If no
|
|
95
|
+
parent defines it, or if dynamic MRO introspection raises a `TypeError`,
|
|
96
|
+
the mixin safely catches the exception and falls back to returning `cls` unchanged.
|
|
97
|
+
|
|
98
|
+
## Notes
|
|
99
|
+
- No `TYPE_CHECKING` import block, unlike most other mixins in this
|
|
100
|
+
package — the method takes no protocol-typed `self` parameter since
|
|
101
|
+
it's a `classmethod` operating on `cls`, not on an instance.
|
|
102
|
+
- Has zero effect on instance creation, validation, or the
|
|
103
|
+
`create_instance` pipeline — it only affects what `MyClass[...]`
|
|
104
|
+
returns when read by a type checker or at import time.
|
|
105
|
+
"""
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
from .ClassGetItem import ClassGetItem
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
_DESIGN_NOTES = """
|
|
5
|
+
# Generics Dunders
|
|
6
|
+
|
|
7
|
+
## Purpose
|
|
8
|
+
Gives Simple classes generic-style subscript syntax (`MyClass[int]`) for
|
|
9
|
+
typing/IDE purposes, without requiring inheritance from `typing.Generic`.
|
|
10
|
+
|
|
11
|
+
## Components
|
|
12
|
+
|
|
13
|
+
| Component | Type | Description |
|
|
14
|
+
| :----------------- | :---- | :------------------------------------------------------ |
|
|
15
|
+
| `ClassGetItem` | Mixin | `__class_getitem__` fallback for subscriptable classes. |
|
|
16
|
+
|
|
17
|
+
## Notes
|
|
18
|
+
- Purely syntactic — has no effect on instance construction or runtime
|
|
19
|
+
behavior.
|
|
20
|
+
"""
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
from typing import TYPE_CHECKING, Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ..._common_logic.immutability import with_any
|
|
4
|
+
from ...core_mixins import Infrastructure
|
|
5
|
+
# Annotations
|
|
6
|
+
if TYPE_CHECKING:
|
|
7
|
+
from ...._core.protocols.mixins.dunders.interfaces import CallProtocol
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
class Call(Infrastructure):
|
|
11
|
+
"""
|
|
12
|
+
Mixin providing support for calling an instance like a function
|
|
13
|
+
(`obj(...)`).
|
|
14
|
+
|
|
15
|
+
This mixin acts as syntactic sugar over the immutable API. It allows
|
|
16
|
+
changes to be expressed using tuple notation:
|
|
17
|
+
|
|
18
|
+
obj("a", 10)
|
|
19
|
+
obj(("a", 10), ("b", 20))
|
|
20
|
+
obj((("a", 10), ("b", 20)))
|
|
21
|
+
|
|
22
|
+
Logic:
|
|
23
|
+
- All processing is delegated to the internal `with_any` engine.
|
|
24
|
+
- Adds no validation or logic of its own.
|
|
25
|
+
- Universal for both mutable and immutable objects.
|
|
26
|
+
"""
|
|
27
|
+
|
|
28
|
+
# ----------------------------------------
|
|
29
|
+
# Basic interface
|
|
30
|
+
# ----------------------------------------
|
|
31
|
+
|
|
32
|
+
# Slot definition
|
|
33
|
+
__slots__ = ()
|
|
34
|
+
|
|
35
|
+
# ----------------------------------------
|
|
36
|
+
# Methods - CALL
|
|
37
|
+
# ----------------------------------------
|
|
38
|
+
|
|
39
|
+
def __call__(
|
|
40
|
+
self: "CallProtocol",
|
|
41
|
+
*changes: Any,
|
|
42
|
+
**kwargs: Any
|
|
43
|
+
) -> "CallProtocol":
|
|
44
|
+
"""
|
|
45
|
+
Allows the instance to be called like a function.
|
|
46
|
+
|
|
47
|
+
Supported forms:
|
|
48
|
+
obj("a", 10)
|
|
49
|
+
obj(("a", 10))
|
|
50
|
+
obj(("a", 10), ("b", 20))
|
|
51
|
+
obj((("a", 10), ("b", 20)))
|
|
52
|
+
|
|
53
|
+
If keyword arguments are used, they are converted to tuple form.
|
|
54
|
+
"""
|
|
55
|
+
|
|
56
|
+
# 1. If keyword arguments are used → convert them to tuple form
|
|
57
|
+
if kwargs:
|
|
58
|
+
# kwargs always take the form of constants
|
|
59
|
+
changes = tuple(kwargs.items())
|
|
60
|
+
|
|
61
|
+
# 2. If a single tuple was passed → normalize the shape
|
|
62
|
+
elif len(changes) == 1 and isinstance(changes[0], tuple):
|
|
63
|
+
changes = changes[0]
|
|
64
|
+
|
|
65
|
+
# 3. Delegate to the engine
|
|
66
|
+
return with_any(self, changes)
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
_DESIGN_NOTES = """
|
|
70
|
+
# Call
|
|
71
|
+
|
|
72
|
+
## Purpose
|
|
73
|
+
Lets a Simple instance be called like a function — `obj("a", 10)` — as a
|
|
74
|
+
compact, expressive shortcut for producing a changed instance. Think of
|
|
75
|
+
it as a one-line alternative to writing out an explicit "with a=10" call.
|
|
76
|
+
|
|
77
|
+
> For newcomers: this is the classic Python "make objects callable"
|
|
78
|
+
> trick (`__call__`), the same mechanism functions and lambdas use under
|
|
79
|
+
> the hood. Here it's repurposed as sugar for expressing value changes.
|
|
80
|
+
|
|
81
|
+
## Compatibility
|
|
82
|
+
- No compatibility flags — works uniformly for mutable and immutable
|
|
83
|
+
instances, since it delegates entirely to `with_any`, which already
|
|
84
|
+
knows how to handle both.
|
|
85
|
+
|
|
86
|
+
## Logic
|
|
87
|
+
- No logic of its own beyond normalizing the call's argument shape:
|
|
88
|
+
keyword args become tuple pairs, a single passed-in tuple is unwrapped,
|
|
89
|
+
everything else is passed through as-is.
|
|
90
|
+
- All actual work — validation, applying changes, returning a new vs.
|
|
91
|
+
mutated instance — happens inside `with_any`. This mixin exists purely
|
|
92
|
+
to give that engine a friendlier call syntax.
|
|
93
|
+
|
|
94
|
+
## Notes
|
|
95
|
+
- Because this is "just" a syntactic front end, any change to
|
|
96
|
+
`with_any`'s underlying semantics (e.g. immutable-vs-mutable behavior)
|
|
97
|
+
is automatically reflected here without needing changes to this file.
|
|
98
|
+
- Inherits from `Infrastructure` rather than `SimpleMixin` directly,
|
|
99
|
+
since it needs the shared plumbing that mixin provides for
|
|
100
|
+
reading/applying changes.
|
|
101
|
+
"""
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
from typing import Literal, TYPE_CHECKING
|
|
2
|
+
from types import TracebackType
|
|
3
|
+
# Outers
|
|
4
|
+
from ...base_class import SimpleMixin
|
|
5
|
+
# Annotations
|
|
6
|
+
if TYPE_CHECKING:
|
|
7
|
+
from ...._core.protocols.mixins.dunders.interfaces import ContextProtocol
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
class ContextManager(SimpleMixin):
|
|
11
|
+
"""
|
|
12
|
+
Mixin providing basic support for the context manager protocol
|
|
13
|
+
(`with obj:`).
|
|
14
|
+
|
|
15
|
+
This mixin allows an instance to be used in a `with` construct
|
|
16
|
+
without performing any side effects. It is fully universal — it
|
|
17
|
+
works for mutable and immutable objects, atoms and composites alike,
|
|
18
|
+
since it never changes the instance's state.
|
|
19
|
+
|
|
20
|
+
Behavior:
|
|
21
|
+
- `__enter__` returns the instance itself.
|
|
22
|
+
- `__exit__` does not suppress exceptions (returns False), so any
|
|
23
|
+
errors propagate normally.
|
|
24
|
+
|
|
25
|
+
This mixin serves purely as a syntactic API extension and does not
|
|
26
|
+
interfere with value logic, snapshots, mutability, or immutable mode.
|
|
27
|
+
"""
|
|
28
|
+
|
|
29
|
+
# ----------------------------------------
|
|
30
|
+
# Basic interface
|
|
31
|
+
# ----------------------------------------
|
|
32
|
+
|
|
33
|
+
# Slot definition
|
|
34
|
+
__slots__ = ()
|
|
35
|
+
|
|
36
|
+
# ----------------------------------------
|
|
37
|
+
# Methods - ENTER / EXIT
|
|
38
|
+
# ----------------------------------------
|
|
39
|
+
|
|
40
|
+
def __enter__(
|
|
41
|
+
self: "ContextProtocol"
|
|
42
|
+
) -> "ContextProtocol":
|
|
43
|
+
"""
|
|
44
|
+
Returns the instance on entering the context.
|
|
45
|
+
|
|
46
|
+
Enables the construct:
|
|
47
|
+
with obj as x:
|
|
48
|
+
...
|
|
49
|
+
|
|
50
|
+
Without any change to the instance's state.
|
|
51
|
+
"""
|
|
52
|
+
return self
|
|
53
|
+
|
|
54
|
+
def __exit__(
|
|
55
|
+
self: "ContextProtocol",
|
|
56
|
+
exc_type: type[BaseException] | None,
|
|
57
|
+
exc_val: BaseException | None,
|
|
58
|
+
exc_tb: TracebackType | None
|
|
59
|
+
) -> Literal[False]:
|
|
60
|
+
"""
|
|
61
|
+
Ends the context block.
|
|
62
|
+
|
|
63
|
+
Returns False, meaning any exceptions are NOT suppressed and
|
|
64
|
+
propagate normally. The mixin performs no cleanup or state
|
|
65
|
+
change — it is purely syntactic.
|
|
66
|
+
"""
|
|
67
|
+
return False
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
_DESIGN_NOTES = """
|
|
71
|
+
# ContextManager
|
|
72
|
+
|
|
73
|
+
## Purpose
|
|
74
|
+
Lets a Simple instance be used in a `with obj:` block. On its own this
|
|
75
|
+
does nothing functional — no cleanup, no side effects — it exists so an
|
|
76
|
+
instance can participate in context-manager-based APIs or read naturally
|
|
77
|
+
in code that scopes a variable to a block.
|
|
78
|
+
|
|
79
|
+
> For newcomers: `__enter__`/`__exit__` are the two methods Python looks
|
|
80
|
+
> for when you write `with x:`. Here they're intentionally inert — this
|
|
81
|
+
> is a "no-op" context manager, not a resource-management one like a file
|
|
82
|
+
> handle.
|
|
83
|
+
|
|
84
|
+
## Compatibility
|
|
85
|
+
- No compatibility flags — safe for every instance kind, precisely
|
|
86
|
+
because it never touches state.
|
|
87
|
+
|
|
88
|
+
## Logic
|
|
89
|
+
- `__enter__` just returns `self`, enabling `with obj as x:` to bind `x`
|
|
90
|
+
to the same instance.
|
|
91
|
+
- `__exit__` always returns `False`, so any exception raised inside the
|
|
92
|
+
`with` block propagates as normal — this mixin never swallows errors.
|
|
93
|
+
|
|
94
|
+
## Notes
|
|
95
|
+
- Purely syntactic — does not create a snapshot, does not lock the
|
|
96
|
+
instance, does not interact with mutability at all.
|
|
97
|
+
- If a future use case needs an actual scoped effect (e.g. temporarily
|
|
98
|
+
freezing an instance), that belongs in a separate, more specific mixin
|
|
99
|
+
rather than being added here.
|
|
100
|
+
"""
|