lutaml 0.11.6 → 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,1276 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module Lutaml
|
|
4
|
+
module KeyValue
|
|
5
|
+
# KeyValue-specific transformation implementation.
|
|
6
|
+
#
|
|
7
|
+
# Transforms model instances into KeyValueElement trees without
|
|
8
|
+
# serialization concerns. This provides the same architectural
|
|
9
|
+
# pattern as Xml::Transformation but for key-value formats
|
|
10
|
+
# (JSON, YAML, TOML).
|
|
11
|
+
#
|
|
12
|
+
# Architecture:
|
|
13
|
+
# - Content Layer: KeyValueElement defines WHAT to serialize
|
|
14
|
+
# - Presentation Layer: Adapters define HOW to serialize
|
|
15
|
+
#
|
|
16
|
+
# This is a critical step toward symmetric OOP architecture
|
|
17
|
+
# across all serialization formats.
|
|
18
|
+
# Coerces values the model layer accepted into a rule's declared
|
|
19
|
+
# nested type (lutaml-model#1089): constructors and writers accept
|
|
20
|
+
# raw hashes, sibling Serializable instances, and content scalars,
|
|
21
|
+
# but the KeyValue serializer demanded exact declared-class
|
|
22
|
+
# instances — accept-then-explode mid-render. Hashes construct
|
|
23
|
+
# directly; Serializable siblings round-trip through the framework
|
|
24
|
+
# hash; scalars wrap onto the declared type's content attribute
|
|
25
|
+
# when its XML mapping declares one (`map_content to: :x` — the
|
|
26
|
+
# same semantics the XML lane applies to text). Genuinely
|
|
27
|
+
# un-coercible values pass through unchanged so the caller's
|
|
28
|
+
# validation raises with its own message.
|
|
29
|
+
module NestedValueCoercion
|
|
30
|
+
@content_attributes = {}.compare_by_identity
|
|
31
|
+
|
|
32
|
+
# The attribute a declared type's XML mapping designates as its
|
|
33
|
+
# textual content. Class-level memo: the answer is a static
|
|
34
|
+
# per-type mapping fact. Keyed by type only; register-specific
|
|
35
|
+
# content mappings are not a supported combination.
|
|
36
|
+
def self.content_attribute_for(type)
|
|
37
|
+
@content_attributes[type] ||= begin
|
|
38
|
+
mapping = type.mappings_for(:xml)
|
|
39
|
+
mapping&.content_mapping&.to
|
|
40
|
+
end
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
def self.coerce(value, declared_class)
|
|
44
|
+
if value.is_a?(::Hash)
|
|
45
|
+
declared_class.new(value)
|
|
46
|
+
elsif value.is_a?(Lutaml::Model::Serialize)
|
|
47
|
+
declared_class.new(value.to_hash)
|
|
48
|
+
elsif (content_key = content_attribute_for(declared_class))
|
|
49
|
+
declared_class.new(content_key => value)
|
|
50
|
+
else
|
|
51
|
+
value
|
|
52
|
+
end
|
|
53
|
+
end
|
|
54
|
+
end
|
|
55
|
+
|
|
56
|
+
class Transformation < Lutaml::Model::Transformation
|
|
57
|
+
# Builtin Value types whose cast of an already-native value is the
|
|
58
|
+
# identity — used by the serialize_value fast path.
|
|
59
|
+
NATIVE_VALUE_CLASS = {
|
|
60
|
+
::Lutaml::Model::Type::String => ::String,
|
|
61
|
+
::Lutaml::Model::Type::Integer => ::Integer,
|
|
62
|
+
::Lutaml::Model::Type::Float => ::Float,
|
|
63
|
+
::Lutaml::Model::Type::Date => ::Date,
|
|
64
|
+
::Lutaml::Model::Type::Time => ::Time,
|
|
65
|
+
::Lutaml::Model::Type::DateTime => ::DateTime,
|
|
66
|
+
::Lutaml::Model::Type::Symbol => ::Symbol,
|
|
67
|
+
}.freeze
|
|
68
|
+
|
|
69
|
+
include Lutaml::Model::RenderPolicy
|
|
70
|
+
|
|
71
|
+
autoload :RuleCompiler, "#{__dir__}/transformation/rule_compiler"
|
|
72
|
+
autoload :ValueSerializer, "#{__dir__}/transformation/value_serializer"
|
|
73
|
+
autoload :CollectionSerializer,
|
|
74
|
+
"#{__dir__}/transformation/collection_serializer"
|
|
75
|
+
|
|
76
|
+
# Initialize serializers before calling super
|
|
77
|
+
# This must happen before super calls freeze
|
|
78
|
+
#
|
|
79
|
+
# @param model_class [Class] The model class to transform
|
|
80
|
+
# @param mapping_dsl [Mapping] The mapping DSL to compile
|
|
81
|
+
# @param format [Symbol] The format (:json, :yaml, :toml)
|
|
82
|
+
# @param register [Register, nil] The register for type resolution
|
|
83
|
+
def initialize(model_class, mapping_dsl, format, register)
|
|
84
|
+
# Extract register_id before super
|
|
85
|
+
register_id = extract_register_id(register)
|
|
86
|
+
# #985: the catch-all target (collected unknown keys) — merged
|
|
87
|
+
# after the compiled rules on serialize; mapped keys win. The
|
|
88
|
+
# DSL object is a KeyValue::Mapping by contract, and the target
|
|
89
|
+
# must be a declared attribute: a typo fails here, at compile
|
|
90
|
+
# time, not as a silent no-op on the wire.
|
|
91
|
+
@unmapped_attribute = mapping_dsl.unmapped_attribute
|
|
92
|
+
if @unmapped_attribute &&
|
|
93
|
+
!model_class.attributes(register_id).key?(@unmapped_attribute)
|
|
94
|
+
raise ArgumentError,
|
|
95
|
+
"map_unmapped target :#{@unmapped_attribute} is not a " \
|
|
96
|
+
"declared attribute of #{model_class}"
|
|
97
|
+
end
|
|
98
|
+
transformation_factory = ->(type_class) {
|
|
99
|
+
build_child_transformation(type_class)
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
# Set up serializers before calling super
|
|
103
|
+
# The super will call compile_rules and freeze
|
|
104
|
+
# Pre-declared: the transformation is frozen after compile, and
|
|
105
|
+
# the type-transformation memo mutates this hash in place.
|
|
106
|
+
@lutaml_type_transformations = {}
|
|
107
|
+
@rule_compiler = RuleCompiler.new(
|
|
108
|
+
model_class: model_class,
|
|
109
|
+
register_id: register_id,
|
|
110
|
+
format: format,
|
|
111
|
+
transformation_factory: transformation_factory,
|
|
112
|
+
)
|
|
113
|
+
|
|
114
|
+
@value_serializer = ValueSerializer.new(
|
|
115
|
+
format: format,
|
|
116
|
+
register_id: register_id,
|
|
117
|
+
model_class: model_class,
|
|
118
|
+
transformation_factory: transformation_factory,
|
|
119
|
+
)
|
|
120
|
+
|
|
121
|
+
@collection_serializer = CollectionSerializer.new(
|
|
122
|
+
format: format,
|
|
123
|
+
register_id: register_id,
|
|
124
|
+
value_serializer: @value_serializer,
|
|
125
|
+
transformation_factory: transformation_factory,
|
|
126
|
+
)
|
|
127
|
+
|
|
128
|
+
super
|
|
129
|
+
end
|
|
130
|
+
|
|
131
|
+
# Extract register_id from register parameter
|
|
132
|
+
#
|
|
133
|
+
# @param register [Register, Symbol, nil] The register
|
|
134
|
+
# @return [Symbol, nil] The register ID
|
|
135
|
+
def extract_register_id(register)
|
|
136
|
+
case register
|
|
137
|
+
when Lutaml::Model::Register
|
|
138
|
+
register.id
|
|
139
|
+
when Symbol
|
|
140
|
+
register
|
|
141
|
+
else
|
|
142
|
+
Lutaml::Model::Config.default_register
|
|
143
|
+
end
|
|
144
|
+
end
|
|
145
|
+
|
|
146
|
+
# Build child transformation for nested model
|
|
147
|
+
#
|
|
148
|
+
# @param type_class [Class] The nested model class
|
|
149
|
+
# @param format [Symbol] The format
|
|
150
|
+
# @param register [Register, nil] The register
|
|
151
|
+
# @return [Transformation, nil] Child transformation or nil
|
|
152
|
+
def build_child_transformation(type_class, format = self.format,
|
|
153
|
+
register = self.register)
|
|
154
|
+
return nil unless type_class.is_a?(Class) &&
|
|
155
|
+
type_class.include?(Lutaml::Model::Serialize)
|
|
156
|
+
|
|
157
|
+
# Prevent infinite recursion for self-referential models
|
|
158
|
+
compilation_stack = Thread.current[:lutaml_compilation_stack] ||= []
|
|
159
|
+
return nil if compilation_stack.include?(type_class)
|
|
160
|
+
|
|
161
|
+
compilation_stack.push(type_class)
|
|
162
|
+
begin
|
|
163
|
+
# Get the mapping for the current format
|
|
164
|
+
mapping = type_class.mappings_for(format,
|
|
165
|
+
extract_register_id(register))
|
|
166
|
+
|
|
167
|
+
# Create a new Transformation instance with the mapping
|
|
168
|
+
self.class.new(type_class, mapping, format, register)
|
|
169
|
+
ensure
|
|
170
|
+
compilation_stack.pop
|
|
171
|
+
end
|
|
172
|
+
end
|
|
173
|
+
|
|
174
|
+
# lutaml-model#88: rules sharing a wire key through when_attribute
|
|
175
|
+
# must serialize as ONE value — group them here, before freeze.
|
|
176
|
+
# Rules with custom `to` methods or delegates keep their own path;
|
|
177
|
+
# a key mixing them with discriminator rules is not a partition.
|
|
178
|
+
def after_compile
|
|
179
|
+
partitioned_names = nil
|
|
180
|
+
compiled_rules.each do |rule|
|
|
181
|
+
pairs = rule.option(:when_attribute)
|
|
182
|
+
next if pairs.nil? || pairs.empty?
|
|
183
|
+
|
|
184
|
+
(partitioned_names ||= {})[rule.serialized_name] = true
|
|
185
|
+
end
|
|
186
|
+
return unless partitioned_names
|
|
187
|
+
|
|
188
|
+
groups = {}
|
|
189
|
+
by_rule = {}.compare_by_identity
|
|
190
|
+
compiled_rules.each do |rule|
|
|
191
|
+
name = rule.serialized_name
|
|
192
|
+
next unless partitioned_names[name]
|
|
193
|
+
next if (rule.custom_methods || {}).key?(:to) || rule.option(:delegate)
|
|
194
|
+
|
|
195
|
+
entry = (groups[name] ||= [])
|
|
196
|
+
entry << rule
|
|
197
|
+
by_rule[rule] = entry
|
|
198
|
+
end
|
|
199
|
+
groups.each_value(&:freeze)
|
|
200
|
+
|
|
201
|
+
@partition_groups = groups.freeze
|
|
202
|
+
@partitioned_rules = by_rule
|
|
203
|
+
end
|
|
204
|
+
|
|
205
|
+
private
|
|
206
|
+
|
|
207
|
+
# Get the register ID, handling both Symbol and Register objects
|
|
208
|
+
# This normalizes the register to an ID for backward compatibility
|
|
209
|
+
#
|
|
210
|
+
# @return [Symbol, nil] The register ID
|
|
211
|
+
def register_id
|
|
212
|
+
return @register if @register.is_a?(Symbol)
|
|
213
|
+
|
|
214
|
+
@register_id
|
|
215
|
+
end
|
|
216
|
+
|
|
217
|
+
# Compile key-value mapping DSL into pre-compiled rules
|
|
218
|
+
#
|
|
219
|
+
# @param mapping_dsl [Mapping::KeyValueMapping] The mapping to compile
|
|
220
|
+
# @return [Array<CompiledRule>] Array of compiled transformation rules
|
|
221
|
+
def compile_rules(mapping_dsl)
|
|
222
|
+
rule_compiler.compile(mapping_dsl)
|
|
223
|
+
end
|
|
224
|
+
|
|
225
|
+
# Get the rule compiler instance
|
|
226
|
+
#
|
|
227
|
+
# @return [RuleCompiler] The rule compiler
|
|
228
|
+
def rule_compiler
|
|
229
|
+
@rule_compiler
|
|
230
|
+
end
|
|
231
|
+
|
|
232
|
+
# Get the value serializer instance
|
|
233
|
+
#
|
|
234
|
+
# @return [ValueSerializer] The value serializer
|
|
235
|
+
def value_serializer
|
|
236
|
+
@value_serializer
|
|
237
|
+
end
|
|
238
|
+
|
|
239
|
+
# Get the collection serializer instance
|
|
240
|
+
#
|
|
241
|
+
# @return [CollectionSerializer] The collection serializer
|
|
242
|
+
def collection_serializer
|
|
243
|
+
@collection_serializer
|
|
244
|
+
end
|
|
245
|
+
|
|
246
|
+
# Check if a mapping rule should be applied based on only/except options
|
|
247
|
+
#
|
|
248
|
+
# @param rule [CompiledRule] The rule to check
|
|
249
|
+
# @param options [Hash] Transformation options (may contain :only, :except)
|
|
250
|
+
# @return [Boolean] true if the rule should be applied
|
|
251
|
+
def valid_mapping?(rule, options)
|
|
252
|
+
rule_compiler.valid_mapping?(rule, options)
|
|
253
|
+
end
|
|
254
|
+
|
|
255
|
+
public
|
|
256
|
+
|
|
257
|
+
# Transform a model instance into KeyValueElement tree
|
|
258
|
+
#
|
|
259
|
+
# @param model_instance [Object] The model instance to transform
|
|
260
|
+
# @param options [Hash] Transformation options (supports :only, :except for filtering)
|
|
261
|
+
# @return [Lutaml::KeyValue::DataModel::Element] The root element
|
|
262
|
+
def transform(model_instance, options = {})
|
|
263
|
+
# For key-value formats, we typically don't have a named root
|
|
264
|
+
# Instead, we create an anonymous root that holds all attributes
|
|
265
|
+
# Hash-direct emission (TODO.perf 19): the output hash is built
|
|
266
|
+
# directly; the intermediate Element tree and its flatten are gone.
|
|
267
|
+
root = {}
|
|
268
|
+
|
|
269
|
+
# Apply each compiled rule (with filtering support). A
|
|
270
|
+
# when_attribute partition applies once for its whole key.
|
|
271
|
+
handled_groups = nil
|
|
272
|
+
compiled_rules.each do |rule|
|
|
273
|
+
# Check if this rule should be applied based on only/except options
|
|
274
|
+
next unless valid_mapping?(rule, options)
|
|
275
|
+
|
|
276
|
+
if @partitioned_rules && (group = @partitioned_rules[rule])
|
|
277
|
+
next if handled_groups&.include?(group)
|
|
278
|
+
|
|
279
|
+
(handled_groups ||= []) << group
|
|
280
|
+
apply_partition_group(root, group, model_instance, options)
|
|
281
|
+
else
|
|
282
|
+
apply_rule(root, rule, model_instance, options)
|
|
283
|
+
end
|
|
284
|
+
end
|
|
285
|
+
|
|
286
|
+
if @unmapped_attribute
|
|
287
|
+
extras = model_instance.public_send(@unmapped_attribute)
|
|
288
|
+
extras.each { |key, value| root[key] ||= value } if extras.is_a?(::Hash)
|
|
289
|
+
end
|
|
290
|
+
|
|
291
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
292
|
+
puts "=== TRANSFORM COMPLETE ==="
|
|
293
|
+
puts "root: #{root.inspect}"
|
|
294
|
+
end
|
|
295
|
+
|
|
296
|
+
root
|
|
297
|
+
end
|
|
298
|
+
|
|
299
|
+
private
|
|
300
|
+
|
|
301
|
+
# The rule's value on the instance, initializing an absent
|
|
302
|
+
# delegate target like apply_rule does.
|
|
303
|
+
def extract_rule_value(rule, model_instance)
|
|
304
|
+
delegate = rule.option(:delegate)
|
|
305
|
+
unless delegate
|
|
306
|
+
return model_instance.public_send(rule.attribute_name)
|
|
307
|
+
end
|
|
308
|
+
|
|
309
|
+
delegated_object = model_instance.public_send(delegate)
|
|
310
|
+
if delegated_object.nil? ||
|
|
311
|
+
Lutaml::Model::Utils.uninitialized?(delegated_object)
|
|
312
|
+
delegate_attr = model_class.attributes(register_id)&.[](delegate)
|
|
313
|
+
if delegate_attr
|
|
314
|
+
delegated_object = delegate_attr.type(register_id).new
|
|
315
|
+
model_instance.public_send(:"#{delegate}=", delegated_object)
|
|
316
|
+
end
|
|
317
|
+
end
|
|
318
|
+
delegated_object&.public_send(rule.attribute_name)
|
|
319
|
+
end
|
|
320
|
+
|
|
321
|
+
# Serialize one when_attribute partition: every rule on the key
|
|
322
|
+
# contributes its items in declaration order, each stamped with
|
|
323
|
+
# its rule's discriminator pairs (unless the item's own mapping
|
|
324
|
+
# already wrote the key). The wire value is an array whenever any
|
|
325
|
+
# rule had a present value.
|
|
326
|
+
def apply_partition_group(parent, group, model_instance, options)
|
|
327
|
+
items = []
|
|
328
|
+
present = false
|
|
329
|
+
group.each do |rule|
|
|
330
|
+
next unless valid_mapping?(rule, options)
|
|
331
|
+
|
|
332
|
+
value = extract_rule_value(rule, model_instance)
|
|
333
|
+
next if should_skip_value?(value, rule, model_instance,
|
|
334
|
+
rule.option(:delegate))
|
|
335
|
+
|
|
336
|
+
value = rule.transform_value(value, :export) if rule.value_transformer
|
|
337
|
+
|
|
338
|
+
present = true
|
|
339
|
+
Array(value).each do |item|
|
|
340
|
+
child = create_value_for_item(rule, item, options)
|
|
341
|
+
next if child.nil?
|
|
342
|
+
|
|
343
|
+
items << stamp_discriminator(child, rule)
|
|
344
|
+
end
|
|
345
|
+
end
|
|
346
|
+
return unless present
|
|
347
|
+
|
|
348
|
+
# Items are stamped hashes or primitives: the tree's
|
|
349
|
+
# children_to_array semantics, expressed directly.
|
|
350
|
+
parent[group.first.serialized_name] = items
|
|
351
|
+
end
|
|
352
|
+
|
|
353
|
+
def stamp_discriminator(item, rule)
|
|
354
|
+
pairs = rule.option(:when_attribute)
|
|
355
|
+
return item if pairs.nil? || pairs.empty? || !item.is_a?(::Hash)
|
|
356
|
+
|
|
357
|
+
missing = {}
|
|
358
|
+
pairs.each do |name, expected|
|
|
359
|
+
unless Lutaml::Model::Utils.string_or_symbol_key?(item, name)
|
|
360
|
+
missing[name.to_s] = expected.to_s
|
|
361
|
+
end
|
|
362
|
+
end
|
|
363
|
+
missing.empty? ? item : item.merge(missing)
|
|
364
|
+
end
|
|
365
|
+
|
|
366
|
+
# Apply a single transformation rule
|
|
367
|
+
#
|
|
368
|
+
# @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
|
|
369
|
+
# @param rule [CompiledRule] The rule to apply
|
|
370
|
+
# @param model_instance [Object] The model instance
|
|
371
|
+
# @param options [Hash] Transformation options
|
|
372
|
+
def apply_rule(parent, rule, model_instance, options)
|
|
373
|
+
# DEBUG for keyed collections
|
|
374
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
375
|
+
puts "apply_rule: #{rule.serialized_name}, collection?: #{rule.collection?}"
|
|
376
|
+
if rule.collection?
|
|
377
|
+
puts " collection_info: #{rule.collection_info.inspect}"
|
|
378
|
+
puts " child_mappings: #{rule.collection_info && rule.collection_info[:child_mappings].inspect}"
|
|
379
|
+
end
|
|
380
|
+
end
|
|
381
|
+
|
|
382
|
+
# Handle custom serialization methods (e.g., with: { to: ... })
|
|
383
|
+
if rule.has_custom_methods? && rule.custom_methods[:to]
|
|
384
|
+
to_method = rule.custom_methods[:to]
|
|
385
|
+
# Custom methods receive an Element "doc" and populate it
|
|
386
|
+
# (public contract, TODO.perf 19 keeps it): only the doc's
|
|
387
|
+
# payload — the merged children or the direct value hash —
|
|
388
|
+
# is merged into the output.
|
|
389
|
+
doc = Lutaml::KeyValue::DataModel::Element.new(rule.serialized_name)
|
|
390
|
+
# Custom methods may write children, or doc.value[key]=, or
|
|
391
|
+
# nothing at all (pubid 2.0 regression: an empty scratch
|
|
392
|
+
# flattened to {key => nil} and crashed the merge). Seed the
|
|
393
|
+
# value hash and merge only hash-shaped results.
|
|
394
|
+
doc.value = {}
|
|
395
|
+
# lutaml-model#550: custom methods may declare a third context
|
|
396
|
+
# parameter to receive the options passed to `to_*`.
|
|
397
|
+
if Lutaml::Model::MappingRule.custom_method_arity(model_instance.class, to_method).to_i >= 3
|
|
398
|
+
model_instance.public_send(to_method, model_instance,
|
|
399
|
+
doc, options[:context])
|
|
400
|
+
else
|
|
401
|
+
model_instance.public_send(to_method, model_instance, doc)
|
|
402
|
+
end
|
|
403
|
+
# The 0.8.68 contract: only the method's doc mutations count —
|
|
404
|
+
# its return value is ignored. (A mutation-style handler whose
|
|
405
|
+
# last statement is an assignment returns the assigned inner
|
|
406
|
+
# value; honoring it merged child content at the wrong level —
|
|
407
|
+
# lutaml-model#892.) A doc whose payload is not a hash — nil
|
|
408
|
+
# (untouched), a scalar, or an array of primitives — serializes
|
|
409
|
+
# as nothing, matching the pre-0.8.74 behavior.
|
|
410
|
+
merged = doc.payload
|
|
411
|
+
parent.update(merged) if merged.is_a?(::Hash)
|
|
412
|
+
return
|
|
413
|
+
end
|
|
414
|
+
|
|
415
|
+
# Handle delegation - extract value from delegated object
|
|
416
|
+
delegate = rule.option(:delegate)
|
|
417
|
+
if delegate
|
|
418
|
+
# Get the delegated object
|
|
419
|
+
delegated_object = model_instance.public_send(delegate)
|
|
420
|
+
|
|
421
|
+
# Initialize delegated object if nil/uninitialized (like legacy does)
|
|
422
|
+
if delegated_object.nil? || Lutaml::Model::Utils.uninitialized?(delegated_object)
|
|
423
|
+
# Get the delegate attribute from model to create a new instance
|
|
424
|
+
delegate_attr = model_class.attributes(register_id)&.[](delegate)
|
|
425
|
+
if delegate_attr
|
|
426
|
+
delegated_object = delegate_attr.type(register_id).new
|
|
427
|
+
model_instance.public_send(:"#{delegate}=", delegated_object)
|
|
428
|
+
end
|
|
429
|
+
end
|
|
430
|
+
|
|
431
|
+
# Extract value from delegated object
|
|
432
|
+
value = delegated_object&.public_send(rule.attribute_name)
|
|
433
|
+
else
|
|
434
|
+
# Get attribute value directly
|
|
435
|
+
value = model_instance.public_send(rule.attribute_name)
|
|
436
|
+
end
|
|
437
|
+
|
|
438
|
+
# Handle raw mapping (map_all directive)
|
|
439
|
+
# Raw mappings parse the stored content and merge it directly into the parent
|
|
440
|
+
if rule.option(:mapping_type) == :raw
|
|
441
|
+
return handle_raw_mapping(parent, value, options)
|
|
442
|
+
end
|
|
443
|
+
|
|
444
|
+
# Check if value should be skipped
|
|
445
|
+
skip_result = should_skip_value?(value, rule, model_instance,
|
|
446
|
+
delegate)
|
|
447
|
+
|
|
448
|
+
return if skip_result
|
|
449
|
+
|
|
450
|
+
# Apply export transformation if present
|
|
451
|
+
if rule.value_transformer
|
|
452
|
+
value = rule.transform_value(value, :export)
|
|
453
|
+
end
|
|
454
|
+
|
|
455
|
+
# Create element for this attribute
|
|
456
|
+
if rule.collection?
|
|
457
|
+
# For collections, apply value_map conversion with tracking flags
|
|
458
|
+
# so the collection serializer knows the original intent
|
|
459
|
+
converted_from_empty_to_nil = false
|
|
460
|
+
converted_from_nil_to_empty = false
|
|
461
|
+
value_map = rule.option(:value_map) || {}
|
|
462
|
+
to_map = value_map[:to] || {}
|
|
463
|
+
|
|
464
|
+
if value.nil?
|
|
465
|
+
to_nil = to_map[:nil]
|
|
466
|
+
if to_nil == :empty
|
|
467
|
+
converted_from_nil_to_empty = true
|
|
468
|
+
end
|
|
469
|
+
elsif Lutaml::Model::Utils.empty?(value)
|
|
470
|
+
to_empty = to_map[:empty] # nil → no conversion (default: omit)
|
|
471
|
+
if to_empty == :nil
|
|
472
|
+
value = nil
|
|
473
|
+
converted_from_empty_to_nil = true
|
|
474
|
+
end
|
|
475
|
+
end
|
|
476
|
+
|
|
477
|
+
collection_serializer.serialize(parent, value, rule, options,
|
|
478
|
+
converted_from_empty_to_nil: converted_from_empty_to_nil,
|
|
479
|
+
converted_from_nil_to_empty: converted_from_nil_to_empty)
|
|
480
|
+
else
|
|
481
|
+
# For non-collections, pass original value directly.
|
|
482
|
+
# create_value_element handles all value_map conversions with full context.
|
|
483
|
+
create_value_element(parent, rule, value, options)
|
|
484
|
+
end
|
|
485
|
+
end
|
|
486
|
+
|
|
487
|
+
# Check if value should be skipped based on render options
|
|
488
|
+
#
|
|
489
|
+
# Delegates to the shared RenderPolicy module for consistent
|
|
490
|
+
# behavior across XML and KeyValue formats.
|
|
491
|
+
#
|
|
492
|
+
# @param value [Object] The value to check
|
|
493
|
+
# @param rule [CompiledRule] The rule
|
|
494
|
+
# @param model_instance [Object] The model instance
|
|
495
|
+
# @param delegate [Symbol, nil] The delegate attribute name if present
|
|
496
|
+
# @return [Boolean] true if should skip
|
|
497
|
+
def should_skip_value?(value, rule, model_instance, delegate = nil)
|
|
498
|
+
if delegate
|
|
499
|
+
delegate_obj = model_instance.public_send(delegate)
|
|
500
|
+
should_skip_delegated_value?(value, rule, delegate_obj)
|
|
501
|
+
else
|
|
502
|
+
super(value, rule, model_instance)
|
|
503
|
+
end
|
|
504
|
+
end
|
|
505
|
+
|
|
506
|
+
# Create a collection element
|
|
507
|
+
#
|
|
508
|
+
# @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
|
|
509
|
+
# @param rule [CompiledRule] The rule
|
|
510
|
+
# @param collection [Array] The collection value
|
|
511
|
+
# @param options [Hash] Options
|
|
512
|
+
# @param converted_from_empty_to_nil [Boolean] True if value was converted from empty to nil
|
|
513
|
+
# @param converted_from_nil_to_empty [Boolean] True if value should be converted from nil to empty
|
|
514
|
+
def create_collection_element(parent, rule, collection, options,
|
|
515
|
+
converted_from_empty_to_nil: false, converted_from_nil_to_empty: false)
|
|
516
|
+
# Handle nil collection - skip if nil unless should render
|
|
517
|
+
if collection.nil?
|
|
518
|
+
to_map = (rule.option(:value_map) || {})[:to] || {}
|
|
519
|
+
nil_mapping = to_map[:nil]
|
|
520
|
+
if nil_mapping == :empty || converted_from_nil_to_empty
|
|
521
|
+
parent[rule.serialized_name] = []
|
|
522
|
+
elsif nil_mapping == :nil || converted_from_empty_to_nil
|
|
523
|
+
parent[rule.serialized_name] = nil
|
|
524
|
+
else
|
|
525
|
+
# Skip nil collection
|
|
526
|
+
end
|
|
527
|
+
return
|
|
528
|
+
end
|
|
529
|
+
|
|
530
|
+
# Convert to array for consistent handling
|
|
531
|
+
items = Array(collection)
|
|
532
|
+
|
|
533
|
+
# Check if this has root_mappings - merge directly into parent
|
|
534
|
+
root_mappings = rule.option(:root_mappings)
|
|
535
|
+
if root_mappings
|
|
536
|
+
# For root_mappings, the collection items are keyed and merged directly into parent
|
|
537
|
+
# Find the attribute to use as key
|
|
538
|
+
key_attribute = root_mappings.key(:key)
|
|
539
|
+
# Find the attribute to use as value (optional - if not provided, serialize all attributes)
|
|
540
|
+
value_attribute = root_mappings.key(:value)
|
|
541
|
+
|
|
542
|
+
# Initialize parent's value as a hash if it's nil
|
|
543
|
+
parent.value ||= {} if parent.value.nil?
|
|
544
|
+
|
|
545
|
+
# Case 1: Both key and value attributes specified
|
|
546
|
+
if key_attribute && value_attribute
|
|
547
|
+
items.each do |item|
|
|
548
|
+
next if item.nil?
|
|
549
|
+
|
|
550
|
+
# Get the key value from the item
|
|
551
|
+
key_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(key_attribute)
|
|
552
|
+
item.public_send(key_attribute)
|
|
553
|
+
end
|
|
554
|
+
next if key_value.nil?
|
|
555
|
+
|
|
556
|
+
# Get the value from the item
|
|
557
|
+
attr_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(value_attribute)
|
|
558
|
+
item.public_send(value_attribute)
|
|
559
|
+
end
|
|
560
|
+
next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
|
|
561
|
+
|
|
562
|
+
# For the value, we need to transform it appropriately
|
|
563
|
+
# First, check if it's a single nested model
|
|
564
|
+
item_class = item.class
|
|
565
|
+
attr_def = item_class.attributes(register_id)&.[](value_attribute)
|
|
566
|
+
|
|
567
|
+
if attr_def && attr_value.is_a?(Lutaml::Model::Serialize)
|
|
568
|
+
# Single nested model - transform it to a hash
|
|
569
|
+
attr_type = attr_def.type(register_id)
|
|
570
|
+
if attr_type.is_a?(Class) && attr_type < Lutaml::Model::Serialize
|
|
571
|
+
# Get the mapping for the value's class
|
|
572
|
+
value_class_mapping = attr_value.class.mappings_for(format,
|
|
573
|
+
register_id)
|
|
574
|
+
|
|
575
|
+
# Build a transformation for the value's class
|
|
576
|
+
value_transformation = self.class.new(attr_value.class,
|
|
577
|
+
value_class_mapping, format, register)
|
|
578
|
+
|
|
579
|
+
# Transform the value to a KeyValueElement
|
|
580
|
+
value_root = value_transformation.transform(attr_value,
|
|
581
|
+
options)
|
|
582
|
+
|
|
583
|
+
# transform emits the output hash directly (TODO.perf 19)
|
|
584
|
+
parent[key_value.to_s] = value_root
|
|
585
|
+
next
|
|
586
|
+
end
|
|
587
|
+
end
|
|
588
|
+
|
|
589
|
+
# Check if it's a collection
|
|
590
|
+
if attr_value.is_a?(Array) || attr_value.is_a?(Lutaml::Model::Collection)
|
|
591
|
+
# Get the attribute definition for the value attribute from the item's class
|
|
592
|
+
item_class = item.class
|
|
593
|
+
attr_def = item_class.attributes(register_id)&.[](value_attribute)
|
|
594
|
+
next unless attr_def
|
|
595
|
+
|
|
596
|
+
# Get the type of items in the collection
|
|
597
|
+
item_type = attr_def.type(register_id)
|
|
598
|
+
|
|
599
|
+
# Get the child transformation for the collection item type
|
|
600
|
+
if item_type.is_a?(Class) && item_type < Lutaml::Model::Serialize
|
|
601
|
+
# Create a temporary parent KeyValueElement to hold the collection
|
|
602
|
+
temp_parent = {}
|
|
603
|
+
|
|
604
|
+
# Convert to array
|
|
605
|
+
coll_items = Array(attr_value)
|
|
606
|
+
|
|
607
|
+
# Get the mapping for the item's class
|
|
608
|
+
item_class_mapping = item_class.mappings_for(format,
|
|
609
|
+
register_id)
|
|
610
|
+
|
|
611
|
+
# Build a temporary transformation for the item's class
|
|
612
|
+
item_class_transformation = self.class.new(item_class,
|
|
613
|
+
item_class_mapping, format, register)
|
|
614
|
+
|
|
615
|
+
# Find the rule for the value_attribute in the item's class mapping
|
|
616
|
+
item_rule = item_class_transformation.compiled_rules.find do |r|
|
|
617
|
+
r.attribute_name == value_attribute
|
|
618
|
+
end
|
|
619
|
+
|
|
620
|
+
if item_rule&.collection_info && item_rule.collection_info[:child_mappings]
|
|
621
|
+
# Use the keyed collection handling
|
|
622
|
+
child_mappings = item_rule.collection_info[:child_mappings]
|
|
623
|
+
coll_key_attr = keyed_collection_key_attribute(child_mappings)
|
|
624
|
+
|
|
625
|
+
if coll_key_attr
|
|
626
|
+
# Create a keyed collection directly
|
|
627
|
+
create_keyed_collection_element(temp_parent, item_rule,
|
|
628
|
+
coll_items, coll_key_attr, child_mappings, options)
|
|
629
|
+
else
|
|
630
|
+
create_array_collection_element(temp_parent, item_rule,
|
|
631
|
+
coll_items, options)
|
|
632
|
+
end
|
|
633
|
+
elsif item_rule
|
|
634
|
+
# No child_mappings - serialize as array
|
|
635
|
+
create_array_collection_element(temp_parent, item_rule,
|
|
636
|
+
coll_items, options)
|
|
637
|
+
end
|
|
638
|
+
|
|
639
|
+
coll_value = temp_parent[value_attribute.to_s]
|
|
640
|
+
|
|
641
|
+
parent[key_value.to_s] = coll_value
|
|
642
|
+
next
|
|
643
|
+
end
|
|
644
|
+
end
|
|
645
|
+
|
|
646
|
+
# Fallback: just use the value directly
|
|
647
|
+
parent[key_value.to_s] = attr_value
|
|
648
|
+
end
|
|
649
|
+
# Case 2: Only key attribute specified - serialize all other attributes
|
|
650
|
+
elsif key_attribute
|
|
651
|
+
items.each do |item|
|
|
652
|
+
next if item.nil?
|
|
653
|
+
|
|
654
|
+
key_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(key_attribute)
|
|
655
|
+
item.public_send(key_attribute)
|
|
656
|
+
end
|
|
657
|
+
next if key_value.nil?
|
|
658
|
+
|
|
659
|
+
# Serialize all attributes except the key
|
|
660
|
+
item_hash = {}
|
|
661
|
+
item_class = item.class
|
|
662
|
+
|
|
663
|
+
# Get the mapping for the item's class to find serialized names
|
|
664
|
+
if item_class.is_a?(Class) && item_class.include?(Lutaml::Model::Serialize)
|
|
665
|
+
item_class_mapping = item_class.mappings_for(format,
|
|
666
|
+
register_id)
|
|
667
|
+
|
|
668
|
+
item_class.attributes(register_id).each do |attr_name, attr_def|
|
|
669
|
+
# Skip the key attribute since it's used as the hash key
|
|
670
|
+
next if attr_name == key_attribute
|
|
671
|
+
|
|
672
|
+
attr_value = item.public_send(attr_name)
|
|
673
|
+
next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
|
|
674
|
+
|
|
675
|
+
# Serialize the attribute value
|
|
676
|
+
serialized_value = serialize_collection_item_value(
|
|
677
|
+
attr_value, attr_def, options
|
|
678
|
+
)
|
|
679
|
+
|
|
680
|
+
# Determine the path for this attribute based on root_mappings
|
|
681
|
+
# root_mappings format: { attr_name => path_spec }
|
|
682
|
+
# where path_spec can be:
|
|
683
|
+
# - :key (used as hash key, already skipped above)
|
|
684
|
+
# - "string" (single key, use the string)
|
|
685
|
+
# - [:path, :to, :nested] (array of path segments)
|
|
686
|
+
path_spec = root_mappings[attr_name]
|
|
687
|
+
|
|
688
|
+
# Use the path_spec if present, otherwise use the serialized name from mapping
|
|
689
|
+
if path_spec
|
|
690
|
+
if path_spec.is_a?(Array)
|
|
691
|
+
# Build nested structure: [:path, :to, :nested] -> item_hash["path"]["to"]["nested"] = value
|
|
692
|
+
current = item_hash
|
|
693
|
+
path_spec[0...-1].each do |key|
|
|
694
|
+
key_str = key.to_s
|
|
695
|
+
current[key_str] ||= {}
|
|
696
|
+
current = current[key_str]
|
|
697
|
+
end
|
|
698
|
+
current[path_spec.last.to_s] = serialized_value
|
|
699
|
+
elsif path_spec == :key
|
|
700
|
+
# Skip - key is used as the hash key
|
|
701
|
+
next
|
|
702
|
+
else
|
|
703
|
+
# Use the path_spec as a single key
|
|
704
|
+
item_hash[path_spec.to_s] = serialized_value
|
|
705
|
+
end
|
|
706
|
+
else
|
|
707
|
+
# No path_spec in root_mappings - use the serialized name from the mapping
|
|
708
|
+
serialized_name = attr_name.to_s
|
|
709
|
+
if item_class_mapping
|
|
710
|
+
mapping_rule = item_class_mapping.mappings.find do |m|
|
|
711
|
+
m.to == attr_name
|
|
712
|
+
end
|
|
713
|
+
serialized_name = mapping_rule.name.to_s if mapping_rule&.name
|
|
714
|
+
end
|
|
715
|
+
|
|
716
|
+
item_hash[serialized_name] = serialized_value
|
|
717
|
+
end
|
|
718
|
+
end
|
|
719
|
+
end
|
|
720
|
+
|
|
721
|
+
parent[key_value.to_s] = item_hash unless item_hash.empty?
|
|
722
|
+
end
|
|
723
|
+
end
|
|
724
|
+
|
|
725
|
+
return
|
|
726
|
+
end
|
|
727
|
+
|
|
728
|
+
# Check if this is a keyed collection (map_key feature)
|
|
729
|
+
child_mappings = rule.collection_info && rule.collection_info[:child_mappings]
|
|
730
|
+
key_attribute = keyed_collection_key_attribute(child_mappings)
|
|
731
|
+
|
|
732
|
+
if key_attribute
|
|
733
|
+
# Serialize as hash keyed by the key attribute
|
|
734
|
+
create_keyed_collection_element(parent, rule, items, key_attribute,
|
|
735
|
+
child_mappings, options)
|
|
736
|
+
else
|
|
737
|
+
# Serialize as array (default)
|
|
738
|
+
create_array_collection_element(parent, rule, items, options)
|
|
739
|
+
end
|
|
740
|
+
end
|
|
741
|
+
|
|
742
|
+
# Create a keyed collection element (map_key feature)
|
|
743
|
+
#
|
|
744
|
+
# @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
|
|
745
|
+
# @param rule [CompiledRule] The rule
|
|
746
|
+
# @param items [Array] The collection items
|
|
747
|
+
# @param key_attribute [Symbol] The attribute to use as hash key
|
|
748
|
+
# @param child_mappings [Hash] The child mappings configuration
|
|
749
|
+
# @param options [Hash] Options
|
|
750
|
+
def create_keyed_collection_element(parent, rule, items, key_attribute,
|
|
751
|
+
child_mappings, options)
|
|
752
|
+
# Create hash to hold keyed items
|
|
753
|
+
keyed_hash = {}
|
|
754
|
+
|
|
755
|
+
# Check if there's a value mapping (map_value as_attribute: :name)
|
|
756
|
+
# This means we should serialize just the specified attribute value, not the full item hash
|
|
757
|
+
value_attribute = nil
|
|
758
|
+
child_mappings&.each do |attr_name, mapping_type|
|
|
759
|
+
value_attribute = attr_name if mapping_type == :value
|
|
760
|
+
end
|
|
761
|
+
|
|
762
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
763
|
+
puts "create_keyed_collection_element: items.count=#{items.count}, key_attribute=#{key_attribute}, value_attribute=#{value_attribute.inspect}"
|
|
764
|
+
end
|
|
765
|
+
|
|
766
|
+
items.each do |item|
|
|
767
|
+
# Get the key value from the item
|
|
768
|
+
key_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(key_attribute)
|
|
769
|
+
item.public_send(key_attribute)
|
|
770
|
+
end
|
|
771
|
+
|
|
772
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
773
|
+
puts " item: #{item.inspect}, key_value=#{key_value.inspect}"
|
|
774
|
+
end
|
|
775
|
+
|
|
776
|
+
next if key_value.nil?
|
|
777
|
+
|
|
778
|
+
# If there's a value mapping, serialize just that attribute value
|
|
779
|
+
if value_attribute
|
|
780
|
+
attr_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(value_attribute)
|
|
781
|
+
item.public_send(value_attribute)
|
|
782
|
+
end
|
|
783
|
+
next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
|
|
784
|
+
|
|
785
|
+
# Get the attribute definition for proper serialization
|
|
786
|
+
attr_def = nil
|
|
787
|
+
item_class = item.class
|
|
788
|
+
if item_class.is_a?(Class) && item_class.include?(Lutaml::Model::Serialize)
|
|
789
|
+
attr_def = item_class.attributes(register_id)&.[](value_attribute)
|
|
790
|
+
end
|
|
791
|
+
|
|
792
|
+
# Serialize the attribute value
|
|
793
|
+
serialized_value = if attr_def
|
|
794
|
+
serialize_collection_item_value(attr_value,
|
|
795
|
+
attr_def, options)
|
|
796
|
+
else
|
|
797
|
+
attr_value
|
|
798
|
+
end
|
|
799
|
+
|
|
800
|
+
unless serialized_value.nil?
|
|
801
|
+
keyed_hash[key_value.to_s] =
|
|
802
|
+
serialized_value
|
|
803
|
+
end
|
|
804
|
+
else
|
|
805
|
+
# No value mapping - serialize all attributes as a hash
|
|
806
|
+
item_hash = {}
|
|
807
|
+
|
|
808
|
+
# Check if child_mappings only contains :key/:value (no nested paths)
|
|
809
|
+
# In that case, we should also serialize other attributes not in child_mappings
|
|
810
|
+
has_nested_paths = child_mappings&.any? do |_, path_spec|
|
|
811
|
+
path_spec.is_a?(Array)
|
|
812
|
+
end
|
|
813
|
+
|
|
814
|
+
# Use child_mappings to determine where each attribute goes in the nested hash
|
|
815
|
+
if child_mappings && (has_nested_paths || child_mappings.any? do |_, path_spec|
|
|
816
|
+
path_spec != :key && path_spec != :value
|
|
817
|
+
end)
|
|
818
|
+
# child_mappings format: { attr_name => path_spec }
|
|
819
|
+
# where path_spec can be:
|
|
820
|
+
# - :key (used as hash key, already handled)
|
|
821
|
+
# - :value (use the value directly)
|
|
822
|
+
# - [:path, :to, :nested] (nested path)
|
|
823
|
+
# - :simple (single key, same as attr_name)
|
|
824
|
+
|
|
825
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
826
|
+
puts " Using child_mappings: #{child_mappings.inspect}"
|
|
827
|
+
end
|
|
828
|
+
|
|
829
|
+
child_mappings.each do |attr_name, path_spec|
|
|
830
|
+
# Skip :key mappings - they're used as the hash key
|
|
831
|
+
next if path_spec == :key
|
|
832
|
+
# Skip :value mappings - handled separately
|
|
833
|
+
next if path_spec == :value
|
|
834
|
+
|
|
835
|
+
# Get the attribute value
|
|
836
|
+
attr_value = if item.is_a?(Lutaml::Model::Serialize) && item.class.attributes.key?(attr_name)
|
|
837
|
+
item.public_send(attr_name)
|
|
838
|
+
end
|
|
839
|
+
|
|
840
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
841
|
+
puts " #{attr_name}: path_spec=#{path_spec.inspect}, attr_value=#{attr_value.inspect}"
|
|
842
|
+
end
|
|
843
|
+
|
|
844
|
+
next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
|
|
845
|
+
|
|
846
|
+
# Get the attribute definition for proper serialization
|
|
847
|
+
attr_def = nil
|
|
848
|
+
item_class = item.class
|
|
849
|
+
if item_class.is_a?(Class) && item_class.include?(Lutaml::Model::Serialize)
|
|
850
|
+
attr_def = item_class.attributes(register_id)&.[](attr_name)
|
|
851
|
+
end
|
|
852
|
+
|
|
853
|
+
# Serialize the attribute value
|
|
854
|
+
serialized_value = if attr_def
|
|
855
|
+
serialize_collection_item_value(
|
|
856
|
+
attr_value, attr_def, options
|
|
857
|
+
)
|
|
858
|
+
else
|
|
859
|
+
attr_value
|
|
860
|
+
end
|
|
861
|
+
|
|
862
|
+
next if serialized_value.nil?
|
|
863
|
+
|
|
864
|
+
# Build the nested hash structure based on path_spec
|
|
865
|
+
# path_spec can be:
|
|
866
|
+
# - [:path, :to, :nested] - array of path segments
|
|
867
|
+
# - :simple - single key
|
|
868
|
+
if path_spec.is_a?(Array)
|
|
869
|
+
# Build nested structure: [:path, :to, :nested] -> item_hash["path"]["to"]["nested"] = value
|
|
870
|
+
current = item_hash
|
|
871
|
+
path_spec[0...-1].each do |key|
|
|
872
|
+
key_str = key.to_s
|
|
873
|
+
current[key_str] ||= {}
|
|
874
|
+
current = current[key_str]
|
|
875
|
+
end
|
|
876
|
+
current[path_spec.last.to_s] = serialized_value
|
|
877
|
+
else
|
|
878
|
+
# Single key - use attr_name as key
|
|
879
|
+
item_hash[attr_name.to_s] = serialized_value
|
|
880
|
+
end
|
|
881
|
+
end
|
|
882
|
+
end
|
|
883
|
+
|
|
884
|
+
# Always serialize all attributes (as fallback) for keyed collections
|
|
885
|
+
# This handles the case where child_mappings only has :key mapping
|
|
886
|
+
item_class = item.class
|
|
887
|
+
if item_class.is_a?(Class) && item_class.include?(Lutaml::Model::Serialize)
|
|
888
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
889
|
+
puts " item_class.attributes(#{register_id}): #{item_class.attributes(register_id).inspect}"
|
|
890
|
+
end
|
|
891
|
+
item_class.attributes(register_id).each do |attr_name, attr_def|
|
|
892
|
+
# Skip the key attribute since it's used as the hash key
|
|
893
|
+
next if attr_name == key_attribute
|
|
894
|
+
# Skip attributes already processed by child_mappings
|
|
895
|
+
next if child_mappings&.key?(attr_name)
|
|
896
|
+
|
|
897
|
+
attr_value = item.public_send(attr_name)
|
|
898
|
+
|
|
899
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
900
|
+
puts " #{attr_name}: attr_value=#{attr_value.inspect}"
|
|
901
|
+
end
|
|
902
|
+
|
|
903
|
+
next if attr_value.nil? || Lutaml::Model::Utils.uninitialized?(attr_value)
|
|
904
|
+
|
|
905
|
+
# Serialize the attribute value
|
|
906
|
+
serialized_value = serialize_collection_item_value(attr_value,
|
|
907
|
+
attr_def, options)
|
|
908
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
909
|
+
puts " serialized_value=#{serialized_value.inspect}"
|
|
910
|
+
end
|
|
911
|
+
unless serialized_value.nil?
|
|
912
|
+
item_hash[attr_name.to_s] =
|
|
913
|
+
serialized_value
|
|
914
|
+
end
|
|
915
|
+
end
|
|
916
|
+
end
|
|
917
|
+
|
|
918
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
919
|
+
puts " item_hash: #{item_hash.inspect}"
|
|
920
|
+
end
|
|
921
|
+
|
|
922
|
+
# Add to keyed hash
|
|
923
|
+
keyed_hash[key_value.to_s] = item_hash unless item_hash.empty?
|
|
924
|
+
end
|
|
925
|
+
end
|
|
926
|
+
|
|
927
|
+
if ENV["DEBUG_KEYED_COLLECTION"]
|
|
928
|
+
puts " keyed_hash: #{keyed_hash.inspect}"
|
|
929
|
+
end
|
|
930
|
+
|
|
931
|
+
parent[rule.serialized_name] = keyed_hash
|
|
932
|
+
end
|
|
933
|
+
|
|
934
|
+
# Create an array collection element (default)
|
|
935
|
+
#
|
|
936
|
+
# @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
|
|
937
|
+
# @param rule [CompiledRule] The rule
|
|
938
|
+
# @param items [Array] The collection items
|
|
939
|
+
# @param options [Hash] Options
|
|
940
|
+
def create_array_collection_element(parent, rule, items, options)
|
|
941
|
+
# children_to_array semantics directly: always an array,
|
|
942
|
+
# nil children skipped (explicit nil check — booleans matter).
|
|
943
|
+
built = items.each_with_object([]) do |item, memo|
|
|
944
|
+
child_value = create_value_for_item(rule, item, options)
|
|
945
|
+
memo << child_value unless child_value.nil?
|
|
946
|
+
end
|
|
947
|
+
parent[rule.serialized_name] = built
|
|
948
|
+
end
|
|
949
|
+
|
|
950
|
+
# Get the key attribute for a keyed collection from child_mappings
|
|
951
|
+
#
|
|
952
|
+
# @param child_mappings [Hash] The child mappings (e.g., { id: :key })
|
|
953
|
+
# @return [Symbol, nil] The attribute name to use as key, or nil
|
|
954
|
+
def keyed_collection_key_attribute(child_mappings)
|
|
955
|
+
return nil unless child_mappings
|
|
956
|
+
|
|
957
|
+
# Find the attribute mapped to :key
|
|
958
|
+
child_mappings.each do |attr_name, mapping|
|
|
959
|
+
return attr_name.to_sym if mapping == :key
|
|
960
|
+
end
|
|
961
|
+
|
|
962
|
+
nil
|
|
963
|
+
end
|
|
964
|
+
|
|
965
|
+
# Serialize a collection item value (for keyed collections)
|
|
966
|
+
#
|
|
967
|
+
# @param value [Object] The value to serialize
|
|
968
|
+
# @param attr_def [Attribute] The attribute definition
|
|
969
|
+
# @param options [Hash] Options
|
|
970
|
+
# @return [Object] The serialized value
|
|
971
|
+
def serialize_collection_item_value(value, attr_def, options)
|
|
972
|
+
return nil if value.nil? || Lutaml::Model::Utils.uninitialized?(value)
|
|
973
|
+
|
|
974
|
+
# Check if this is a collection attribute
|
|
975
|
+
attr_type = attr_def.type(register_id)
|
|
976
|
+
if attr_def.collection?
|
|
977
|
+
# For collections, check if it's a collection of Serialize models
|
|
978
|
+
if attr_type.is_a?(Class) && attr_type < Lutaml::Model::Serialize
|
|
979
|
+
# Create child transformation for the item type
|
|
980
|
+
mapping = attr_type.mappings_for(format, register_id)
|
|
981
|
+
child_transformation = self.class.new(attr_type, mapping, format,
|
|
982
|
+
register)
|
|
983
|
+
|
|
984
|
+
# Serialize each item in the collection
|
|
985
|
+
items = Array(value)
|
|
986
|
+
if items.empty?
|
|
987
|
+
[]
|
|
988
|
+
else
|
|
989
|
+
# For keyed collections (with child_mappings), serialize as hash
|
|
990
|
+
# For regular collections, serialize as array
|
|
991
|
+
# We need to check if the mapping has child_mappings for this attribute
|
|
992
|
+
# Since we don't have direct access to the parent mapping here,
|
|
993
|
+
# serialize as array for now (default behavior)
|
|
994
|
+
items.map do |item|
|
|
995
|
+
child_transformation.transform(item, options)
|
|
996
|
+
end
|
|
997
|
+
end
|
|
998
|
+
else
|
|
999
|
+
# Primitive collection - return as-is (already an array)
|
|
1000
|
+
value
|
|
1001
|
+
end
|
|
1002
|
+
elsif attr_type.is_a?(Class) && attr_type < Lutaml::Model::Serialize
|
|
1003
|
+
# Single value - check if it's a nested model
|
|
1004
|
+
mapping = attr_type.mappings_for(format, register_id)
|
|
1005
|
+
child_transformation = self.class.new(attr_type, mapping, format,
|
|
1006
|
+
register)
|
|
1007
|
+
child_transformation.transform(value, options)
|
|
1008
|
+
# Use the transformation to serialize the nested model
|
|
1009
|
+
elsif attr_type.is_a?(Class) && attr_type < Lutaml::Model::Type::Value
|
|
1010
|
+
wrapped_value = attr_type.new(value)
|
|
1011
|
+
wrapped_value.public_send(:"to_#{format}")
|
|
1012
|
+
else
|
|
1013
|
+
value
|
|
1014
|
+
end
|
|
1015
|
+
end
|
|
1016
|
+
|
|
1017
|
+
# Create a value element
|
|
1018
|
+
#
|
|
1019
|
+
# @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
|
|
1020
|
+
# @param rule [CompiledRule] The rule
|
|
1021
|
+
# @param value [Object] The value
|
|
1022
|
+
# @param options [Hash] Options
|
|
1023
|
+
def create_value_element(parent, rule, value, options)
|
|
1024
|
+
to_map = (rule.option(:value_map) || {})[:to] || {}
|
|
1025
|
+
|
|
1026
|
+
# Handle value_map conversions for nil/uninitialized/empty values.
|
|
1027
|
+
# Skip logic (should_skip_value?) already filters omitted cases,
|
|
1028
|
+
# so here we only handle render directives.
|
|
1029
|
+
if value.nil?
|
|
1030
|
+
nil_mapping = to_map[:nil]
|
|
1031
|
+
case nil_mapping
|
|
1032
|
+
when :omitted
|
|
1033
|
+
return
|
|
1034
|
+
when :nil
|
|
1035
|
+
parent[rule.serialized_name] = nil
|
|
1036
|
+
return
|
|
1037
|
+
when :empty
|
|
1038
|
+
parent[rule.serialized_name] = ""
|
|
1039
|
+
return
|
|
1040
|
+
end
|
|
1041
|
+
|
|
1042
|
+
# nil with no mapping → skip (default behavior)
|
|
1043
|
+
return
|
|
1044
|
+
elsif Lutaml::Model::Utils.uninitialized?(value)
|
|
1045
|
+
omitted_mapping = to_map[:omitted]
|
|
1046
|
+
if omitted_mapping == :nil
|
|
1047
|
+
parent[rule.serialized_name] = nil
|
|
1048
|
+
return
|
|
1049
|
+
elsif omitted_mapping == :empty
|
|
1050
|
+
parent[rule.serialized_name] = ""
|
|
1051
|
+
return
|
|
1052
|
+
end
|
|
1053
|
+
# uninitialized with no/omitted mapping → skip (default behavior)
|
|
1054
|
+
return
|
|
1055
|
+
elsif Lutaml::Model::Utils.empty?(value)
|
|
1056
|
+
empty_mapping = to_map[:empty]
|
|
1057
|
+
if empty_mapping == :nil
|
|
1058
|
+
parent[rule.serialized_name] = nil
|
|
1059
|
+
return
|
|
1060
|
+
elsif empty_mapping == :omitted
|
|
1061
|
+
return
|
|
1062
|
+
end
|
|
1063
|
+
# empty with :empty or no mapping → fall through to normal serialization
|
|
1064
|
+
end
|
|
1065
|
+
|
|
1066
|
+
# Normal value serialization
|
|
1067
|
+
child_value = create_value_for_item(rule, value, options)
|
|
1068
|
+
|
|
1069
|
+
parent[rule.serialized_name] = child_value unless child_value.nil?
|
|
1070
|
+
end
|
|
1071
|
+
|
|
1072
|
+
# Create value for an item (handles nested models and primitives)
|
|
1073
|
+
#
|
|
1074
|
+
# @param rule [CompiledRule] The rule
|
|
1075
|
+
# @param value [Object] The value
|
|
1076
|
+
# @param options [Hash] Options
|
|
1077
|
+
# @return [Object] The value (could be Hash, primitive, or KeyValueElement)
|
|
1078
|
+
def coerce_accepted_nested_value(value, declared_class)
|
|
1079
|
+
NestedValueCoercion.coerce(value, declared_class)
|
|
1080
|
+
end
|
|
1081
|
+
|
|
1082
|
+
# Child transformations memoized on this transformation instance:
|
|
1083
|
+
# the factory binds this instance's mapping/format/register, so
|
|
1084
|
+
# the memo is register-safe, and building one per serialized node
|
|
1085
|
+
# is a Transformation per nested model per instance.
|
|
1086
|
+
def transformation_for_type(type_class)
|
|
1087
|
+
(@lutaml_type_transformations ||= {})[type_class] ||=
|
|
1088
|
+
build_child_transformation(type_class)
|
|
1089
|
+
end
|
|
1090
|
+
|
|
1091
|
+
def create_value_for_item(rule, value, options)
|
|
1092
|
+
return nil if value.nil?
|
|
1093
|
+
|
|
1094
|
+
# Union: dispatch on the value's own class (stateless, like polymorphism).
|
|
1095
|
+
# A model member serializes via its class; a scalar member emits as-is.
|
|
1096
|
+
union = Lutaml::Model::Type::Union.rule?(rule)
|
|
1097
|
+
is_nested_model = if union
|
|
1098
|
+
value.is_a?(Lutaml::Model::Serialize)
|
|
1099
|
+
else
|
|
1100
|
+
rule.attribute_type.is_a?(Class) &&
|
|
1101
|
+
rule.attribute_type < Lutaml::Model::Serialize
|
|
1102
|
+
end
|
|
1103
|
+
|
|
1104
|
+
if is_nested_model && !value.is_a?(Lutaml::Model::Serialize)
|
|
1105
|
+
# The KV mirror of the XML lane's #971 collapse: a tolerated
|
|
1106
|
+
# singular attribute holding an over-assigned collection
|
|
1107
|
+
# serializes its leading value instead of raising.
|
|
1108
|
+
attr = if model_class.respond_to?(:attributes)
|
|
1109
|
+
model_class.attributes[rule.attribute_name.to_sym]
|
|
1110
|
+
end
|
|
1111
|
+
value = value.first if attr&.tolerates_singular_overflow?(value)
|
|
1112
|
+
end
|
|
1113
|
+
|
|
1114
|
+
if is_nested_model
|
|
1115
|
+
# Validate that value matches the expected type
|
|
1116
|
+
# There are three valid cases:
|
|
1117
|
+
# 1. attribute_type is a mapper class (has model method) and value is an instance of that model
|
|
1118
|
+
# 2. attribute_type is a regular Serializable class and value is an instance of it (or subclass)
|
|
1119
|
+
# 3. value's class is a registered type substitution for attribute_type
|
|
1120
|
+
context = Lutaml::Model::GlobalContext.context(register_id)
|
|
1121
|
+
subs = context.substitution_for(rule.attribute_type)
|
|
1122
|
+
uses_type_substitution = subs.any? { |s| s.to_type == value.class }
|
|
1123
|
+
|
|
1124
|
+
if rule.attribute_type.is_a?(Class) && rule.attribute_type.include?(Lutaml::Model::Serialize) && rule.attribute_type.model
|
|
1125
|
+
# Mapper class: value should be an instance of the mapped model
|
|
1126
|
+
# or a valid substituted type
|
|
1127
|
+
unless value.is_a?(rule.attribute_type.model) || uses_type_substitution
|
|
1128
|
+
value = coerce_accepted_nested_value(value, rule.attribute_type.model)
|
|
1129
|
+
unless value.is_a?(rule.attribute_type.model)
|
|
1130
|
+
msg = "attribute '#{rule.attribute_name}' value is a '#{value.class}' but should be a '#{rule.attribute_type.model}'"
|
|
1131
|
+
raise Lutaml::Model::IncorrectModelError, msg
|
|
1132
|
+
end
|
|
1133
|
+
end
|
|
1134
|
+
else
|
|
1135
|
+
# Regular Serializable class: value should be a Serialize instance
|
|
1136
|
+
# or a valid substituted type
|
|
1137
|
+
unless value.is_a?(Lutaml::Model::Serialize) || uses_type_substitution
|
|
1138
|
+
value = coerce_accepted_nested_value(value, rule.attribute_type)
|
|
1139
|
+
unless value.is_a?(Lutaml::Model::Serialize)
|
|
1140
|
+
msg = "attribute '#{rule.attribute_name}' value is a '#{value.class}' but should be a kind of 'Lutaml::Model::Serialize'"
|
|
1141
|
+
raise Lutaml::Model::IncorrectModelError, msg
|
|
1142
|
+
end
|
|
1143
|
+
end
|
|
1144
|
+
end
|
|
1145
|
+
|
|
1146
|
+
# Use the actual runtime type for polymorphism support
|
|
1147
|
+
# If value is a subclass of the declared type, use its mappings instead
|
|
1148
|
+
# Also handle type substitution the same way
|
|
1149
|
+
actual_type = value.class
|
|
1150
|
+
uses_polymorphism = union ||
|
|
1151
|
+
(actual_type != rule.attribute_type &&
|
|
1152
|
+
actual_type < rule.attribute_type) || uses_type_substitution
|
|
1153
|
+
|
|
1154
|
+
# Get child transformation - may be cached or need to create
|
|
1155
|
+
child_transformation = rule.child_transformation
|
|
1156
|
+
|
|
1157
|
+
# If not cached (e.g., due to cycles) or using polymorphism, create it now
|
|
1158
|
+
if !child_transformation || uses_polymorphism
|
|
1159
|
+
# For polymorphic types, use the actual runtime type's mappings
|
|
1160
|
+
type_for_mapping = uses_polymorphism ? actual_type : rule.attribute_type
|
|
1161
|
+
child_transformation = transformation_for_type(type_for_mapping)
|
|
1162
|
+
end
|
|
1163
|
+
|
|
1164
|
+
if child_transformation
|
|
1165
|
+
child_root = child_transformation.transform(value, options)
|
|
1166
|
+
# transform emits the content hash directly (TODO.perf 19);
|
|
1167
|
+
# an empty serialization still returns nil so render_nil:
|
|
1168
|
+
# false keeps working for nested models.
|
|
1169
|
+
child_root.empty? ? nil : child_root
|
|
1170
|
+
else
|
|
1171
|
+
# Fallback: serialize as primitive
|
|
1172
|
+
serialize_value(value, rule)
|
|
1173
|
+
end
|
|
1174
|
+
elsif union
|
|
1175
|
+
# Union scalar: serialize through the value type matching the value's
|
|
1176
|
+
# own class so output is canonical (e.g. BigDecimal -> "1.5"), not a
|
|
1177
|
+
# raw Ruby object.
|
|
1178
|
+
Lutaml::Model::Type::Union.serialize_scalar(value, format)
|
|
1179
|
+
else
|
|
1180
|
+
# Serialize primitive value
|
|
1181
|
+
serialize_value(value, rule)
|
|
1182
|
+
end
|
|
1183
|
+
end
|
|
1184
|
+
|
|
1185
|
+
# Handle raw mapping (map_all directive)
|
|
1186
|
+
#
|
|
1187
|
+
# Raw mappings parse the stored content (JSON/YAML/TOML string) and merge it
|
|
1188
|
+
# directly into the parent element, rather than creating a child element.
|
|
1189
|
+
#
|
|
1190
|
+
# @param parent [Lutaml::KeyValue::DataModel::Element] Parent element
|
|
1191
|
+
# @param value [String] The raw content (JSON/YAML/TOML string)
|
|
1192
|
+
# @param options [Hash] Options
|
|
1193
|
+
def handle_raw_mapping(parent, value, options)
|
|
1194
|
+
return if value.nil? || Lutaml::Model::Utils.uninitialized?(value)
|
|
1195
|
+
return if Lutaml::Model::Utils.empty?(value)
|
|
1196
|
+
|
|
1197
|
+
# Get the adapter for the current format and parse the raw content
|
|
1198
|
+
adapter = Lutaml::Model::Config.adapter_for(format)
|
|
1199
|
+
parsed_content = adapter.parse(value, options)
|
|
1200
|
+
|
|
1201
|
+
# Merge the parsed content into the parent element
|
|
1202
|
+
# For each key-value pair in the parsed content, add as a child element
|
|
1203
|
+
if parsed_content.is_a?(::Hash)
|
|
1204
|
+
parsed_content.each do |key, val|
|
|
1205
|
+
parent[key.to_s] = val
|
|
1206
|
+
end
|
|
1207
|
+
elsif !parsed_content.nil?
|
|
1208
|
+
# A raw mapping's content must be a key-value document — it is
|
|
1209
|
+
# merged into the parent by key. Any other shape (an Array, a
|
|
1210
|
+
# scalar) has no representation here; serializing it under a
|
|
1211
|
+
# synthetic key would leak that key into the document.
|
|
1212
|
+
raise ArgumentError,
|
|
1213
|
+
"raw mapping content must parse to a Hash, got " \
|
|
1214
|
+
"#{parsed_content.class}"
|
|
1215
|
+
end
|
|
1216
|
+
end
|
|
1217
|
+
|
|
1218
|
+
# Serialize a value to appropriate representation
|
|
1219
|
+
#
|
|
1220
|
+
# @param value [Object] The value to serialize
|
|
1221
|
+
# @param rule [CompiledRule] The rule
|
|
1222
|
+
# @return [Object] Serialized value
|
|
1223
|
+
def serialize_value(value, rule)
|
|
1224
|
+
return nil if value.nil?
|
|
1225
|
+
return nil if Lutaml::Model::Utils.uninitialized?(value)
|
|
1226
|
+
|
|
1227
|
+
# Rule-invariant resolution (attribute lookup, Reference probe,
|
|
1228
|
+
# nested-type class) is compiled once per rule — the per-value
|
|
1229
|
+
# hash lookups dominated primitive-heavy serialization.
|
|
1230
|
+
# Transformation freezes itself after compile; the plan cache
|
|
1231
|
+
# lives on the ValueSerializer (same model_class/register_id).
|
|
1232
|
+
plan = value_serializer.serialize_value_plan(rule)
|
|
1233
|
+
|
|
1234
|
+
if plan[:reference]
|
|
1235
|
+
return plan[:attr].serialize(value, format, register_id, {})
|
|
1236
|
+
end
|
|
1237
|
+
|
|
1238
|
+
# Validate that value is an instance of the expected Serializable type
|
|
1239
|
+
# When attribute_type is a Serializable class, value must be an instance of that class
|
|
1240
|
+
if plan[:nested]
|
|
1241
|
+
unless value.is_a?(rule.attribute_type)
|
|
1242
|
+
value = coerce_accepted_nested_value(value, rule.attribute_type)
|
|
1243
|
+
unless value.is_a?(rule.attribute_type)
|
|
1244
|
+
msg = "attribute '#{rule.attribute_name}' value is a '#{value.class}' but should be a '#{rule.attribute_type}'"
|
|
1245
|
+
raise Lutaml::Model::IncorrectModelError, msg
|
|
1246
|
+
end
|
|
1247
|
+
end
|
|
1248
|
+
|
|
1249
|
+
# Value is a valid Serialize instance - serialize it using its own to_#{format} method
|
|
1250
|
+
return value.public_send(:"to_#{format}")
|
|
1251
|
+
end
|
|
1252
|
+
|
|
1253
|
+
# Wrap value in type and call to_#{format} instance method (like legacy Attribute#serialize_value)
|
|
1254
|
+
# This allows custom type subclasses to override to_json, to_yaml, etc.
|
|
1255
|
+
if rule.attribute_type.is_a?(Class) && rule.attribute_type < Lutaml::Model::Type::Value
|
|
1256
|
+
type = rule.attribute_type
|
|
1257
|
+
# Identity fast path (TODO.perf/07): a builtin type with no custom
|
|
1258
|
+
# to_<format>/from_<format> behavior emits an already-native value
|
|
1259
|
+
# unchanged — the wrap only re-casts and re-emits it.
|
|
1260
|
+
native = NATIVE_VALUE_CLASS[type]
|
|
1261
|
+
if native && value.instance_of?(native) &&
|
|
1262
|
+
!::Lutaml::Model::Type::Value
|
|
1263
|
+
.format_type_serializer_for(format, type)&.fetch(:to, nil) &&
|
|
1264
|
+
!::Lutaml::Model::Attribute.custom_from_probe?(type)
|
|
1265
|
+
return value
|
|
1266
|
+
end
|
|
1267
|
+
|
|
1268
|
+
wrapped_value = type.new(value)
|
|
1269
|
+
wrapped_value.public_send(:"to_#{format}")
|
|
1270
|
+
else
|
|
1271
|
+
value
|
|
1272
|
+
end
|
|
1273
|
+
end
|
|
1274
|
+
end
|
|
1275
|
+
end
|
|
1276
|
+
end
|