lutaml-model 0.8.22 → 0.8.24

data/spec/lutaml/xml/plan_fast_path_spec.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+RSpec.describe "XML plan fast path" do
+  let(:classes) do
+    item_class = Class.new(Lutaml::Model::Serializable) do
+      attribute :id, :integer
+      attribute :name, :string
+      attribute :tags, :string, collection: true
+
+      xml do
+        element "item"
+        map_attribute "id", to: :id
+        map_element "name", to: :name
+        map_element "tag", to: :tags
+      end
+    end
+    root_class = Class.new(Lutaml::Model::Serializable) do
+      attribute :item, item_class, collection: true
+
+      xml do
+        element "root"
+        map_element "item", to: :item
+      end
+    end
+    [item_class, root_class]
+  end
+
+  let(:item_class) { classes[0] }
+  let(:root_class) { classes[1] }
+
+  around do |example|
+    old = Lutaml::Model::Config.instance.xml_plan_fast_path
+    Lutaml::Model::Config.instance.xml_plan_fast_path = true
+    example.run
+  ensure
+    Lutaml::Model::Config.instance.xml_plan_fast_path = old
+  end
+
+  it "is opt-in and off by default" do
+    expect(Lutaml::Model::Configuration.new.xml_plan_fast_path).to be(false)
+  end
+
+  it "hydrates equal to the interpretive path" do
+    xml = root_class.new(item: [
+                           item_class.new(id: 1, name: "a", tags: %w[x y]),
+                           item_class.new(id: 2, name: "b", tags: %w[z]),
+                         ]).to_xml
+
+    expect(root_class.from_xml(xml).item).to eq(root_class.new(item: [
+                                                                 item_class.new(id: 1, name: "a", tags: %w[x y]),
+                                                                 item_class.new(id: 2, name: "b", tags: %w[z]),
+                                                               ]).item)
+  end
+
+  it "matches the interpretive path on missing elements" do
+    xml = <<~XML
+      <root>
+        <item id="1"><name>A</name><tag>x</tag></item>
+        <item id="2"><tag>y</tag><tag>z</tag></item>
+        <item id="3"><name>C</name></item>
+      </root>
+    XML
+
+    parsed = root_class.from_xml(xml)
+    expect(parsed.item.map { |i| [i.id, i.name, i.tags] })
+      .to eq([[1, "A", %w[x]], [2, nil, %w[y z]], [3, "C", []]])
+  end
+
+  it "wraps engine parse errors as InvalidFormatError" do
+    Lutaml::Model::Config.with_adapter(xml: :leptris) do
+      expect { root_class.from_xml("<root><item>") }
+        .to raise_error(Lutaml::Model::InvalidFormatError)
+    end
+  end
+
+  it "falls back for non-compilable models" do
+    klass = Class.new(Lutaml::Model::Serializable) do
+      attribute :note, :string
+
+      xml do
+        element "doc"
+        map_element "note", to: :note, with: { from: :note_from }
+      end
+
+      def note_from(instance, value)
+        instance.note = value.text
+      end
+    end
+
+    expect(Lutaml::Xml::PlanCompiler.compile(klass,
+                                             Lutaml::Model::Config.default_register)).to be_nil
+    expect(klass.from_xml("<doc><note>hi</note></doc>").note).to eq("hi")
+  end
+end

