lutaml 0.11.7 → 0.11.8
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.
- checksums.yaml +4 -4
- data/.rubocop.yml +20 -0
- data/.rubocop_todo.yml +0 -1
- data/Gemfile +32 -5
- data/README.adoc +3 -3
- data/README.md +6 -8
- data/Rakefile +41 -1
- data/bin/console +0 -1
- data/exe/lutaml-lml +6 -0
- data/exe/lutaml-lml-lsp +11 -0
- data/lib/compat/opal/generate_boot.rb +132 -0
- data/lib/compat/opal/js_bundle_entry.rb +42 -0
- data/lib/compat/opal/lutaml_model_boot.rb +540 -0
- data/lib/compat/opal/monitor.rb +31 -0
- data/lib/compat/opal/moxml/adapter/customized_rexml/entity_reference.rb +9 -0
- data/lib/compat/opal/moxml/adapter/customized_rexml/formatter.rb +225 -0
- data/lib/compat/opal/moxml/adapter/customized_rexml.rb +11 -0
- data/lib/compat/opal/moxml_boot.rb +68 -0
- data/lib/compat/opal/objectspace_shim.rb +23 -0
- data/lib/compat/opal/rexml/namespace.rb +59 -0
- data/lib/compat/opal/rexml/parsers/baseparser.rb +1016 -0
- data/lib/compat/opal/rexml/source.rb +214 -0
- data/lib/compat/opal/rexml/text.rb +426 -0
- data/lib/compat/opal/rexml/xmltokens.rb +45 -0
- data/lib/compat/opal/rexml_compat.rb +85 -0
- data/lib/compat/opal/yaml_compat.rb +32 -0
- data/lib/lutaml/hash_format/adapter/document.rb +10 -0
- data/lib/lutaml/hash_format/adapter/mapping.rb +17 -0
- data/lib/lutaml/hash_format/adapter/mapping_rule.rb +9 -0
- data/lib/lutaml/hash_format/adapter/standard_adapter.rb +17 -0
- data/lib/lutaml/hash_format/adapter/transform.rb +9 -0
- data/lib/lutaml/hash_format/adapter.rb +13 -0
- data/lib/lutaml/hash_format/format.rb +29 -0
- data/lib/lutaml/hash_format/type/serializers.rb +24 -0
- data/lib/lutaml/hash_format.rb +7 -0
- data/lib/lutaml/json/adapter/document.rb +13 -0
- data/lib/lutaml/json/adapter/mapping.rb +17 -0
- data/lib/lutaml/json/adapter/mapping_rule.rb +9 -0
- data/lib/lutaml/json/adapter/multi_json_adapter.rb +45 -0
- data/lib/lutaml/json/adapter/oj_adapter.rb +41 -0
- data/lib/lutaml/json/adapter/standard_adapter.rb +43 -0
- data/lib/lutaml/json/adapter/transform.rb +9 -0
- data/lib/lutaml/json/adapter/yeptris_adapter.rb +74 -0
- data/lib/lutaml/json/adapter.rb +21 -0
- data/lib/lutaml/json/format.rb +61 -0
- data/lib/lutaml/json/generator_options.rb +62 -0
- data/lib/lutaml/json/schema/json_schema.rb +62 -0
- data/lib/lutaml/json/schema.rb +9 -0
- data/lib/lutaml/json/type/serializers.rb +72 -0
- data/lib/lutaml/json.rb +7 -0
- data/lib/lutaml/jsonl/adapter/document.rb +14 -0
- data/lib/lutaml/jsonl/adapter/mapping.rb +17 -0
- data/lib/lutaml/jsonl/adapter/mapping_rule.rb +9 -0
- data/lib/lutaml/jsonl/adapter/standard_adapter.rb +34 -0
- data/lib/lutaml/jsonl/adapter/transform.rb +26 -0
- data/lib/lutaml/jsonl/adapter.rb +13 -0
- data/lib/lutaml/jsonl/format.rb +22 -0
- data/lib/lutaml/jsonl.rb +7 -0
- data/lib/lutaml/jsonld/adapter.rb +31 -0
- data/lib/lutaml/jsonld.rb +20 -0
- data/lib/lutaml/key_value/adapter/hash/document.rb +13 -0
- data/lib/lutaml/key_value/adapter/hash/mapping.rb +17 -0
- data/lib/lutaml/key_value/adapter/hash/mapping_rule.rb +9 -0
- data/lib/lutaml/key_value/adapter/hash/standard_adapter.rb +19 -0
- data/lib/lutaml/key_value/adapter/hash/transform.rb +10 -0
- data/lib/lutaml/key_value/adapter/hash.rb +15 -0
- data/lib/lutaml/key_value/adapter/json/document.rb +16 -0
- data/lib/lutaml/key_value/adapter/json/mapping.rb +22 -0
- data/lib/lutaml/key_value/adapter/json/mapping_rule.rb +14 -0
- data/lib/lutaml/key_value/adapter/json/multi_json_adapter.rb +54 -0
- data/lib/lutaml/key_value/adapter/json/oj_adapter.rb +46 -0
- data/lib/lutaml/key_value/adapter/json/standard_adapter.rb +47 -0
- data/lib/lutaml/key_value/adapter/json/transform.rb +14 -0
- data/lib/lutaml/key_value/adapter/json/yeptris_adapter.rb +15 -0
- data/lib/lutaml/key_value/adapter/json.rb +24 -0
- data/lib/lutaml/key_value/adapter/jsonl/document.rb +16 -0
- data/lib/lutaml/key_value/adapter/jsonl/mapping.rb +17 -0
- data/lib/lutaml/key_value/adapter/jsonl/mapping_rule.rb +9 -0
- data/lib/lutaml/key_value/adapter/jsonl/standard_adapter.rb +36 -0
- data/lib/lutaml/key_value/adapter/jsonl/transform.rb +26 -0
- data/lib/lutaml/key_value/adapter/jsonl.rb +17 -0
- data/lib/lutaml/key_value/adapter/toml/document.rb +13 -0
- data/lib/lutaml/key_value/adapter/toml/mapping.rb +26 -0
- data/lib/lutaml/key_value/adapter/toml/mapping_rule.rb +9 -0
- data/lib/lutaml/key_value/adapter/toml/teptris_adapter.rb +36 -0
- data/lib/lutaml/key_value/adapter/toml/toml_rb_adapter.rb +34 -0
- data/lib/lutaml/key_value/adapter/toml/tomlib_adapter.rb +40 -0
- data/lib/lutaml/key_value/adapter/toml/transform.rb +10 -0
- data/lib/lutaml/key_value/adapter/toml.rb +22 -0
- data/lib/lutaml/key_value/adapter/yaml/document.rb +12 -0
- data/lib/lutaml/key_value/adapter/yaml/mapping.rb +17 -0
- data/lib/lutaml/key_value/adapter/yaml/mapping_rule.rb +9 -0
- data/lib/lutaml/key_value/adapter/yaml/standard_adapter.rb +35 -0
- data/lib/lutaml/key_value/adapter/yaml/transform.rb +10 -0
- data/lib/lutaml/key_value/adapter/yaml/yeptris_adapter.rb +15 -0
- data/lib/lutaml/key_value/adapter/yaml.rb +17 -0
- data/lib/lutaml/key_value/adapter/yamls/document.rb +16 -0
- data/lib/lutaml/key_value/adapter/yamls/mapping.rb +17 -0
- data/lib/lutaml/key_value/adapter/yamls/mapping_rule.rb +9 -0
- data/lib/lutaml/key_value/adapter/yamls/standard_adapter.rb +37 -0
- data/lib/lutaml/key_value/adapter/yamls/transform.rb +26 -0
- data/lib/lutaml/key_value/adapter/yamls.rb +17 -0
- data/lib/lutaml/key_value/adapter.rb +14 -0
- data/lib/lutaml/key_value/data_model/element.rb +225 -0
- data/lib/lutaml/key_value/data_model.rb +14 -0
- data/lib/lutaml/key_value/document.rb +28 -0
- data/lib/lutaml/key_value/format.rb +26 -0
- data/lib/lutaml/key_value/mapping.rb +393 -0
- data/lib/lutaml/key_value/mapping_rule.rb +95 -0
- data/lib/lutaml/key_value/transform.rb +1223 -0
- data/lib/lutaml/key_value/transformation/collection_serializer.rb +572 -0
- data/lib/lutaml/key_value/transformation/rule_compiler.rb +299 -0
- data/lib/lutaml/key_value/transformation/value_serializer.rb +399 -0
- data/lib/lutaml/key_value/transformation.rb +1276 -0
- data/lib/lutaml/key_value/transformation_builder.rb +30 -0
- data/lib/lutaml/key_value.rb +7 -0
- data/lib/lutaml/lml/association_label_resolver.rb +52 -0
- data/lib/lutaml/lml/cli.rb +506 -0
- data/lib/lutaml/lml/data_processor/attribute_processing.rb +133 -0
- data/lib/lutaml/lml/data_processor/collection_processing.rb +37 -0
- data/lib/lutaml/lml/data_processor/instance_processing.rb +77 -0
- data/lib/lutaml/lml/data_processor/value_declaration_processing.rb +70 -0
- data/lib/lutaml/lml/data_processor/value_processing.rb +103 -0
- data/lib/lutaml/lml/data_processor/view_processing.rb +26 -0
- data/lib/lutaml/lml/data_processor.rb +59 -0
- data/lib/lutaml/lml/diagnostic.rb +149 -0
- data/lib/lutaml/lml/document_builder.rb +481 -0
- data/lib/lutaml/lml/entity_types.rb +30 -0
- data/lib/lutaml/lml/executor/adapter_helpers.rb +45 -0
- data/lib/lutaml/lml/executor/condition_evaluator.rb +169 -0
- data/lib/lutaml/lml/executor/csv_adapter.rb +88 -0
- data/lib/lutaml/lml/executor/format_adapter.rb +54 -0
- data/lib/lutaml/lml/executor/xml_adapter.rb +102 -0
- data/lib/lutaml/lml/executor.rb +96 -0
- data/lib/lutaml/lml/format/adapter/document.rb +11 -0
- data/lib/lutaml/lml/format/adapter/mapping.rb +31 -0
- data/lib/lutaml/lml/format/adapter/standard_adapter.rb +162 -0
- data/lib/lutaml/lml/format/adapter/transform.rb +11 -0
- data/lib/lutaml/lml/format.rb +29 -0
- data/lib/lutaml/lml/formatter/base.rb +79 -0
- data/lib/lutaml/lml/formatter/canonical.rb +736 -0
- data/lib/lutaml/lml/formatter/elk.rb +45 -0
- data/lib/lutaml/lml/formatter/svg_pdf/path_parser.rb +134 -0
- data/lib/lutaml/lml/formatter/svg_pdf.rb +285 -0
- data/lib/lutaml/lml/formatter.rb +11 -0
- data/lib/lutaml/lml/grammar/lml.artifact.json +14993 -0
- data/lib/lutaml/lml/grammar/lml.parg +389 -0
- data/lib/lutaml/lml/grammar.rb +60 -0
- data/lib/lutaml/lml/has_attributes.rb +14 -0
- data/lib/lutaml/lml/import_resolver.rb +96 -0
- data/lib/lutaml/lml/layout/elk_engine.rb +15 -0
- data/lib/lutaml/lml/layout/elk_graph_builder.rb +129 -0
- data/lib/lutaml/lml/layout/elk_svg_markers.rb +45 -0
- data/lib/lutaml/lml/layout/elk_svg_renderer.rb +119 -0
- data/lib/lutaml/lml/layout/engine.rb +17 -0
- data/lib/lutaml/lml/layout.rb +12 -0
- data/lib/lutaml/lml/literal_value.rb +32 -0
- data/lib/lutaml/lml/lsp/conversions.rb +78 -0
- data/lib/lutaml/lml/lsp/keywords.rb +43 -0
- data/lib/lutaml/lml/lsp/server.rb +378 -0
- data/lib/lutaml/lml/lsp/store.rb +68 -0
- data/lib/lutaml/lml/lsp/transport.rb +53 -0
- data/lib/lutaml/lml/lsp.rb +16 -0
- data/lib/lutaml/lml/model_compiler/enums.rb +172 -0
- data/lib/lutaml/lml/model_compiler/hydration.rb +123 -0
- data/lib/lutaml/lml/model_compiler/serialization_mappings.rb +188 -0
- data/lib/lutaml/lml/model_compiler/string_formats.rb +42 -0
- data/lib/lutaml/lml/model_compiler/validation.rb +65 -0
- data/lib/lutaml/lml/model_compiler.rb +323 -0
- data/lib/lutaml/lml/models/action.rb +10 -0
- data/lib/lutaml/lml/models/association.rb +29 -0
- data/lib/lutaml/lml/models/cardinality.rb +10 -0
- data/lib/lutaml/lml/models/collection.rb +11 -0
- data/lib/lutaml/lml/models/constraint.rb +23 -0
- data/lib/lutaml/lml/models/data_type.rb +41 -0
- data/lib/lutaml/lml/models/derived_field.rb +14 -0
- data/lib/lutaml/lml/models/diagram.rb +20 -0
- data/lib/lutaml/lml/models/document.rb +84 -0
- data/lib/lutaml/lml/models/enum.rb +38 -0
- data/lib/lutaml/lml/models/fidelity.rb +10 -0
- data/lib/lutaml/lml/models/group.rb +11 -0
- data/lib/lutaml/lml/models/instance.rb +26 -0
- data/lib/lutaml/lml/models/instance_collection.rb +16 -0
- data/lib/lutaml/lml/models/instances_export.rb +10 -0
- data/lib/lutaml/lml/models/instances_import.rb +11 -0
- data/lib/lutaml/lml/models/mapping.rb +15 -0
- data/lib/lutaml/lml/models/mapping_rule.rb +16 -0
- data/lib/lutaml/lml/models/member_field.rb +14 -0
- data/lib/lutaml/lml/models/namespace.rb +16 -0
- data/lib/lutaml/lml/models/operation.rb +26 -0
- data/lib/lutaml/lml/models/operation_parameter.rb +12 -0
- data/lib/lutaml/lml/models/package.rb +26 -0
- data/lib/lutaml/lml/models/primitive_type.rb +33 -0
- data/lib/lutaml/lml/models/reference.rb +23 -0
- data/lib/lutaml/lml/models/serialization_mapping.rb +19 -0
- data/lib/lutaml/lml/models/string_format.rb +16 -0
- data/lib/lutaml/lml/models/top_element_attribute.rb +116 -0
- data/lib/lutaml/lml/models/uml_class.rb +85 -0
- data/lib/lutaml/lml/models/value.rb +15 -0
- data/lib/lutaml/lml/models/view_filter.rb +11 -0
- data/lib/lutaml/lml/models/view_import.rb +11 -0
- data/lib/lutaml/lml/parser.rb +19 -0
- data/lib/lutaml/lml/pipeline.rb +73 -0
- data/lib/lutaml/lml/positioned.rb +13 -0
- data/lib/lutaml/lml/preprocessor.rb +130 -0
- data/lib/lutaml/lml/quoting.rb +60 -0
- data/lib/lutaml/lml/source.rb +49 -0
- data/lib/lutaml/lml/source_position.rb +20 -0
- data/lib/lutaml/lml/symbol_index.rb +200 -0
- data/lib/lutaml/lml/transform.rb +119 -0
- data/lib/lutaml/lml/types/text_type.rb +28 -0
- data/lib/lutaml/lml/types.rb +10 -0
- data/lib/lutaml/lml/validator.rb +458 -0
- data/lib/lutaml/lml/version.rb +10 -0
- data/lib/lutaml/lml/view_resolution.rb +32 -0
- data/lib/lutaml/lml/view_resolver.rb +48 -0
- data/lib/lutaml/lml/yaml_parser.rb +17 -0
- data/lib/lutaml/lml.rb +130 -0
- data/lib/lutaml/model/adapter_resolver.rb +487 -0
- data/lib/lutaml/model/adapter_scope.rb +64 -0
- data/lib/lutaml/model/attribute.rb +1511 -0
- data/lib/lutaml/model/attribute_validator.rb +290 -0
- data/lib/lutaml/model/cached_type_resolver/concurrent_map_cache.rb +48 -0
- data/lib/lutaml/model/cached_type_resolver/mutex_hash_cache.rb +53 -0
- data/lib/lutaml/model/cached_type_resolver.rb +145 -0
- data/lib/lutaml/model/choice.rb +343 -0
- data/lib/lutaml/model/cli.rb +85 -0
- data/lib/lutaml/model/collection.rb +740 -0
- data/lib/lutaml/model/collection_handler.rb +157 -0
- data/lib/lutaml/model/comparable_model.rb +710 -0
- data/lib/lutaml/model/comparable_nil.rb +9 -0
- data/lib/lutaml/model/comparison.rb +15 -0
- data/lib/lutaml/model/compiled_rule.rb +242 -0
- data/lib/lutaml/model/config.rb +169 -0
- data/lib/lutaml/model/configuration.rb +138 -0
- data/lib/lutaml/model/consolidation/attribute_grouper.rb +44 -0
- data/lib/lutaml/model/consolidation/dispatcher.rb +45 -0
- data/lib/lutaml/model/consolidation/engine.rb +33 -0
- data/lib/lutaml/model/consolidation/pattern_chunker.rb +87 -0
- data/lib/lutaml/model/consolidation_map.rb +68 -0
- data/lib/lutaml/model/consolidation_rule/dispatch_block.rb +34 -0
- data/lib/lutaml/model/consolidation_rule/gather_rule.rb +17 -0
- data/lib/lutaml/model/consolidation_rule/pattern_content_rule.rb +15 -0
- data/lib/lutaml/model/consolidation_rule/pattern_element_rule.rb +17 -0
- data/lib/lutaml/model/consolidation_rule.rb +27 -0
- data/lib/lutaml/model/constants.rb +11 -0
- data/lib/lutaml/model/context_registry.rb +208 -0
- data/lib/lutaml/model/deep_dupable.rb +16 -0
- data/lib/lutaml/model/error/choice_lower_bound_error.rb +9 -0
- data/lib/lutaml/model/error/choice_upper_bound_error.rb +9 -0
- data/lib/lutaml/model/error/collection_count_out_of_range_error.rb +29 -0
- data/lib/lutaml/model/error/collection_true_missing_error.rb +16 -0
- data/lib/lutaml/model/error/element_count_out_of_range_error.rb +35 -0
- data/lib/lutaml/model/error/format_adapter_not_specified_error.rb +25 -0
- data/lib/lutaml/model/error/fraction_digits_error.rb +20 -0
- data/lib/lutaml/model/error/import_model_with_root_error.rb +9 -0
- data/lib/lutaml/model/error/incorrect_mapping_argument_error.rb +6 -0
- data/lib/lutaml/model/error/incorrect_sequence_error.rb +9 -0
- data/lib/lutaml/model/error/invalid_attribute_name_error.rb +15 -0
- data/lib/lutaml/model/error/invalid_attribute_options_error.rb +16 -0
- data/lib/lutaml/model/error/invalid_attribute_type_error.rb +98 -0
- data/lib/lutaml/model/error/invalid_choice_range_error.rb +18 -0
- data/lib/lutaml/model/error/invalid_format_error.rb +11 -0
- data/lib/lutaml/model/error/invalid_value_error.rb +18 -0
- data/lib/lutaml/model/error/length_error.rb +19 -0
- data/lib/lutaml/model/error/liquid_class_not_found_error.rb +9 -0
- data/lib/lutaml/model/error/liquid_drop_already_registered_error.rb +11 -0
- data/lib/lutaml/model/error/liquid_not_enabled_error.rb +9 -0
- data/lib/lutaml/model/error/mapping_already_exists_error.rb +6 -0
- data/lib/lutaml/model/error/mapping_attribute_missing_error.rb +6 -0
- data/lib/lutaml/model/error/mapping_attribute_type_error.rb +6 -0
- data/lib/lutaml/model/error/max_exclusive_error.rb +19 -0
- data/lib/lutaml/model/error/max_inclusive_error.rb +20 -0
- data/lib/lutaml/model/error/max_length_error.rb +20 -0
- data/lib/lutaml/model/error/min_exclusive_error.rb +19 -0
- data/lib/lutaml/model/error/min_inclusive_error.rb +20 -0
- data/lib/lutaml/model/error/min_length_error.rb +20 -0
- data/lib/lutaml/model/error/mixed_content_collection_error.rb +17 -0
- data/lib/lutaml/model/error/multiple_mappings_error.rb +6 -0
- data/lib/lutaml/model/error/no_attributes_defined_liquid_error.rb +9 -0
- data/lib/lutaml/model/error/no_mapping_found_error.rb +9 -0
- data/lib/lutaml/model/error/no_root_mapping_error.rb +10 -0
- data/lib/lutaml/model/error/no_root_namespace_error.rb +10 -0
- data/lib/lutaml/model/error/ordered_content_mapping_error.rb +17 -0
- data/lib/lutaml/model/error/pattern_not_matched_error.rb +17 -0
- data/lib/lutaml/model/error/polymorphic_error.rb +14 -0
- data/lib/lutaml/model/error/register/not_registrable_class_error.rb +11 -0
- data/lib/lutaml/model/error/required_attribute_missing_error.rb +9 -0
- data/lib/lutaml/model/error/restriction_error.rb +8 -0
- data/lib/lutaml/model/error/reverse_transform_block_not_defined_error.rb +6 -0
- data/lib/lutaml/model/error/reverse_transformation_declaration_error.rb +6 -0
- data/lib/lutaml/model/error/sorting_configuration_conflict_error.rb +9 -0
- data/lib/lutaml/model/error/total_digits_error.rb +20 -0
- data/lib/lutaml/model/error/transform_block_not_defined_error.rb +6 -0
- data/lib/lutaml/model/error/type/invalid_value_error.rb +21 -0
- data/lib/lutaml/model/error/type/max_bound_error.rb +20 -0
- data/lib/lutaml/model/error/type/max_exclusive_error.rb +20 -0
- data/lib/lutaml/model/error/type/max_length_error.rb +20 -0
- data/lib/lutaml/model/error/type/min_bound_error.rb +20 -0
- data/lib/lutaml/model/error/type/min_exclusive_error.rb +20 -0
- data/lib/lutaml/model/error/type/min_length_error.rb +20 -0
- data/lib/lutaml/model/error/type/pattern_not_matched_error.rb +18 -0
- data/lib/lutaml/model/error/type.rb +19 -0
- data/lib/lutaml/model/error/type_error.rb +9 -0
- data/lib/lutaml/model/error/type_not_enabled_error.rb +9 -0
- data/lib/lutaml/model/error/type_only_mapping_error.rb +13 -0
- data/lib/lutaml/model/error/type_only_namespace_error.rb +12 -0
- data/lib/lutaml/model/error/undefined_attribute_error.rb +9 -0
- data/lib/lutaml/model/error/union_schema_unsupported_error.rb +11 -0
- data/lib/lutaml/model/error/unknown_adapter_type_error.rb +95 -0
- data/lib/lutaml/model/error/unknown_discriminator_error.rb +11 -0
- data/lib/lutaml/model/error/unknown_mapping_error.rb +18 -0
- data/lib/lutaml/model/error/unknown_sequence_mapping_error.rb +9 -0
- data/lib/lutaml/model/error/unknown_type_error.rb +32 -0
- data/lib/lutaml/model/error/unresolvable_type_error.rb +27 -0
- data/lib/lutaml/model/error/unsupported_version_error.rb +14 -0
- data/lib/lutaml/model/error/validation_error.rb +20 -0
- data/lib/lutaml/model/error/validation_failed_error.rb +9 -0
- data/lib/lutaml/model/error.rb +8 -0
- data/lib/lutaml/model/errors.rb +38 -0
- data/lib/lutaml/model/evolution_steps.rb +85 -0
- data/lib/lutaml/model/finalization_cache.rb +51 -0
- data/lib/lutaml/model/format_registry.rb +218 -0
- data/lib/lutaml/model/global_context.rb +476 -0
- data/lib/lutaml/model/global_register.rb +142 -0
- data/lib/lutaml/model/hash.rb +15 -0
- data/lib/lutaml/model/import_registry.rb +250 -0
- data/lib/lutaml/model/instrumentation.rb +304 -0
- data/lib/lutaml/model/json.rb +25 -0
- data/lib/lutaml/model/json_adapter.rb +8 -0
- data/lib/lutaml/model/jsonl.rb +15 -0
- data/lib/lutaml/model/liquefiable.rb +198 -0
- data/lib/lutaml/model/liquid/indexed_access.rb +33 -0
- data/lib/lutaml/model/liquid/mapping.rb +30 -0
- data/lib/lutaml/model/liquid.rb +10 -0
- data/lib/lutaml/model/lml/document.rb +109 -0
- data/lib/lutaml/model/lml/exporter.rb +328 -0
- data/lib/lutaml/model/lml/rejected_error.rb +32 -0
- data/lib/lutaml/model/lml/round_trip.rb +49 -0
- data/lib/lutaml/model/lml.rb +40 -0
- data/lib/lutaml/model/mapping/listener.rb +126 -0
- data/lib/lutaml/model/mapping/mapping.rb +209 -0
- data/lib/lutaml/model/mapping/mapping_rule.rb +673 -0
- data/lib/lutaml/model/mapping/model_mapping.rb +133 -0
- data/lib/lutaml/model/mapping/model_mapping_rule.rb +57 -0
- data/lib/lutaml/model/mapping_hash.rb +80 -0
- data/lib/lutaml/model/model_transformer.rb +101 -0
- data/lib/lutaml/model/one_entry_cache.rb +57 -0
- data/lib/lutaml/model/organization.rb +29 -0
- data/lib/lutaml/model/register/model_tree_importer.rb +88 -0
- data/lib/lutaml/model/register/namespace_binding.rb +92 -0
- data/lib/lutaml/model/register.rb +589 -0
- data/lib/lutaml/model/registrable.rb +8 -0
- data/lib/lutaml/model/render_policy.rb +166 -0
- data/lib/lutaml/model/restriction_validation.rb +437 -0
- data/lib/lutaml/model/runtime_compatibility.rb +144 -0
- data/lib/lutaml/model/schema/base_schema.rb +77 -0
- data/lib/lutaml/model/schema/class_loader.rb +59 -0
- data/lib/lutaml/model/schema/compiled_output.rb +83 -0
- data/lib/lutaml/model/schema/decorators/attribute.rb +116 -0
- data/lib/lutaml/model/schema/decorators/choices.rb +29 -0
- data/lib/lutaml/model/schema/decorators/class_definition.rb +84 -0
- data/lib/lutaml/model/schema/decorators/definition_collection.rb +97 -0
- data/lib/lutaml/model/schema/decorators.rb +15 -0
- data/lib/lutaml/model/schema/definitions/attribute.rb +32 -0
- data/lib/lutaml/model/schema/definitions/choice.rb +20 -0
- data/lib/lutaml/model/schema/definitions/facet.rb +40 -0
- data/lib/lutaml/model/schema/definitions/group_import.rb +22 -0
- data/lib/lutaml/model/schema/definitions/member_walk.rb +33 -0
- data/lib/lutaml/model/schema/definitions/model.rb +40 -0
- data/lib/lutaml/model/schema/definitions/namespace.rb +24 -0
- data/lib/lutaml/model/schema/definitions/restricted_type.rb +32 -0
- data/lib/lutaml/model/schema/definitions/sequence.rb +19 -0
- data/lib/lutaml/model/schema/definitions/simple_content.rb +22 -0
- data/lib/lutaml/model/schema/definitions/transform_facet.rb +21 -0
- data/lib/lutaml/model/schema/definitions/type_ref.rb +20 -0
- data/lib/lutaml/model/schema/definitions/union_type.rb +28 -0
- data/lib/lutaml/model/schema/definitions/xml_root.rb +20 -0
- data/lib/lutaml/model/schema/definitions.rb +24 -0
- data/lib/lutaml/model/schema/file_writer.rb +73 -0
- data/lib/lutaml/model/schema/generator/definition.rb +98 -0
- data/lib/lutaml/model/schema/generator/definitions_collection.rb +117 -0
- data/lib/lutaml/model/schema/generator/properties_collection.rb +65 -0
- data/lib/lutaml/model/schema/generator/property.rb +182 -0
- data/lib/lutaml/model/schema/generator/ref.rb +24 -0
- data/lib/lutaml/model/schema/generator.rb +15 -0
- data/lib/lutaml/model/schema/helpers/template_helper.rb +49 -0
- data/lib/lutaml/model/schema/helpers.rb +11 -0
- data/lib/lutaml/model/schema/json_schema.rb +17 -0
- data/lib/lutaml/model/schema/json_schema_parser.rb +91 -0
- data/lib/lutaml/model/schema/module_nesting.rb +31 -0
- data/lib/lutaml/model/schema/namespace_naming.rb +46 -0
- data/lib/lutaml/model/schema/registry_generator.rb +115 -0
- data/lib/lutaml/model/schema/renderer.rb +38 -0
- data/lib/lutaml/model/schema/renderers/base.rb +41 -0
- data/lib/lutaml/model/schema/renderers/mappings.rb +78 -0
- data/lib/lutaml/model/schema/renderers/member_decls.rb +121 -0
- data/lib/lutaml/model/schema/renderers/model.rb +133 -0
- data/lib/lutaml/model/schema/renderers/namespace.rb +30 -0
- data/lib/lutaml/model/schema/renderers/registration.rb +64 -0
- data/lib/lutaml/model/schema/renderers/required_files_calculator.rb +94 -0
- data/lib/lutaml/model/schema/renderers/restricted_type.rb +218 -0
- data/lib/lutaml/model/schema/renderers/union.rb +83 -0
- data/lib/lutaml/model/schema/renderers.rb +20 -0
- data/lib/lutaml/model/schema/rnc_compiler/source_resolver.rb +51 -0
- data/lib/lutaml/model/schema/rnc_compiler.rb +64 -0
- data/lib/lutaml/model/schema/rng_compiler/define_classifier.rb +94 -0
- data/lib/lutaml/model/schema/rng_compiler/element_visitor.rb +412 -0
- data/lib/lutaml/model/schema/rng_compiler/member_collector.rb +30 -0
- data/lib/lutaml/model/schema/rng_compiler/rng_helpers.rb +160 -0
- data/lib/lutaml/model/schema/rng_compiler/value_type_resolver.rb +129 -0
- data/lib/lutaml/model/schema/rng_compiler.rb +225 -0
- data/lib/lutaml/model/schema/schema_builder/nokogiri.rb +41 -0
- data/lib/lutaml/model/schema/schema_builder/oga.rb +92 -0
- data/lib/lutaml/model/schema/shared_methods.rb +24 -0
- data/lib/lutaml/model/schema/templates/model.erb +9 -0
- data/lib/lutaml/model/schema/templates.rb +164 -0
- data/lib/lutaml/model/schema/xml_compiler/element_order.rb +42 -0
- data/lib/lutaml/model/schema/xml_compiler/registry_generator.rb +51 -0
- data/lib/lutaml/model/schema/xml_compiler/spec_builder/complex_types.rb +198 -0
- data/lib/lutaml/model/schema/xml_compiler/spec_builder/members.rb +249 -0
- data/lib/lutaml/model/schema/xml_compiler/spec_builder/simple_types.rb +185 -0
- data/lib/lutaml/model/schema/xml_compiler/spec_builder.rb +186 -0
- data/lib/lutaml/model/schema/xml_compiler/supported_data_types.rb +100 -0
- data/lib/lutaml/model/schema/xml_compiler.rb +109 -0
- data/lib/lutaml/model/schema/yaml_schema.rb +17 -0
- data/lib/lutaml/model/schema.rb +88 -0
- data/lib/lutaml/model/schema_location.rb +18 -0
- data/lib/lutaml/model/sequence.rb +220 -0
- data/lib/lutaml/model/serializable.rb +46 -0
- data/lib/lutaml/model/serialization_adapter.rb +24 -0
- data/lib/lutaml/model/serialize/attribute_definition.rb +897 -0
- data/lib/lutaml/model/serialize/builder.rb +258 -0
- data/lib/lutaml/model/serialize/conversion_caching.rb +129 -0
- data/lib/lutaml/model/serialize/deserialization_context.rb +51 -0
- data/lib/lutaml/model/serialize/enum_handling.rb +171 -0
- data/lib/lutaml/model/serialize/format_conversion.rb +624 -0
- data/lib/lutaml/model/serialize/initialization.rb +825 -0
- data/lib/lutaml/model/serialize/model_import.rb +425 -0
- data/lib/lutaml/model/serialize/transformation_builder.rb +128 -0
- data/lib/lutaml/model/serialize/value_mapping.rb +173 -0
- data/lib/lutaml/model/serialize.rb +533 -0
- data/lib/lutaml/model/services/base.rb +13 -0
- data/lib/lutaml/model/services/logger.rb +57 -0
- data/lib/lutaml/model/services/rule_value_extractor.rb +95 -0
- data/lib/lutaml/model/services/transformer.rb +143 -0
- data/lib/lutaml/model/services/type/validator/number.rb +25 -0
- data/lib/lutaml/model/services/type/validator/string.rb +53 -0
- data/lib/lutaml/model/services/type/validator/symbol.rb +30 -0
- data/lib/lutaml/model/services/type/validator.rb +69 -0
- data/lib/lutaml/model/services/type.rb +9 -0
- data/lib/lutaml/model/services/validator.rb +143 -0
- data/lib/lutaml/model/services.rb +10 -0
- data/lib/lutaml/model/store.rb +239 -0
- data/lib/lutaml/model/toml.rb +40 -0
- data/lib/lutaml/model/transform/xml_transform.rb +5 -0
- data/lib/lutaml/model/transform.rb +229 -0
- data/lib/lutaml/model/transformation.rb +89 -0
- data/lib/lutaml/model/transformation_builder.rb +55 -0
- data/lib/lutaml/model/transformation_registry.rb +327 -0
- data/lib/lutaml/model/type/base64_binary.rb +58 -0
- data/lib/lutaml/model/type/boolean.rb +35 -0
- data/lib/lutaml/model/type/date.rb +75 -0
- data/lib/lutaml/model/type/date_time.rb +60 -0
- data/lib/lutaml/model/type/date_time_with_timezone.rb +28 -0
- data/lib/lutaml/model/type/date_with_timezone.rb +28 -0
- data/lib/lutaml/model/type/day_time_duration.rb +35 -0
- data/lib/lutaml/model/type/decimal.rb +64 -0
- data/lib/lutaml/model/type/duration.rb +82 -0
- data/lib/lutaml/model/type/email_address.rb +28 -0
- data/lib/lutaml/model/type/float.rb +33 -0
- data/lib/lutaml/model/type/hash.rb +74 -0
- data/lib/lutaml/model/type/hex_binary.rb +56 -0
- data/lib/lutaml/model/type/hostname.rb +30 -0
- data/lib/lutaml/model/type/integer.rb +62 -0
- data/lib/lutaml/model/type/ip_v4_address.rb +27 -0
- data/lib/lutaml/model/type/ip_v6_address.rb +47 -0
- data/lib/lutaml/model/type/metaschema_pattern.rb +34 -0
- data/lib/lutaml/model/type/non_negative_integer.rb +25 -0
- data/lib/lutaml/model/type/positive_integer.rb +25 -0
- data/lib/lutaml/model/type/qname.rb +85 -0
- data/lib/lutaml/model/type/reference.rb +76 -0
- data/lib/lutaml/model/type/string.rb +62 -0
- data/lib/lutaml/model/type/symbol.rb +67 -0
- data/lib/lutaml/model/type/time.rb +52 -0
- data/lib/lutaml/model/type/time_without_date.rb +50 -0
- data/lib/lutaml/model/type/token.rb +25 -0
- data/lib/lutaml/model/type/uninitialized_class_guard.rb +36 -0
- data/lib/lutaml/model/type/uri.rb +51 -0
- data/lib/lutaml/model/type/uri_reference.rb +29 -0
- data/lib/lutaml/model/type/uuid.rb +25 -0
- data/lib/lutaml/model/type/value.rb +364 -0
- data/lib/lutaml/model/type/year_month_duration.rb +29 -0
- data/lib/lutaml/model/type.rb +199 -0
- data/lib/lutaml/model/type_context.rb +294 -0
- data/lib/lutaml/model/type_registry.rb +165 -0
- data/lib/lutaml/model/type_resolver.rb +187 -0
- data/lib/lutaml/model/type_substitution.rb +117 -0
- data/lib/lutaml/model/uninitialized_class.rb +70 -0
- data/lib/lutaml/model/union.rb +363 -0
- data/lib/lutaml/model/utils.rb +352 -0
- data/lib/lutaml/model/validation/concerns/has_issues.rb +27 -0
- data/lib/lutaml/model/validation/context.rb +36 -0
- data/lib/lutaml/model/validation/issue.rb +62 -0
- data/lib/lutaml/model/validation/layer_result.rb +34 -0
- data/lib/lutaml/model/validation/profile.rb +66 -0
- data/lib/lutaml/model/validation/registry.rb +60 -0
- data/lib/lutaml/model/validation/remediation.rb +33 -0
- data/lib/lutaml/model/validation/remediation_result.rb +20 -0
- data/lib/lutaml/model/validation/report.rb +39 -0
- data/lib/lutaml/model/validation/rule.rb +59 -0
- data/lib/lutaml/model/validation.rb +137 -0
- data/lib/lutaml/model/validation_framework.rb +77 -0
- data/lib/lutaml/model/value_policy.rb +27 -0
- data/lib/lutaml/model/value_transformer.rb +25 -0
- data/lib/lutaml/model/version.rb +7 -0
- data/lib/lutaml/model/yaml.rb +15 -0
- data/lib/lutaml/model/yamls.rb +15 -0
- data/lib/lutaml/model.rb +309 -0
- data/lib/lutaml/rdf/context.rb +69 -0
- data/lib/lutaml/rdf/error.rb +7 -0
- data/lib/lutaml/rdf/iri.rb +44 -0
- data/lib/lutaml/rdf/language_tagged.rb +11 -0
- data/lib/lutaml/rdf/linked_data_transform.rb +249 -0
- data/lib/lutaml/rdf/literal.rb +62 -0
- data/lib/lutaml/rdf/mapping.rb +86 -0
- data/lib/lutaml/rdf/mapping_rule.rb +52 -0
- data/lib/lutaml/rdf/member_rule.rb +55 -0
- data/lib/lutaml/rdf/namespace.rb +58 -0
- data/lib/lutaml/rdf/namespace_set.rb +69 -0
- data/lib/lutaml/rdf/namespaces/dcterms_namespace.rb +12 -0
- data/lib/lutaml/rdf/namespaces/owl_namespace.rb +12 -0
- data/lib/lutaml/rdf/namespaces/rdf_namespace.rb +14 -0
- data/lib/lutaml/rdf/namespaces/rdfs_namespace.rb +12 -0
- data/lib/lutaml/rdf/namespaces/skos_namespace.rb +12 -0
- data/lib/lutaml/rdf/namespaces/xsd_namespace.rb +12 -0
- data/lib/lutaml/rdf/namespaces.rb +14 -0
- data/lib/lutaml/rdf/term_definition.rb +39 -0
- data/lib/lutaml/rdf/transform.rb +45 -0
- data/lib/lutaml/rdf.rb +22 -0
- data/lib/lutaml/toml/adapter/document.rb +10 -0
- data/lib/lutaml/toml/adapter/mapping.rb +26 -0
- data/lib/lutaml/toml/adapter/mapping_rule.rb +9 -0
- data/lib/lutaml/toml/adapter/teptris_adapter.rb +14 -0
- data/lib/lutaml/toml/adapter/toml_rb_adapter.rb +32 -0
- data/lib/lutaml/toml/adapter/tomlib_adapter.rb +48 -0
- data/lib/lutaml/toml/adapter/transform.rb +9 -0
- data/lib/lutaml/toml/adapter.rb +20 -0
- data/lib/lutaml/toml/format.rb +48 -0
- data/lib/lutaml/toml/type/serializers.rb +71 -0
- data/lib/lutaml/toml.rb +7 -0
- data/lib/lutaml/turtle/adapter.rb +35 -0
- data/lib/lutaml/turtle/mapping.rb +7 -0
- data/lib/lutaml/turtle/transform.rb +250 -0
- data/lib/lutaml/turtle.rb +22 -0
- data/lib/lutaml/version.rb +1 -1
- data/lib/lutaml/xml/adapter/adapter_helpers.rb +108 -0
- data/lib/lutaml/xml/adapter/base_adapter.rb +249 -0
- data/lib/lutaml/xml/adapter/leptris_adapter.rb +16 -0
- data/lib/lutaml/xml/adapter/namespace_data.rb +56 -0
- data/lib/lutaml/xml/adapter/namespace_uri_collector.rb +71 -0
- data/lib/lutaml/xml/adapter/nokogiri_adapter.rb +16 -0
- data/lib/lutaml/xml/adapter/oga_adapter.rb +20 -0
- data/lib/lutaml/xml/adapter/ox_adapter.rb +16 -0
- data/lib/lutaml/xml/adapter/plan_based_builder.rb +944 -0
- data/lib/lutaml/xml/adapter/rexml_adapter.rb +25 -0
- data/lib/lutaml/xml/adapter/xml_parser.rb +89 -0
- data/lib/lutaml/xml/adapter/xml_serializer.rb +334 -0
- data/lib/lutaml/xml/adapter.rb +24 -0
- data/lib/lutaml/xml/adapter_element.rb +339 -0
- data/lib/lutaml/xml/adapter_loader.rb +56 -0
- data/lib/lutaml/xml/attribute_namespace_resolver.rb +139 -0
- data/lib/lutaml/xml/blank_namespace.rb +51 -0
- data/lib/lutaml/xml/blank_namespace_handler.rb +50 -0
- data/lib/lutaml/xml/builder/base.rb +258 -0
- data/lib/lutaml/xml/builder/leptris.rb +13 -0
- data/lib/lutaml/xml/builder/nokogiri.rb +13 -0
- data/lib/lutaml/xml/builder/oga.rb +13 -0
- data/lib/lutaml/xml/builder/ox.rb +13 -0
- data/lib/lutaml/xml/builder/rexml.rb +13 -0
- data/lib/lutaml/xml/builder.rb +18 -0
- data/lib/lutaml/xml/configurable.rb +215 -0
- data/lib/lutaml/xml/data_model.rb +295 -0
- data/lib/lutaml/xml/decisions/decision.rb +120 -0
- data/lib/lutaml/xml/decisions/decision_context.rb +225 -0
- data/lib/lutaml/xml/decisions/decision_engine.rb +67 -0
- data/lib/lutaml/xml/decisions/decision_rule.rb +54 -0
- data/lib/lutaml/xml/decisions/element_prefix_resolver.rb +85 -0
- data/lib/lutaml/xml/decisions/rules/attribute_usage_rule.rb +37 -0
- data/lib/lutaml/xml/decisions/rules/default_preference_rule.rb +62 -0
- data/lib/lutaml/xml/decisions/rules/element_form_default_rule.rb +66 -0
- data/lib/lutaml/xml/decisions/rules/element_form_default_unqualified_rule.rb +73 -0
- data/lib/lutaml/xml/decisions/rules/element_form_option_rule.rb +83 -0
- data/lib/lutaml/xml/decisions/rules/explicit_option_rule.rb +57 -0
- data/lib/lutaml/xml/decisions/rules/format_preservation_rule.rb +74 -0
- data/lib/lutaml/xml/decisions/rules/hoisted_on_parent_rule.rb +60 -0
- data/lib/lutaml/xml/decisions/rules/inherit_from_parent_rule.rb +52 -0
- data/lib/lutaml/xml/decisions/rules/inherit_parent_prefix_rule.rb +69 -0
- data/lib/lutaml/xml/decisions/rules/namespace_scope_rule.rb +54 -0
- data/lib/lutaml/xml/decisions/rules/reuse_parent_prefix_rule.rb +78 -0
- data/lib/lutaml/xml/decisions/rules/used_prefix_rule.rb +70 -0
- data/lib/lutaml/xml/decisions/rules.rb +39 -0
- data/lib/lutaml/xml/decisions.rb +15 -0
- data/lib/lutaml/xml/declaration_handler.rb +115 -0
- data/lib/lutaml/xml/declaration_plan/attribute_node.rb +81 -0
- data/lib/lutaml/xml/declaration_plan/element_node.rb +101 -0
- data/lib/lutaml/xml/declaration_plan.rb +480 -0
- data/lib/lutaml/xml/declaration_plan_query.rb +105 -0
- data/lib/lutaml/xml/declaration_planner.rb +1914 -0
- data/lib/lutaml/xml/doctype_extractor.rb +51 -0
- data/lib/lutaml/xml/document.rb +385 -0
- data/lib/lutaml/xml/element.rb +108 -0
- data/lib/lutaml/xml/element_prefix_resolver.rb +50 -0
- data/lib/lutaml/xml/encoding_normalizer.rb +54 -0
- data/lib/lutaml/xml/error/invalid_namespace_error.rb +46 -0
- data/lib/lutaml/xml/error/invalid_xsd_type_error.rb +43 -0
- data/lib/lutaml/xml/error/namespace_mismatch_error.rb +53 -0
- data/lib/lutaml/xml/error/schema_validation_error.rb +25 -0
- data/lib/lutaml/xml/error/xml_configuration_error.rb +17 -0
- data/lib/lutaml/xml/error/xml_error.rb +21 -0
- data/lib/lutaml/xml/format.rb +364 -0
- data/lib/lutaml/xml/format_chooser.rb +214 -0
- data/lib/lutaml/xml/hoisting_algorithm.rb +234 -0
- data/lib/lutaml/xml/html_entities.rb +290 -0
- data/lib/lutaml/xml/leptris/element.rb +34 -0
- data/lib/lutaml/xml/leptris/native_emission.rb +295 -0
- data/lib/lutaml/xml/leptris/plan_compiler.rb +652 -0
- data/lib/lutaml/xml/leptris/plan_hydrator.rb +827 -0
- data/lib/lutaml/xml/leptris/plan_order.rb +72 -0
- data/lib/lutaml/xml/leptris/plan_serializer.rb +711 -0
- data/lib/lutaml/xml/leptris/plan_walk.rb +36 -0
- data/lib/lutaml/xml/leptris.rb +48 -0
- data/lib/lutaml/xml/listener.rb +33 -0
- data/lib/lutaml/xml/mapping.rb +1746 -0
- data/lib/lutaml/xml/mapping_rule.rb +688 -0
- data/lib/lutaml/xml/model_transform.rb +1824 -0
- data/lib/lutaml/xml/namespace.rb +445 -0
- data/lib/lutaml/xml/namespace_class_registry.rb +144 -0
- data/lib/lutaml/xml/namespace_collector.rb +649 -0
- data/lib/lutaml/xml/namespace_declaration.rb +202 -0
- data/lib/lutaml/xml/namespace_declaration_builder.rb +67 -0
- data/lib/lutaml/xml/namespace_declaration_data.rb +179 -0
- data/lib/lutaml/xml/namespace_inheritance_resolver.rb +142 -0
- data/lib/lutaml/xml/namespace_inheritance_strategy.rb +26 -0
- data/lib/lutaml/xml/namespace_needs.rb +255 -0
- data/lib/lutaml/xml/namespace_resolution_strategy.rb +230 -0
- data/lib/lutaml/xml/namespace_resolver.rb +219 -0
- data/lib/lutaml/xml/namespace_scope_config.rb +110 -0
- data/lib/lutaml/xml/namespace_type_resolver.rb +135 -0
- data/lib/lutaml/xml/namespace_usage.rb +121 -0
- data/lib/lutaml/xml/nested_collection_attribute.rb +95 -0
- data/lib/lutaml/xml/nokogiri/element.rb +34 -0
- data/lib/lutaml/xml/nokogiri.rb +10 -0
- data/lib/lutaml/xml/oga/element.rb +15 -0
- data/lib/lutaml/xml/oga.rb +10 -0
- data/lib/lutaml/xml/ox/element.rb +15 -0
- data/lib/lutaml/xml/ox.rb +10 -0
- data/lib/lutaml/xml/parse_session.rb +139 -0
- data/lib/lutaml/xml/parsed_namespace_declaration.rb +129 -0
- data/lib/lutaml/xml/parsed_namespace_set.rb +149 -0
- data/lib/lutaml/xml/polymorphic_value_handler.rb +41 -0
- data/lib/lutaml/xml/qualified_inheritance_strategy.rb +27 -0
- data/lib/lutaml/xml/rexml/element.rb +15 -0
- data/lib/lutaml/xml/rexml.rb +10 -0
- data/lib/lutaml/xml/schema/builder/nokogiri.rb +41 -0
- data/lib/lutaml/xml/schema/builder/oga.rb +92 -0
- data/lib/lutaml/xml/schema/builder.rb +59 -0
- data/lib/lutaml/xml/schema/builtin_types.rb +112 -0
- data/lib/lutaml/xml/schema/relaxng_schema.rb +83 -0
- data/lib/lutaml/xml/schema/xsd/all.rb +31 -0
- data/lib/lutaml/xml/schema/xsd/annotation.rb +31 -0
- data/lib/lutaml/xml/schema/xsd/any.rb +33 -0
- data/lib/lutaml/xml/schema/xsd/any_attribute.rb +29 -0
- data/lib/lutaml/xml/schema/xsd/appinfo.rb +25 -0
- data/lib/lutaml/xml/schema/xsd/attribute.rb +78 -0
- data/lib/lutaml/xml/schema/xsd/attribute_group.rb +89 -0
- data/lib/lutaml/xml/schema/xsd/base.rb +270 -0
- data/lib/lutaml/xml/schema/xsd/choice.rb +68 -0
- data/lib/lutaml/xml/schema/xsd/complex_content.rb +39 -0
- data/lib/lutaml/xml/schema/xsd/complex_type.rb +159 -0
- data/lib/lutaml/xml/schema/xsd/documentation.rb +26 -0
- data/lib/lutaml/xml/schema/xsd/element.rb +117 -0
- data/lib/lutaml/xml/schema/xsd/enumeration.rb +25 -0
- data/lib/lutaml/xml/schema/xsd/errors/enhanced_error.rb +142 -0
- data/lib/lutaml/xml/schema/xsd/errors/error_context.rb +67 -0
- data/lib/lutaml/xml/schema/xsd/errors/message_builder.rb +103 -0
- data/lib/lutaml/xml/schema/xsd/errors/suggestion.rb +67 -0
- data/lib/lutaml/xml/schema/xsd/errors/troubleshooters/namespace_troubleshooter.rb +96 -0
- data/lib/lutaml/xml/schema/xsd/errors/troubleshooters/troubleshooting_handler.rb +70 -0
- data/lib/lutaml/xml/schema/xsd/errors.rb +148 -0
- data/lib/lutaml/xml/schema/xsd/extension_complex_content.rb +63 -0
- data/lib/lutaml/xml/schema/xsd/extension_simple_content.rb +48 -0
- data/lib/lutaml/xml/schema/xsd/field.rb +25 -0
- data/lib/lutaml/xml/schema/xsd/file_validation_result.rb +55 -0
- data/lib/lutaml/xml/schema/xsd/fraction_digits.rb +29 -0
- data/lib/lutaml/xml/schema/xsd/glob.rb +105 -0
- data/lib/lutaml/xml/schema/xsd/group.rb +79 -0
- data/lib/lutaml/xml/schema/xsd/import.rb +33 -0
- data/lib/lutaml/xml/schema/xsd/include.rb +31 -0
- data/lib/lutaml/xml/schema/xsd/key.rb +32 -0
- data/lib/lutaml/xml/schema/xsd/keyref.rb +34 -0
- data/lib/lutaml/xml/schema/xsd/length.rb +27 -0
- data/lib/lutaml/xml/schema/xsd/list.rb +29 -0
- data/lib/lutaml/xml/schema/xsd/max_exclusive.rb +25 -0
- data/lib/lutaml/xml/schema/xsd/max_inclusive.rb +23 -0
- data/lib/lutaml/xml/schema/xsd/max_length.rb +25 -0
- data/lib/lutaml/xml/schema/xsd/min_exclusive.rb +25 -0
- data/lib/lutaml/xml/schema/xsd/min_inclusive.rb +23 -0
- data/lib/lutaml/xml/schema/xsd/min_length.rb +25 -0
- data/lib/lutaml/xml/schema/xsd/namespace_mapping.rb +37 -0
- data/lib/lutaml/xml/schema/xsd/namespace_uri_remapping.rb +79 -0
- data/lib/lutaml/xml/schema/xsd/notation.rb +31 -0
- data/lib/lutaml/xml/schema/xsd/pattern.rb +25 -0
- data/lib/lutaml/xml/schema/xsd/redefine.rb +35 -0
- data/lib/lutaml/xml/schema/xsd/restriction_complex_content.rb +56 -0
- data/lib/lutaml/xml/schema/xsd/restriction_simple_content.rb +84 -0
- data/lib/lutaml/xml/schema/xsd/restriction_simple_type.rb +64 -0
- data/lib/lutaml/xml/schema/xsd/schema.rb +379 -0
- data/lib/lutaml/xml/schema/xsd/schema_file_validation_results.rb +55 -0
- data/lib/lutaml/xml/schema/xsd/schema_location_mapping.rb +74 -0
- data/lib/lutaml/xml/schema/xsd/schema_name_resolver.rb +32 -0
- data/lib/lutaml/xml/schema/xsd/schema_path.rb +207 -0
- data/lib/lutaml/xml/schema/xsd/schema_validator.rb +259 -0
- data/lib/lutaml/xml/schema/xsd/selector.rb +27 -0
- data/lib/lutaml/xml/schema/xsd/sequence.rb +68 -0
- data/lib/lutaml/xml/schema/xsd/serialized_schema.rb +185 -0
- data/lib/lutaml/xml/schema/xsd/simple_content.rb +61 -0
- data/lib/lutaml/xml/schema/xsd/simple_type.rb +37 -0
- data/lib/lutaml/xml/schema/xsd/total_digits.rb +29 -0
- data/lib/lutaml/xml/schema/xsd/type_index_entry.rb +40 -0
- data/lib/lutaml/xml/schema/xsd/type_resolution_result.rb +112 -0
- data/lib/lutaml/xml/schema/xsd/union.rb +30 -0
- data/lib/lutaml/xml/schema/xsd/unique.rb +31 -0
- data/lib/lutaml/xml/schema/xsd/validation_error.rb +48 -0
- data/lib/lutaml/xml/schema/xsd/validation_result.rb +86 -0
- data/lib/lutaml/xml/schema/xsd/version.rb +11 -0
- data/lib/lutaml/xml/schema/xsd/white_space.rb +27 -0
- data/lib/lutaml/xml/schema/xsd.rb +164 -0
- data/lib/lutaml/xml/schema/xsd_namespace.rb +29 -0
- data/lib/lutaml/xml/schema/xsd_schema.rb +1002 -0
- data/lib/lutaml/xml/schema.rb +16 -0
- data/lib/lutaml/xml/schema_location.rb +155 -0
- data/lib/lutaml/xml/serialization/collection_ext.rb +61 -0
- data/lib/lutaml/xml/serialization/format_conversion.rb +433 -0
- data/lib/lutaml/xml/serialization/instance_methods.rb +323 -0
- data/lib/lutaml/xml/serialization/model_import_ext.rb +40 -0
- data/lib/lutaml/xml/serialization.rb +15 -0
- data/lib/lutaml/xml/shared_dsl.rb +119 -0
- data/lib/lutaml/xml/transform.rb +6 -0
- data/lib/lutaml/xml/transformation/custom_method_wrapper.rb +258 -0
- data/lib/lutaml/xml/transformation/element_builder.rb +697 -0
- data/lib/lutaml/xml/transformation/order_reconciler.rb +282 -0
- data/lib/lutaml/xml/transformation/ordered_applier.rb +529 -0
- data/lib/lutaml/xml/transformation/rule_applier.rb +403 -0
- data/lib/lutaml/xml/transformation/rule_compiler.rb +556 -0
- data/lib/lutaml/xml/transformation/skip_logic.rb +70 -0
- data/lib/lutaml/xml/transformation/value_serializer.rb +137 -0
- data/lib/lutaml/xml/transformation.rb +454 -0
- data/lib/lutaml/xml/transformation_builder.rb +28 -0
- data/lib/lutaml/xml/transformation_support.rb +15 -0
- data/lib/lutaml/xml/type/configurable.rb +153 -0
- data/lib/lutaml/xml/type/serializers.rb +105 -0
- data/lib/lutaml/xml/type/value_xml_mapping.rb +94 -0
- data/lib/lutaml/xml/type_namespace/collector.rb +101 -0
- data/lib/lutaml/xml/type_namespace/declaration.rb +61 -0
- data/lib/lutaml/xml/type_namespace/planner.rb +121 -0
- data/lib/lutaml/xml/type_namespace/reference.rb +71 -0
- data/lib/lutaml/xml/type_namespace/resolver.rb +43 -0
- data/lib/lutaml/xml/type_namespace.rb +13 -0
- data/lib/lutaml/xml/type_namespace_resolver.rb +76 -0
- data/lib/lutaml/xml/unqualified_inheritance_strategy.rb +34 -0
- data/lib/lutaml/xml/w3c/registration.rb +66 -0
- data/lib/lutaml/xml/w3c.rb +398 -0
- data/lib/lutaml/xml/xml_attribute.rb +58 -0
- data/lib/lutaml/xml/xml_element.rb +498 -0
- data/lib/lutaml/xml/xml_namespace.rb +72 -0
- data/lib/lutaml/xml/xml_orderable.rb +17 -0
- data/lib/lutaml/xml/xsd_validator.rb +66 -0
- data/lib/lutaml/xml.rb +7 -0
- data/lib/lutaml/yaml/adapter/document.rb +12 -0
- data/lib/lutaml/yaml/adapter/mapping.rb +17 -0
- data/lib/lutaml/yaml/adapter/mapping_rule.rb +9 -0
- data/lib/lutaml/yaml/adapter/standard_adapter.rb +35 -0
- data/lib/lutaml/yaml/adapter/transform.rb +9 -0
- data/lib/lutaml/yaml/adapter/yeptris_adapter.rb +107 -0
- data/lib/lutaml/yaml/adapter.rb +18 -0
- data/lib/lutaml/yaml/format.rb +31 -0
- data/lib/lutaml/yaml/schema/yaml_schema.rb +65 -0
- data/lib/lutaml/yaml/schema.rb +9 -0
- data/lib/lutaml/yaml/type/serializers.rb +60 -0
- data/lib/lutaml/yaml.rb +7 -0
- data/lib/lutaml/yamlld/adapter.rb +20 -0
- data/lib/lutaml/yamlld.rb +25 -0
- data/lib/lutaml/yamls/adapter/document.rb +14 -0
- data/lib/lutaml/yamls/adapter/mapping.rb +30 -0
- data/lib/lutaml/yamls/adapter/mapping_rule.rb +9 -0
- data/lib/lutaml/yamls/adapter/standard_adapter.rb +56 -0
- data/lib/lutaml/yamls/adapter/transform.rb +124 -0
- data/lib/lutaml/yamls/adapter/yamls_sequence.rb +20 -0
- data/lib/lutaml/yamls/adapter/yamls_sequence_rule.rb +48 -0
- data/lib/lutaml/yamls/adapter.rb +15 -0
- data/lib/lutaml/yamls/format.rb +22 -0
- data/lib/lutaml/yamls.rb +7 -0
- data/lib/lutaml.rb +11 -5
- data/lib/tasks/benchmark_runner.rb +161 -0
- data/lib/tasks/memory_profile.rb +176 -0
- data/lib/tasks/performance.rake +80 -0
- data/lib/tasks/performance_benchmark.rb +499 -0
- data/lib/tasks/performance_comparator.rb +130 -0
- data/lib/tasks/performance_helpers.rb +149 -0
- data/lib/tasks/performance_probe.rake +33 -0
- data/lib/tasks/performance_probe.rb +106 -0
- data/lib/tasks/performance_probe_plan_walk.rb +58 -0
- data/lib/tasks/performance_probe_xml.rb +54 -0
- data/lib/tasks/xml_compiler_benchmark.rb +226 -0
- data/lib/tasks/xml_optimization_benchmark.rb +178 -0
- data/lutaml.gemspec +16 -8
- metadata +902 -83
- data/.github/workflows/docs.yml +0 -86
- data/.github/workflows/links.yml +0 -113
- data/.github/workflows/rake.yml +0 -23
- data/.github/workflows/release.yml +0 -37
- data/.gitignore +0 -29
- data/CLAUDE.md +0 -62
- data/docs/.github/workflows/docs.yml +0 -66
- data/docs/.github/workflows/links.yml +0 -78
- data/docs/CONTINUATION_PLAN.md +0 -168
- data/docs/Gemfile +0 -13
- data/docs/MIGRATION_GUIDE.md +0 -202
- data/docs/README.md +0 -252
- data/docs/REFACTOR_PLAN.md +0 -214
- data/docs/_config.yml +0 -144
- data/docs/_guides/cli-usage.adoc +0 -43
- data/docs/_guides/diagram-generation.adoc +0 -316
- data/docs/_guides/index.adoc +0 -136
- data/docs/_guides/parsing/express-parsing.adoc +0 -42
- data/docs/_guides/parsing/index.adoc +0 -78
- data/docs/_guides/parsing/qea-parsing.adoc +0 -47
- data/docs/_guides/parsing/xmi-parsing.adoc +0 -40
- data/docs/_guides/repository-management.adoc +0 -44
- data/docs/_guides/sysml-modeling.adoc +0 -37
- data/docs/_guides/uml-modeling.adoc +0 -115
- data/docs/_pages/concepts/diagram-generation.adoc +0 -337
- data/docs/_pages/concepts/lur-format.adoc +0 -711
- data/docs/_pages/concepts/qea-parsing.adoc +0 -418
- data/docs/_pages/concepts/uml-models.adoc +0 -43
- data/docs/_pages/core/architecture.adoc +0 -329
- data/docs/_pages/core/installation.adoc +0 -321
- data/docs/_pages/core/overview.adoc +0 -197
- data/docs/_pages/index.adoc +0 -49
- data/docs/_pages/uml-syntax.adoc +0 -1011
- data/docs/_references/api/parsers.adoc +0 -61
- data/docs/_references/api/presenters.adoc +0 -43
- data/docs/_references/api/repository.adoc +0 -67
- data/docs/_references/cli/commands.adoc +0 -72
- data/docs/_references/configuration/diagram-styles.adoc +0 -716
- data/docs/_references/configuration/index.adoc +0 -53
- data/docs/_references/configuration/package-metadata.adoc +0 -416
- data/docs/_references/formats/index.adoc +0 -43
- data/docs/_references/formats/lur-format.adoc +0 -39
- data/docs/_references/formats/lutaml-syntax.adoc +0 -379
- data/docs/_references/formats/qea-structure.adoc +0 -1364
- data/docs/_references/index.adoc +0 -198
- data/docs/_tutorials/documentation-site.adoc +0 -47
- data/docs/_tutorials/first-lur-package.adoc +0 -45
- data/docs/_tutorials/generating-diagrams.adoc +0 -42
- data/docs/_tutorials/getting-started.adoc +0 -45
- data/docs/_tutorials/index.adoc +0 -100
- data/docs/_tutorials/querying-models.adoc +0 -44
- data/docs/examples/build_package.rb +0 -12
- data/docs/examples/build_site.rb +0 -12
- data/docs/examples/city_model.rb +0 -21
- data/docs/examples/present_class.rb +0 -10
- data/docs/examples/query_model.rb +0 -12
- data/docs/examples/render_diagram.rb +0 -11
- data/docs/index.adoc +0 -64
- data/docs/lychee.toml +0 -50
- data/lib/lutaml/express/parsers/exp.rb +0 -28
- data/lib/lutaml/express.rb +0 -10
- data/scripts/check-site-urls.rb +0 -54
- data/scripts/check-vendor-link.py +0 -64
|
@@ -0,0 +1,1223 @@
|
|
|
1
|
+
module Lutaml
|
|
2
|
+
module KeyValue
|
|
3
|
+
MISSING = Object.new.freeze
|
|
4
|
+
class Transform < Lutaml::Model::Transform
|
|
5
|
+
def data_to_model(data, format, options = {})
|
|
6
|
+
# Use child's own default register if it has one
|
|
7
|
+
# This ensures versioned schemas (e.g., MML v2 with lutaml_default_register = :mml_v2)
|
|
8
|
+
# are instantiated with their native context
|
|
9
|
+
# TODO.max-perf/32: constant per (model class, register) — the
|
|
10
|
+
# transform itself is cached per that pair, so resolve once.
|
|
11
|
+
child_register = @kv_child_register ||= Lutaml::Model::Register
|
|
12
|
+
.resolve_for_child(
|
|
13
|
+
model_class, lutaml_register
|
|
14
|
+
)
|
|
15
|
+
|
|
16
|
+
# TODO.max-perf/37: eligible models hydrate in one pass —
|
|
17
|
+
# collect raw values per rule, recurse into eligible child
|
|
18
|
+
# models, build every instance through the bulk constructor.
|
|
19
|
+
# Falls back to the per-rule walk for anything ineligible.
|
|
20
|
+
if !options.key?(:mappings) && data.is_a?(::Hash) &&
|
|
21
|
+
%i[json yaml toml hash].include?(format) &&
|
|
22
|
+
(group = self.class.kv_group_plan(model_class, format,
|
|
23
|
+
lutaml_register)) &&
|
|
24
|
+
(instance = kv_group_build(group, data, format, child_register,
|
|
25
|
+
options))
|
|
26
|
+
root_and_parent_assignment(instance, options)
|
|
27
|
+
return instance
|
|
28
|
+
end
|
|
29
|
+
|
|
30
|
+
if model_class.include?(Lutaml::Model::Serialize)
|
|
31
|
+
# #1003: constructor-equivalent state via the compiled walk
|
|
32
|
+
# seed — no per-attribute determine_value walk per instance.
|
|
33
|
+
instance = model_class.allocate_for_walk(child_register)
|
|
34
|
+
else
|
|
35
|
+
instance = model_class.new
|
|
36
|
+
register_accessor_methods_for(instance, child_register)
|
|
37
|
+
end
|
|
38
|
+
root_and_parent_assignment(instance, options)
|
|
39
|
+
mappings = extract_mappings(options, format)
|
|
40
|
+
|
|
41
|
+
rules = mappings.mappings(lutaml_register)
|
|
42
|
+
# lutaml-model#88: nil unless the mapping partitions a wire key
|
|
43
|
+
# with when_attribute rules — the common case pays one scan.
|
|
44
|
+
partition = kv_partition(rules)
|
|
45
|
+
rules.each do |rule|
|
|
46
|
+
process_mapping_rule(data, instance, format, rule, options, partition)
|
|
47
|
+
end
|
|
48
|
+
collect_unmapped_keys(data, instance, mappings, rules)
|
|
49
|
+
|
|
50
|
+
instance
|
|
51
|
+
end
|
|
52
|
+
|
|
53
|
+
# #985: with `map_unmapped to:` declared, document keys no rule
|
|
54
|
+
# claims are collected verbatim into the target attribute, exactly
|
|
55
|
+
# as the model would have kept them outside a mapping.
|
|
56
|
+
def collect_unmapped_keys(data, instance, mappings, rules)
|
|
57
|
+
return unless data.is_a?(::Hash)
|
|
58
|
+
|
|
59
|
+
target = validated_unmapped_target(mappings)
|
|
60
|
+
return if target.nil?
|
|
61
|
+
|
|
62
|
+
claimed = {}
|
|
63
|
+
rules.each do |rule|
|
|
64
|
+
Array(rule.name).each { |name| claimed[name.to_s] = true } if rule.name
|
|
65
|
+
end
|
|
66
|
+
|
|
67
|
+
extras = nil
|
|
68
|
+
data.each do |key, value|
|
|
69
|
+
next if claimed[key.to_s]
|
|
70
|
+
|
|
71
|
+
(extras ||= {})[key] = value
|
|
72
|
+
end
|
|
73
|
+
return if extras.nil?
|
|
74
|
+
|
|
75
|
+
existing = instance.public_send(target)
|
|
76
|
+
merged = existing.is_a?(::Hash) ? existing.merge(extras) : extras
|
|
77
|
+
instance.public_send(:"#{target}=", merged)
|
|
78
|
+
end
|
|
79
|
+
|
|
80
|
+
# Memoized on the cached transform (one instance per model class
|
|
81
|
+
# and register): a typo'd map_unmapped target raises at first
|
|
82
|
+
# parse, naming the class and the target, instead of NoMethodError
|
|
83
|
+
# from inside the walk.
|
|
84
|
+
def validated_unmapped_target(mappings)
|
|
85
|
+
target = mappings.unmapped_attribute
|
|
86
|
+
return if target.nil?
|
|
87
|
+
return @lutaml_unmapped_target if @lutaml_unmapped_target == target
|
|
88
|
+
|
|
89
|
+
unless model_class.attributes(lutaml_register).key?(target)
|
|
90
|
+
raise ArgumentError,
|
|
91
|
+
"map_unmapped target :#{target} is not a declared " \
|
|
92
|
+
"attribute of #{model_class}"
|
|
93
|
+
end
|
|
94
|
+
|
|
95
|
+
@lutaml_unmapped_target = target
|
|
96
|
+
end
|
|
97
|
+
|
|
98
|
+
def model_to_data(instance, format, options = {})
|
|
99
|
+
# NEW ARCHITECTURE: Use KeyValue::Transformation if available
|
|
100
|
+
# This provides symmetric OOP architecture with XmlDataModel
|
|
101
|
+
if context.is_a?(Class) && context.include?(Lutaml::Model::Serialize)
|
|
102
|
+
transformation = context.transformation_for(
|
|
103
|
+
format, lutaml_register, mapping: @lutaml_mapping_override
|
|
104
|
+
)
|
|
105
|
+
|
|
106
|
+
# transformation_for returns nil for cyclic dependencies or :building sentinel
|
|
107
|
+
# Fall back to legacy approach in these cases
|
|
108
|
+
if transformation.is_a?(Lutaml::KeyValue::Transformation)
|
|
109
|
+
# transform emits the output hash directly (TODO.perf 19)
|
|
110
|
+
return transformation.transform(instance, options)
|
|
111
|
+
end
|
|
112
|
+
end
|
|
113
|
+
|
|
114
|
+
# LEGACY ARCHITECTURE: Fall back to Hash-based approach
|
|
115
|
+
# This maintains backward compatibility for models without transformations
|
|
116
|
+
mappings = extract_mappings(options, format)
|
|
117
|
+
|
|
118
|
+
rules = mappings.mappings(lutaml_register)
|
|
119
|
+
partition = kv_partition(rules)
|
|
120
|
+
hash = {}
|
|
121
|
+
handled_groups = nil
|
|
122
|
+
rules.each do |rule|
|
|
123
|
+
next unless valid_mapping?(rule, options)
|
|
124
|
+
|
|
125
|
+
group = partition && kv_partition_group(rule, partition)
|
|
126
|
+
if group
|
|
127
|
+
next if handled_groups&.include?(group)
|
|
128
|
+
|
|
129
|
+
(handled_groups ||= []) << group
|
|
130
|
+
process_partition_group!(instance, group, hash, format, options)
|
|
131
|
+
else
|
|
132
|
+
process_rule!(instance, rule, hash, format, mappings, options)
|
|
133
|
+
end
|
|
134
|
+
end
|
|
135
|
+
merge_unmapped_on_serialize(instance, mappings, hash)
|
|
136
|
+
|
|
137
|
+
hash.keys == [""] ? hash[""] : hash
|
|
138
|
+
end
|
|
139
|
+
|
|
140
|
+
# #985: re-emit the collected unknown keys after the mapped rules,
|
|
141
|
+
# so a mapped key colliding with a collected one wins. The
|
|
142
|
+
# attribute was declared in the mapping and validated at compile,
|
|
143
|
+
# so the accessor exists on every instance shape.
|
|
144
|
+
def merge_unmapped_on_serialize(instance, mappings, hash)
|
|
145
|
+
target = mappings.unmapped_attribute
|
|
146
|
+
return if target.nil?
|
|
147
|
+
|
|
148
|
+
extras = instance.public_send(target)
|
|
149
|
+
extras.each { |key, value| hash[key] ||= value } if extras.is_a?(::Hash)
|
|
150
|
+
end
|
|
151
|
+
|
|
152
|
+
# ---- TODO.max-perf/37: group-then-instantiate fast path ----
|
|
153
|
+
|
|
154
|
+
# [model class, format, register] -> rows or false (ineligible).
|
|
155
|
+
# Rows: [[rule, attr, kind, child_rows]] with kind :scalar or
|
|
156
|
+
# :model; child_rows is the child model's own row set. Cycle-safe:
|
|
157
|
+
# an in-progress model resolves false, so self-referential models
|
|
158
|
+
# take the interpretive walk.
|
|
159
|
+
# Concurrent::Map under threaded MRI, plain Hash under Opal
|
|
160
|
+
# (Concurrent is unavailable there) — the RULE_RECORDS pattern.
|
|
161
|
+
# Writes are idempotent (the same deterministic plan is computed),
|
|
162
|
+
# so a lost race costs a duplicate build, never a wrong value.
|
|
163
|
+
KV_GROUP_PLANS = if Lutaml::Model.opal?
|
|
164
|
+
{}
|
|
165
|
+
else
|
|
166
|
+
Lutaml::Model::RuntimeCompatibility
|
|
167
|
+
.require_native("concurrent")
|
|
168
|
+
Concurrent::Map.new
|
|
169
|
+
end
|
|
170
|
+
|
|
171
|
+
# [model class, register, format, generation] -> { rule => plan }.
|
|
172
|
+
# Class-level, generation-retired: the whole dispatch table for a
|
|
173
|
+
# model mapping compiles once — kind (scalar/custom/hash_map/
|
|
174
|
+
# interpretive/skip/invalid), target attribute and validity — so
|
|
175
|
+
# process_mapping_rule stops re-probing rule predicates at every
|
|
176
|
+
# node (~12 predicate calls plus a key array per rule per node;
|
|
177
|
+
# 154k+154k allocations per heroku.json parse). Same
|
|
178
|
+
# idempotent-write pattern as KV_GROUP_PLANS.
|
|
179
|
+
KV_WALK_PLANS = if Lutaml::Model.opal?
|
|
180
|
+
{}
|
|
181
|
+
else
|
|
182
|
+
Lutaml::Model::RuntimeCompatibility
|
|
183
|
+
.require_native("concurrent")
|
|
184
|
+
Concurrent::Map.new
|
|
185
|
+
end
|
|
186
|
+
|
|
187
|
+
def self.kv_group_plan(model_class, format, register)
|
|
188
|
+
# Context generation: specs (and apps) reset registers between
|
|
189
|
+
# parses; a plan cached across a reset references dead attribute
|
|
190
|
+
# objects. The generation key retires stale plans for free.
|
|
191
|
+
key = [model_class, format, register,
|
|
192
|
+
Lutaml::Model::GlobalContext.context_generation]
|
|
193
|
+
plan = KV_GROUP_PLANS[key]
|
|
194
|
+
return plan unless plan.nil?
|
|
195
|
+
|
|
196
|
+
# Cycle detection rides a THREAD-LOCAL recursion stack: a shared
|
|
197
|
+
# in-progress set races (a concurrent same-key build would cache
|
|
198
|
+
# false permanently), and the stack is per-build by definition.
|
|
199
|
+
# The false at the cycle point is NOT cached — the outermost
|
|
200
|
+
# build completes and caches the model's real verdict.
|
|
201
|
+
stack = (Thread.current[:kv_group_plan_stack] ||= [])
|
|
202
|
+
return false if stack.include?(key)
|
|
203
|
+
|
|
204
|
+
stack.push(key)
|
|
205
|
+
begin
|
|
206
|
+
KV_GROUP_PLANS[key] = build_kv_group_plan(model_class, format,
|
|
207
|
+
register)
|
|
208
|
+
ensure
|
|
209
|
+
stack.pop
|
|
210
|
+
end
|
|
211
|
+
end
|
|
212
|
+
|
|
213
|
+
def self.build_kv_group_plan(model_class, format, register)
|
|
214
|
+
return false unless model_class.is_a?(Class) &&
|
|
215
|
+
model_class.include?(Lutaml::Model::Serialize)
|
|
216
|
+
|
|
217
|
+
mapping = model_class.mappings_for(format, register)
|
|
218
|
+
return false if mapping.nil?
|
|
219
|
+
|
|
220
|
+
attrs = model_class.attributes(register)
|
|
221
|
+
# The catch-all compiles as a row: unclaimed document keys are
|
|
222
|
+
# collected into the target attribute after the rules hydrate,
|
|
223
|
+
# mirroring the interpretive collect's position and merge. A
|
|
224
|
+
# typo'd target raises here, exactly as the walk raises at
|
|
225
|
+
# first parse.
|
|
226
|
+
unmapped_target = mapping.unmapped_attribute
|
|
227
|
+
if unmapped_target && !attrs.key?(unmapped_target)
|
|
228
|
+
raise ArgumentError,
|
|
229
|
+
"map_unmapped target :#{unmapped_target} is not a " \
|
|
230
|
+
"declared attribute of #{model_class}"
|
|
231
|
+
end
|
|
232
|
+
rows = nil
|
|
233
|
+
claimed = nil
|
|
234
|
+
mapping.mappings(register).each do |rule|
|
|
235
|
+
eligible = !rule.name.nil? && !rule.multiple_mappings? &&
|
|
236
|
+
rule.delegate.nil? &&
|
|
237
|
+
!rule.has_custom_method_for_deserialization? &&
|
|
238
|
+
!rule.raw_mapping? && !rule.root_mapping? &&
|
|
239
|
+
rule.when_attribute.empty? &&
|
|
240
|
+
!(if rule.polymorphic.is_a?(::Hash)
|
|
241
|
+
!rule.polymorphic.empty?
|
|
242
|
+
else
|
|
243
|
+
!!rule.polymorphic
|
|
244
|
+
end) &&
|
|
245
|
+
rule.transform.is_a?(::Hash) && rule.transform.empty? &&
|
|
246
|
+
rule.value_map(:from) ==
|
|
247
|
+
Lutaml::Model::Serialize::DEFAULT_VALUE_MAP
|
|
248
|
+
return false unless eligible
|
|
249
|
+
|
|
250
|
+
attr = attrs[rule.to]
|
|
251
|
+
return false if attr.nil? || attr.derived?
|
|
252
|
+
# Declared ranges keep their eager validation on the
|
|
253
|
+
# interpretive walk; polymorphic/union/custom-collection
|
|
254
|
+
# dispatch and registered type substitutions own their cast
|
|
255
|
+
# (the per-rule walk threads them through cast options).
|
|
256
|
+
return false if attr.collection? && attr.collection.is_a?(Range)
|
|
257
|
+
return false if attr.polymorphic? || attr.union? ||
|
|
258
|
+
attr.custom_collection?
|
|
259
|
+
|
|
260
|
+
type = attr.type(register)
|
|
261
|
+
return false if Lutaml::Model::GlobalContext.context(register)
|
|
262
|
+
.substitution_for(type).any?
|
|
263
|
+
|
|
264
|
+
if rule.hash_mappings
|
|
265
|
+
# #1003: compiled child-map row. The compiled ChildMapPlan
|
|
266
|
+
# reproduces translate_mappings' per-child lookups; shapes
|
|
267
|
+
# the compile cannot cover (unmappable child attribute,
|
|
268
|
+
# singular target, non-model child type) keep the whole
|
|
269
|
+
# model interpretive.
|
|
270
|
+
return false unless attr.collection? &&
|
|
271
|
+
type.is_a?(Class) && type.include?(Lutaml::Model::Serialize)
|
|
272
|
+
|
|
273
|
+
child_plan = compile_group_child_plan(type, format, register,
|
|
274
|
+
rule.hash_mappings)
|
|
275
|
+
return false unless child_plan
|
|
276
|
+
|
|
277
|
+
rows ||= []
|
|
278
|
+
rows << [rule, attr, :child_map, child_plan, nil, nil]
|
|
279
|
+
next
|
|
280
|
+
end
|
|
281
|
+
|
|
282
|
+
if type.is_a?(Class) && type.include?(Lutaml::Model::Serialize)
|
|
283
|
+
child_register = Lutaml::Model::Register
|
|
284
|
+
.resolve_for_child(type, register)
|
|
285
|
+
child_rows = kv_group_plan(type, format, child_register)
|
|
286
|
+
return false unless child_rows
|
|
287
|
+
|
|
288
|
+
rows ||= []
|
|
289
|
+
# child_register rides the row: the plan was BUILT under it,
|
|
290
|
+
# and rebuilding the resolution per model row per document
|
|
291
|
+
# cost a Concurrent::Map hop each time (TODO.perf 14).
|
|
292
|
+
rows << [rule, attr, :model, type, child_rows, child_register]
|
|
293
|
+
elsif type.is_a?(Class) && type < Lutaml::Model::Type::Value &&
|
|
294
|
+
!attr.value_policy.whole_value?(type) &&
|
|
295
|
+
!Lutaml::Model::Attribute.custom_from_probe?(type)
|
|
296
|
+
rows ||= []
|
|
297
|
+
rows << [rule, attr, :scalar, nil, nil, nil]
|
|
298
|
+
else
|
|
299
|
+
return false
|
|
300
|
+
end
|
|
301
|
+
end
|
|
302
|
+
if unmapped_target
|
|
303
|
+
claimed = {}
|
|
304
|
+
mapping.mappings(register).each do |rule|
|
|
305
|
+
Array(rule.name).each { |name| claimed[name.to_s] = true } if rule.name
|
|
306
|
+
end
|
|
307
|
+
claimed.freeze
|
|
308
|
+
(rows ||= []) << [nil, nil, :unmapped, unmapped_target, claimed,
|
|
309
|
+
nil]
|
|
310
|
+
end
|
|
311
|
+
# No eligible rows at all (empty mapping) — nothing to gain.
|
|
312
|
+
rows
|
|
313
|
+
end
|
|
314
|
+
|
|
315
|
+
# Class-level twin of the walk's child-map compile: the registry
|
|
316
|
+
# lookups (child rules, per-attribute wire names, path casts)
|
|
317
|
+
# resolve once per plan instead of once per node per child. nil
|
|
318
|
+
# keeps the model interpretive (preserving the walk's raise
|
|
319
|
+
# timing for declaration errors).
|
|
320
|
+
def self.compile_group_child_plan(child_class, format, register,
|
|
321
|
+
child_mappings)
|
|
322
|
+
child_rules = child_class.mappings_for(format, register)
|
|
323
|
+
wire_names = {}
|
|
324
|
+
paths = {}
|
|
325
|
+
child_mappings.each do |attr_name, path|
|
|
326
|
+
attr_rule = child_rules.find_by_to!(attr_name)
|
|
327
|
+
wire_names[attr_name] = attr_rule.from.to_s
|
|
328
|
+
paths[attr_name] = case path
|
|
329
|
+
when :key then :key
|
|
330
|
+
when :value then :value
|
|
331
|
+
else Array(path).map(&:to_s).freeze
|
|
332
|
+
end
|
|
333
|
+
end
|
|
334
|
+
ChildMapPlan.new(child_mappings, wire_names, paths,
|
|
335
|
+
child_mappings.values == [:key], child_rules,
|
|
336
|
+
child_class)
|
|
337
|
+
rescue Lutaml::Model::NoMappingFoundError
|
|
338
|
+
nil
|
|
339
|
+
end
|
|
340
|
+
|
|
341
|
+
# Build values bottom-up, then ONE instance per model: present
|
|
342
|
+
# keys through the casting setters, ABSENT rules through the real
|
|
343
|
+
# per-rule walk (their extractor/defaults/sentinel semantics are
|
|
344
|
+
# the walk's own — reproducing them here would fork them). The
|
|
345
|
+
# per-rule walk is eliminated exactly for the present-key hot
|
|
346
|
+
# path. Returns nil (caller falls back) on any shape the plan
|
|
347
|
+
# does not cover, e.g. a non-Hash item where a model was expected.
|
|
348
|
+
def kv_group_build(rows, doc, format, register, options)
|
|
349
|
+
# Positional values, not per-row [name, value] pairs: rows are a
|
|
350
|
+
# fixed per-class list, so the writer to apply lives at the row's
|
|
351
|
+
# index and the pair arrays were the lane's biggest allocation
|
|
352
|
+
# (~6 arrays per node on hydrate-heavy corpora).
|
|
353
|
+
values = Array.new(rows.size, MISSING)
|
|
354
|
+
children = []
|
|
355
|
+
# Lazy: the present-key hot path never pushes, and this runs
|
|
356
|
+
# once per hydrated model instance.
|
|
357
|
+
absent = nil
|
|
358
|
+
unmapped = nil
|
|
359
|
+
i = 0
|
|
360
|
+
rows.each do |rule, attr, kind, type, child_rows, child_register|
|
|
361
|
+
if kind == :unmapped
|
|
362
|
+
unmapped = [type, child_rows]
|
|
363
|
+
i += 1
|
|
364
|
+
next
|
|
365
|
+
end
|
|
366
|
+
|
|
367
|
+
# One hash pass per row: fetch with a sentinel distinguishes
|
|
368
|
+
# absent keys from present-nil values (both read as nil), so
|
|
369
|
+
# the separate string_or_symbol_key? probe goes away.
|
|
370
|
+
v = Lutaml::Model::Utils.fetch_str_or_sym(doc, rule.name, MISSING)
|
|
371
|
+
if v.equal?(MISSING)
|
|
372
|
+
(absent ||= []) << rule
|
|
373
|
+
i += 1
|
|
374
|
+
next
|
|
375
|
+
end
|
|
376
|
+
|
|
377
|
+
if kind == :child_map
|
|
378
|
+
# Compiled translate_mappings (#1003): per-child lookups
|
|
379
|
+
# are plan constants. Children hydrate through their own
|
|
380
|
+
# compiled walk (the mappings: option routes them there);
|
|
381
|
+
# parent/root wiring rides the shared children pass. A
|
|
382
|
+
# non-Hash value falls back to the walk, which owns that
|
|
383
|
+
# error.
|
|
384
|
+
return nil unless v.is_a?(::Hash)
|
|
385
|
+
|
|
386
|
+
built = []
|
|
387
|
+
keys_only = type.keys_only && v.values.all?(::Hash)
|
|
388
|
+
v.each do |child_key, child_value|
|
|
389
|
+
child_hash = {}
|
|
390
|
+
type.child_mappings.each_key do |attr_name|
|
|
391
|
+
child_hash[type.wire_names[attr_name]] =
|
|
392
|
+
extract_compiled_child_value(type.paths[attr_name],
|
|
393
|
+
child_key, child_value)
|
|
394
|
+
end
|
|
395
|
+
child_hash.update(child_value) if keys_only
|
|
396
|
+
built << self.class.data_to_model(type.attr_type,
|
|
397
|
+
child_hash, format, { mappings: type.child_rules })
|
|
398
|
+
end
|
|
399
|
+
values[i] = built
|
|
400
|
+
children.concat(built)
|
|
401
|
+
i += 1
|
|
402
|
+
next
|
|
403
|
+
end
|
|
404
|
+
|
|
405
|
+
if kind == :scalar
|
|
406
|
+
values[i] = v
|
|
407
|
+
i += 1
|
|
408
|
+
next
|
|
409
|
+
end
|
|
410
|
+
|
|
411
|
+
if attr.collection?
|
|
412
|
+
# A present-but-nil collection reaches the per-rule walk,
|
|
413
|
+
# which owns the sentinel interplay for that edge
|
|
414
|
+
# (render_nil :as_empty semantics).
|
|
415
|
+
return nil if v.nil?
|
|
416
|
+
|
|
417
|
+
items = v.is_a?(::Array) ? v : [v]
|
|
418
|
+
built = []
|
|
419
|
+
items.each do |item|
|
|
420
|
+
return nil unless item.is_a?(::Hash)
|
|
421
|
+
|
|
422
|
+
child = self.class.kv_group_instance(type, child_rows, item,
|
|
423
|
+
format, child_register,
|
|
424
|
+
options)
|
|
425
|
+
return nil if child.nil?
|
|
426
|
+
|
|
427
|
+
built << child
|
|
428
|
+
end
|
|
429
|
+
values[i] = built
|
|
430
|
+
children.concat(built)
|
|
431
|
+
else
|
|
432
|
+
return nil unless v.is_a?(::Hash)
|
|
433
|
+
|
|
434
|
+
child = self.class.kv_group_instance(type, child_rows, v,
|
|
435
|
+
format, child_register,
|
|
436
|
+
options)
|
|
437
|
+
return nil if child.nil?
|
|
438
|
+
|
|
439
|
+
values[i] = child
|
|
440
|
+
children << child
|
|
441
|
+
end
|
|
442
|
+
i += 1
|
|
443
|
+
end
|
|
444
|
+
instance = model_class.allocate_for_walk(register)
|
|
445
|
+
i = 0
|
|
446
|
+
rows.each do |rule, _attr, kind, *_rest|
|
|
447
|
+
v = values[i]
|
|
448
|
+
i += 1
|
|
449
|
+
next if v.equal?(MISSING) || kind == :unmapped
|
|
450
|
+
|
|
451
|
+
instance.public_send(rule.kv_setter, v)
|
|
452
|
+
end
|
|
453
|
+
absent&.each do |rule|
|
|
454
|
+
process_mapping_rule(doc, instance, format, rule, options, nil)
|
|
455
|
+
end
|
|
456
|
+
children.each do |child|
|
|
457
|
+
child.lutaml_parent = instance
|
|
458
|
+
child.lutaml_root ||= instance.lutaml_root || instance
|
|
459
|
+
end
|
|
460
|
+
if unmapped
|
|
461
|
+
target, claimed = unmapped
|
|
462
|
+
extras = nil
|
|
463
|
+
doc.each do |key, value|
|
|
464
|
+
next if claimed.key?(key.to_s)
|
|
465
|
+
|
|
466
|
+
(extras ||= {})[key] = value
|
|
467
|
+
end
|
|
468
|
+
if extras
|
|
469
|
+
existing = instance.public_send(target)
|
|
470
|
+
merged = existing.is_a?(::Hash) ? existing.merge(extras) : extras
|
|
471
|
+
instance.public_send(:"#{target}=", merged)
|
|
472
|
+
end
|
|
473
|
+
end
|
|
474
|
+
instance
|
|
475
|
+
end
|
|
476
|
+
|
|
477
|
+
def self.kv_group_instance(model_class, rows, doc, format, register,
|
|
478
|
+
options)
|
|
479
|
+
# cached_transform is per (class, register); format rides the
|
|
480
|
+
# call, not the cache.
|
|
481
|
+
cached_transform(model_class, register)
|
|
482
|
+
.kv_group_build(rows, doc, format, register, options)
|
|
483
|
+
end
|
|
484
|
+
|
|
485
|
+
private
|
|
486
|
+
|
|
487
|
+
def process_rule!(instance, rule, hash, format, _mappings, options)
|
|
488
|
+
return handle_delegate(instance, rule, hash, format) if rule.delegate
|
|
489
|
+
|
|
490
|
+
process_mapping_for_instance(instance, hash, format, rule, options)
|
|
491
|
+
end
|
|
492
|
+
|
|
493
|
+
def process_mapping_for_instance(instance, hash, format, rule, options)
|
|
494
|
+
if rule.custom_methods[:to]
|
|
495
|
+
to_method = rule.custom_methods[:to]
|
|
496
|
+
# lutaml-model#550: custom methods may declare a third context
|
|
497
|
+
# parameter to receive the options passed to `to_*`.
|
|
498
|
+
if Lutaml::Model::MappingRule.custom_method_arity(instance.class, to_method).to_i >= 3
|
|
499
|
+
return instance.public_send(to_method, instance, hash,
|
|
500
|
+
options[:context])
|
|
501
|
+
end
|
|
502
|
+
|
|
503
|
+
return instance.public_send(to_method, instance, hash)
|
|
504
|
+
end
|
|
505
|
+
|
|
506
|
+
attribute = attributes[rule.to]
|
|
507
|
+
|
|
508
|
+
# TODO.max-perf/10: plain scalar/collection rules take a fast
|
|
509
|
+
# lane — memoized wire name, shared render? semantics, one
|
|
510
|
+
# serialize dispatch — collapsing the interpretive branch
|
|
511
|
+
# probes below. Rules with any special feature stay on the
|
|
512
|
+
# full path.
|
|
513
|
+
if (plan = kv_serialize_plan(rule, attribute, instance))
|
|
514
|
+
value = instance.public_send(attribute.name)
|
|
515
|
+
if rule.render?(value, instance)
|
|
516
|
+
hash[plan.wire] = attribute.serialize(value, format,
|
|
517
|
+
lutaml_register, options)
|
|
518
|
+
end
|
|
519
|
+
return
|
|
520
|
+
end
|
|
521
|
+
|
|
522
|
+
value = rule.serialize(instance)
|
|
523
|
+
|
|
524
|
+
if rule.can_transform_to?(attribute, format)
|
|
525
|
+
hash[rule_from_name(rule)] =
|
|
526
|
+
rule.transform_value(attribute, value, :to, format)
|
|
527
|
+
return
|
|
528
|
+
end
|
|
529
|
+
|
|
530
|
+
if rule.raw_mapping?
|
|
531
|
+
return handle_raw_mapping(hash, value, format,
|
|
532
|
+
options)
|
|
533
|
+
end
|
|
534
|
+
if rule.root_mapping?
|
|
535
|
+
return handle_root_mappings(hash, value, format, rule,
|
|
536
|
+
attribute)
|
|
537
|
+
end
|
|
538
|
+
|
|
539
|
+
# Use the format parameter passed in instead of hardcoding to :json
|
|
540
|
+
value = ExportTransformer.call(value, rule, attribute,
|
|
541
|
+
format: format,
|
|
542
|
+
context: options[:context])
|
|
543
|
+
|
|
544
|
+
value = serialize_value(value, rule, attribute, format, options)
|
|
545
|
+
|
|
546
|
+
return unless rule.render?(value, instance)
|
|
547
|
+
|
|
548
|
+
value = apply_value_map(value, rule.value_map(:to, options), attribute)
|
|
549
|
+
|
|
550
|
+
hash[rule_from_name(rule)] = value
|
|
551
|
+
end
|
|
552
|
+
|
|
553
|
+
def valid_mapping?(rule, options)
|
|
554
|
+
# rule is always Lutaml::Model::MappingRule; serialize? is
|
|
555
|
+
# statically defined (the hydrate-only marker).
|
|
556
|
+
return false unless rule.serialize?
|
|
557
|
+
|
|
558
|
+
only = options[:only]
|
|
559
|
+
except = options[:except]
|
|
560
|
+
name = rule.to
|
|
561
|
+
|
|
562
|
+
(except.nil? || !except.include?(name)) &&
|
|
563
|
+
(only.nil? || only.include?(name))
|
|
564
|
+
end
|
|
565
|
+
|
|
566
|
+
def handle_raw_mapping(hash, value, format, options)
|
|
567
|
+
result = Lutaml::Model::Config.adapter_for(format).parse(value, options)
|
|
568
|
+
|
|
569
|
+
hash.merge!(result)
|
|
570
|
+
end
|
|
571
|
+
|
|
572
|
+
def handle_root_mappings(hash, value, format, rule, attr)
|
|
573
|
+
hash.merge!(
|
|
574
|
+
generate_hash_from_child_mappings(
|
|
575
|
+
attr,
|
|
576
|
+
value,
|
|
577
|
+
format,
|
|
578
|
+
rule.root_mappings,
|
|
579
|
+
),
|
|
580
|
+
)
|
|
581
|
+
end
|
|
582
|
+
|
|
583
|
+
def serialize_value(value, rule, attr, format, options)
|
|
584
|
+
unless rule.child_mappings
|
|
585
|
+
return attr.serialize(value, format, lutaml_register,
|
|
586
|
+
options)
|
|
587
|
+
end
|
|
588
|
+
|
|
589
|
+
generate_hash_from_child_mappings(
|
|
590
|
+
attr, value, format, rule.child_mappings
|
|
591
|
+
)
|
|
592
|
+
end
|
|
593
|
+
|
|
594
|
+
def rule_from_name(rule)
|
|
595
|
+
rule.multiple_mappings? ? rule.from.first.to_s : rule.from.to_s
|
|
596
|
+
end
|
|
597
|
+
|
|
598
|
+
def generate_hash_from_child_mappings(attr, value, format, child_mappings)
|
|
599
|
+
return value unless child_mappings
|
|
600
|
+
|
|
601
|
+
hash = {}
|
|
602
|
+
|
|
603
|
+
generate_remaining_mappings_for_value(child_mappings, value, format)
|
|
604
|
+
|
|
605
|
+
attr_type = attr.type(lutaml_register)
|
|
606
|
+
rules = attr_type.mappings_for(format)
|
|
607
|
+
pairs = child_mappings.map do |attr_name, path|
|
|
608
|
+
[rules.find_by_to!(attr_name), path]
|
|
609
|
+
end
|
|
610
|
+
|
|
611
|
+
value.each do |child_obj|
|
|
612
|
+
hash.merge!(
|
|
613
|
+
extract_hash_for_child_mapping(pairs, child_obj, format),
|
|
614
|
+
)
|
|
615
|
+
end
|
|
616
|
+
|
|
617
|
+
hash
|
|
618
|
+
end
|
|
619
|
+
|
|
620
|
+
# Generates remaining child mappings for all attributes when only
|
|
621
|
+
# the :key mapping (e.g., { name: :key }) is provided.
|
|
622
|
+
# If any additional mappings (e.g., { name: :key, id: :identifier })
|
|
623
|
+
# are specified, no additional child mappings will be generated.
|
|
624
|
+
def generate_remaining_mappings_for_value(child_mappings, value, format)
|
|
625
|
+
return if child_mappings.values != [:key]
|
|
626
|
+
|
|
627
|
+
klass = value.first.class
|
|
628
|
+
mappings = klass.mappings_for(format, lutaml_register)
|
|
629
|
+
|
|
630
|
+
klass.attributes(lutaml_register).each_key do |name|
|
|
631
|
+
next if Utils.string_or_symbol_key?(child_mappings, name)
|
|
632
|
+
|
|
633
|
+
child_mappings[name.to_sym] = child_mapping_for(name, mappings)
|
|
634
|
+
end
|
|
635
|
+
end
|
|
636
|
+
|
|
637
|
+
def child_mapping_for(name, mappings)
|
|
638
|
+
mappings.find_by_to(name)&.name.to_s
|
|
639
|
+
end
|
|
640
|
+
|
|
641
|
+
def extract_hash_for_child_mapping(pairs, child_obj, format)
|
|
642
|
+
key = nil
|
|
643
|
+
value = {}
|
|
644
|
+
|
|
645
|
+
pairs.each do |rule, path|
|
|
646
|
+
attr_value = normalize_attribute_value(child_obj, rule, format)
|
|
647
|
+
|
|
648
|
+
next unless rule&.render?(attr_value, nil)
|
|
649
|
+
next key = attr_value if path == :key
|
|
650
|
+
|
|
651
|
+
value = extract_hash_value_for_child_mapping(path, attr_value, value)
|
|
652
|
+
end
|
|
653
|
+
|
|
654
|
+
value = nil if value.empty?
|
|
655
|
+
{ key => value }
|
|
656
|
+
end
|
|
657
|
+
|
|
658
|
+
# The child's wire-form value for one attribute, produced through
|
|
659
|
+
# the same pipeline the child's own serializer uses for a rendered
|
|
660
|
+
# value (rule transform, then attribute serialization) — without
|
|
661
|
+
# the serialize-parse string round-trip this read previously paid
|
|
662
|
+
# per child per attribute.
|
|
663
|
+
def normalize_attribute_value(child_obj, rule, format)
|
|
664
|
+
child_attr = child_obj.class.attributes(lutaml_register)[rule.to]
|
|
665
|
+
value = child_obj.public_send(rule.to)
|
|
666
|
+
value = rule.transform_value(child_attr, value, :to, format)
|
|
667
|
+
child_attr.serialize(value, format, lutaml_register)
|
|
668
|
+
end
|
|
669
|
+
|
|
670
|
+
def extract_hash_value_for_child_mapping(path, value, map_value)
|
|
671
|
+
return value if path == :value
|
|
672
|
+
|
|
673
|
+
path = [path] unless path.is_a?(Array)
|
|
674
|
+
path[0...-1].inject(map_value) do |acc, k|
|
|
675
|
+
acc[k.to_s] ||= {}
|
|
676
|
+
end.public_send(:[]=, path.last.to_s, value)
|
|
677
|
+
|
|
678
|
+
map_value
|
|
679
|
+
end
|
|
680
|
+
|
|
681
|
+
def handle_delegate(instance, rule, hash, format)
|
|
682
|
+
value = extract_value_for_delegate(instance, rule)
|
|
683
|
+
return if value.nil? && rule.value_map(:to)[:nil] == :omitted
|
|
684
|
+
|
|
685
|
+
attribute = instance.public_send(rule.delegate).class.attributes(lutaml_register)[rule.to]
|
|
686
|
+
hash[rule_from_name(rule)] =
|
|
687
|
+
attribute.serialize(value, format, lutaml_register)
|
|
688
|
+
end
|
|
689
|
+
|
|
690
|
+
def extract_value_for_delegate(instance, rule)
|
|
691
|
+
instance.public_send(rule.delegate).public_send(rule.to)
|
|
692
|
+
end
|
|
693
|
+
|
|
694
|
+
def extract_mappings(options, format)
|
|
695
|
+
options[:mappings] || mappings_for(format, lutaml_register)
|
|
696
|
+
end
|
|
697
|
+
|
|
698
|
+
# ---- lutaml-model#88: when_attribute for key-value formats ----
|
|
699
|
+
|
|
700
|
+
# Wire keys partitioned by when_attribute rules: key -> { rules: all
|
|
701
|
+
# rules on the key in declaration order, discriminators: the subset
|
|
702
|
+
# carrying when_attribute }. nil unless any rule uses when_attribute.
|
|
703
|
+
def kv_partition(rules)
|
|
704
|
+
partitions = nil
|
|
705
|
+
rules.each do |rule|
|
|
706
|
+
next if rule.when_attribute.empty?
|
|
707
|
+
|
|
708
|
+
partitions ||= {}
|
|
709
|
+
key = kv_partition_key(rule)
|
|
710
|
+
entry = (partitions[key] ||= { rules: [], discriminators: [] })
|
|
711
|
+
entry[:discriminators] << rule
|
|
712
|
+
end
|
|
713
|
+
return nil unless partitions
|
|
714
|
+
|
|
715
|
+
rules.each do |rule|
|
|
716
|
+
key = kv_partition_key(rule)
|
|
717
|
+
partitions[key][:rules] << rule if partitions.key?(key)
|
|
718
|
+
end
|
|
719
|
+
partitions
|
|
720
|
+
end
|
|
721
|
+
|
|
722
|
+
def kv_partition_key(rule)
|
|
723
|
+
name = rule.name
|
|
724
|
+
name = name.first if name.is_a?(Array)
|
|
725
|
+
name.to_s
|
|
726
|
+
end
|
|
727
|
+
|
|
728
|
+
# The partition entry covering any of the rule's wire names.
|
|
729
|
+
def kv_partition_group(rule, partition)
|
|
730
|
+
return nil if partition.nil?
|
|
731
|
+
|
|
732
|
+
if rule.multiple_mappings?
|
|
733
|
+
rule.name.each do |name|
|
|
734
|
+
entry = partition[name.to_s]
|
|
735
|
+
return entry if entry
|
|
736
|
+
end
|
|
737
|
+
nil
|
|
738
|
+
else
|
|
739
|
+
partition[rule.name.to_s]
|
|
740
|
+
end
|
|
741
|
+
end
|
|
742
|
+
|
|
743
|
+
# A value at a partitioned key, filtered for one rule: a
|
|
744
|
+
# discriminator rule keeps its matches; a plain rule keeps the
|
|
745
|
+
# occurrences no discriminator claimed (single-capture, mirroring
|
|
746
|
+
# the XML side).
|
|
747
|
+
def apply_kv_when_attribute(value, rule, entry, attr = nil)
|
|
748
|
+
if rule.when_attribute.empty?
|
|
749
|
+
return kv_partition_value(value, attr) do |item|
|
|
750
|
+
entry[:discriminators].none? { |s| kv_item_matches?(item, s) }
|
|
751
|
+
end
|
|
752
|
+
end
|
|
753
|
+
|
|
754
|
+
plain_sibling = entry[:rules].any? { |r| r.when_attribute.empty? }
|
|
755
|
+
if rule.unmatched == :raise && !plain_sibling
|
|
756
|
+
check_unclaimed_kv_items!(value, rule, entry)
|
|
757
|
+
end
|
|
758
|
+
kv_partition_value(value, attr) { |item| kv_item_matches?(item, rule) }
|
|
759
|
+
end
|
|
760
|
+
|
|
761
|
+
def kv_item_matches?(item, rule)
|
|
762
|
+
return false unless item.is_a?(::Hash)
|
|
763
|
+
|
|
764
|
+
rule.when_attribute.all? do |name, expected|
|
|
765
|
+
actual = Lutaml::Model::Utils.fetch_str_or_sym(item, name.to_s)
|
|
766
|
+
!actual.nil? && actual.to_s == expected.to_s
|
|
767
|
+
end
|
|
768
|
+
end
|
|
769
|
+
|
|
770
|
+
# select/reject over the occurrence shape: an Array filters per
|
|
771
|
+
# item; a single occurrence is kept or dropped as a whole; nil
|
|
772
|
+
# passes through. A dropped occurrence existed on the wire, so a
|
|
773
|
+
# collection attribute reads it as [] rather than absent. A
|
|
774
|
+
# non-hash item satisfies no discriminator, so plain rules keep it
|
|
775
|
+
# and discriminator rules drop it.
|
|
776
|
+
def kv_partition_value(value, attr = nil, &block)
|
|
777
|
+
case value
|
|
778
|
+
when ::Array
|
|
779
|
+
value.select(&block)
|
|
780
|
+
when nil
|
|
781
|
+
nil
|
|
782
|
+
else
|
|
783
|
+
if yield(value)
|
|
784
|
+
value
|
|
785
|
+
else
|
|
786
|
+
attr&.collection? ? [] : nil
|
|
787
|
+
end
|
|
788
|
+
end
|
|
789
|
+
end
|
|
790
|
+
|
|
791
|
+
# lutaml-model#88: fail closed for `unmatched: :raise` — an item
|
|
792
|
+
# no rule on the key claims is exactly the data the default
|
|
793
|
+
# policy silently drops.
|
|
794
|
+
def check_unclaimed_kv_items!(value, rule, entry)
|
|
795
|
+
items = value.is_a?(::Array) ? value : [value]
|
|
796
|
+
tested = entry[:discriminators].flat_map { |s| s.when_attribute.keys }
|
|
797
|
+
.uniq.map(&:to_s)
|
|
798
|
+
items.each do |item|
|
|
799
|
+
next if entry[:discriminators].any? { |s| kv_item_matches?(item, s) }
|
|
800
|
+
|
|
801
|
+
values = tested.filter_map do |name|
|
|
802
|
+
v = item.is_a?(::Hash) &&
|
|
803
|
+
Lutaml::Model::Utils.fetch_str_or_sym(item, name)
|
|
804
|
+
"#{name}=#{v.inspect}" if v
|
|
805
|
+
end
|
|
806
|
+
raise ::Lutaml::Model::UnknownDiscriminatorError,
|
|
807
|
+
"Item at <#{kv_partition_key(rule)}> (#{values.join(', ')}) " \
|
|
808
|
+
"is claimed by no rule: it matches no when_attribute " \
|
|
809
|
+
"discriminator and no plain rule shares the key. Cover the " \
|
|
810
|
+
"value, add a plain rule, or opt out with unmatched: :drop"
|
|
811
|
+
end
|
|
812
|
+
nil
|
|
813
|
+
end
|
|
814
|
+
|
|
815
|
+
# Serialize a partitioned key as one wire value: every rule on the
|
|
816
|
+
# key contributes its items in declaration order, each stamped with
|
|
817
|
+
# its rule's discriminator pairs (unless the item already carries
|
|
818
|
+
# the key — the value's own mapping wins).
|
|
819
|
+
def process_partition_group!(instance, group, hash, format, options)
|
|
820
|
+
wire = rule_from_name(group[:rules].first)
|
|
821
|
+
items = []
|
|
822
|
+
present = false
|
|
823
|
+
group[:rules].each do |rule|
|
|
824
|
+
next unless valid_mapping?(rule, options)
|
|
825
|
+
|
|
826
|
+
scratch = {}
|
|
827
|
+
process_mapping_for_instance(instance, scratch, format, rule, options)
|
|
828
|
+
value = scratch[rule_from_name(rule)]
|
|
829
|
+
next if value.nil?
|
|
830
|
+
|
|
831
|
+
present = true
|
|
832
|
+
Array(value).each do |item|
|
|
833
|
+
items << kv_stamp_discriminator(item, rule)
|
|
834
|
+
end
|
|
835
|
+
end
|
|
836
|
+
return unless present
|
|
837
|
+
|
|
838
|
+
hash[wire] = items
|
|
839
|
+
end
|
|
840
|
+
|
|
841
|
+
def kv_stamp_discriminator(item, rule)
|
|
842
|
+
return item unless item.is_a?(::Hash)
|
|
843
|
+
|
|
844
|
+
missing = {}
|
|
845
|
+
rule.when_attribute.each do |name, expected|
|
|
846
|
+
unless Lutaml::Model::Utils.string_or_symbol_key?(item, name)
|
|
847
|
+
missing[name.to_s] = expected.to_s
|
|
848
|
+
end
|
|
849
|
+
end
|
|
850
|
+
missing.empty? ? item : item.merge(missing)
|
|
851
|
+
end
|
|
852
|
+
|
|
853
|
+
def process_mapping_rule(doc, instance, format, rule, options = {},
|
|
854
|
+
partition = nil)
|
|
855
|
+
plans = walk_plans_for(format)
|
|
856
|
+
plan = plans[rule] ||= build_walk_plan(format, rule)
|
|
857
|
+
kind = plan.kind
|
|
858
|
+
return if kind == :skip
|
|
859
|
+
|
|
860
|
+
raise "Attribute '#{rule.to}' not found in #{self}" unless plan.valid
|
|
861
|
+
|
|
862
|
+
attr = plan.attr
|
|
863
|
+
|
|
864
|
+
# lutaml-model#88: discriminator rules (and plain rules on a
|
|
865
|
+
# partitioned key) must filter the raw value, so they keep the
|
|
866
|
+
# interpretive path.
|
|
867
|
+
partitioned = partition && kv_partition_group(rule, partition)
|
|
868
|
+
if partitioned.nil? && kind == :scalar &&
|
|
869
|
+
(value = kv_fast_extract(doc, plan))
|
|
870
|
+
rule.deserialize(instance, kv_fast_cast(value, plan, instance),
|
|
871
|
+
attributes, self, options[:context], pre_cast: true)
|
|
872
|
+
return
|
|
873
|
+
end
|
|
874
|
+
|
|
875
|
+
value = rule_value_extractor_class.call(rule, doc, format, attr,
|
|
876
|
+
lutaml_register, options, instance)
|
|
877
|
+
if partitioned && !Lutaml::Model::Utils.uninitialized?(value)
|
|
878
|
+
value = apply_kv_when_attribute(value, rule, partitioned, attr)
|
|
879
|
+
end
|
|
880
|
+
value = apply_value_map(value, rule.value_map(:from, options), attr)
|
|
881
|
+
|
|
882
|
+
# An empty value ("", [], {}) is a present value per the
|
|
883
|
+
# missing-values semantics and must reach the custom method;
|
|
884
|
+
# only nil (non-existent) skips it (lutaml-model#746).
|
|
885
|
+
if (kind == :custom) && value.nil?
|
|
886
|
+
return
|
|
887
|
+
end
|
|
888
|
+
|
|
889
|
+
if kind == :custom
|
|
890
|
+
return rule.deserialize(instance, value, attributes, model_class,
|
|
891
|
+
options[:context])
|
|
892
|
+
end
|
|
893
|
+
|
|
894
|
+
value = rule.transform_value(attr, value, :from, format)
|
|
895
|
+
# Hash/child-mapping rules translate a hash document; an absent
|
|
896
|
+
# or explicit-null key has nothing to translate — the attribute
|
|
897
|
+
# keeps its uninitialized/default state (a nil here previously
|
|
898
|
+
# crashed translate_mappings).
|
|
899
|
+
return if value.nil? && kind == :hash_map
|
|
900
|
+
|
|
901
|
+
child_plan = plan.child_map
|
|
902
|
+
value = if child_plan
|
|
903
|
+
translate_child_map_compiled(value, child_plan, attr,
|
|
904
|
+
format, instance)
|
|
905
|
+
else
|
|
906
|
+
translate_mappings(value, rule.hash_mappings, attr, format,
|
|
907
|
+
instance)
|
|
908
|
+
end
|
|
909
|
+
unless kind == :hash_map
|
|
910
|
+
value = cast_value(value, attr, format, rule,
|
|
911
|
+
instance)
|
|
912
|
+
end
|
|
913
|
+
|
|
914
|
+
# Range errors stay eager here. The over-count error only fires when the
|
|
915
|
+
# attribute is not a collection, so this guard defers exactly that case
|
|
916
|
+
# to `.validate` while leaving declared ranges checked at parse. A mapped
|
|
917
|
+
# PORO has no `.validate` to defer into, so it keeps the eager check.
|
|
918
|
+
# singular_tolerance: :first on the KV lane (#971): collapse an
|
|
919
|
+
# over-ingested collection before the writer stores it whole.
|
|
920
|
+
value = value.first if attr.tolerates_singular_overflow?(value)
|
|
921
|
+
|
|
922
|
+
if attr.collection? || !instance.is_a?(Lutaml::Model::Serialize)
|
|
923
|
+
attr.valid_collection!(value, context)
|
|
924
|
+
end
|
|
925
|
+
# No pre_cast here: the interpretive attr.cast is not the full
|
|
926
|
+
# cast chain — whole-value Type policies (e.g. a custom
|
|
927
|
+
# Type::Value that receives the whole hash) are shaped by the
|
|
928
|
+
# setter's cast_value, which must still run.
|
|
929
|
+
rule.deserialize(instance, value, attributes, self,
|
|
930
|
+
options[:context])
|
|
931
|
+
end
|
|
932
|
+
|
|
933
|
+
# Compiled rule plans (TODO.perf/07): for plain scalar rules the
|
|
934
|
+
# per-value interpretation (extraction dispatch, type resolution,
|
|
935
|
+
# per-element probes, validation inside casts) collapses to a
|
|
936
|
+
# precomputed wire name, target class, and identity-guard cast.
|
|
937
|
+
# Guard + cached target — an inline cache per rule. Complex rules
|
|
938
|
+
# (custom methods, transforms, value maps, delegates, hash mappings,
|
|
939
|
+
# unions, polymorphism) return nil and keep the interpretive path.
|
|
940
|
+
WalkPlan = ::Struct.new(:kind, :attr, :valid, :wire, :klass,
|
|
941
|
+
:collection, :child_map)
|
|
942
|
+
|
|
943
|
+
# Compiled child-map translation (#986b): the per-node registry
|
|
944
|
+
# lookups (attribute type, child mapping rules, per-attribute wire
|
|
945
|
+
# names, path string casts) collapse to per-rule constants. nil
|
|
946
|
+
# child_map keeps the interpretive translate path (including its
|
|
947
|
+
# declaration-error timing).
|
|
948
|
+
ChildMapPlan = ::Struct.new(:child_mappings, :wire_names, :paths,
|
|
949
|
+
:keys_only, :child_rules, :attr_type)
|
|
950
|
+
|
|
951
|
+
# Memoized (per transform) wire name for plain rules — the from
|
|
952
|
+
# spelling never changes after definition.
|
|
953
|
+
KvSerializePlan = ::Struct.new(:wire)
|
|
954
|
+
|
|
955
|
+
def build_child_map_plan(format, rule, attr)
|
|
956
|
+
child_mappings = rule.hash_mappings
|
|
957
|
+
return nil unless child_mappings.is_a?(::Hash)
|
|
958
|
+
|
|
959
|
+
attr_type = attr.type(lutaml_register)
|
|
960
|
+
return nil unless attr_type.is_a?(Class) &&
|
|
961
|
+
attr_type.include?(Lutaml::Model::Serialize)
|
|
962
|
+
|
|
963
|
+
child_rules = attr_type.mappings_for(format, lutaml_register)
|
|
964
|
+
wire_names = {}
|
|
965
|
+
paths = {}
|
|
966
|
+
child_mappings.each do |attr_name, path|
|
|
967
|
+
attr_rule = child_rules.find_by_to!(attr_name)
|
|
968
|
+
wire_names[attr_name] = attr_rule.from.to_s
|
|
969
|
+
paths[attr_name] = compile_child_map_path(path)
|
|
970
|
+
end
|
|
971
|
+
ChildMapPlan.new(child_mappings, wire_names, paths,
|
|
972
|
+
child_mappings.values == [:key], child_rules,
|
|
973
|
+
attr_type)
|
|
974
|
+
rescue Lutaml::Model::NoMappingFoundError
|
|
975
|
+
nil
|
|
976
|
+
end
|
|
977
|
+
|
|
978
|
+
def compile_child_map_path(path)
|
|
979
|
+
case path
|
|
980
|
+
when :key then :key
|
|
981
|
+
when :value then :value
|
|
982
|
+
else Array(path).map(&:to_s).freeze
|
|
983
|
+
end
|
|
984
|
+
end
|
|
985
|
+
|
|
986
|
+
# Compiled translate_mappings (#986b). Same shape as the
|
|
987
|
+
# interpretive pair: keys_only is decided once per rule VALUE (the
|
|
988
|
+
# original tests the whole document hash, not each child).
|
|
989
|
+
def translate_child_map_compiled(value, child_plan, attr, format,
|
|
990
|
+
instance)
|
|
991
|
+
child_options = {
|
|
992
|
+
mappings: child_plan.child_rules,
|
|
993
|
+
lutaml_parent: instance,
|
|
994
|
+
lutaml_root: instance.lutaml_root || instance,
|
|
995
|
+
}
|
|
996
|
+
keys_only = child_plan.keys_only && value.values.all?(::Hash)
|
|
997
|
+
wire_names = child_plan.wire_names
|
|
998
|
+
paths = child_plan.paths
|
|
999
|
+
child_mappings = child_plan.child_mappings
|
|
1000
|
+
|
|
1001
|
+
value.map do |key, child_value|
|
|
1002
|
+
child_hash = {}
|
|
1003
|
+
child_mappings.each_key do |attr_name|
|
|
1004
|
+
child_hash[wire_names[attr_name]] =
|
|
1005
|
+
extract_compiled_child_value(paths[attr_name], key, child_value)
|
|
1006
|
+
end
|
|
1007
|
+
child_hash.merge!(child_value) if keys_only
|
|
1008
|
+
map_child_data(child_hash, attr, format, instance, child_plan,
|
|
1009
|
+
child_options)
|
|
1010
|
+
end
|
|
1011
|
+
end
|
|
1012
|
+
|
|
1013
|
+
def extract_compiled_child_value(compiled_path, key, value)
|
|
1014
|
+
case compiled_path
|
|
1015
|
+
when :key then key
|
|
1016
|
+
when :value then value
|
|
1017
|
+
else value.dig(*compiled_path)
|
|
1018
|
+
end
|
|
1019
|
+
end
|
|
1020
|
+
|
|
1021
|
+
def kv_serialize_plan(rule, attr, _instance)
|
|
1022
|
+
return nil if rule.delegate || rule.raw_mapping? || rule.root_mapping? ||
|
|
1023
|
+
rule.hash_mappings || rule.child_mappings ||
|
|
1024
|
+
rule.has_custom_method_for_serialization? ||
|
|
1025
|
+
rule.when_attribute? || rule.multiple_mappings? ||
|
|
1026
|
+
polymorphic_rule?(rule) ||
|
|
1027
|
+
(rule.transform.is_a?(Hash) && !rule.transform.empty?) ||
|
|
1028
|
+
rule.transform.is_a?(Class) || attr.nil? || attr.derived? ||
|
|
1029
|
+
attr.union? || attr.polymorphic? || attr.custom_collection? ||
|
|
1030
|
+
attr.transform ||
|
|
1031
|
+
rule.value_map(:to) != Lutaml::Model::Serialize::DEFAULT_VALUE_MAP
|
|
1032
|
+
|
|
1033
|
+
@kv_serialize_plans ||= {}.compare_by_identity
|
|
1034
|
+
@kv_serialize_plans[rule] ||= KvSerializePlan.new(rule_from_name(rule))
|
|
1035
|
+
end
|
|
1036
|
+
|
|
1037
|
+
def walk_plans_for(format)
|
|
1038
|
+
generation = Lutaml::Model::GlobalContext.context_generation
|
|
1039
|
+
if @lutaml_walk_plans.nil? || @lutaml_walk_generation != generation ||
|
|
1040
|
+
@lutaml_walk_format != format
|
|
1041
|
+
key = [model_class, lutaml_register, format, generation,
|
|
1042
|
+
@lutaml_mapping_override]
|
|
1043
|
+
@lutaml_walk_plans =
|
|
1044
|
+
(KV_WALK_PLANS[key] ||= build_walk_plans(format))
|
|
1045
|
+
@lutaml_walk_generation = generation
|
|
1046
|
+
@lutaml_walk_format = format
|
|
1047
|
+
end
|
|
1048
|
+
@lutaml_walk_plans
|
|
1049
|
+
end
|
|
1050
|
+
|
|
1051
|
+
def build_walk_plans(format)
|
|
1052
|
+
plans = {}.compare_by_identity
|
|
1053
|
+
mappings_for(format).mappings(lutaml_register).each do |rule|
|
|
1054
|
+
plans[rule] = build_walk_plan(format, rule)
|
|
1055
|
+
end
|
|
1056
|
+
plans
|
|
1057
|
+
end
|
|
1058
|
+
|
|
1059
|
+
# The per-rule dispatch compile. Kind precedence mirrors the
|
|
1060
|
+
# interpretive method exactly: skip (derived) > invalid >
|
|
1061
|
+
# custom (deserialization custom method) > hash_map
|
|
1062
|
+
# (hash_mappings truthy — translate, never cast) > scalar (the
|
|
1063
|
+
# fast-extract eligibility) > interpretive.
|
|
1064
|
+
def build_walk_plan(format, rule, _attrs = nil)
|
|
1065
|
+
attr = attribute_for_rule(rule)
|
|
1066
|
+
return WalkPlan.new(:skip, nil, false, nil, nil, false) if attr&.derived?
|
|
1067
|
+
|
|
1068
|
+
valid = valid_rule?(rule, attr)
|
|
1069
|
+
kind =
|
|
1070
|
+
if rule.has_custom_method_for_deserialization?
|
|
1071
|
+
:custom
|
|
1072
|
+
elsif rule.hash_mappings
|
|
1073
|
+
:hash_map
|
|
1074
|
+
else
|
|
1075
|
+
plan = build_kv_rule_plan(format, rule, attr)
|
|
1076
|
+
plan ? :scalar : :interpretive
|
|
1077
|
+
end
|
|
1078
|
+
|
|
1079
|
+
if kind == :hash_map && attr
|
|
1080
|
+
child = build_child_map_plan(format, rule, attr)
|
|
1081
|
+
return WalkPlan.new(:hash_map, attr, valid, nil, nil, false, child)
|
|
1082
|
+
end
|
|
1083
|
+
|
|
1084
|
+
plan || WalkPlan.new(kind, attr, valid, nil, nil, false)
|
|
1085
|
+
end
|
|
1086
|
+
|
|
1087
|
+
# `rule.polymorphic` defaults to an empty Hash, which is truthy —
|
|
1088
|
+
# presence is emptiness-based, mirroring MappingRule#polymorphic_mapping?.
|
|
1089
|
+
def polymorphic_rule?(rule)
|
|
1090
|
+
poly = rule.polymorphic
|
|
1091
|
+
poly.respond_to?(:empty?) ? !poly.empty? : !!poly
|
|
1092
|
+
end
|
|
1093
|
+
|
|
1094
|
+
def build_kv_rule_plan(_format, rule, attr)
|
|
1095
|
+
return nil if rule.raw_mapping? ||
|
|
1096
|
+
rule.has_custom_method_for_deserialization? ||
|
|
1097
|
+
rule.hash_mappings || rule.multiple_mappings? ||
|
|
1098
|
+
polymorphic_rule?(rule) || rule.delegate ||
|
|
1099
|
+
(rule.transform.is_a?(Hash) && !rule.transform.empty?) ||
|
|
1100
|
+
rule.transform.is_a?(Class) ||
|
|
1101
|
+
attr.derived? ||
|
|
1102
|
+
attr.union? || attr.polymorphic? ||
|
|
1103
|
+
attr.custom_collection?
|
|
1104
|
+
|
|
1105
|
+
type = attr.type(lutaml_register)
|
|
1106
|
+
return nil unless type.is_a?(Class) &&
|
|
1107
|
+
type < ::Lutaml::Model::Type::Value &&
|
|
1108
|
+
!attr.value_policy.whole_value?(type) &&
|
|
1109
|
+
!Lutaml::Model::Attribute.custom_from_probe?(type)
|
|
1110
|
+
|
|
1111
|
+
WalkPlan.new(:scalar, attr, true, rule.name.to_s, type,
|
|
1112
|
+
attr.collection?)
|
|
1113
|
+
end
|
|
1114
|
+
|
|
1115
|
+
# Extraction fast path: plain hash fetch for a present, non-blank
|
|
1116
|
+
# value. nil/blank values keep the interpretive path — their
|
|
1117
|
+
# value-map/missing-value semantics must not be duplicated here.
|
|
1118
|
+
def kv_fast_extract(doc, plan)
|
|
1119
|
+
return nil unless doc.is_a?(::Hash)
|
|
1120
|
+
|
|
1121
|
+
v = doc[plan.wire]
|
|
1122
|
+
return nil if v.nil?
|
|
1123
|
+
return nil if v.is_a?(::String) && v.empty?
|
|
1124
|
+
return nil if v.is_a?(::Array) && (v.empty? || !plan.collection)
|
|
1125
|
+
# Structured values on scalar plans keep the interpretive path —
|
|
1126
|
+
# its collection guidance error and cast semantics own them.
|
|
1127
|
+
return nil if v.is_a?(::Hash)
|
|
1128
|
+
|
|
1129
|
+
v
|
|
1130
|
+
end
|
|
1131
|
+
|
|
1132
|
+
# Cast fast path: identity when the value already has the target
|
|
1133
|
+
# class (the overwhelming case for engine-typed scalars), the type's
|
|
1134
|
+
# cast otherwise. Collections cast per element.
|
|
1135
|
+
def kv_fast_cast(value, plan, _instance)
|
|
1136
|
+
if plan.collection
|
|
1137
|
+
unless value.is_a?(::Array)
|
|
1138
|
+
return value.is_a?(plan.klass) ? value : plan.klass.cast(value)
|
|
1139
|
+
end
|
|
1140
|
+
|
|
1141
|
+
klass = plan.klass
|
|
1142
|
+
value.map { |e| e.is_a?(klass) ? e : klass.cast(e) }
|
|
1143
|
+
else
|
|
1144
|
+
value.is_a?(plan.klass) ? value : plan.klass.cast(value)
|
|
1145
|
+
end
|
|
1146
|
+
end
|
|
1147
|
+
|
|
1148
|
+
def cast_value(value, attr, format, rule, instance)
|
|
1149
|
+
cast_options = rule.polymorphic ? { polymorphic: rule.polymorphic } : {}
|
|
1150
|
+
cast_options[:lutaml_parent] = instance if instance
|
|
1151
|
+
if instance
|
|
1152
|
+
cast_options[:lutaml_root] =
|
|
1153
|
+
(instance.lutaml_root || instance)
|
|
1154
|
+
end
|
|
1155
|
+
attr.cast(value, format, lutaml_register, cast_options)
|
|
1156
|
+
end
|
|
1157
|
+
|
|
1158
|
+
def translate_mappings(hash, child_mappings, attr, format, instance)
|
|
1159
|
+
return hash unless child_mappings
|
|
1160
|
+
|
|
1161
|
+
hash.map do |key, value|
|
|
1162
|
+
process_child_mapping(key, value, child_mappings, attr, format, hash,
|
|
1163
|
+
instance)
|
|
1164
|
+
end
|
|
1165
|
+
end
|
|
1166
|
+
|
|
1167
|
+
def process_child_mapping(key, value, child_mappings, attr, format, hash,
|
|
1168
|
+
instance)
|
|
1169
|
+
child_hash = build_child_hash(key, value, child_mappings, attr, format)
|
|
1170
|
+
|
|
1171
|
+
if only_keys_mapped?(child_mappings, hash)
|
|
1172
|
+
child_hash.merge!(value)
|
|
1173
|
+
end
|
|
1174
|
+
|
|
1175
|
+
map_child_data(child_hash, attr, format, instance)
|
|
1176
|
+
end
|
|
1177
|
+
|
|
1178
|
+
def build_child_hash(key, value, child_mappings, attr, format)
|
|
1179
|
+
attr_type = attr.type(lutaml_register)
|
|
1180
|
+
child_mappings.to_h do |attr_name, path|
|
|
1181
|
+
attr_value = extract_attr_value(path, key, value)
|
|
1182
|
+
attr_rule = attr_type.mappings_for(format,
|
|
1183
|
+
lutaml_register).find_by_to!(attr_name)
|
|
1184
|
+
[attr_rule.from.to_s, attr_value]
|
|
1185
|
+
end
|
|
1186
|
+
end
|
|
1187
|
+
|
|
1188
|
+
def extract_attr_value(path, key, value)
|
|
1189
|
+
case path
|
|
1190
|
+
when :key then key
|
|
1191
|
+
when :value then value
|
|
1192
|
+
else
|
|
1193
|
+
path = Array(path)
|
|
1194
|
+
value.dig(*path.map(&:to_s))
|
|
1195
|
+
end
|
|
1196
|
+
end
|
|
1197
|
+
|
|
1198
|
+
def only_keys_mapped?(child_mappings, hash)
|
|
1199
|
+
child_mappings.values == [:key] && hash.values.all?(::Hash)
|
|
1200
|
+
end
|
|
1201
|
+
|
|
1202
|
+
def map_child_data(child_hash, attr, format, instance,
|
|
1203
|
+
child_plan = nil, child_options = nil)
|
|
1204
|
+
if child_plan
|
|
1205
|
+
self.class.data_to_model(child_plan.attr_type, child_hash, format,
|
|
1206
|
+
child_options)
|
|
1207
|
+
else
|
|
1208
|
+
attr_type = attr.type(lutaml_register)
|
|
1209
|
+
options = {
|
|
1210
|
+
mappings: attr_type.mappings_for(format, lutaml_register),
|
|
1211
|
+
lutaml_parent: instance,
|
|
1212
|
+
lutaml_root: instance.lutaml_root || instance,
|
|
1213
|
+
}
|
|
1214
|
+
self.class.data_to_model(attr_type, child_hash, format, options)
|
|
1215
|
+
end
|
|
1216
|
+
end
|
|
1217
|
+
|
|
1218
|
+
def rule_value_extractor_class
|
|
1219
|
+
Lutaml::Model::RuleValueExtractor
|
|
1220
|
+
end
|
|
1221
|
+
end
|
|
1222
|
+
end
|
|
1223
|
+
end
|