lutaml-model 0.8.174 → 0.8.175

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5c88e0fabb05c803bd90e90e239491b158506fbc28a400a5c622947c6b6660f
-  data.tar.gz: 6963e7357fb635c514dcb65844ca6fba6a72e4db19a254b744dcc43ac38ddade
+  metadata.gz: '0658d10c7cba33a11cf0dfbc7105bb1be8661e99a9806800cd967ac2d7b1eff0'
+  data.tar.gz: 3964a62ce7c8bda8b35fc957df765bad29074a9f16f82117b3a421373cd43d9c
 SHA512:
-  metadata.gz: aac56768d97444e04fe6e92ff1c9e4802daf1dc2d974028a972245db3b83b9c77d81993e13733393d2c0b6024329eb31cb4f36b5af1362c88c6faec41c734488
-  data.tar.gz: b999e90b67a01d971f782e906863e35c3d17ed6da0fb1f37f2c757d473d27d1b30f7385903dd94d4f0bea8dfc88a3209be24f5b2a45c17a70362c9047912f05e
+  metadata.gz: 5494168be6927595ed23a594138ee347e0687d90c41bdba72309f942ea7079eb9cc3fd10c1b86579eb7f87ef5647962afc7304374d09cb5519fc6b6c11307f0b
+  data.tar.gz: fcc10b888f2712615ab14c826997f57f7ef1937bda9e0470fd87aff70eaa461e612f6dca7ca272890583a2374149bcc823eb4ba83bdc77a6b7fecd0e0c73ce16

data/lib/lutaml/model/version.rb

@@ -2,6 +2,6 @@
 
 module Lutaml
   module Model
-    VERSION = "0.8.174"
+    VERSION = "0.8.175"
   end
 end

data/lib/lutaml/yaml/adapter/yeptris_adapter.rb

@@ -90,16 +90,72 @@ module Lutaml
         end
         private_class_method :syntax_error
 
-        # Dump rides the inherited standard (Psych) adapter — this class
-        # does not override #to_yaml. The native Yeptris::Psych.dump
-        # does not fold long plain scalars at Psych's 80-column
-        # boundary, so an override here changes every stored fixture's
-        # byte format the moment the native lane is selected (the
-        # 0.8.171 default-flip broke relaton's SAE round-trip spec
-        # exactly this way: parse parity landed in yeptris 0.6.57+,
-        # dump folding did not — yeptris#863's remaining scope). Parse
-        # keeps the native lane, where the parity is real; generation
-        # returns here when the engine folds at parity.
+        # Dump rides the native Yeptris::Psych face when the engine's
+        # emitter is byte-parity with the standard adapter, else the
+        # inherited standard (Psych) dump. The contract: a stored
+        # fixture generated under one adapter must round-trip
+        # byte-exactly under the other, or a host whose bundle flips
+        # the default engine rewrites every stored YAML (the 0.8.171
+        # default-flip broke relaton's SAE suite exactly this way).
+        # Parity is capability-based, not version-based: the probe
+        # dumps the shape battery through the native face and the
+        # standard adapter and compares byte-for-byte. Plain-scalar
+        # folding landed in yeptris 0.6.62.1, bare null-valued keys
+        # after literal blocks in 0.6.63 (#1264); any engine that
+        # misses a shape keeps the standard dump without a version
+        # floor.
+        def to_yaml(_options = {})
+          return super unless self.class.native_dump_parity?
+
+          require "yeptris/psych"
+          Yeptris::Psych.dump(@attributes)
+        end
+
+        # True when the native emitter produces byte-identical output
+        # to the standard adapter across the shape battery (the same
+        # shapes the adapter spec pins: plain-scalar folding, null
+        # keys after literal blocks and quoted siblings, flow, unicode,
+        # nesting, multiline). Memoized; any failure — missing psych,
+        # engine error, non-parity bytes — reports false so dump rides
+        # the standard adapter.
+        def self.native_dump_parity?
+          return @native_dump_parity unless @native_dump_parity.nil?
+
+          @native_dump_parity = begin
+            require "yeptris/psych"
+            dump_parity_shapes.all? do |shape|
+              native = Yeptris::Psych.dump(shape)
+              # The comparison target is the literal parent class, not
+              # this class's to_yaml: the override routes back here
+              # while the probe is still unmemoized, recursing to a
+              # SystemStackError.
+              native == Lutaml::Yaml::Adapter::StandardAdapter.new(shape).to_yaml
+            end
+          rescue StandardError
+            false
+          end
+        end
+
+        # The document shapes whose byte treatment historically differs
+        # between emitters (leptris/yeptris#863, #1264). Keep in sync
+        # with the adapter spec's battery.
+        def self.dump_parity_shapes
+          [
+            {
+              "title" => "Taxonomy and Definitions for Terms Related to " \
+                         "Driving Automation Systems for On-Road Motor " \
+                         "Vehicles for On-Road Motor Vehicles",
+              "roles" => %w[admin dev],
+            },
+            { "s" => "line1\nline2", "n" => nil },
+            { "q" => "has: colon", "n" => nil },
+            { "u" => "héllo wörld", "num" => "007", "f" => 1.5, "e" => "" },
+            { "deep" => { "deeper" => [{ "x" => "y" }, [4, 5]] } },
+            { "multi" => "para one\n\npara two", "dash" => "a - b - c",
+              "omitted" => nil },
+            { "a" => 1, "b" => [1, 2, 3], "c" => { "d" => true } },
+          ]
+        end
       end
     end
   end