data/spec/lutaml/xml/shared_element_rules_spec.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+
+# lutaml-model#765: two element rules mapped to one collection attribute
+# (spelling tolerance, e.g. metanorma's editorial-group/editorialgroup).
+# Parse must merge the spellings' content in document order — never drop
+# the first silently — and serialization must emit the value once, under
+# the first declared spelling.
+module SharedElementRulesSpec
+  class Both < Lutaml::Model::Serializable
+    attribute :items, :string, collection: true
+
+    xml do
+      root "r"
+      map_element "a", to: :items
+      map_element "b", to: :items
+    end
+  end
+end
+
+RSpec.describe "multiple element rules on one attribute" do
+  it "appends both spellings in document order" do
+    expect(SharedElementRulesSpec::Both.from_xml("<r><a>one</a><b>two</b></r>").items)
+      .to eq(["one", "two"])
+  end
+
+  it "appends in document order when the second spelling comes first" do
+    expect(SharedElementRulesSpec::Both.from_xml("<r><b>two</b><a>one</a></r>").items)
+      .to eq(["two", "one"])
+  end
+
+  it "keeps document order across interleaved spellings" do
+    xml = "<r><a>1</a><b>2</b><a>3</a><b>4</b></r>"
+    expect(SharedElementRulesSpec::Both.from_xml(xml).items).to eq(%w[1 2 3 4])
+  end
+
+  it "parses a document that only uses the first spelling" do
+    expect(SharedElementRulesSpec::Both.from_xml("<r><a>one</a></r>").items)
+      .to eq(["one"])
+  end
+
+  it "parses a document that only uses the second spelling" do
+    expect(SharedElementRulesSpec::Both.from_xml("<r><b>two</b></r>").items)
+      .to eq(["two"])
+  end
+
+  it "serializes the value once, under the first declared spelling" do
+    xml = SharedElementRulesSpec::Both.new(items: %w[one two]).to_xml
+    expect(xml.scan(/<(a|b)>/).flatten).to eq(%w[a a])
+    expect(xml).to include("<a>one</a>").and include("<a>two</a>")
+  end
+
+  it "round-trips through both spellings without losing content" do
+    doc = SharedElementRulesSpec::Both.from_xml("<r><a>one</a><b>two</b></r>")
+    reparsed = SharedElementRulesSpec::Both.from_xml(doc.to_xml)
+    expect(reparsed.items).to eq(%w[one two])
+  end
+
+  it "keeps the mapping usable when the attribute also has a default" do
+    both = SharedElementRulesSpec::Both.from_xml("<r/>")
+    expect(both.items).to eq([])
+  end
+end

data/spec/lutaml/xml/xml_spec.rb

@@ -120,6 +120,19 @@ RSpec.describe Lutaml::Xml do
       hide_const("Ox") if Object.const_defined?(:Ox)
       hide_const("Oga") if Object.const_defined?(:Oga)
       hide_const("REXML") if Object.const_defined?(:REXML)
+      # When the leptris gem is in the bundle, moxml prefers it over every
+      # other engine; the legacy-detection contexts below must opt out to
+      # exercise the fallback chain.
+      allow(Moxml::Config).to receive(:leptris_preferred_available?)
+        .and_return(false)
+    end
+
+    context "when the leptris engine is in the bundle" do
+      it "prefers :leptris" do
+        allow(Moxml::Config).to receive(:leptris_preferred_available?)
+          .and_return(true)
+        expect(described_class.detect_xml_adapter).to eq(:leptris)
+      end
     end
 
     context "when Nokogiri is available" do

