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,26 @@
|
|
|
1
|
+
from typing import NoReturn
|
|
2
|
+
from ......exceptions import SimpleRuntimeError
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
def raise_bulk_csv_callable_not_supported(
|
|
6
|
+
param_name: str,
|
|
7
|
+
) -> None | NoReturn:
|
|
8
|
+
"""Raises SimpleRuntimeError when executable parameters are specified in CSV input."""
|
|
9
|
+
|
|
10
|
+
raise SimpleRuntimeError(
|
|
11
|
+
error_name="BULK CSV CALLABLE UNSUPPORTED ERROR",
|
|
12
|
+
label="bulk_csv_callable_not_supported",
|
|
13
|
+
expected=f"Empty field or omit column '{param_name}' in CSV file",
|
|
14
|
+
value=param_name,
|
|
15
|
+
problem=(
|
|
16
|
+
f"CSV bulk creation does not support executable Python callables or functions "
|
|
17
|
+
f"for parameter '{param_name}'."
|
|
18
|
+
),
|
|
19
|
+
context="Attempted to parse callable logic or validation handlers from a flat CSV text stream.",
|
|
20
|
+
how_to_fix=(
|
|
21
|
+
f"Remove value from '{param_name}' column when creating objects from CSV.",
|
|
22
|
+
"If your dynamic objects require 'logic', 'validate', or 'decompose' callables, "
|
|
23
|
+
"use JSON, YAML, or direct Python dicts / BulkCase objects instead.",
|
|
24
|
+
),
|
|
25
|
+
exception=ValueError,
|
|
26
|
+
)
|
simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_data_not_list.py
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from ......exceptions import SimpleRuntimeError
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
def raise_bulk_data_not_list(
|
|
6
|
+
data: Any,
|
|
7
|
+
format_name: str,
|
|
8
|
+
) -> None | NoReturn:
|
|
9
|
+
"""Raises SimpleRuntimeError when deserialized bulk data (JSON/YAML) is not a list."""
|
|
10
|
+
|
|
11
|
+
format_upper = format_name.upper()
|
|
12
|
+
|
|
13
|
+
raise SimpleRuntimeError(
|
|
14
|
+
error_name=f"INVALID BULK {format_upper} DATA STRUCTURE ERROR",
|
|
15
|
+
label="bulk_data_is_not_list",
|
|
16
|
+
expected=f"A list/array of dictionary objects in {format_upper} root",
|
|
17
|
+
value=type(data).__name__,
|
|
18
|
+
problem=(
|
|
19
|
+
f"Parsed {format_upper} payload root must be a list of definition objects, "
|
|
20
|
+
f"received type '{type(data).__name__}' instead."
|
|
21
|
+
),
|
|
22
|
+
context=f"Attempted bulk creation from parsed {format_upper} data.",
|
|
23
|
+
how_to_fix=(
|
|
24
|
+
f"Ensure the top-level structure in your {format_upper} is a list/array (e.g. '[{{...}}, {{...}}]').",
|
|
25
|
+
"Single objects or key-value maps at root level are not supported for bulk generation.",
|
|
26
|
+
),
|
|
27
|
+
exception=ValueError,
|
|
28
|
+
)
|
simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_decode_failed.py
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
from typing import NoReturn
|
|
2
|
+
from ......exceptions import SimpleRuntimeError
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
def raise_bulk_decode_failed(
|
|
6
|
+
raw_content: str,
|
|
7
|
+
format_name: str,
|
|
8
|
+
original_exception: Exception,
|
|
9
|
+
) -> None | NoReturn:
|
|
10
|
+
"""Raises SimpleRuntimeError when JSON or YAML deserialization fails."""
|
|
11
|
+
|
|
12
|
+
format_upper = format_name.upper()
|
|
13
|
+
|
|
14
|
+
raise SimpleRuntimeError(
|
|
15
|
+
error_name=f"BULK {format_upper} DECODE ERROR",
|
|
16
|
+
label="bulk_decode_failed",
|
|
17
|
+
expected=f"A valid, syntax-correct {format_upper} formatted string",
|
|
18
|
+
value=raw_content,
|
|
19
|
+
problem=(
|
|
20
|
+
f"Failed to parse provided {format_upper} string into structured data. "
|
|
21
|
+
f"Underlying decoder error: {original_exception}"
|
|
22
|
+
),
|
|
23
|
+
context=f"Attempted to deserialize bulk object definitions from {format_upper} text stream.",
|
|
24
|
+
how_to_fix=(
|
|
25
|
+
f"Verify that the input string is valid {format_upper} syntax.",
|
|
26
|
+
"Check for common syntax errors like missing quotes, trailing commas, or invalid indentation.",
|
|
27
|
+
),
|
|
28
|
+
exception=ValueError,
|
|
29
|
+
)
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from ......exceptions import SimpleRuntimeError
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
def raise_bulk_input_not_sequence(
|
|
6
|
+
value: Any,
|
|
7
|
+
runner_name: str,
|
|
8
|
+
expected_items_description: str,
|
|
9
|
+
) -> None | NoReturn:
|
|
10
|
+
"""Raises SimpleRuntimeError when bulk input for dicts or table runners is not a list or tuple."""
|
|
11
|
+
|
|
12
|
+
raise SimpleRuntimeError(
|
|
13
|
+
error_name="INVALID BULK SEQUENCE INPUT ERROR",
|
|
14
|
+
label="bulk_input_is_not_sequence",
|
|
15
|
+
expected=f"A list or tuple of {expected_items_description}",
|
|
16
|
+
value=type(value).__name__,
|
|
17
|
+
problem=(
|
|
18
|
+
f"Input provided to '{runner_name}' must be a sequence (list or tuple), "
|
|
19
|
+
f"received type '{type(value).__name__}' instead."
|
|
20
|
+
),
|
|
21
|
+
context=f"Attempted bulk creation using runner '{runner_name}'.",
|
|
22
|
+
how_to_fix=(
|
|
23
|
+
f"Wrap your definition elements in a list or tuple before passing them to '{runner_name}'.",
|
|
24
|
+
f"Example: {runner_name}([element_1, element_2])",
|
|
25
|
+
),
|
|
26
|
+
exception=TypeError,
|
|
27
|
+
)
|
simplibs/object/tools/automate_creators/bulk/specific_bulks/_validations/raise_bulk_input_not_str.py
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from ......exceptions import SimpleRuntimeError
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
def raise_bulk_input_not_str(
|
|
6
|
+
value: Any,
|
|
7
|
+
format_name: str,
|
|
8
|
+
) -> None | NoReturn:
|
|
9
|
+
"""Raises SimpleRuntimeError when bulk text input (CSV/JSON/YAML) is not a string."""
|
|
10
|
+
|
|
11
|
+
format_upper = format_name.upper()
|
|
12
|
+
|
|
13
|
+
raise SimpleRuntimeError(
|
|
14
|
+
error_name=f"INVALID BULK {format_upper} INPUT ERROR",
|
|
15
|
+
label="bulk_input_is_not_str",
|
|
16
|
+
expected=f"A raw {format_upper} content string",
|
|
17
|
+
value=type(value).__name__,
|
|
18
|
+
problem=(
|
|
19
|
+
f"Bulk creation input for {format_upper} must be a string, "
|
|
20
|
+
f"received type '{type(value).__name__}' instead."
|
|
21
|
+
),
|
|
22
|
+
context=f"Attempted to parse bulk definitions using 'create_simple_object_bulk_from_{format_name.lower()}'.",
|
|
23
|
+
how_to_fix=(
|
|
24
|
+
f"Ensure the input provided to 'create_simple_object_bulk_from_{format_name.lower()}' is a valid string.",
|
|
25
|
+
f"If reading from a file, make sure to read its text content first (e.g., path.read_text()).",
|
|
26
|
+
),
|
|
27
|
+
exception=TypeError,
|
|
28
|
+
)
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
# Outers
|
|
3
|
+
from ......exceptions import SimpleRuntimeError
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
def raise_bulk_item_is_not_bulk_dict(
|
|
7
|
+
item: Any,
|
|
8
|
+
index: int
|
|
9
|
+
) -> None | NoReturn:
|
|
10
|
+
"""Validates that a provided bulk element is an instance of BulkCase."""
|
|
11
|
+
|
|
12
|
+
raise SimpleRuntimeError(
|
|
13
|
+
error_name="INVALID BULK ITEM ERROR",
|
|
14
|
+
label="bulk_item_is_not_bulk_dict",
|
|
15
|
+
expected="An instance of BulkCase",
|
|
16
|
+
value=type(item).__name__,
|
|
17
|
+
problem=(
|
|
18
|
+
f"Element at index {index} in the bulk creation sequence is not a 'BulkCase' instance "
|
|
19
|
+
f"(received type '{type(item).__name__}')."
|
|
20
|
+
),
|
|
21
|
+
context="Attempted to perform bulk object generation using 'create_simple_object_bulk_from_bulk_dict'.",
|
|
22
|
+
how_to_fix=(
|
|
23
|
+
"Ensure all items passed to bulk creation are wrapped in 'BulkCase' specification instances.",
|
|
24
|
+
"Example: create_simple_object_bulk_from_bulk_dict([BulkCase(class_name='MyConst', default=10), ...])",
|
|
25
|
+
),
|
|
26
|
+
exception=TypeError,
|
|
27
|
+
)
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
_DESIGN_NOTES = """
|
|
31
|
+
# raise_bulk_item_is_not_bulk_dict
|
|
32
|
+
|
|
33
|
+
## Purpose
|
|
34
|
+
Guarantees that every item processed by the BulkCase bulk runner is a valid `BulkCase` instance.
|
|
35
|
+
|
|
36
|
+
## Behavior
|
|
37
|
+
1. Performs an `isinstance(item, BulkCase)` check.
|
|
38
|
+
2. Raises structured `SimpleRuntimeError` wrapping `TypeError` if an invalid element is encountered.
|
|
39
|
+
"""
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
from typing import Any, NoReturn
|
|
2
|
+
from ......exceptions import SimpleRuntimeError
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
def raise_bulk_table_row_not_sequence(
|
|
6
|
+
row: Any,
|
|
7
|
+
index: int,
|
|
8
|
+
) -> None | NoReturn:
|
|
9
|
+
"""Raises SimpleRuntimeError when a specific row in 2D matrix input is not a sequence."""
|
|
10
|
+
|
|
11
|
+
raise SimpleRuntimeError(
|
|
12
|
+
error_name="INVALID BULK TABLE ROW ERROR",
|
|
13
|
+
label="bulk_table_row_is_not_sequence",
|
|
14
|
+
expected="A list or tuple representing a 2D table row",
|
|
15
|
+
value=type(row).__name__,
|
|
16
|
+
problem=(
|
|
17
|
+
f"Row at index {index} in the 2D bulk table input is not a sequence "
|
|
18
|
+
f"(received type '{type(row).__name__}')."
|
|
19
|
+
),
|
|
20
|
+
context="Attempted bulk creation using 'create_simple_object_bulk_from_table'.",
|
|
21
|
+
how_to_fix=(
|
|
22
|
+
f"Ensure every row inside the 2D matrix is wrapped in a list or tuple.",
|
|
23
|
+
f"Example format: [[class_name, default, ...], [class_name_2, default_2, ...]]",
|
|
24
|
+
),
|
|
25
|
+
exception=TypeError,
|
|
26
|
+
)
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
from typing import NoReturn
|
|
2
|
+
from ......exceptions import SimpleRuntimeError
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
def raise_bulk_yaml_import_failed() -> None | NoReturn:
|
|
6
|
+
"""Raises SimpleRuntimeError when PyYAML package is missing during YAML parsing."""
|
|
7
|
+
|
|
8
|
+
raise SimpleRuntimeError(
|
|
9
|
+
error_name="BULK YAML MISSING DEPENDENCY ERROR",
|
|
10
|
+
label="bulk_yaml_import_failed",
|
|
11
|
+
expected="Installed 'pyyaml' package in the python environment",
|
|
12
|
+
value="ModuleNotFoundError: yaml",
|
|
13
|
+
problem=(
|
|
14
|
+
"Cannot execute bulk creation from YAML because the 'PyYAML' library is not installed."
|
|
15
|
+
),
|
|
16
|
+
context="Attempted to invoke 'create_simple_object_bulk_from_yaml'.",
|
|
17
|
+
how_to_fix=(
|
|
18
|
+
"Install the PyYAML library using pip: 'pip install pyyaml'.",
|
|
19
|
+
"Alternatively, use JSON, CSV, or python dictionary runners which do not require external dependencies.",
|
|
20
|
+
),
|
|
21
|
+
exception=ImportError,
|
|
22
|
+
)
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
from typing import Any, Iterable, TYPE_CHECKING
|
|
2
|
+
# Outers
|
|
3
|
+
from ..BulkCase import BulkCase
|
|
4
|
+
# Inners
|
|
5
|
+
from ._validations import raise_bulk_item_is_not_bulk_dict
|
|
6
|
+
# Annotations
|
|
7
|
+
if TYPE_CHECKING:
|
|
8
|
+
from ....._core.protocols import SimpleClassLike, SimpleInstanceLike
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def create_simple_object_bulk_from_bulk_case_class(
|
|
12
|
+
bulk_dicts: Iterable[BulkCase],
|
|
13
|
+
) -> list["SimpleClassLike | SimpleInstanceLike"]:
|
|
14
|
+
"""Generates multiple SimpleConstant or SimpleObject blueprints/instances from BulkCase specifications.
|
|
15
|
+
|
|
16
|
+
Args:
|
|
17
|
+
bulk_dicts: Iterable collection containing BulkCase specification instances.
|
|
18
|
+
|
|
19
|
+
Returns:
|
|
20
|
+
List of generated Simple class blueprints or instantiated objects.
|
|
21
|
+
|
|
22
|
+
Raises:
|
|
23
|
+
SimpleDefinitionError: If any element in the iterable is not an instance of BulkCase.
|
|
24
|
+
"""
|
|
25
|
+
|
|
26
|
+
results: list[Any] = []
|
|
27
|
+
|
|
28
|
+
# 1. Iterate and validate each bulk dictionary item
|
|
29
|
+
for index, item in enumerate(bulk_dicts):
|
|
30
|
+
|
|
31
|
+
# 2. Validation that item is an instance of the BulkCase class
|
|
32
|
+
if not isinstance(item, BulkCase):
|
|
33
|
+
raise_bulk_item_is_not_bulk_dict(item, index)
|
|
34
|
+
|
|
35
|
+
# 2. Execute dynamic creation for valid item
|
|
36
|
+
results.append(item.create_simple_object())
|
|
37
|
+
|
|
38
|
+
# 3. Return aggregated creation outputs
|
|
39
|
+
return results
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
_DESIGN_NOTES = """
|
|
43
|
+
# create_simple_object_bulk_from_bulk_dict (Bulk Processing Engine)
|
|
44
|
+
|
|
45
|
+
## Purpose
|
|
46
|
+
Executes batch dynamic generation of `SimpleConstant` and `SimpleObject` blueprints or
|
|
47
|
+
instances from an iterable of pre-validated `BulkCase` specification objects.
|
|
48
|
+
|
|
49
|
+
## Execution Workflow
|
|
50
|
+
1. Iterates through the provided `bulk_dicts` collection with item tracking.
|
|
51
|
+
2. Validates each element's type using `validate_bulk_item_is_bulk_dict`.
|
|
52
|
+
3. Invokes `create_simple_object()` on each `BulkCase` instance to produce the class/object.
|
|
53
|
+
4. Aggregates and returns the results in a python list.
|
|
54
|
+
|
|
55
|
+
## Framework Usage
|
|
56
|
+
- Internal engine backing bulk object definition workflows.
|
|
57
|
+
"""
|
simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_csv.py
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import csv
|
|
2
|
+
from typing import Any
|
|
3
|
+
from simplibs.sentinels import UNSET
|
|
4
|
+
# Outers
|
|
5
|
+
from ..BulkCase import BulkCase
|
|
6
|
+
# Inners
|
|
7
|
+
from .create_simple_object_bulk_from_bulk_case_class import create_simple_object_bulk_from_bulk_case_class
|
|
8
|
+
from ._validations import (
|
|
9
|
+
raise_bulk_input_not_str,
|
|
10
|
+
raise_bulk_csv_callable_not_supported,
|
|
11
|
+
)
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def _convert_value(v: str | None) -> Any:
|
|
15
|
+
if v is None or v.strip() == "":
|
|
16
|
+
return UNSET
|
|
17
|
+
val = v.strip()
|
|
18
|
+
try:
|
|
19
|
+
return int(val)
|
|
20
|
+
except ValueError:
|
|
21
|
+
try:
|
|
22
|
+
return float(val)
|
|
23
|
+
except ValueError:
|
|
24
|
+
return val
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def _convert_type(v: str | None) -> Any:
|
|
28
|
+
if v is None or v.strip() == "":
|
|
29
|
+
return UNSET
|
|
30
|
+
types_map = {"int": int, "str": str, "float": float, "bool": bool}
|
|
31
|
+
return types_map.get(v.strip().lower(), Any)
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
def _convert_bool(v: str | None) -> bool:
|
|
35
|
+
if v is None:
|
|
36
|
+
return False
|
|
37
|
+
return v.strip().lower() in ("true", "1", "yes")
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
def _convert_callable(v: str | None, param_name: str) -> Any:
|
|
41
|
+
if not v or v.strip() == "":
|
|
42
|
+
return UNSET
|
|
43
|
+
raise_bulk_csv_callable_not_supported(param_name)
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
def create_simple_object_bulk_from_csv(csv_string: str):
|
|
47
|
+
"""Parses a CSV string with headers and creates a bulk collection of Simple objects."""
|
|
48
|
+
if not isinstance(csv_string, str):
|
|
49
|
+
raise_bulk_input_not_str(csv_string, "csv")
|
|
50
|
+
|
|
51
|
+
reader = csv.DictReader(csv_string.strip().splitlines())
|
|
52
|
+
bulk = []
|
|
53
|
+
|
|
54
|
+
for row in reader:
|
|
55
|
+
converted = {
|
|
56
|
+
"class_name": row.get("class_name"),
|
|
57
|
+
"default": _convert_value(row.get("default")),
|
|
58
|
+
"value_type": _convert_type(row.get("value_type")),
|
|
59
|
+
"validate": _convert_callable(row.get("validate"), "validate"),
|
|
60
|
+
"logic": _convert_callable(row.get("logic"), "logic"),
|
|
61
|
+
"decompose": _convert_callable(row.get("decompose"), "decompose"),
|
|
62
|
+
"return_instance": _convert_bool(row.get("return_instance")),
|
|
63
|
+
"as_atom": _convert_bool(row.get("as_atom")),
|
|
64
|
+
"mutable": _convert_bool(row.get("mutable")),
|
|
65
|
+
}
|
|
66
|
+
bulk.append(BulkCase(**converted))
|
|
67
|
+
|
|
68
|
+
return create_simple_object_bulk_from_bulk_case_class(tuple(bulk))
|
simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_dicts.py
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
# Outers
|
|
3
|
+
from ..BulkCase import BulkCase
|
|
4
|
+
# Inners
|
|
5
|
+
from .create_simple_object_bulk_from_bulk_case_class import create_simple_object_bulk_from_bulk_case_class
|
|
6
|
+
from ._validations import raise_bulk_input_not_sequence
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def create_simple_object_bulk_from_dicts(dicts: list[dict[str, Any]]):
|
|
10
|
+
"""Creates a bulk collection of Simple objects from a sequence of dictionaries."""
|
|
11
|
+
if not isinstance(dicts, (list, tuple)):
|
|
12
|
+
raise_bulk_input_not_sequence(
|
|
13
|
+
value=dicts,
|
|
14
|
+
runner_name="create_simple_object_bulk_from_dicts",
|
|
15
|
+
expected_items_description="dictionaries",
|
|
16
|
+
)
|
|
17
|
+
|
|
18
|
+
bulk = tuple(BulkCase(**d) for d in dicts)
|
|
19
|
+
return create_simple_object_bulk_from_bulk_case_class(bulk)
|
simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_json.py
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import json
|
|
2
|
+
# Inners
|
|
3
|
+
from .create_simple_object_bulk_from_dicts import create_simple_object_bulk_from_dicts
|
|
4
|
+
from ._validations import (
|
|
5
|
+
raise_bulk_input_not_str,
|
|
6
|
+
raise_bulk_decode_failed,
|
|
7
|
+
raise_bulk_data_not_list,
|
|
8
|
+
)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def create_simple_object_bulk_from_json(json_string: str):
|
|
12
|
+
"""Parses a JSON string and creates a bulk collection of Simple objects."""
|
|
13
|
+
if not isinstance(json_string, str):
|
|
14
|
+
raise_bulk_input_not_str(json_string, "json")
|
|
15
|
+
|
|
16
|
+
try:
|
|
17
|
+
data = json.loads(json_string)
|
|
18
|
+
except json.JSONDecodeError as exc:
|
|
19
|
+
raise_bulk_decode_failed(json_string, "json", exc)
|
|
20
|
+
|
|
21
|
+
if not isinstance(data, list):
|
|
22
|
+
raise_bulk_data_not_list(data, "json")
|
|
23
|
+
|
|
24
|
+
return create_simple_object_bulk_from_dicts(data)
|
simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_table.py
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
from simplibs.sentinels import UNSET
|
|
3
|
+
# Outers
|
|
4
|
+
from ..BulkCase import BulkCase
|
|
5
|
+
# Inners
|
|
6
|
+
from .create_simple_object_bulk_from_bulk_case_class import create_simple_object_bulk_from_bulk_case_class
|
|
7
|
+
from ._validations import (
|
|
8
|
+
raise_bulk_input_not_sequence,
|
|
9
|
+
raise_bulk_table_row_not_sequence,
|
|
10
|
+
)
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
def create_simple_object_bulk_from_table(table: list[list[Any]]):
|
|
14
|
+
"""Creates a bulk collection of Simple objects from a 2D matrix / table."""
|
|
15
|
+
if not isinstance(table, (list, tuple)):
|
|
16
|
+
raise_bulk_input_not_sequence(
|
|
17
|
+
value=table,
|
|
18
|
+
runner_name="create_simple_object_bulk_from_table",
|
|
19
|
+
expected_items_description="2D table rows (lists/tuples)",
|
|
20
|
+
)
|
|
21
|
+
|
|
22
|
+
bulk = []
|
|
23
|
+
for index, row in enumerate(table):
|
|
24
|
+
if not isinstance(row, (list, tuple)):
|
|
25
|
+
raise_bulk_table_row_not_sequence(row, index)
|
|
26
|
+
|
|
27
|
+
# Změna výchozí hodnoty z None na UNSET
|
|
28
|
+
def _get(idx: int, default: Any = UNSET) -> Any:
|
|
29
|
+
return row[idx] if len(row) > idx else default
|
|
30
|
+
|
|
31
|
+
bulk.append(
|
|
32
|
+
BulkCase(
|
|
33
|
+
class_name=_get(0),
|
|
34
|
+
default=_get(1),
|
|
35
|
+
value_type=_get(2),
|
|
36
|
+
validate=_get(3),
|
|
37
|
+
logic=_get(4),
|
|
38
|
+
decompose=_get(5),
|
|
39
|
+
return_instance=_get(6, False),
|
|
40
|
+
)
|
|
41
|
+
)
|
|
42
|
+
|
|
43
|
+
return create_simple_object_bulk_from_bulk_case_class(tuple(bulk))
|
simplibs/object/tools/automate_creators/bulk/specific_bulks/create_simple_object_bulk_from_yaml.py
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Inners
|
|
2
|
+
from .create_simple_object_bulk_from_dicts import create_simple_object_bulk_from_dicts
|
|
3
|
+
from ._validations import (
|
|
4
|
+
raise_bulk_input_not_str,
|
|
5
|
+
raise_bulk_yaml_import_failed,
|
|
6
|
+
raise_bulk_decode_failed,
|
|
7
|
+
raise_bulk_data_not_list,
|
|
8
|
+
)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
def create_simple_object_bulk_from_yaml(yaml_string: str):
|
|
12
|
+
"""Parses a YAML string and creates a bulk collection of Simple objects."""
|
|
13
|
+
if not isinstance(yaml_string, str):
|
|
14
|
+
raise_bulk_input_not_str(yaml_string, "yaml")
|
|
15
|
+
|
|
16
|
+
try:
|
|
17
|
+
import yaml
|
|
18
|
+
except ImportError:
|
|
19
|
+
raise_bulk_yaml_import_failed()
|
|
20
|
+
|
|
21
|
+
try:
|
|
22
|
+
data = yaml.safe_load(yaml_string)
|
|
23
|
+
except Exception as exc:
|
|
24
|
+
raise_bulk_decode_failed(yaml_string, "yaml", exc)
|
|
25
|
+
|
|
26
|
+
if not isinstance(data, list):
|
|
27
|
+
raise_bulk_data_not_list(data, "yaml")
|
|
28
|
+
|
|
29
|
+
return create_simple_object_bulk_from_dicts(data)
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
from typing import Any, Callable, TYPE_CHECKING
|
|
2
|
+
from simplibs.sentinels import UNSET, UnsetType
|
|
3
|
+
# Outers
|
|
4
|
+
from ...SimpleConstant import SimpleConstant
|
|
5
|
+
# Inners
|
|
6
|
+
from ._helpers.process_validate import process_validate
|
|
7
|
+
from ._validations import (
|
|
8
|
+
validate_class_name_is_str,
|
|
9
|
+
validate_constant_has_default,
|
|
10
|
+
)
|
|
11
|
+
# Annotations
|
|
12
|
+
if TYPE_CHECKING:
|
|
13
|
+
from ..._core.protocols import SimpleClassLike
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def create_constant_class(
|
|
17
|
+
class_name: str,
|
|
18
|
+
default: Any,
|
|
19
|
+
value_type: type | UnsetType = UNSET,
|
|
20
|
+
validate: Callable | UnsetType = UNSET,
|
|
21
|
+
) -> "SimpleClassLike":
|
|
22
|
+
"""Dynamically creates a SimpleConstant leaf subclass.
|
|
23
|
+
|
|
24
|
+
Args:
|
|
25
|
+
class_name: Target name of the generated class.
|
|
26
|
+
default: Mandatory initial default value for the constant.
|
|
27
|
+
value_type: Explicit value type override; if UNSET, inferred from default type.
|
|
28
|
+
validate: Optional validation function or lambda rule.
|
|
29
|
+
|
|
30
|
+
Returns:
|
|
31
|
+
Newly created SimpleConstant subclass blueprint.
|
|
32
|
+
|
|
33
|
+
Raises:
|
|
34
|
+
SimpleDefinitionError: If class_name is invalid or default is UNSET.
|
|
35
|
+
"""
|
|
36
|
+
|
|
37
|
+
# 1. Parameter boundary validations
|
|
38
|
+
if not (
|
|
39
|
+
isinstance(class_name, str)
|
|
40
|
+
and class_name.strip()
|
|
41
|
+
and default not in (None, UNSET)
|
|
42
|
+
):
|
|
43
|
+
validate_class_name_is_str(class_name)
|
|
44
|
+
validate_constant_has_default(class_name, default)
|
|
45
|
+
|
|
46
|
+
# 2. Infer value type if omitted
|
|
47
|
+
if value_type is UNSET:
|
|
48
|
+
value_type = type(default)
|
|
49
|
+
|
|
50
|
+
# 3. Prepare class namespace blueprint
|
|
51
|
+
namespace = {
|
|
52
|
+
"_default": default,
|
|
53
|
+
"_type": value_type,
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
# 4. Attach normalized validation handler if provided
|
|
57
|
+
if validate is not UNSET:
|
|
58
|
+
# noinspection PyTypeChecker
|
|
59
|
+
_validate = process_validate(validate)
|
|
60
|
+
namespace["_validate"] = classmethod(_validate)
|
|
61
|
+
|
|
62
|
+
# 5. Dynamically instantiate subclass and return
|
|
63
|
+
new_class = type(class_name, (SimpleConstant,), namespace)
|
|
64
|
+
new_class: "SimpleClassLike"
|
|
65
|
+
return new_class
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
_DESIGN_NOTES = """
|
|
69
|
+
# create_constant_class (Creator Engine)
|
|
70
|
+
|
|
71
|
+
## Purpose
|
|
72
|
+
Dynamically constructs a `SimpleConstant` subclass at runtime without requiring explicit class
|
|
73
|
+
statement declarations. Used for generating atomic leaf node blueprints programmatically.
|
|
74
|
+
|
|
75
|
+
## Execution Workflow
|
|
76
|
+
1. Validates `class_name` and ensures `default` is non-UNSET using guard functions.
|
|
77
|
+
2. Infers `_type` from `type(default)` if `value_type` is `UNSET`.
|
|
78
|
+
3. Constructs standard namespace dictionary containing `_default` and `_type`.
|
|
79
|
+
4. Wraps and attaches `_validate` as a `classmethod` if a validation callable was provided.
|
|
80
|
+
5. Invokes `type(class_name, (SimpleConstant,), namespace)` to create the class definition.
|
|
81
|
+
|
|
82
|
+
## Framework Usage
|
|
83
|
+
- Called directly by developers or internally via `create_simple_object`.
|
|
84
|
+
"""
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
from typing import Callable, TYPE_CHECKING
|
|
2
|
+
from simplibs.sentinels import UNSET, UnsetType
|
|
3
|
+
# Outers
|
|
4
|
+
from ...SimpleObject import SimpleObject
|
|
5
|
+
# Inners
|
|
6
|
+
from ._helpers.process_validate import process_validate
|
|
7
|
+
from ._helpers.load_parameters_from_inners import load_parameters_from_inners
|
|
8
|
+
from ._helpers.process_logic import process_logic
|
|
9
|
+
from ._helpers.calculate_default import calculate_default
|
|
10
|
+
from ._helpers.process_decompose import process_decompose
|
|
11
|
+
from ._validations import (
|
|
12
|
+
validate_class_name_is_str,
|
|
13
|
+
validate_composite_has_logic,
|
|
14
|
+
validate_composite_has_inners
|
|
15
|
+
)
|
|
16
|
+
# Annotations
|
|
17
|
+
if TYPE_CHECKING:
|
|
18
|
+
from ..._core.protocols import SimpleClassType, SimpleClassLike
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
# noinspection PyTypeChecker
|
|
22
|
+
def create_object_class(
|
|
23
|
+
class_name: str,
|
|
24
|
+
inners: tuple["SimpleClassType", ...],
|
|
25
|
+
logic: Callable,
|
|
26
|
+
value_type: type | UnsetType = UNSET,
|
|
27
|
+
validate: Callable | UnsetType = UNSET,
|
|
28
|
+
decompose: Callable | UnsetType = UNSET,
|
|
29
|
+
) -> "SimpleClassLike":
|
|
30
|
+
"""Dynamically creates a SimpleObject composite subclass.
|
|
31
|
+
|
|
32
|
+
Args:
|
|
33
|
+
class_name: Target name of the generated composite class.
|
|
34
|
+
inners: Tuple of inner child component blueprint classes.
|
|
35
|
+
logic: Functional calculation rule deriving value from inner components.
|
|
36
|
+
value_type: Explicit value type override; if UNSET, inferred from logic default result.
|
|
37
|
+
validate: Optional user validation function or lambda rule.
|
|
38
|
+
decompose: Optional top-down value decomposition function or lambda handler.
|
|
39
|
+
|
|
40
|
+
Returns:
|
|
41
|
+
Newly created SimpleObject subclass blueprint.
|
|
42
|
+
|
|
43
|
+
Raises:
|
|
44
|
+
SimpleDefinitionError: If class_name is invalid or required logic parameter is UNSET.
|
|
45
|
+
"""
|
|
46
|
+
|
|
47
|
+
# 1. Parameter boundary validations
|
|
48
|
+
if not (
|
|
49
|
+
isinstance(class_name, str)
|
|
50
|
+
and class_name.strip()
|
|
51
|
+
and inners not in (None, UNSET)
|
|
52
|
+
and logic not in (None, UNSET)
|
|
53
|
+
):
|
|
54
|
+
validate_class_name_is_str(class_name)
|
|
55
|
+
validate_composite_has_inners(class_name, inners)
|
|
56
|
+
validate_composite_has_logic(class_name, logic)
|
|
57
|
+
|
|
58
|
+
# 2. Extract inner parameter names and defaults
|
|
59
|
+
_params = load_parameters_from_inners(class_name, inners)
|
|
60
|
+
|
|
61
|
+
# 3. Normalize logic signature
|
|
62
|
+
_logic = process_logic(logic, _params.keys())
|
|
63
|
+
|
|
64
|
+
# 4. Infer output value_type if omitted
|
|
65
|
+
if value_type is UNSET:
|
|
66
|
+
_default_value = calculate_default(_logic, tuple(_params.values()))
|
|
67
|
+
value_type = type(_default_value)
|
|
68
|
+
|
|
69
|
+
# 5. Prepare class namespace blueprint
|
|
70
|
+
namespace = {
|
|
71
|
+
"_inners": inners,
|
|
72
|
+
"_type": value_type,
|
|
73
|
+
"_logic": classmethod(_logic),
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
# 6. Attach normalized validation handler if provided
|
|
77
|
+
if validate is not UNSET:
|
|
78
|
+
_validate = process_validate(validate)
|
|
79
|
+
namespace["_validate"] = classmethod(_validate)
|
|
80
|
+
|
|
81
|
+
# 7. Attach normalized decomposition handler if provided
|
|
82
|
+
if decompose is not UNSET:
|
|
83
|
+
_decompose = process_decompose(decompose)
|
|
84
|
+
namespace["_decompose"] = classmethod(_decompose)
|
|
85
|
+
|
|
86
|
+
# 8. Dynamically instantiate subclass and return
|
|
87
|
+
new_class = type(class_name, (SimpleObject,), namespace)
|
|
88
|
+
|
|
89
|
+
return new_class
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
_DESIGN_NOTES = """
|
|
93
|
+
# create_object_class (Creator Engine)
|
|
94
|
+
|
|
95
|
+
## Purpose
|
|
96
|
+
Dynamically constructs a `SimpleObject` composite subclass at runtime without requiring explicit
|
|
97
|
+
class blueprint statements. Programmatically builds reactive object tree nodes.
|
|
98
|
+
|
|
99
|
+
## Execution Workflow
|
|
100
|
+
1. Validates `class_name` and ensures `logic` is not `UNSET` via guard functions.
|
|
101
|
+
2. Extracts inner component parameter names and default values via `load_parameters_from_inners`.
|
|
102
|
+
3. Normalizes `logic` callable signature to accept `(cls, *args)` via `process_logic`.
|
|
103
|
+
4. Executes `calculate_default` to derive the composite default value and infers `value_type` if `UNSET`.
|
|
104
|
+
5. Prepares class `namespace` dictionary with `_inners`, `_type`, and `_logic`.
|
|
105
|
+
6. Wraps and attaches optional `_validate` and `_decompose` methods using `process_validate` and `process_decompose`.
|
|
106
|
+
7. Calls `type(class_name, (SimpleObject,), namespace)` to generate and return the class blueprint.
|
|
107
|
+
|
|
108
|
+
## Framework Usage
|
|
109
|
+
- Called directly by developers or internally via `create_simple_object`.
|
|
110
|
+
"""
|