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
|
+
from typing import Any, Callable
|
|
2
|
+
# Inners
|
|
3
|
+
from ._is_lambda import _is_lambda
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
def process_decompose(
|
|
7
|
+
decompose: Callable
|
|
8
|
+
) -> Callable:
|
|
9
|
+
"""Normalizes a decompose callable to ensure a unified (cls, value) signature.
|
|
10
|
+
|
|
11
|
+
If the provided ``decompose`` handler is an anonymous lambda, wraps it to accept
|
|
12
|
+
and ignore the class instance context (``cls``) argument automatically.
|
|
13
|
+
|
|
14
|
+
Args:
|
|
15
|
+
decompose: Raw decompose function or lambda handler.
|
|
16
|
+
|
|
17
|
+
Returns:
|
|
18
|
+
A normalized callable adhering to the standard (cls, value) method signature.
|
|
19
|
+
"""
|
|
20
|
+
|
|
21
|
+
# 1. Return regular functions directly
|
|
22
|
+
if not _is_lambda(decompose):
|
|
23
|
+
return decompose
|
|
24
|
+
|
|
25
|
+
# 2. Wrap anonymous lambda to accept (cls, value) signature
|
|
26
|
+
def _decompose(cls, value):
|
|
27
|
+
return decompose(value)
|
|
28
|
+
|
|
29
|
+
return _decompose
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
_DESIGN_NOTES = """
|
|
33
|
+
# process_decompose (Internal Helper Engine)
|
|
34
|
+
|
|
35
|
+
## Purpose
|
|
36
|
+
Normalizes user-supplied `decompose` callables for composite object blueprints. Anonymous lambda
|
|
37
|
+
functions typically accept only a single value argument `lambda val: ...`; this helper wraps them
|
|
38
|
+
so that the framework can invoke `_decompose(cls, value)` uniformly.
|
|
39
|
+
|
|
40
|
+
## Execution Workflow
|
|
41
|
+
1. Checks if `decompose` is an anonymous lambda using `_is_lambda`.
|
|
42
|
+
2. If it is a regular named function, returns it untouched.
|
|
43
|
+
3. If it is a lambda, wraps it into a closure `_decompose(cls, value)` that passes only `value` to the lambda.
|
|
44
|
+
|
|
45
|
+
## Framework Usage
|
|
46
|
+
- Internal helper invoked exclusively within `create_object_class`.
|
|
47
|
+
"""
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
from typing import Any, Callable, Iterable
|
|
2
|
+
# Inners
|
|
3
|
+
from ._is_lambda import _is_lambda
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
def process_logic(
|
|
7
|
+
logic: Callable,
|
|
8
|
+
params_name: Iterable[str]
|
|
9
|
+
) -> Callable:
|
|
10
|
+
"""Normalizes a logic calculation callable to ensure a unified (cls, *args) signature.
|
|
11
|
+
|
|
12
|
+
If the provided ``logic`` callable is an anonymous lambda, dynamically compiles
|
|
13
|
+
a wrapper function via ``exec`` that accepts the class context (``cls``) alongside
|
|
14
|
+
all named child inner parameters.
|
|
15
|
+
|
|
16
|
+
Args:
|
|
17
|
+
logic: Raw logic function or lambda calculation rule.
|
|
18
|
+
params_name: Iterable of parameter snake_case names derived from inner components.
|
|
19
|
+
|
|
20
|
+
Returns:
|
|
21
|
+
A normalized callable adhering to the standard (cls, *params) method signature.
|
|
22
|
+
"""
|
|
23
|
+
|
|
24
|
+
# 1. Return regular named functions directly
|
|
25
|
+
if not _is_lambda(logic):
|
|
26
|
+
return logic
|
|
27
|
+
|
|
28
|
+
# 2. Build parameter signature string from inner names
|
|
29
|
+
params = ", ".join(params_name)
|
|
30
|
+
src = f"def _logic(cls, {params}): return logic({params})"
|
|
31
|
+
|
|
32
|
+
# 3. Dynamically compile wrapper function
|
|
33
|
+
namespace: dict[str, Any] = {"logic": logic}
|
|
34
|
+
exec(src, namespace)
|
|
35
|
+
|
|
36
|
+
# 4. Return compiled logic wrapper
|
|
37
|
+
return namespace["_logic"]
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
_DESIGN_NOTES = """
|
|
41
|
+
# process_logic (Internal Helper Engine)
|
|
42
|
+
|
|
43
|
+
## Purpose
|
|
44
|
+
Normalizes user-supplied calculation logic for composite object blueprints. Lambda functions
|
|
45
|
+
typically omit the implicit `cls` context argument (e.g. `lambda a, b: a + b`); this helper
|
|
46
|
+
dynamically wraps the lambda using `exec` to create a standard `_logic(cls, a, b)` signature.
|
|
47
|
+
|
|
48
|
+
## Execution Workflow
|
|
49
|
+
1. Checks if `logic` is an anonymous lambda using `_is_lambda`.
|
|
50
|
+
2. If it is a regular function, returns it untouched.
|
|
51
|
+
3. Joins `params_name` into a comma-separated parameter string.
|
|
52
|
+
4. Dynamically compiles a signature-correct wrapper via `exec` in a local namespace.
|
|
53
|
+
5. Extracts and returns the compiled `_logic` function.
|
|
54
|
+
|
|
55
|
+
## Framework Usage
|
|
56
|
+
- Internal helper invoked exclusively within `create_object_class`.
|
|
57
|
+
"""
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
from typing import Any, Callable
|
|
2
|
+
# Inners
|
|
3
|
+
from ._is_lambda import _is_lambda
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
def process_validate(
|
|
7
|
+
validate: Callable
|
|
8
|
+
) -> Callable:
|
|
9
|
+
"""Normalizes a validation callable to ensure a unified (cls, value, *, return_bool) signature.
|
|
10
|
+
|
|
11
|
+
If the provided ``validate`` handler is an anonymous lambda, wraps it into a classmethod-compatible
|
|
12
|
+
closure that accepts the class context (``cls``) and optional keyword arguments while executing
|
|
13
|
+
the single-argument lambda.
|
|
14
|
+
|
|
15
|
+
Args:
|
|
16
|
+
validate: Raw validation function or lambda callable.
|
|
17
|
+
|
|
18
|
+
Returns:
|
|
19
|
+
A normalized callable adhering to the standard (cls, value, *, return_bool=False) signature.
|
|
20
|
+
"""
|
|
21
|
+
|
|
22
|
+
# 1. Return regular named functions directly
|
|
23
|
+
if not _is_lambda(validate):
|
|
24
|
+
return validate
|
|
25
|
+
|
|
26
|
+
# 2. Wrap anonymous lambda to accept (cls, value, *, return_bool=False) signature
|
|
27
|
+
def _validate(cls: Any, value: Any, *, return_bool: bool = False):
|
|
28
|
+
return validate(value)
|
|
29
|
+
|
|
30
|
+
return _validate
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
_DESIGN_NOTES = """
|
|
34
|
+
# process_validate (Internal Helper Engine)
|
|
35
|
+
|
|
36
|
+
## Purpose
|
|
37
|
+
Normalizes user-supplied validation rules for both `SimpleConstant` and `SimpleObject` blueprints.
|
|
38
|
+
Anonymous lambdas typically accept only a single value argument (e.g. `lambda val: val > 0`);
|
|
39
|
+
this helper wraps them so they can be mounted as `classmethod` handlers accepting `(cls, value, *, return_bool=False)`.
|
|
40
|
+
|
|
41
|
+
## Execution Workflow
|
|
42
|
+
1. Checks if `validate` is an anonymous lambda using `_is_lambda`.
|
|
43
|
+
2. If it is a regular named function, returns it untouched.
|
|
44
|
+
3. If it is a lambda, returns a closure `_validate(cls, value, *, return_bool=False)` that forwards `value` to the lambda.
|
|
45
|
+
|
|
46
|
+
## Framework Usage
|
|
47
|
+
- Internal helper invoked exclusively within `create_constant_class` and `create_object_class`.
|
|
48
|
+
"""
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
from .validate_composite_has_logic import validate_composite_has_logic
|
|
2
|
+
from .validate_composite_has_not_default import validate_composite_has_not_default
|
|
3
|
+
from .validate_constant_has_default import validate_constant_has_default
|
|
4
|
+
from .validate_constant_has_not_decompose import validate_constant_has_not_decompose
|
|
5
|
+
from .validate_constant_has_not_logic import validate_constant_has_not_logic
|
|
6
|
+
from .validate_class_name_is_str import validate_class_name_is_str
|
|
7
|
+
from .validate_composite_has_inners import validate_composite_has_inners
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
# Outers
|
|
3
|
+
from ....exceptions import SimpleDefinitionError
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
def validate_class_name_is_str(class_name: Any) -> None | NoReturn:
|
|
7
|
+
"""Validates that class_name is a non-empty string."""
|
|
8
|
+
|
|
9
|
+
if isinstance(class_name, str) and class_name.strip():
|
|
10
|
+
return
|
|
11
|
+
|
|
12
|
+
raise SimpleDefinitionError(
|
|
13
|
+
error_name="INVALID CLASS NAME ERROR",
|
|
14
|
+
label="class_name_is_not_str",
|
|
15
|
+
expected="A non-empty string for class name definition",
|
|
16
|
+
value=type(class_name).__name__,
|
|
17
|
+
problem=f"Provided class name must be a non-empty string. Received type '{type(class_name).__name__}'.",
|
|
18
|
+
context="Attempted to dynamically generate a class blueprint, but 'class_name' validation failed.",
|
|
19
|
+
how_to_fix=(
|
|
20
|
+
"Pass a valid string for 'class_name', e.g. class_name='MyCustomConstant'.",
|
|
21
|
+
"Ensure class_name is not empty or whitespace-only.",
|
|
22
|
+
),
|
|
23
|
+
exception=TypeError,
|
|
24
|
+
)
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
_DESIGN_NOTES = """
|
|
28
|
+
# validate_class_name_is_str
|
|
29
|
+
|
|
30
|
+
## Purpose
|
|
31
|
+
Guarantees that the target name for dynamically generated classes is a valid non-empty string.
|
|
32
|
+
|
|
33
|
+
## Behavior
|
|
34
|
+
1. Checks if `class_name` is an instance of `str` and contains non-whitespace characters.
|
|
35
|
+
2. Raises `SimpleDefinitionError` wrapping `TypeError` if invalid.
|
|
36
|
+
"""
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ....exceptions import SimpleRuntimeError
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def validate_composite_has_inners(class_name: str, inners: Any) -> None | NoReturn:
|
|
8
|
+
"""Validates that a composite object class definition provides a valid tuple of inner components."""
|
|
9
|
+
|
|
10
|
+
if inners in (UNSET, None):
|
|
11
|
+
raise SimpleRuntimeError(
|
|
12
|
+
error_name="COMPOSITE MISSING INNERS ERROR",
|
|
13
|
+
label="composite_missing_or_none_inners",
|
|
14
|
+
expected="A valid non-empty tuple of inner component classes (inners not in (UNSET, None))",
|
|
15
|
+
value=inners,
|
|
16
|
+
problem=(
|
|
17
|
+
f"Attempted to create composite class '{class_name}' without specifying required 'inners' "
|
|
18
|
+
f"child components (received: {inners!r})."
|
|
19
|
+
),
|
|
20
|
+
context=(
|
|
21
|
+
f"Dynamic creator requires child component blueprints ('inners') to build "
|
|
22
|
+
f"a composite SimpleObject node tree."
|
|
23
|
+
),
|
|
24
|
+
how_to_fix=(
|
|
25
|
+
"Provide a tuple of child component blueprint classes for 'inners', e.g. inners=(ChildClassA, ChildClassB).",
|
|
26
|
+
"Do not pass None or UNSET for 'inners' when defining composite objects.",
|
|
27
|
+
"Required for composites: 'inners', 'logic'. Optional: 'decompose', 'validate', 'value_type'.",
|
|
28
|
+
"If this is a leaf constant: remove 'logic' and provide a static 'default' value instead.",
|
|
29
|
+
),
|
|
30
|
+
exception=ValueError,
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
_DESIGN_NOTES = """
|
|
35
|
+
# validate_composite_has_inners
|
|
36
|
+
|
|
37
|
+
## Purpose
|
|
38
|
+
Ensures that composite `SimpleObject` definitions explicitly specify their inner child component classes.
|
|
39
|
+
|
|
40
|
+
## Behavior
|
|
41
|
+
1. Checks if `inners` is in `(UNSET, None)`.
|
|
42
|
+
2. Raises structured `SimpleRuntimeError` guiding the developer to pass a valid tuple of child classes.
|
|
43
|
+
"""
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ....exceptions import SimpleRuntimeError
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def validate_composite_has_logic(class_name: str, logic: Any) -> None | NoReturn:
|
|
8
|
+
"""Validates that a composite object class definition provides a valid logic calculation callable."""
|
|
9
|
+
|
|
10
|
+
if logic in (UNSET, None):
|
|
11
|
+
raise SimpleRuntimeError(
|
|
12
|
+
error_name="COMPOSITE MISSING LOGIC ERROR",
|
|
13
|
+
label="composite_missing_or_none_logic",
|
|
14
|
+
expected="A valid non-None and non-UNSET callable logic function (logic not in (UNSET, None))",
|
|
15
|
+
value=logic,
|
|
16
|
+
problem=(
|
|
17
|
+
f"Composite class '{class_name}' specifies 'inners' but is missing the required 'logic' "
|
|
18
|
+
f"calculation rule (received: {logic!r})."
|
|
19
|
+
),
|
|
20
|
+
context=(
|
|
21
|
+
f"Dynamic creator inferred composite mode for class '{class_name}' because 'inners' was provided, "
|
|
22
|
+
f"but a valid logic pipeline was not supplied."
|
|
23
|
+
),
|
|
24
|
+
how_to_fix=(
|
|
25
|
+
"SimpleObject composites must derive their value from inner child components via a 'logic' function.",
|
|
26
|
+
"Provide a callable 'logic' function (or lambda) accepting parameters corresponding to inner snake_case names.",
|
|
27
|
+
"Do not pass None or UNSET for 'logic' when defining composite objects.",
|
|
28
|
+
"Required for composites: 'inners', 'logic'. Optional: 'decompose', 'validate', 'value_type'.",
|
|
29
|
+
"If this is a leaf constant: remove 'inners' and provide a static 'default' value instead.",
|
|
30
|
+
),
|
|
31
|
+
exception=ValueError,
|
|
32
|
+
)
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
_DESIGN_NOTES = """
|
|
36
|
+
# validate_composite_has_logic
|
|
37
|
+
|
|
38
|
+
## Purpose
|
|
39
|
+
Guarantees that every composite `SimpleObject` defines a functional `logic` pipeline for value derivation.
|
|
40
|
+
|
|
41
|
+
## Behavior
|
|
42
|
+
1. Asserts `logic` is not in `(UNSET, None)` when `inners` is present.
|
|
43
|
+
2. Raises structured `SimpleRuntimeError` emphasizing mandatory calculation rules for composite nodes.
|
|
44
|
+
"""
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ....exceptions import SimpleRuntimeError
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def validate_composite_has_not_default(class_name: str, default: Any) -> None | NoReturn:
|
|
8
|
+
"""Validates that a composite object class definition does not provide a static default value."""
|
|
9
|
+
|
|
10
|
+
if default is not UNSET:
|
|
11
|
+
raise SimpleRuntimeError(
|
|
12
|
+
error_name="COMPOSITE DEFAULT CONFLICT ERROR",
|
|
13
|
+
label="composite_default_conflict",
|
|
14
|
+
expected="default=UNSET when creating a SimpleObject composite class",
|
|
15
|
+
value=default,
|
|
16
|
+
problem=f"Composite class '{class_name}' received a 'default' parameter, which is reserved for leaf constants.",
|
|
17
|
+
context=f"Dynamic creator detected 'inners' tuple was provided for composite class '{class_name}'.",
|
|
18
|
+
how_to_fix=(
|
|
19
|
+
"SimpleObject composite values are dynamically derived from child 'inners' via 'logic' calculation.",
|
|
20
|
+
"If this is a composite node: remove the 'default' argument.",
|
|
21
|
+
"Required for composites: 'inners', 'logic'. Optional for composites: 'decompose', 'validate', 'value_type'.",
|
|
22
|
+
"If this is a leaf constant: remove 'inners' and 'logic'. Constants require: 'default' (optional: 'validate', 'value_type').",
|
|
23
|
+
),
|
|
24
|
+
exception=ValueError,
|
|
25
|
+
)
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
_DESIGN_NOTES = """
|
|
29
|
+
# validate_composite_has_not_default
|
|
30
|
+
|
|
31
|
+
## Purpose
|
|
32
|
+
Prevents setting a static default on composite nodes whose values must be computed via `logic`.
|
|
33
|
+
|
|
34
|
+
## Behavior
|
|
35
|
+
1. Verifies `default` is `UNSET` when `inners` is supplied.
|
|
36
|
+
2. Guides the developer to remove `default` or switch to constant mode by removing `inners`.
|
|
37
|
+
"""
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ....exceptions import SimpleRuntimeError
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def validate_constant_has_default(class_name: str, default: Any) -> None | NoReturn:
|
|
8
|
+
"""Validates that a constant leaf class definition provides a valid non-None default value."""
|
|
9
|
+
|
|
10
|
+
if default in (UNSET, None):
|
|
11
|
+
raise SimpleRuntimeError(
|
|
12
|
+
error_name="INVALID CONSTANT DEFAULT ERROR",
|
|
13
|
+
label="constant_missing_or_none_default",
|
|
14
|
+
expected="A valid non-UNSET and non-None default value (default not in (UNSET, None))",
|
|
15
|
+
value=default,
|
|
16
|
+
problem=(
|
|
17
|
+
f"Attempted to create constant class '{class_name}' with an invalid default value ({default!r}). ",
|
|
18
|
+
f"Constant default values cannot be UNSET or None."
|
|
19
|
+
),
|
|
20
|
+
context=(
|
|
21
|
+
f"Dynamic creator requires a concrete non-None default value for constant '{class_name}' ",
|
|
22
|
+
f"to perform type inference and compute composite default values across node trees."
|
|
23
|
+
),
|
|
24
|
+
how_to_fix=(
|
|
25
|
+
"Provide a concrete initial value for 'default' (e.g. 0, '', False, or a specific domain object).",
|
|
26
|
+
"Do not use None as a default value — Simple framework trees rely on non-None defaults to derive composite logic.",
|
|
27
|
+
"Supported optional parameters for constants: 'value_type', 'validate'.",
|
|
28
|
+
"If you intended to create a SimpleObject (composite node): provide 'inners' tuple and 'logic' callable instead.",
|
|
29
|
+
),
|
|
30
|
+
exception=ValueError,
|
|
31
|
+
)
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
_DESIGN_NOTES = """
|
|
35
|
+
# validate_constant_has_default
|
|
36
|
+
|
|
37
|
+
## Purpose
|
|
38
|
+
Enforces the mandatory presence of a concrete, non-None default value when dynamically instantiating
|
|
39
|
+
a `SimpleConstant` class blueprint.
|
|
40
|
+
|
|
41
|
+
## Behavior
|
|
42
|
+
1. Checks if `default` is `UNSET` or `None`.
|
|
43
|
+
2. Raises `SimpleRuntimeError` explaining that `None` is disallowed due to automatic type inference
|
|
44
|
+
and default value propagation rules across composite object trees.
|
|
45
|
+
|
|
46
|
+
## Notes
|
|
47
|
+
- Strict non-None default enforcement is a core architectural rule of the Simple library.
|
|
48
|
+
"""
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ....exceptions import SimpleRuntimeError
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def validate_constant_has_not_decompose(class_name: str, decompose: Any) -> None | NoReturn:
|
|
8
|
+
"""Validates that a constant leaf class definition does not provide a decomposition handler."""
|
|
9
|
+
|
|
10
|
+
if decompose is not UNSET:
|
|
11
|
+
raise SimpleRuntimeError(
|
|
12
|
+
error_name="CONSTANT DECOMPOSE CONFLICT ERROR",
|
|
13
|
+
label="constant_decompose_conflict",
|
|
14
|
+
expected="decompose=UNSET when creating a SimpleConstant class",
|
|
15
|
+
value=decompose,
|
|
16
|
+
problem=f"Constant class '{class_name}' received a 'decompose' parameter, which is reserved for composite objects.",
|
|
17
|
+
context=f"Dynamic creator detected 'inners' was UNSET but received 'decompose' for class '{class_name}'.",
|
|
18
|
+
how_to_fix=(
|
|
19
|
+
"SimpleConstant leaf nodes cannot be decomposed into inner children.",
|
|
20
|
+
"If this is a leaf node: remove the 'decompose' argument. Allowed constant parameters: 'default', 'value_type', 'validate'.",
|
|
21
|
+
"If this is a composite node: provide the 'inners' tuple specifying child component types.",
|
|
22
|
+
"Required for composites: 'inners', 'logic'. Optional for composites: 'decompose', 'validate', 'value_type'.",
|
|
23
|
+
),
|
|
24
|
+
exception=ValueError,
|
|
25
|
+
)
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
_DESIGN_NOTES = """
|
|
29
|
+
# validate_constant_has_not_decompose
|
|
30
|
+
|
|
31
|
+
## Purpose
|
|
32
|
+
Ensures top-down decomposition callables are not assigned to single leaf constants.
|
|
33
|
+
|
|
34
|
+
## Behavior
|
|
35
|
+
1. Checks if `decompose` is set when `inners` is omitted.
|
|
36
|
+
2. Raises structured error clarifying that decomposition is exclusive to composite trees.
|
|
37
|
+
"""
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ....exceptions import SimpleRuntimeError
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def validate_constant_has_not_logic(class_name: str, logic: Any) -> None | NoReturn:
|
|
8
|
+
"""Validates that a constant leaf class definition does not provide a logic calculation rule."""
|
|
9
|
+
|
|
10
|
+
if logic is not UNSET:
|
|
11
|
+
raise SimpleRuntimeError(
|
|
12
|
+
error_name="CONSTANT LOGIC CONFLICT ERROR",
|
|
13
|
+
label="constant_logic_conflict",
|
|
14
|
+
expected="logic=UNSET when creating a SimpleConstant class",
|
|
15
|
+
value=logic,
|
|
16
|
+
problem=f"Constant class '{class_name}' received a 'logic' parameter, which is reserved for composite objects.",
|
|
17
|
+
context=f"Dynamic creator detected 'inners' was UNSET but received 'logic' for class '{class_name}'.",
|
|
18
|
+
how_to_fix=(
|
|
19
|
+
"SimpleConstant leaf nodes store raw static values and do not support calculation rules ('logic').",
|
|
20
|
+
"If this is a leaf node: remove the 'logic' argument. Allowed constant parameters: 'default', 'value_type', 'validate'.",
|
|
21
|
+
"If this is a composite node: provide the 'inners' tuple specifying child component types alongside 'logic'.",
|
|
22
|
+
"Required for composites: 'inners', 'logic'. Optional for composites: 'decompose', 'validate', 'value_type'.",
|
|
23
|
+
),
|
|
24
|
+
exception=ValueError,
|
|
25
|
+
)
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
_DESIGN_NOTES = """
|
|
29
|
+
# validate_constant_has_not_logic
|
|
30
|
+
|
|
31
|
+
## Purpose
|
|
32
|
+
Prevents assigning a calculation rule (`logic`) to atomic `SimpleConstant` leaf nodes.
|
|
33
|
+
|
|
34
|
+
## Behavior
|
|
35
|
+
1. Ensures `logic` is `UNSET` when `inners` is not supplied.
|
|
36
|
+
2. Directs the user to either remove `logic` or supply `inners` to switch to composite mode.
|
|
37
|
+
"""
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
from dataclasses import dataclass
|
|
2
|
+
from typing import Any, Callable, TYPE_CHECKING
|
|
3
|
+
from simplibs.sentinels import UNSET, UnsetType
|
|
4
|
+
# Inners
|
|
5
|
+
from ..create_simple_object import create_simple_object
|
|
6
|
+
from .._validations import (
|
|
7
|
+
validate_class_name_is_str,
|
|
8
|
+
validate_constant_has_default,
|
|
9
|
+
validate_constant_has_not_logic,
|
|
10
|
+
validate_constant_has_not_decompose,
|
|
11
|
+
validate_composite_has_inners,
|
|
12
|
+
validate_composite_has_logic,
|
|
13
|
+
validate_composite_has_not_default,
|
|
14
|
+
)
|
|
15
|
+
# Annotations
|
|
16
|
+
if TYPE_CHECKING:
|
|
17
|
+
from ...._core.protocols import SimpleClassType, SimpleMixinLike
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
@dataclass
|
|
21
|
+
class BulkCase:
|
|
22
|
+
"""Data container representing a single definition blueprint for bulk object generation.
|
|
23
|
+
|
|
24
|
+
Validates initial specification boundaries during initialization and serves as a
|
|
25
|
+
factory runner forwarding stored configuration parameters to ``create_simple_object``.
|
|
26
|
+
"""
|
|
27
|
+
|
|
28
|
+
class_name: str
|
|
29
|
+
default: Any | UnsetType = UNSET
|
|
30
|
+
inners: tuple["SimpleClassType", ...] | UnsetType = UNSET
|
|
31
|
+
value_type: type | UnsetType = UNSET
|
|
32
|
+
validate: Callable | UnsetType = UNSET
|
|
33
|
+
logic: Callable | UnsetType = UNSET
|
|
34
|
+
decompose: Callable | UnsetType = UNSET
|
|
35
|
+
return_instance: bool = False
|
|
36
|
+
mixins: tuple["SimpleMixinLike", ...] = ()
|
|
37
|
+
as_atom: bool = False
|
|
38
|
+
mutable: bool = True
|
|
39
|
+
|
|
40
|
+
def __post_init__(self) -> None:
|
|
41
|
+
"""Validates parameter constraints upon dataclass initialization."""
|
|
42
|
+
|
|
43
|
+
# 1. Validate class_name strictly as non-empty string
|
|
44
|
+
validate_class_name_is_str(self.class_name)
|
|
45
|
+
|
|
46
|
+
# 2. Leaf constant definition checks
|
|
47
|
+
if self.inners is UNSET:
|
|
48
|
+
validate_constant_has_default(self.class_name, self.default)
|
|
49
|
+
validate_constant_has_not_logic(self.class_name, self.logic)
|
|
50
|
+
validate_constant_has_not_decompose(self.class_name, self.decompose)
|
|
51
|
+
|
|
52
|
+
# 3. Composite object definition checks
|
|
53
|
+
else:
|
|
54
|
+
validate_composite_has_inners(self.class_name, self.inners)
|
|
55
|
+
validate_composite_has_logic(self.class_name, self.logic)
|
|
56
|
+
validate_composite_has_not_default(self.class_name, self.default)
|
|
57
|
+
|
|
58
|
+
def create_simple_object(self) -> Any:
|
|
59
|
+
"""Executes object creation using the encapsulated parameters.
|
|
60
|
+
|
|
61
|
+
Returns:
|
|
62
|
+
Dynamically created Simple class blueprint, or initialized instance if return_instance=True.
|
|
63
|
+
"""
|
|
64
|
+
return create_simple_object(
|
|
65
|
+
class_name=self.class_name,
|
|
66
|
+
default=self.default,
|
|
67
|
+
inners=self.inners,
|
|
68
|
+
value_type=self.value_type,
|
|
69
|
+
validate=self.validate,
|
|
70
|
+
logic=self.logic,
|
|
71
|
+
decompose=self.decompose,
|
|
72
|
+
return_instance=self.return_instance,
|
|
73
|
+
mixins=self.mixins,
|
|
74
|
+
as_atom=self.as_atom,
|
|
75
|
+
mutable=self.mutable,
|
|
76
|
+
)
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
_DESIGN_NOTES = """
|
|
80
|
+
# BulkCase (Bulk Definition Specification Container)
|
|
81
|
+
|
|
82
|
+
## Purpose
|
|
83
|
+
Acts as an explicit structural container (data object) representing a target `SimpleConstant`
|
|
84
|
+
or `SimpleObject` definition for bulk dynamic generation workflows.
|
|
85
|
+
|
|
86
|
+
## Post-Initialization Validation Rules
|
|
87
|
+
1. **Class Name:** Enforces non-empty string via `validate_class_name_is_str`.
|
|
88
|
+
2. **Leaf Node (`inners` is UNSET):**
|
|
89
|
+
- Must provide concrete non-None default (`validate_constant_has_default`).
|
|
90
|
+
- Must NOT supply `logic` (`validate_constant_has_not_logic`).
|
|
91
|
+
- Must NOT supply `decompose` (`validate_constant_has_not_decompose`).
|
|
92
|
+
3. **Composite Node (`inners` is supplied):**
|
|
93
|
+
- Must supply non-empty `inners` tuple (`validate_composite_has_inners`).
|
|
94
|
+
- Must supply calculation `logic` (`validate_composite_has_logic`).
|
|
95
|
+
- Must NOT supply `default` (`validate_composite_has_not_default`).
|
|
96
|
+
|
|
97
|
+
## Execution
|
|
98
|
+
- `create_simple_object()` acts as a runner forwarding stored configuration arguments
|
|
99
|
+
directly to the orchestrator facade.
|
|
100
|
+
"""
|
|
File without changes
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# create_simple_object_bulk.py
|
|
2
|
+
from typing import Any
|
|
3
|
+
from .BulkCase import BulkCase
|
|
4
|
+
from .specific_bulks.create_simple_object_bulk_from_csv import create_simple_object_bulk_from_csv
|
|
5
|
+
from .specific_bulks.create_simple_object_bulk_from_dicts import create_simple_object_bulk_from_dicts
|
|
6
|
+
from .specific_bulks.create_simple_object_bulk_from_json import create_simple_object_bulk_from_json
|
|
7
|
+
from .specific_bulks.create_simple_object_bulk_from_table import create_simple_object_bulk_from_table
|
|
8
|
+
from .specific_bulks.create_simple_object_bulk_from_yaml import create_simple_object_bulk_from_yaml
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def create_simple_object_bulk(source: Any):
|
|
12
|
+
"""
|
|
13
|
+
Univerzální orchestrátor pro tvorbu bulk objektů.
|
|
14
|
+
Automaticky rozpozná typ vstupu a deleguje zpracování správnému parseru.
|
|
15
|
+
|
|
16
|
+
Podporované typy vstupu:
|
|
17
|
+
- list/tuple s instance `BulkCase`
|
|
18
|
+
- list/tuple s Python `dict`
|
|
19
|
+
- 2D list/tuple (`table`)
|
|
20
|
+
- str obsahující JSON
|
|
21
|
+
- str obsahující YAML (pokud začíná nebo obsahuje typické klíče)
|
|
22
|
+
- str obsahující CSV (s hlavičkou class_name)
|
|
23
|
+
"""
|
|
24
|
+
# 1. Je to sekvence (List / Tuple)
|
|
25
|
+
if isinstance(source, (list, tuple)):
|
|
26
|
+
if not source:
|
|
27
|
+
return create_simple_object_bulk_from_dicts([])
|
|
28
|
+
|
|
29
|
+
first_item = source[0]
|
|
30
|
+
|
|
31
|
+
# A) List instancí BulkCase
|
|
32
|
+
if isinstance(first_item, BulkCase):
|
|
33
|
+
from .specific_bulks.create_simple_object_bulk_from_bulk_case_class import (
|
|
34
|
+
create_simple_object_bulk_from_bulk_case_class,
|
|
35
|
+
)
|
|
36
|
+
return create_simple_object_bulk_from_bulk_case_class(tuple(source))
|
|
37
|
+
|
|
38
|
+
# B) List slovníků
|
|
39
|
+
if isinstance(first_item, dict):
|
|
40
|
+
return create_simple_object_bulk_from_dicts(source)
|
|
41
|
+
|
|
42
|
+
# C) Matice / Tabulka (2D list)
|
|
43
|
+
if isinstance(first_item, (list, tuple)):
|
|
44
|
+
return create_simple_object_bulk_from_table(source)
|
|
45
|
+
|
|
46
|
+
raise TypeError(f"Nerozpoznatelný prvek v seznamu: {type(first_item)}")
|
|
47
|
+
|
|
48
|
+
# 2. Je to Textový řetězec (JSON / YAML / CSV)
|
|
49
|
+
if isinstance(source, str):
|
|
50
|
+
cleaned = source.strip()
|
|
51
|
+
|
|
52
|
+
# A) Detekce JSON (začíná '[')
|
|
53
|
+
if cleaned.startswith("["):
|
|
54
|
+
return create_simple_object_bulk_from_json(cleaned)
|
|
55
|
+
|
|
56
|
+
# B) Detekce CSV (první řádek obsahuje 'class_name' A ZÁROVEŇ oddělovač ',' nebo ';')
|
|
57
|
+
first_line = cleaned.splitlines()[0] if cleaned else ""
|
|
58
|
+
if "class_name" in first_line and ("," in first_line or ";" in first_line):
|
|
59
|
+
return create_simple_object_bulk_from_csv(cleaned)
|
|
60
|
+
|
|
61
|
+
# C) Záložní pokus o YAML
|
|
62
|
+
return create_simple_object_bulk_from_yaml(cleaned)
|
|
63
|
+
|
|
64
|
+
raise TypeError(f"Nepodporovaný typ vstupu pro bulk tvorbu: {type(source)}")
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
"""
|
|
68
|
+
# Všechna tato volání vrátí stejný výsledek:
|
|
69
|
+
|
|
70
|
+
# 1. Univerzální fasáda (Doporučeno)
|
|
71
|
+
bulk_1 = create_simple_object_bulk([{"class_name": "MyConstant", "default": 100}])
|
|
72
|
+
bulk_2 = create_simple_object_bulk('[{"class_name": "MyConstant", "default": 100}]')
|
|
73
|
+
bulk_3 = create_simple_object_bulk([["MyConstant", 100]])
|
|
74
|
+
|
|
75
|
+
# 2. Explicitní parser (Když uživatel chce 100% jistotu bez auto-detekce)
|
|
76
|
+
bulk_4 = create_simple_object_bulk_from_json('[{"class_name": "MyConstant", "default": 100}]')
|
|
77
|
+
"""
|
|
File without changes
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
from .raise_bulk_item_is_not_bulk_dict import raise_bulk_item_is_not_bulk_dict
|
|
2
|
+
from .raise_bulk_csv_callable_not_supported import raise_bulk_csv_callable_not_supported
|
|
3
|
+
from .raise_bulk_data_not_list import raise_bulk_data_not_list
|
|
4
|
+
from .raise_bulk_decode_failed import raise_bulk_decode_failed
|
|
5
|
+
from .raise_bulk_input_not_sequence import raise_bulk_input_not_sequence
|
|
6
|
+
from .raise_bulk_input_not_str import raise_bulk_input_not_str
|
|
7
|
+
from .raise_bulk_table_row_not_sequence import raise_bulk_table_row_not_sequence
|
|
8
|
+
from .raise_bulk_yaml_import_failed import raise_bulk_yaml_import_failed
|