data/spec/lutaml/yaml/yeptris_adapter_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+begin
+  require "lutaml/yaml/adapter/yeptris_adapter"
+rescue LoadError
+  # yeptris ships no platform gem here (e.g. Windows): every example skips.
+end
+
+YEPTRIS_AVAILABLE = defined?(Yeptris)
+
+RSpec.describe(YEPTRIS_AVAILABLE ? Lutaml::Yaml::Adapter::YeptrisAdapter : Object) do
+  before { skip "yeptris is not available on this platform" unless YEPTRIS_AVAILABLE }
+
+  let(:attributes) { { "name" => "John", "roles" => %w[admin dev] } }
+
+  describe ".parse" do
+    it "parses a YAML document into a hash" do
+      expect(described_class.parse("name: John\nroles:\n  - admin\n  - dev\n"))
+        .to eq(attributes)
+    end
+
+    it "round-trips nested structures" do
+      yaml = described_class.parse("outer:\n  inner: 1\n")
+      expect(yaml).to eq("outer" => { "inner" => 1 })
+    end
+
+    it "supports the same permitted classes as the standard adapter" do
+      require "date"
+      expect(described_class.parse("d: 2020-01-01\n"))
+        .to eq("d" => Date.new(2020, 1, 1))
+    end
+  end
+
+  describe "#to_yaml" do
+    subject(:document) { described_class.new(attributes) }
+
+    it "serializes a hash to YAML that parses back identically" do
+      expect(described_class.parse(document.to_yaml)).to eq(attributes)
+    end
+  end
+
+  describe "round trip through a model" do
+    let(:model_class) do
+      Class.new(Lutaml::Model::Serializable) do
+        attribute :name, :string
+        attribute :roles, :string, collection: true
+
+        key_value do
+          map "name", to: :name
+          map "roles", to: :roles
+        end
+      end
+    end
+
+    it "deserializes and serializes via the yeptris engine" do
+      model = model_class.from_yaml("name: John\nroles:\n  - admin\n  - dev\n")
+      expect(model.name).to eq("John")
+      expect(model.roles).to eq(%w[admin dev])
+      expect(model_class.from_yaml(model.to_yaml).roles).to eq(%w[admin dev])
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -99,7 +99,13 @@ require_relative "support/test_adapter_config"
 # require_relative "../lib/lutaml/model/toml_adapter/toml_rb_adapter"
 
 Lutaml::Model::Config.configure do |config|
-  config.xml_adapter_type  = RUBY_ENGINE == "opal" ? :oga : :nokogiri
+  config.xml_adapter_type  = if RUBY_ENGINE == "opal"
+                               :oga
+                             elsif ENV["XML_ADAPTER"]
+                               ENV["XML_ADAPTER"].to_sym
+                             else
+                               :nokogiri
+                             end
   config.hash_adapter_type = :standard
   config.json_adapter_type = :standard
   config.yaml_adapter_type = :standard

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-model
 version: !ruby/object:Gem::Version
-  version: 0.8.22
+  version: 0.8.24
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-29 00:00:00.000000000 Z
+date: 2026-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -92,14 +92,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 0.5.34
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 0.5.34
 - !ruby/object:Gem::Dependency
   name: ostruct
   requirement: !ruby/object:Gem::Requirement
@@ -208,6 +208,7 @@ files:
 - docs/_guides/keyvalue-serialization.adoc
 - docs/_guides/liquid-templates.adoc
 - docs/_guides/missing-values-handling.adoc
+- docs/_guides/native-engines.adoc
 - docs/_guides/ooxml-examples.adoc
 - docs/_guides/opal.adoc
 - docs/_guides/rdf-serialization.adoc
@@ -320,7 +321,9 @@ files:
 - lib/lutaml/json/adapter/oj_adapter.rb
 - lib/lutaml/json/adapter/standard_adapter.rb
 - lib/lutaml/json/adapter/transform.rb
+- lib/lutaml/json/adapter/yeptris_adapter.rb
 - lib/lutaml/json/format.rb
+- lib/lutaml/json/generator_options.rb
 - lib/lutaml/json/schema.rb
 - lib/lutaml/json/schema/json_schema.rb
 - lib/lutaml/json/type/serializers.rb
@@ -350,6 +353,7 @@ files:
 - lib/lutaml/key_value/adapter/json/oj_adapter.rb
 - lib/lutaml/key_value/adapter/json/standard_adapter.rb
 - lib/lutaml/key_value/adapter/json/transform.rb
+- lib/lutaml/key_value/adapter/json/yeptris_adapter.rb
 - lib/lutaml/key_value/adapter/jsonl.rb
 - lib/lutaml/key_value/adapter/jsonl/document.rb
 - lib/lutaml/key_value/adapter/jsonl/mapping.rb
@@ -360,6 +364,7 @@ files:
 - lib/lutaml/key_value/adapter/toml/document.rb
 - lib/lutaml/key_value/adapter/toml/mapping.rb
 - lib/lutaml/key_value/adapter/toml/mapping_rule.rb