data/spec/lutaml/yaml/yeptris_adapter_spec.rb

@@ -60,9 +60,12 @@ RSpec.describe Lutaml::Yaml::Adapter::YeptrisAdapter do
     # fixture generated under one adapter must round-trip byte-exactly
     # under the other, or a host whose bundle flips the default engine
     # rewrites every stored YAML (relaton's SAE suite caught the
-    # 0.8.171 default flip this way — the native emitter does not fold
-    # long plain scalars at Psych's 80-column boundary, so generation
-    # rides the standard adapter until the engine folds at parity).
+    # 0.8.171 default flip this way). Generation rides the native face
+    # only when the adapter's capability probe (native_dump_parity?)
+    # finds the engine byte-identical across the shape battery —
+    # plain-scalar folding landed in yeptris 0.6.62.1, bare null keys
+    # after literal blocks in 0.6.63 (leptris/yeptris#863, #1264);
+    # engines that miss a shape keep the standard dump.
     describe "byte parity with the standard adapter" do
       let(:long_scalar) do
         "Taxonomy and Definitions for Terms Related to Driving Automation " \
@@ -72,14 +75,42 @@ RSpec.describe Lutaml::Yaml::Adapter::YeptrisAdapter do
         { "title" => long_scalar, "roles" => %w[admin dev] }
       end
 
-      it "folds long plain scalars exactly like the standard adapter" do
-        standard = Lutaml::Yaml::Adapter::StandardAdapter.new(wrapped_attributes).to_yaml
-        expect(described_class.new(wrapped_attributes).to_yaml).to eq(standard)
+      # The same shapes the capability probe exercises in
+      # yeptris_adapter.rb — keep the two lists in sync.
+      let(:parity_shapes) do
+        [
+          wrapped_attributes,
+          { "s" => "line1\nline2", "n" => nil },
+          { "q" => "has: colon", "n" => nil },
+          { "u" => "héllo wörld", "num" => "007", "f" => 1.5, "e" => "" },
+          { "deep" => { "deeper" => [{ "x" => "y" }, [4, 5]] } },
+          { "multi" => "para one\n\npara two", "dash" => "a - b - c",
+            "omitted" => nil },
+          { "a" => 1, "b" => [1, 2, 3], "c" => { "d" => true } },
+        ]
       end
 
-      it "parses the standard adapter's folded dump back identically" do
-        standard = Lutaml::Yaml::Adapter::StandardAdapter.new(wrapped_attributes).to_yaml
-        expect(described_class.parse(standard)).to eq(wrapped_attributes)
+      it "dumps every parity shape byte-identically to the standard adapter" do
+        parity_shapes.each do |shape|
+          standard = Lutaml::Yaml::Adapter::StandardAdapter.new(shape).to_yaml
+          expect(described_class.new(shape).to_yaml).to eq(standard)
+        end
+      end
+
+      it "parses the standard adapter's dumps back identically" do
+        parity_shapes.each do |shape|
+          standard = Lutaml::Yaml::Adapter::StandardAdapter.new(shape).to_yaml
+          expect(described_class.parse(standard)).to eq(shape)
+        end
+      end
+
+      it "opens the native dump lane when the engine answers the probe" do
+        skip "engine not fold-parity on this platform" unless
+          described_class.native_dump_parity?
+
+        first = parity_shapes.first
+        expect(described_class.new(first).to_yaml)
+          .to eq(Yeptris::Psych.dump(first))
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lutaml-model
 version: !ruby/object:Gem::Version
-  version: 0.8.174
+  version: 0.8.175
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-11-11 00:00:00.000000000 Z
+date: 2026-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64