lutaml-model 0.8.23 → 0.8.24

data/spec/lutaml/key_value/adapter/toml/teptris_adapter_spec.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require "spec_helper"
+require "lutaml/key_value/adapter/toml/teptris_adapter"
+begin
+  require "teptris"
+rescue LoadError
+  # teptris is not resolvable here (absent or broken native library):
+  # every example skips.
+end
+
+TEPTRIS_AVAILABLE = defined?(Teptris)
+
+RSpec.describe(TEPTRIS_AVAILABLE ? Lutaml::KeyValue::Adapter::Toml::TeptrisAdapter : Object) do
+  before { skip "teptris is not available" unless TEPTRIS_AVAILABLE }
+
+  describe ".parse" do
+    it "parses a TOML document into a hash" do
+      expect(described_class.parse("name = \"John\"\nage = 30\n"))
+        .to eq("name" => "John", "age" => 30)
+    end
+
+    it "parses nested tables and arrays" do
+      toml = <<~TOML
+        title = "cfg"
+        [owner]
+        name = "t"
+        tags = ["a", "b"]
+      TOML
+      expect(described_class.parse(toml))
+        .to eq("title" => "cfg", "owner" => { "name" => "t", "tags" => %w[a b] })
+    end
+
+    it "materializes dates and datetimes like tomlib" do
+      require "date"
+      doc = described_class.parse("d = 1979-05-27\ndt = 1979-05-27T07:32:00Z\n")
+      expect(doc["d"]).to be_a(Date)
+      expect(doc["dt"]).to be_a(Time)
+    end
+
+    it "reports parse errors with line and column" do
+      expect { described_class.parse("a = [1,") }
+        .to raise_error(Teptris::ParseError) do |e|
+          expect(e.line).to eq(1)
+          expect(e.column).to eq(8)
+        end
+    end
+  end
+
+  describe "#to_toml" do
+    it "dumps a hash to TOML" do
+      attributes = { "name" => "x", "nested" => { "a" => [1, 2] } }
+      expect(described_class.new(attributes).to_toml)
+        .to include("name", "[nested]", "a = [1, 2]")
+    end
+
+    it "unwraps the __root__ KeyValueElement wrapper" do
+      element = Lutaml::KeyValue::DataModel::Element.new("__root__")
+      name_child = Lutaml::KeyValue::DataModel::Element.new("name")
+      name_child.value = "x"
+      element.add_child(name_child)
+      expect(described_class.new(element).to_toml).to include("name")
+    end
+  end
+
+  it "round-trips through the model layer" do
+    attributes = { "name" => "John", "age" => 30 }
+    adapter_toml = described_class.new(attributes).to_toml
+    expect(described_class.parse(adapter_toml)).to eq(attributes)
+  end
+end

data/spec/lutaml/model/json_adapter_spec.rb

@@ -1,4 +1,5 @@
 require "spec_helper"
+require "multi_json"
 require "lutaml/key_value/adapter/json/standard_adapter"
 require "lutaml/key_value/adapter/json/multi_json_adapter"
 require "lutaml/key_value/adapter/json/oj_adapter"
@@ -37,6 +38,11 @@ RSpec.describe "JsonAdapter" do
   end
 
   describe Lutaml::KeyValue::Adapter::Json::MultiJsonAdapter do
+    # multi_json 1.21's json_gem adapter passes options positionally to
+    # JSON.parse, which json >= 3 removed (intridea/multi_json#227).
+    if Gem::Version.new(JSON::VERSION) >= Gem::Version.new("3")
+      before { skip "multi_json is incompatible with json #{JSON::VERSION} (intridea/multi_json#227)" }
+    end
     it_behaves_like "a JSON adapter", described_class
   end
 

data/spec/lutaml/model/toml_adapter_spec.rb

@@ -17,6 +17,8 @@ RSpec.describe "TomlAdapter" do
         TomlRB.dump(attributes)
       elsif adapter_class == Lutaml::Model::Toml::TomlibAdapter
         Tomlib.dump(attributes)
+      elsif adapter_class == Lutaml::Model::Toml::TeptrisAdapter && defined?(Teptris)
+        Teptris::TOML.dump(attributes)
       end
     end
 
@@ -45,4 +47,10 @@ RSpec.describe "TomlAdapter" do
       it_behaves_like "a TOML adapter", described_class
     end
   end
+
+  if defined?(Teptris)
+    describe Lutaml::Model::Toml::TeptrisAdapter do
+      it_behaves_like "a TOML adapter", described_class
+    end
+  end
 end

data/spec/lutaml/model/toml_spec.rb

@@ -10,7 +10,7 @@ RSpec.describe Lutaml::Model::Toml do
     end
 
     it "does not autoload native TOML adapters on Opal" do
-      %i[TomlRbAdapter TomlibAdapter].each do |constant_name|
+      %i[TomlRbAdapter TomlibAdapter TeptrisAdapter].each do |constant_name|
         hide_const("Lutaml::Toml::Adapter::#{constant_name}")
       end
 
@@ -19,12 +19,14 @@ RSpec.describe Lutaml::Model::Toml do
 
       expect(Lutaml::Toml::Adapter.autoload?(:TomlRbAdapter)).to be_nil
       expect(Lutaml::Toml::Adapter.autoload?(:TomlibAdapter)).to be_nil
+      expect(Lutaml::Toml::Adapter.autoload?(:TeptrisAdapter)).to be_nil
     end
   end
 
   describe ".detect_toml_adapter" do
     before do
       # Hide any existing constants first
+      hide_const("Teptris") if Object.const_defined?(:Teptris)
       hide_const("Tomlib") if Object.const_defined?(:Tomlib)
       hide_const("TomlRb") if Object.const_defined?(:TomlRb)
 
@@ -32,6 +34,39 @@ RSpec.describe Lutaml::Model::Toml do
       allow(Lutaml::Model::Utils).to receive(:require).and_return(true)
     end
 
+    context "when teptris is available" do
+      before do
+        stub_const("Teptris", Module.new)
+      end
+
+      it "returns :teptris on non-Windows platforms (tomlib absent)" do
+        allow(Gem).to receive(:win_platform?).and_return(false)
+        expect(described_class.detect_toml_adapter).to eq(:teptris)
+      end
+
+      it "returns :teptris on Windows (native TOML without tomlib segfaults)" do
+        allow(Gem).to receive(:win_platform?).and_return(true)
+        expect(described_class.detect_toml_adapter).to eq(:teptris)
+      end
+    end
+
+    context "when teptris and tomlib are both available" do
+      before do
+        stub_const("Teptris", Module.new)
+        stub_const("Tomlib", Module.new)
+      end
+
+      it "prefers teptris on non-Windows (0.2.12+ beats tomlib both directions)" do
+        allow(Gem).to receive(:win_platform?).and_return(false)
+        expect(described_class.detect_toml_adapter).to eq(:teptris)
+      end
+
+      it "prefers teptris on Windows" do
+        allow(Gem).to receive(:win_platform?).and_return(true)
+        expect(described_class.detect_toml_adapter).to eq(:teptris)
+      end
+    end
+
     context "when Tomlib is available" do
       before do
         stub_const("Tomlib", Module.new)

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/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.23
+  version: 0.8.24
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-08 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,6 +321,7 @@ 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
@@ -351,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
@@ -361,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
@@ -370,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
@@ -678,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
@@ -691,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
@@ -707,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
@@ -753,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
@@ -780,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
@@ -904,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
@@ -926,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
@@ -1640,7 +1655,9 @@ files:
 - 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
@@ -1893,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
@@ -1942,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