+- lib/lutaml/key_value/adapter/toml/teptris_adapter.rb
 - lib/lutaml/key_value/adapter/toml/toml_rb_adapter.rb
 - lib/lutaml/key_value/adapter/toml/tomlib_adapter.rb
 - lib/lutaml/key_value/adapter/toml/transform.rb
@@ -369,6 +374,7 @@ files:
 - lib/lutaml/key_value/adapter/yaml/mapping_rule.rb
 - lib/lutaml/key_value/adapter/yaml/standard_adapter.rb
 - lib/lutaml/key_value/adapter/yaml/transform.rb
+- lib/lutaml/key_value/adapter/yaml/yeptris_adapter.rb
 - lib/lutaml/key_value/adapter/yamls.rb
 - lib/lutaml/key_value/adapter/yamls/document.rb
 - lib/lutaml/key_value/adapter/yamls/mapping.rb
@@ -677,6 +683,7 @@ files:
 - lib/lutaml/toml/adapter/document.rb
 - lib/lutaml/toml/adapter/mapping.rb
 - lib/lutaml/toml/adapter/mapping_rule.rb
+- lib/lutaml/toml/adapter/teptris_adapter.rb
 - lib/lutaml/toml/adapter/toml_rb_adapter.rb
 - lib/lutaml/toml/adapter/tomlib_adapter.rb
 - lib/lutaml/toml/adapter/transform.rb
@@ -690,6 +697,7 @@ files:
 - lib/lutaml/xml/adapter.rb
 - lib/lutaml/xml/adapter/adapter_helpers.rb
 - lib/lutaml/xml/adapter/base_adapter.rb
+- lib/lutaml/xml/adapter/leptris_adapter.rb
 - lib/lutaml/xml/adapter/namespace_data.rb
 - lib/lutaml/xml/adapter/namespace_uri_collector.rb
 - lib/lutaml/xml/adapter/nokogiri_adapter.rb
@@ -706,6 +714,7 @@ files:
 - lib/lutaml/xml/blank_namespace_handler.rb
 - lib/lutaml/xml/builder.rb
 - lib/lutaml/xml/builder/base.rb
+- lib/lutaml/xml/builder/leptris.rb
 - lib/lutaml/xml/builder/nokogiri.rb
 - lib/lutaml/xml/builder/oga.rb
 - lib/lutaml/xml/builder/ox.rb
@@ -752,6 +761,7 @@ files:
 - lib/lutaml/xml/format.rb
 - lib/lutaml/xml/format_chooser.rb
 - lib/lutaml/xml/hoisting_algorithm.rb
+- lib/lutaml/xml/leptris/element.rb
 - lib/lutaml/xml/listener.rb
 - lib/lutaml/xml/mapping.rb
 - lib/lutaml/xml/mapping_rule.rb
@@ -779,6 +789,8 @@ files:
 - lib/lutaml/xml/parse_session.rb
 - lib/lutaml/xml/parsed_namespace_declaration.rb
 - lib/lutaml/xml/parsed_namespace_set.rb
+- lib/lutaml/xml/plan_compiler.rb
+- lib/lutaml/xml/plan_hydrator.rb
 - lib/lutaml/xml/polymorphic_value_handler.rb
 - lib/lutaml/xml/qualified_inheritance_strategy.rb
 - lib/lutaml/xml/rexml.rb
@@ -903,6 +915,7 @@ files:
 - lib/lutaml/yaml/adapter/mapping_rule.rb
 - lib/lutaml/yaml/adapter/standard_adapter.rb
 - lib/lutaml/yaml/adapter/transform.rb
+- lib/lutaml/yaml/adapter/yeptris_adapter.rb
 - lib/lutaml/yaml/format.rb
 - lib/lutaml/yaml/schema.rb
 - lib/lutaml/yaml/schema/yaml_schema.rb
@@ -925,6 +938,9 @@ files:
 - lib/tasks/performance_benchmark.rb
 - lib/tasks/performance_comparator.rb
 - lib/tasks/performance_helpers.rb
