lutaml-model 0.8.24 → 0.8.28

data/spec/lutaml/xml/plan_walk_spec.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "lutaml/xml/plan_walk"
+
+RSpec.describe "XML PlanWalk consumer surface" do
+  around do |example|
+    Lutaml::Model::Config.with_adapter(xml: :leptris) { example.run }
+  end
+
+  let(:item_class) do
+    Class.new(Lutaml::Model::Serializable) do
+      attribute :id, :integer
+      attribute :name, :string
+      attribute :tags, :string, collection: true
+
+      xml do
+        element "row"
+        map_attribute "id", to: :id
+        map_element "name", to: :name
+        map_element "tags", to: :tags
+      end
+    end
+  end
+
+  it "hydrates equal to the interpretive path on a single-row document" do
+    xml = %(<row id="7"><name>Alice</name><tags>x</tags><tags>y</tags></row>)
+    walked = Lutaml::Xml::PlanWalk.call(item_class, xml)
+    expected = item_class.from_xml(xml)
+
+    expect(walked).to be_a(item_class)
+    expect(walked.id).to eq(expected.id)
+    expect(walked.name).to eq(expected.name)
+    expect(walked.tags).to eq(expected.tags)
+  end
+
+  it "returns an Array for collection roots" do
+    xml = %(<root><row id="1"><name>a</name></row><row id="2"><name>b</name></row></root>)
+    item_type = item_class
+    root_class = Class.new(Lutaml::Model::Serializable) do
+      attribute :item, item_type, collection: true
+
+      xml do
+        element "root"
+        map_element "row", to: :item
+      end
+    end
+
+    walked = Lutaml::Xml::PlanWalk.call(root_class, xml)
+    expected = root_class.from_xml(xml)
+
+    expect(walked.item).to be_an(Array)
+    expect(walked.item.map(&:id)).to eq(expected.item.map(&:id))
+    expect(walked.item.map(&:name)).to eq(expected.item.map(&:name))
+  end
+
+  it "walks and hydrates a 5000-row document in under the interpretive cost" do
+    xml = +"<root>"
+    5000.times do |i|
+      xml << %(<row id="#{i}"><name>r-#{i}</name><tags>a</tags><tags>b</tags></row>)
+    end
+    xml << "</root>"
+
+    item_type = item_class
+    root_class = Class.new(Lutaml::Model::Serializable) do
+      attribute :item, item_type, collection: true
+
+      xml do
+        element "root"
+        map_element "row", to: :item
+      end
+    end
+
+    walked = Lutaml::Xml::PlanWalk.call(root_class, xml)
+    interpretive = root_class.from_xml(xml)
+    expect(walked.item.size).to eq(interpretive.item.size)
+    expect(walked.item.map(&:id)).to eq(interpretive.item.map(&:id))
+  end
+
+  it "compiles delegate mappings for post-instance routing" do
+    # delegates compile and route after the target instance exists
+    target = Class.new(Lutaml::Model::Serializable) do
+      attribute :note, :string
+      xml do
+        element "tgt"
+        map_element "note", to: :note
+      end
+    end
+    klass = Class.new(Lutaml::Model::Serializable) do
+      attribute :tgt, target
+      xml do
+        element "doc"
+        map_element "note", to: :note, delegate: :tgt
+      end
+    end
+
+    expect(Lutaml::Xml::PlanCompiler.compile(klass,
+                                             Lutaml::Model::Config.default_register)).not_to be_nil
+    expect(Lutaml::Xml::PlanWalk.call(klass, "<doc><note>x</note></doc>").tgt.note)
+      .to eq("x")
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-model
 version: !ruby/object:Gem::Version
-  version: 0.8.24
+  version: 0.8.28
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-15 00:00:00.000000000 Z
+date: 2026-09-17 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.34
+        version: 0.5.56
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.34
+        version: 0.5.56
 - !ruby/object:Gem::Dependency
   name: ostruct
   requirement: !ruby/object:Gem::Requirement
@@ -791,6 +791,9 @@ files:
 - lib/lutaml/xml/parsed_namespace_set.rb
 - lib/lutaml/xml/plan_compiler.rb
 - lib/lutaml/xml/plan_hydrator.rb
+- lib/lutaml/xml/plan_order.rb
+- lib/lutaml/xml/plan_serializer.rb
+- lib/lutaml/xml/plan_walk.rb
 - lib/lutaml/xml/polymorphic_value_handler.rb
 - lib/lutaml/xml/qualified_inheritance_strategy.rb
 - lib/lutaml/xml/rexml.rb
@@ -940,6 +943,7 @@ files:
 - lib/tasks/performance_helpers.rb
 - lib/tasks/performance_probe.rake
 - lib/tasks/performance_probe.rb
+- lib/tasks/performance_probe_plan_walk.rb
 - lib/tasks/performance_probe_xml.rb
 - lib/tasks/xml_compiler_benchmark.rb
 - lib/tasks/xml_optimization_benchmark.rb
@@ -1911,6 +1915,7 @@ files:
 - 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/plan_walk_spec.rb
 - spec/lutaml/xml/prefix_control_spec.rb
 - spec/lutaml/xml/register_spec.rb
 - spec/lutaml/xml/reusable_mapping_spec.rb