+- lib/tasks/performance_probe.rake
+- lib/tasks/performance_probe.rb
+- lib/tasks/performance_probe_xml.rb
 - lib/tasks/xml_compiler_benchmark.rb
 - lib/tasks/xml_optimization_benchmark.rb
 - lutaml-model.gemspec
@@ -1638,7 +1654,10 @@ files:
 - spec/lutaml/integration/edge_cases_spec.rb
 - spec/lutaml/integration/multi_format_spec.rb
 - spec/lutaml/integration/round_trip_spec.rb
+- spec/lutaml/json/adapter/standard_adapter_spec.rb
+- spec/lutaml/json/yeptris_adapter_spec.rb
 - spec/lutaml/jsonld/adapter_spec.rb
+- spec/lutaml/key_value/adapter/toml/teptris_adapter_spec.rb
 - spec/lutaml/key_value/transformation/collection_serializer_spec.rb
 - spec/lutaml/key_value/transformation/rule_compiler_spec.rb
 - spec/lutaml/key_value/transformation/value_serializer_spec.rb
@@ -1657,6 +1676,7 @@ files:
 - spec/lutaml/model/collection_index_spec.rb
 - spec/lutaml/model/collection_mutation_spec.rb
 - spec/lutaml/model/collection_spec.rb
+- spec/lutaml/model/collection_state_nesting_spec.rb
 - spec/lutaml/model/collection_validation_spec.rb
 - spec/lutaml/model/comparable_model_spec.rb
 - spec/lutaml/model/compiled_rule_spec.rb
@@ -1677,6 +1697,7 @@ files:
 - spec/lutaml/model/enum_spec.rb
 - spec/lutaml/model/except_spec.rb
 - spec/lutaml/model/finalization_cache_spec.rb
+- spec/lutaml/model/generator_defaults_spec.rb
 - spec/lutaml/model/global_context_spec.rb
 - spec/lutaml/model/global_register_spec.rb
 - spec/lutaml/model/group_spec.rb
@@ -1686,6 +1707,7 @@ files:
 - spec/lutaml/model/inheritance_spec.rb
 - spec/lutaml/model/json_adapter_spec.rb
 - spec/lutaml/model/json_spec.rb
+- spec/lutaml/model/json_state_nesting_spec.rb
 - spec/lutaml/model/jsonl/standard_adapter_spec.rb
 - spec/lutaml/model/jsonl_spec.rb
 - spec/lutaml/model/key_value_data_model/key_value_element_spec.rb
@@ -1888,6 +1910,7 @@ files:
 - spec/lutaml/xml/ordered_method_spec.rb
 - spec/lutaml/xml/out_of_namespace_parsing_spec.rb
 - spec/lutaml/xml/pipeline_integration_spec.rb
+- spec/lutaml/xml/plan_fast_path_spec.rb
 - spec/lutaml/xml/prefix_control_spec.rb
 - spec/lutaml/xml/register_spec.rb
 - spec/lutaml/xml/reusable_mapping_spec.rb
@@ -1916,6 +1939,7 @@ files:
 - spec/lutaml/xml/schema/xsd/xsd_spec.rb
 - spec/lutaml/xml/schema_primer_spec.rb
 - spec/lutaml/xml/serializable_namespace_spec.rb
+- spec/lutaml/xml/shared_element_rules_spec.rb
 - spec/lutaml/xml/transformation/custom_method_wrapper_spec.rb
 - spec/lutaml/xml/transformation_spec.rb
 - spec/lutaml/xml/type_namespace/collector_spec.rb
@@ -1936,6 +1960,7 @@ files:
 - spec/lutaml/xml/xml_space_spec.rb
 - spec/lutaml/xml/xml_space_type_spec.rb
 - spec/lutaml/xml/xml_spec.rb
+- spec/lutaml/yaml/yeptris_adapter_spec.rb
 - spec/lutaml/yamlld/adapter_spec.rb
 - spec/lutaml/yamlld/registration_spec.rb
 - spec/parent_root_spec.rb